October 1, 1979 COMMAND MACROS CREATION
MACROS
11.2 CREATION _____________
11.2.1 INDIVIDUAL MACROS ________________________
Note ____: The "$"s in the titles for this section represent "&"s.
Format ______
A Command Macro is created as a CMS MEMO file with the same
name as that desired for the macro. These files are created and
changed using the CMS editor (see TM17 "CMS Editor Primer"). When
complete, the MEMO file form is merged into a <maclib> by using
either FMACADD or FMACREP (see Section 7.2.2).
Each line of the MEMO file is considered to be a FRESS command
line and may contain multiple commands separated by the FRESS
may not logical command separator ">" (see Section 5.4), but _______
contain nested macro calls __________________________.
Trailing blanks are removed from lines during processing unless
followed by the FRESS Command Separator.
Each command in the macro consists of literal character
strings, special functions (described below) and symbolic
parameter indicators which represent values to be filled in
when the user invokes the macro.
Literal ampersands ("&" -- those not used as special function
indicators, &C or &I, and those not used as symbolic parameters
&<n>, &R<n>) must be doubled.
Continuation Column ___________________
It is possible for a logical command line of the MEMO file to
up to 3 physical lines occupy ______________________ by placing a "*" in column 80.
The next line will then be concatenated to the 79th column of
the first line.
Although the macro definition may be 3 lines long (including
macro comments, prompts, etc.) the resulting expanded FRESS
must be less than 130 characters command line ________________________________ in length.
Symbolic parameters (&<n>, &R<n>), special function indicators
(&C, &I) and literal ampersands (&&) all consist of two or more
must not be split over card boundaries characters which ______________________________________.
FRESS Resource Manual Release 9.1 FRESS RSection 7.2 -- 249
October 1, 1979 COMMAND MACROS CREATION
MACROS -- $<n>
11.2.1.1 Symbolic Parameters (Index Variables) ______________________________________________
The symbolic parameters specified on a command line indicate
that a read will be done from the terminal and the line read in
can be used throughout the macro. One form is:


&<n>[<default>]


<n>.........a number from 1 to 9
<default>...a value for the parameter that is used if the
parameter is omitted or left null. Defaults may
contain any of the symbolic parameters, any of the
special functions, or regular text as well as any
a default cannot combination of these. The only thing ________________
contain another default _______ is _______________.
Notes _____
omitted If a parameter is _______ when no default is present an error
message will be typed and the Command Macro will not be
executed.
null Parameters may be left ____ even when no default is present.
The null string will be substituted in its place.
Each separate occurrence of a symbolic parameter indicator may
have its own particular associated default string.
Example _______
i/&1/&3&2 and &R'second half of inserted text:'
In this macro, the default will be used if &3 is either omitted
must or left null. If the default is used, &2 ____ previously have
been specified, since it can have no default.
250 -- Section 7 Release 9.1 FRESS Resource Manual
Previous Page Next Page