z/OS TSO/E Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Parameter list for the compiler interface load routine

z/OS TSO/E Customization
SA32-0976-00

In register 1, the calling program (IRXLOAD) will pass the address of aparameter list, which consists of a list of addresses. Each address in the parameter list points to a parameter. IRXLOAD will pass all parameters on the call. The high-order bit of the last address in the parameter list is set to 1. Table 1 lists the parameters for the compiler interface load routine.

Table 1. Parameter list for the compiler interface load routine
Parameter Number of bytes Description
Parameter 1 8 Function requested. On entry, this parameter contains the function requested of the compiler interface load routine The function specification must be in uppercase, left-justified, and padded on the right with blanks. Acceptable values are:
"LOAD   "
Specifies that the compiler interface load routine is to load an exec into storage.
"FREE   "
Specifies that the compiler interface load routine is to free the exec represented by the in-storage control block specified in parameter 8.

For more information on the LOAD and FREE functions, see the descriptions for the LOAD and FREE functions of IRXLOAD in .

Parameter 2 4 EXECBLK address. On entry to the compiler interface load routine, this parameter contains the address of the REXX exec block (EXECBLK) that is used by IRXLOAD. The exec block is a control block that describes the exec to be loaded. For more information on the exec block parameter for IRXLOAD, see .
Parameter 3 4 Record format. On entry, this parameter specifies the format of records in the blocks passed to this routine in parameter 5. Possible values for this parameter are 'F   ' for fixed-length records and 'V   ' for variable-length records. Variable-length records will not span across blocks.
Parameter 4 4 Record length. On entry, this parameter specifies the length of each record for fixed-length records, or the maximum record length for variable-length records. Each variable-length record contains a record descriptor word (RDW). The first two bytes of the RDW indicate the actual length of the record, including the RDW.
Parameter 5 4 Address of a vector of address/length pairs. Each address/length pair contains the address and length of a block of data that contains the statements of the exec. A double word of X'FFFFFFFFFFFFFFFF' delineates the end of the pairs.
Parameter 6 4 Environment block address. On entry, this parameter contains the address of the REXX environment block with which the compiler programming table is associated. This parameter is identical to the address in register 0. For more information on the REXX environment block, see .
Parameter 7 4 compiler runtime processor entry address. Specifies the address of the entry in the compiler programming table for the compiler runtime processor.
Parameter 8 4 In-storage control block address. The in-storage control block contains a series of address/length pairs, which REXX uses to describe the structure of a loaded exec in storage. For more information on the in-storage control block, see .

When IRXLOAD invokes the compiler interface load routine to load a compiled exec, the compiler interface load routine should create an in-storage control block and place the control block address in this parameter. IRXLOAD will consider this parameter to be valid only when the return code from the compiler interface load routine is zero.

When IRXLOAD invokes the compiler interface load routine to free storage for the REXX exec, this parameter contains the address of the in-storage control block that the compiler interface load routine previously created, and is to free.

For complete details on in-storage control blocks, see .

Parameter 9 4 Compiler interface load routine return code. On exit, the compiler interface load routine must set this parameter to a return code that indicates the completion status of the compiler interface load routine. Table 1 lists the return codes issued by the compiler interface load routine.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014