HLASM Language Reference

Sublists in Operands
the order in which the positional operands must appear. Interspersed keyword
parameters and operands (see ▌4▐ in Figure 79) do not affect this order.
▌4▐
┌─────────┴─────────┐
MACRO ▼ ▼
▌1▐ MIX &P1,&KEY1=A,&P2,&P3,&P4,&KEY2=,&P5
. ▌3▐
.
.
MEND
─────────────────────────────────────────────────────────────────
START
.
.
. ▌3▐
▌2▐ MIX KEY1=B,ONE,TWO,THREE,KEY2=33,FOUR,FIVE
. ▲ ▲
. └─────────┬──────────┘
. ▌4▐
END
Figure 79. Combining Positional and Keyword Parameters
&SYSLIST( n): The system variable symbol &SYSLIST(n) refers only to the
positional operands in a macro instruction.
Sublists in Operands
You can use a sublist in a positional or keyword operand to specify several values.
A sublist is a character string that consists of one or more entries separated by
commas and enclosed in parentheses.
If the COMPAT(SYSLIST) assembler option is not specified, a variable symbol that
has been assigned a character string that consists of one or more entries
separated by commas and enclosed in parentheses is also treated as a sublist.
However, if the COMPAT(SYSLIST) assembler option is specified, a sublist
assigned to a variable symbol is treated as a character string, not as a sublist.
A variable symbol is not treated as a sublist if the parentheses are not present.
The following example shows two calls to macro MAC1. In the first call, the value of
the operand in variable &VAR1 is treated as a sublist. In the second call, the value
of the operand is treated as a character string, not a sublist, because the variable
&VAR2 does not include parentheses.
&VAR1 SETC '(1,2)'
MAC1 KEY=&VAR1
&VAR2 SETC '1,2'
MAC1 KEY=(&VAR2)
To refer to an entry of a sublist code, use:
The corresponding symbolic parameter with an applicable subscript, or
The system variable symbol &SYSLIST with applicable subscripts, the first of
which refers to the positional operand, and the second to the sublist entry in
the operand. &SYSLIST can refer only to sublists in positional operands.
304 HLASM V1R5 Language Reference