
Revision D • 8/05
H
A
R
R
I
S
C
O
R
P
O
R
A T
I
O
N
A-6
Appendix A VMCC
digital
SETUP, CONFIG, SESSION, MACRO—
GENERAL FILE INFO
All VistaMax device setup and configuration files
are text-only files that share common formatting
rules like: each section begins with a [Section
Name] header, which is limited to 32 characters;
that each entry line has an absolute maximum
length of 1,000 characters (the line length may be
further limited by other constraints imposed by
the section); and that all text proceeded by a semi-
colon (;) is a comment line, which is limited to 80
characters.
Config (
.cfg
) and setup (
.ini
) files are cre-
ated and maintained using VMCC so this infor-
mation is more applicable to session and macro
files, which are created and/or edited manually
using Notepad.
Here’s how each section and its entries appears
in each VistaMax file:
[Section Name]
;Section Comment Line
KeyValue=EntryValue ;Comment
The
[Section Name]
defines what the sec-
tion entry values set up. The name is specific and
must be entered using exact characters. Following
each
[Section Name]
heading is space avail-
able for one or more comment lines. Up to 32 com-
ment lines could be added. Each comment line
begins with a semicolon (;).
Each section is limited to 64 data entry lines.
Each data entry line is composed of a KeyValue
followed by = (equals) and then the EntryValue.
The KeyValue may be up to 32 characters in
length. The EntryValue may be up to 80 charac-
ters in length, plus each entry can be followed by
an optional comment—which can also be up to
80 characters in length (after the ;).
The format of the Entry Value is Section Name
specific, and it may have multiple components,
each separated by a comma.
When an EntryValue refers to a specific signal
in the VistaMax system it can be identified in three
ways: by its global number (
65697); by its local
number (
161); or, when the signal is on another
device, by its universal number (
d1.161). Each of
these numbers reference the Mix-Minus 1 signal
on the console set as device 1.
The following command shows the use of local
numbering,
[RouterCommand_1]
take_1=161,241; MM-1 > KSU A1
take_2=163,243; MM-2 > KSU A2
The following command shows the use of uni-
versal numbering,
[RouterCommand_1]
take_1=d1.161,d1.241; MM-1 > KSU A1
take_2=d1.163,d1.243; MM-2 > KSU A2
The following command shows the use of glo-
bal numbering,
[RouterCommand_1]
take_1=65697,65777; MM-1 > KSU A1
take_2=65699,65779; MM-2 > KSU A2
There are three Excel spreadsheets included on
the 99-5000 CD-ROM that can be used to deter-
mine the local and global numbers for each signal
in any console or rack. The universal number is
simply the device indicator (
d
) and the device num-
ber (1 up to 63) followed by a period and the local
number, as shown in the above examples.
There are also PDF files for each spreadsheet
that show the local and global numbers for device
1 of each console type and rack.
Section Headings
In session files most section headings define the
button states of each channel strip on the control
surface when the session loads. Thus there are sec-
tion headings for PGM 1, PGM 2, Mode, Cue, etc.
and under each heading is an entry for each chan-
nel strip in the console. These types of headings
were covered in chapter 4.