Pathmaker Reference Manual
Macro Definition and Commands
Macro Language
067869 Tandem Computers Incorporated 3–13
INVOKE Use the INVOKE command to start a macro process.
% INVOKE
macro-name-text
[IN
file-name-text
]
[ (
parameter-value
[,
parameter-value
] . . .)]
macro-name-text
is one of the following:
The name of a macro.
A text string containing a variable that expands to the name of a macro.
A ?SECTION in
file-name-text.
file-name-text
is the valid name of an edit file or a variable that expands to the name of a file.
Required only if the macro has not been registered using the Macro Registration
screen.
parameter-value
is the value passed to the macro to be used as the argument for the associated
parameter name. Parameter values are associated with parameter names by their
position in the parenthetical list. That is, the first
parameter-value
is
substituted for the first parameter name defined in the macro, the second
parameter-value
for the second parameter name, and so on.
parameter-value
can consist of either of the following:
alphanumeric string
is any text. A text string can itself contain references to other variables. If
alphanumeric string contains another variable, the system performs
nested substitutions prior to invoking the macro.
arithmetic expression
is a legal arithmetic expression that includes terms which can be variables or
decimal numbers and uses standard operators (+, -, *, /) and balanced
parentheses. Arithmetic operations follow standard precedence: unary - has
precedence over * and /. * and / have precedence over + and -. Operators of
like precedence are evaluated left to right unless parentheses are used to
indicate the order of evaluation. All arithmetic operations are done using
integer arithmetic.
The result of using an
arithmetic expression
for the
variable-value
is to assign the integer result of the operation to the variable.