HLASM Language Reference

AEJECT Instruction
AEJECT Instruction
Use the AEJECT instruction to stop the printing of the assembler listing of your
macro definition on the current page, and continue the printing on the next page.
►►──┬─────────────────┬──AEJECT────────────────────────────────────►◄
└─sequence_symbol─┘
sequence_symbol
is a sequence symbol.
The AEJECT instruction causes the next line of the assembly listing of your macro
definition to be printed at the top of a new page. If the line before the AEJECT
statement appears at the bottom of a page, the AEJECT statement has no effect.
An AEJECT instruction immediately following another AEJECT instruction causes a
blank page in the listing of the macro definition.
Notes:
1. The AEJECT instruction can only be used inside a macro definition.
2. The AEJECT instruction itself is not printed in the listing.
3. The AEJECT instruction does not affect the listing of statements generated
when the macro is called.
AINSERT Instruction
The AINSERT instruction, inside macro definitions, harnesses the power of macros
to generate source statements, for instance, using variable substitution. Generated
statements are queued in a special buffer and read after the macro generator
finishes.
The specifications for the AINSERT instruction, which can also be used in open
code, are described in “AINSERT Instruction” on page 108.
AREAD Instruction
The AREAD instruction assigns an arbitrary character string value to a SETC
symbol.
The AREAD instruction has two formats. The first format lets you assign to a
SETC symbol the character string value of a statement that is placed immediately
after a macro instruction.
The AREAD instruction can only be used inside macro definitions.
Assign Character String Value
►►──SETC_symbol──AREAD──┬─────────┬────────────────────────────────►◄
├─NOPRINT─┤
└─NOSTMT──┘
The second format of the AREAD instruction assigns to a SETC symbol a character
string containing the local time.
Chapter 7. How to Specify Macro Definitions 257