HLASM Language Reference

Sublists in Operands
Figure 80 on page 305 shows that the value specified in a positional or keyword
operand can be a sublist.
A symbolic parameter can refer to the whole sublist (see ▌1▐ in Figure 80), or to an
individual entry of the sublist. To refer to an individual entry, the symbolic
parameter (see ▌2▐ in Figure 80) must have a subscript whose value indicates the
position (see ▌3▐ in Figure 80) of the entry in the sublist. The subscript must have
a value greater than or equal to 1.
| A sublist, including the enclosing parentheses, must not contain more than 1024
characters. It consists of one or more entries separated by commas and enclosed
in parentheses; for example, (A,B,C,D,E). () is a valid sublist with the null
character string as the only entry.
MACRO
SUBLISTS &P1,&P2,&KEY=(F,F,)
. ▲ Refers to default value
. ┌───▌3▐──┘ in keyword operand
. │
&KEY(1) DC &KEY(2)'&KEY(3)'
.
. ┌────────────▌3▐ Refers to value in
&P1(1) DC &P1(2)'&P1(3)' │ positional operand
. ▌2▐ │
. │
DC A&P2 │
. │ │
. └───────────────▌1▐ │
MEND │ │
──────────────────────────────────┼──────┼───────────────────────────────
OPEN START │ │
. ▼ │
. ┌─────┐ │
SUBLISTS (H2,H,2),(A,B,C) │
. ▲ │
. └──────────────┘
.
+F DC F''
.
.
+H2 DC H'2'
.
.
+ DC A(A,B,C)
.
.
END
Figure 80. Sublists in Operands
Figure 81 shows the relationship between subscripted parameters and sublist
entries if:
A sublist entry is omitted (see ▌1▐ in Figure 81).
The subscript refers past the end of the sublist (see ▌2▐ in Figure 81).
The value of the operand is not a sublist (see ▌3▐ in Figure 81).
The parameter is not subscripted (see ▌4▐ in Figure 81).
Chapter 8. How to Write Macro Instructions 305