HLASM Language Reference

Macro Instruction Format
Operand Entry
You can use a variable symbol as a macro instruction. For example if MAC1 has
been defined as a macro, you can use the following statements to call it:
&CALL SETC 'MAC1'
&CALL
You cannot use a variable symbol as a macro instruction that passes operands to
the macro. The second statement in the following example generates an error:
&CALL SETC 'MAC1 OPERAND1=VALUE'
&CALL
You must specify operand entries after the variable symbol, as shown in the
following example:
&CALL SETC 'MAC1'
&CALL OPERAND1=VALUE
Use the operand entry of a macro instruction to pass values into the called macro
definition. These values can be passed through:
The symbolic parameters you have specified in the macro prototype, or
The system variable symbol &SYSLIST if it is specified in the body of the
macro definition (see “&SYSLIST System Variable Symbol” on page 276).
The two types of operands allowed in a macro instruction are positional and
keyword operands. You can specify a sublist with multiple values in both types of
operands. Special rules for the various values you can specify in operands are
also given below.
Positional Operands
You can use a positional operand to pass a value into a macro definition through
the corresponding positional parameter declared for the definition. You should
declare a positional parameter in a macro definition when you want to change the
value passed at every call to that macro definition.
You can also use a positional operand to pass a value to the system variable
symbol &SYSLIST. If &SYSLIST, with the applicable subscripts, is specified in a
macro definition, you do not need to declare positional parameters in the prototype
statement of the macro definition. You can thus use &SYSLIST to refer to any
positional operand. This allows you to vary the number of operands you specify
each time you call the same macro definition.
The positional operands of a macro instruction must be specified in the same order
as the positional parameters declared in the called macro definition.
Each positional operand constitutes a character string. This character string is the
value passed through a positional parameter into a macro definition.
The specification for each positional parameter in the prototype statement definition
must be a valid variable symbol. Values are assigned (see ▌1▐ in Figure 77 on
page 301) to the positional operands by the corresponding positional arguments
(see ▌2▐ in Figure 77) specified in the macro instruction that calls the macro
definition.
300 HLASM V1R5 Language Reference