22.02.2015 Views

HLASM Language Reference

HLASM Language Reference

HLASM Language Reference

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

AINSERT Instruction<br />

character_string<br />

is a character string up to 255 bytes long, enclosed in single quotes. If omitted,<br />

the length of the user data field in the associated data file is set to zero.<br />

Notes:<br />

1. All operands may be omitted to produce a record containing binary zeros in all<br />

fields except the user data field.<br />

2. The record written to the associated data file is described under “User-Supplied<br />

Information Record X'0070',” in Appendix D, “Associated Data File Output” of<br />

the <strong>HLASM</strong> Programmer's Guide.<br />

3. If you do not specify the ADATA assembler option, or the GOFF(ADATA) or the<br />

XOBJECT(ADATA) assembler option (MVS or CMS), the assembler only<br />

checks the syntax of an ADATA instruction, and prints it in the assembler<br />

listing.<br />

4. The assembler writes associated data records to the SYSADATA (MVS or<br />

CMS), or the SYSADAT (VSE) file if the ADATA assembler option has been<br />

specified.<br />

AINSERT Instruction<br />

The AINSERT instruction inserts statements into the input stream. These<br />

statements are queued in an internal buffer until the macro generator has<br />

completed expanding the current outermost macro instruction. At that point the<br />

internal buffer queue provides the next statement or statements. An operand<br />

controls the sequence of the statements within the internal buffer queue.<br />

Note: While inserted statements may be placed at either end of the buffer queue,<br />

the statements are removed only from the front of the buffer queue.<br />

►►──┬─────────────────┬──AINSERT──'statement'──┬─,BACK──┬──────────►◄<br />

└─sequence_symbol─┘<br />

└─,FRONT─┘<br />

sequence_symbol<br />

is a sequence symbol.<br />

statement<br />

is the statement stored in the internal buffer. It may be any characters<br />

enclosed in single quotation marks.<br />

The rules that apply to this character string are:<br />

Variable symbols are allowed.<br />

The string may be up to 80 characters in length. If the string is longer than<br />

80 characters, only the first 80 characters are used. The rest of the string<br />

is ignored.<br />

BACK<br />

The statement is placed at the back of the internal buffer.<br />

108 <strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!