HLASM Language Reference

Values in Operands
Figure 82. Multilevel Sublists
Selected Elements
from &P
&P
&P(1)
&P(2)
&P(2,1)
&P(2,2)
&P(2,2,1)
&P(2,2,2)
N'&P(2,2)
N'&P(2)
N'&P(3)
N'&P
Selected Elements
from &SYSLIST
&SYSLIST(1)
&SYSLIST(1,1)
&SYSLIST(1,2)
&SYSLIST(1,2,1)
&SYSLIST(1,2,2)
&SYSLIST(1,2,2,1)
&SYSLIST(1,2,2,2)
N'&SYSLIST(1,2,2)
N'&SYSLIST(1,2)
N'&SYSLIST(1,3)
N'&SYSLIST(1)
Value of
Selected Element
(A,(B,(C)),D)
A
(B,(C))
B
(C)
C
null
1
2
1
3
Passing Sublists to Inner Macro Instructions
You can pass a suboperand of an outer macro instruction sublist as a sublist to an
inner macro instruction. However, if you specify the COMPAT(SYSLIST) assembler
option, a sublist assigned to a variable symbol is treated as a character string, not
as a sublist.
Values in Operands
You can use a macro instruction operand to pass a value into the called macro
definition. The two types of value you can pass are:
Explicit values or the actual character strings you specify in the operand
Implicit values, or the attributes inherent in the data represented by the explicit
values
The explicit value specified in a macro instruction operand is a character string that
can contain zero or more variable symbols.
| The character string must not be greater than 1024 characters after substitution of
values for any variable symbols. This includes a character string that constitutes a
sublist.
The character string values in the operands, including sublist entries, are assigned
to the corresponding parameters declared in the prototype statement of the called
macro definition. A sublist entry is assigned to the corresponding subscripted
parameter.
Omitted Operands
When a keyword operand is omitted, the default value specified for the
corresponding keyword parameter is the value assigned to the parameter. When a
positional operand or sublist entry is omitted, the null character string is assigned to
the parameter.
Chapter 8. How to Write Macro Instructions 307