OPEN

The assembler calls the exit with a request type of 1 (OPEN) at the start of the assembly. This is the first call to the exit.

The exit may set the return code in the Exit Parameter List to one of these:

0
Instructs the assembler to open the primary input data set, and supply the primary input records to the exit in later PROCESS calls.
Note:
A reason code of 16 indicates a REINIT call is required.
4
Indicates that the exit supplies the primary input records to the assembler in later READ calls. If you wish to provide the assembler with the values for the system variables &SYSIN_DSN, &SYSIN_MEMBER and &SYSIN_VOLUME, the user exit must set the reason code to 4 and place the values in the data set name, member name, and volume serial fields of the exit-specific information block. The assembler also shows this information in the Diagnostic Cross Reference and Assembler Summary section of the listing, and includes it in the associated data file Job Identification record.
Note:
A reason code of 16 indicates a REINIT call is required.
16
Instructs the assembler to open the primary input data set, and make no further calls to the exit.

If you provide a character string in the str1 suboption of the EXIT assembler option, the buffer pointer points to the character string, and buffer length contains the length of the character string. The buffer length is set to zero if there is no character string.


[ Top of Page | Previous Page | Next Page | Contents | Index ]