HLASM Programmer's Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


PROCESS MACRO or PROCESS COPY

HLASM Programmer's Guide
SC26-4941-06

The assembler calls the exit with a request type of 5 (PROCESS MACRO) or 6 (PROCESS COPY) when the assembler is reading members from the library data set, and it has a record for the exit to process. The exit is also called with these request types when both the assembler and the exit are supplying library records (return code 8 from the OPEN call), and the assembler is supplying the record. The address of the record read is in the buffer pointer field, and the length is in the buffer length field. The record length is always 80.

The exit sets the return code in the Exit Parameter List to one of these values:
0
Indicates that the record has been accepted, and the assembler is to process it. The exit can modify the record before it returns control to the assembler. The user exit can also insert extra records in the library member by setting the reason code to 4. The assembler processes the current record and then calls the user exit with an empty buffer. The exit must place the record in the 80-byte area pointed to by the buffer pointer field. The exit can continue to supply additional records by setting the reason code to 4. The exit must keep track of when the assembler calls it with an empty buffer, and ensure that it resets the reason code to zero to resume normal processing.
Note: A reason code of 8 requests redrive of the exit.
4
Instructs the assembler to discard the current record.
Note: A reason code of 8 requests redrive of the exit.
16
Instructs the assembler to make no further calls to the exit. This is disregarded by the assembler if the exit return code from the OPEN was 8.

Although the user exit can insert or discard records, the assembler maintains the absolute record number and relative record number.

If the options field is set to 1, the assembler has provided the exit with the current primary input data set information in the data set name, member name, and volume serial fields of the exit-specific information block. The assembler updates this information when it reads the first record of each data set in a data set concatenation.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014