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


Parameter descriptions for INMRZ01

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

When INMRZ01 receives control, register 1 points to the following parameter list.

Offset Length Value
+0 4 Address of an exit-to-exit communication word. RECEIVE exits can use this word to communicate among themselves by passing information in the storage to which the it points. INMRZ01 can obtain the block of storage, and make it available to all exits by storing the address in the exit-to-exit communication word. RECEIVE initially sets the value of the word to zero, and thereafter, does not modify it or the contents of the storage to which it points.
+4 4 Address of the character string that the user entered on the PARM keyword of the RECEIVE command. The address points to an area consisting of a halfword length field followed by the character string. The length field specifies the length of the character string. If no string was specified, the value in the length field is zero.

For more information about how you can use the RECEIVE PARM keyword, see Installation-defined parameters.

+8 4 Address of a byte of action flags, which the exit can set to control RECEIVE processing after it returns.
Bit
Action
1... ....
RECEIVE is to issue message INMR151I, using the text contained in the parameter pointed to at offset +16.
.1.. ....
If the return code from the exit is non-zero (end processing), RECEIVE is not to issue the normal error message. The exit either sends an appropriate message to the user, or requests that RECEIVE issue message INMR151I, using the text contained in the parameter pointed to at offset +16.
..11 ....
Reserved
.... 1...
RECEIVE is to bypass normal authorization checking and continue processing. The exit has validated the user ID at offset +28.
.... .1..
The exit has determined that the user is not authorized to receive files for the user ID requested. RECEIVE processing terminates.
.... ..11
Reserved
+12 4 Address of the TSO/E command processor parameter list (the CPPL). The exit can use the parameter list to examine the initial RECEIVE command, or to build an IOPL for invoking the TSO/E I/O service routines.
+16 4 Address of the message text that RECEIVE is to issue with message ID INMR151I. When the exit is invoked, the address points to an area consisting of a halfword length field, followed by an area in which the exit can insert message text. The length value at entry is zero.

Exits that pass back message text must put the length of text into the length field. (Do not include the halfword of the length field in the length specification.) The maximum length is 243 bytes.

+20 4 Address of a status flag byte. RECEIVE uses this byte to pass indicators to the exit.
1... ....
The input source for RECEIVE is not JES. The bit is on when the user specified either INDATASET, INDSNAME, INDDNAME, or INFILE on the RECEIVE command.
.111 ....
Reserved
.... 1...
The user ID pointed to at offset +28 is the user ID specified on the USERID parameter of the RECEIVE command.
.... .111
Reserved
+24 4 Address of an 8-character user ID field that contains the user ID of the person who issued RECEIVE. The user ID is taken from the PSCBUSER field of the protected step control block (PSCB).
+28 4 Address of an 8-character user ID field. The field contains either the user ID specified on the USERID parameter of RECEIVE, or, if the USERID parameter was not specified, the user ID of the person who issued RECEIVE (the same user ID pointed to at offset +24).

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014