Macro File Editing Rules; Macro File Syntax; Syntax Of Event And Continue; Statements - Sony XKS-C9111 User Manual

Macro File Editing Rules

When editing a macro file, observe the following rules.

Macro File Syntax

The macro file syntax is as follows.
File format
The file is in CSV (comma-separated value) format.
Newline code
CR (ASCII code 0D), LF (ASCII code 0A), or CRLF may
be used.
Statement syntax
There are four types of statement, each terminated by a
newline code.
File header: This must always appear as the first line of
the file. It comprises 28 characters, as follows.
Example: PNL (space) 0001PNL_rrrr.PMRnnnnnnnn
rrrr: Macro register number (0001 to 0250)
nnnnnnnn: In a file created on the switcher, this is a
register name automatically set by the switcher.
When creating a new file, it is recommended to set this
to be the same as the file name (see page 538).
The name is limited to eight characters.
The following characters may not be used.
space, \, /, :, ;, , (comma), . (period), <, >, *, ?, ", |
Comment: Begins with "#". The content of the line
following the "#" up to the next newline has no effect
on macro execution, and can be used as a comment.
Note
Comments can be used on the local drive or a
removable drive only. When you load a macro file into
a register, the comments are discarded.
Event statement: Begins with "Event?", and defines the
macro event content (see page 538).
Continue statement: Begins with "Continue?", and
defines the macro event content (see page 538).
Some events cannot be used (see page 539).

Syntax of Event and Continue

Statements

An event can be written with an Event statement only, or
with an Event statement followed by any number of
Continue statements. Event statements and Continue
statements have the following syntax.
Word separator character
Use "," (comma).
Ignored
Spaces and tabs are ignored. There is no distinction
between lowercase and uppercase. If two or more
separator characters appear consecutively, later ones are
ignored. Separator characters at the beginning of a line are
also ignored.
Content of line
Must begin with "Event?" or "Continue?", followed by
symbols and parameters.
Event?,[symbol],[parameter],[parameter],...
Continue?,[symbol],[parameter],[parameter],...
symbol: Type of event (ASCII character string) (see
page 539).
parameter: Shows details of an event. Consists of
parameter names and arguments, and these must
appear in pairs. The number and type of parameters
depends on the event (see page 541).
If the same parameter appears two or more times, the
rightmost occurrence is valid.
How to use Continue statements
When a single parameter has more than one argument, use
a Continue statement.
This section describes a snapshot event as an example.
An event to recall a snapshot in region M/E-1 is written as:
Event?,Snapshot,Region?,ME1,Register?,1,
Attribute?,Off,Time?,Current
In the Event statement, only one region can be specified.
To specify both regions M/E-1 and DME1, use a Continue
statement, thus:
Event?,Snapshot,Region?,ME1,Register?,1,
Attribute?,Off,Time?,Current
Continue?,Snapshot,Region?,DME1,Register?,1,
Attribute?,Off,Time?,Current
To specify more than one argument for a region parameter,
follow the Event statement by a Continue statement on the
next line.

File Name

Set the file name as follows.
Example: nnnnnnnn.PNL_rrrr.PMR
nnnnnnnn: In a file created on the switcher, this is a
register name automatically set by the switcher.
The name for a new file is limited to eight characters.
The following characters may not be used.
space, \, /, :, ;, , (comma), . (period), <, >, *, ?, ", |
rrrr: macro register number (0001 to 0250)
538