Parameter list for the compiler interface variable handling routine

In register 1, the calling program passes the address of aparameter list, which consists of a list of addresses. Each address in the parameter list points to a parameter. 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 variable handling routine.

Table 1. Parameter list for the compiler interface variable handling routine
Parameter	Number of bytes	Description
Parameter 1	1	Variable handling function request. On entry to the compiler interface variable handling routine, this parameter contains a one-character field corresponding to the shared variable request code (SHVCODE) used by IRXEXCOM. For more information on shared variable request codes, see . In addition, this routine must support the function 'n', Fetch Next With Mask. TSO/E uses the Fetch Next With Mask function to search through all variables known to the language processor. These variables include stem variables that have been assigned a value. The output from this function is expected to be the next variable that begins with the specified mask.
Parameter 2	4	The address of the variable name to be manipulated. This is an input parameter for the following functions: Function SHVCODE Set Variable 'S','s' Fetch Variable 'F','f' Drop Variable 'D','d' Fetch Private 'P' For the Fetch Next ('N') and Fetch Next With Mask ('n') functions, this parameter must be set on output to the address of the next variable name.
Parameter 3	4	Length of variable name. Specifies the length of the string pointed to by the address in parameter 2.
Parameter 4	4	Address of the value for the variable. This is an input parameter for the Set Variable function ('S','s') and an output parameter for the following functions: Function SHVCODE Fetch Variable 'F','f' Fetch Next With Mask 'n' Fetch Private 'P' Fetch Next 'N' This parameter is not used for the Drop Variable ('D','d') function.
Parameter 5	4	Length of the value for the variable. Specifies the length of the value pointed to by the address in parameter 4.
Parameter 6	4	Work block extension address. On entry, this parameter contains the address of the work block extension. The work block extension contains the WORKEXT_RTPROC field, which can be used by the compiler runtime processor as an anchor for resources that are specific to a particular compiled exec.
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	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 9	1	Shared variable function return code (SHVRET). On output, the compiler interface variable handling routine must set this parameter to the appropriate value for the SHVRET field. The values returned in this parameter for the Fetch Next With Mask function must be identical to those returned for the Fetch Next function. For a list of appropriate values for the SHVRET field, see .
Parameter 10	4	Compiler interface variable handling routine return code. On exit, the compiler interface variable handling routine must set this parameter to a return code that indicates the completion status of the compiler interface variable handling routine. Table 1 lists the return codes for the compiler interface variable handling routine.
Parameter 11	4	Fetch next mask. This parameter is optional, and is used only with the Fetch Next With Mask function ('n'). If this parameter is provided, it specifies an address of a mask to be used to search for the next variable or stem. The mask can be a character string that meets the naming conventions for simple variables or variable stems. The mask cannot identify a compound variable. The compiler interface variable handling routine must return a variable whose name begins with the mask provided. A parameter value of zero indicates that no mask is provided.
Parameter 12	4	Fetch next mask length. This parameter is optional, and may be used only in conjunction with parameter 11. If the parameter is specified, the value represents the length of the mask provided in parameter 11. This parameter should be ignored if the value in parameter 11 is zero.