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


Parameter descriptions for INMRZ04

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

When INMRZ04 receives control, register 1 points to the following parameter list. Note that many of the parameters are the same as those that INMRZ01 receives. Explanations of those parameters are not repeated here. For more information about them, see Parameter descriptions for INMRZ01.

Offset Length Value
+0 4 Address of an exit-to-exit communication word.
+4 4 Address of the character string that the user entered on the PARM keyword of the RECEIVE command.
+8 4 Address of a byte of action flags, which the exit can set to control RECEIVE processing after the exit 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 1111
Reserved
+12 4 Address of the TSO/E command processor parameter list (the CPPL).
+16 4 Address of the message text that RECEIVE is to issue with message ID INMR151I.
+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 1111
Reserved
+24 4 If the TRANSMIT initialization exit (INMRZ01R or INMRZ01) passes a notification string, this field contains the address of that string. The address points to an area that consists of a halfword length field followed by the character string. The length value is the length of the character string only. If no string is specified, the value in the length field is zero.
+28 4 Address of a 44-character field that contains the name of the data set that was transmitted. If the data was transmitted as a message, the field contains the string, ‘***MESSAGE***’.
+32 4 Address of a text unit pointer list. The list points to copies of text units that are sent with the transmission. They identify the originator of the transmission, and can include:
INMFACK   INMFNODE  INMFTIME  INMFUID
INMFVERS  INMLRECL  INMNUMF   INMUSERP

For more information about those text units or text unit pointer lists, see Text units and text unit pointer lists. Note that altering the text units has no effect on subsequent processing. The exit receives copies of the actual text units for information only.

+36 4 Address of the string taken from the :PARM tag in the addressee's nickname entry in the sender's NAMES.TEXT data set. The string is present if the TRANSMIT command specified a nickname directly or via a distribution list, and the entry for that nickname in the sender's NAMES.TEXT data set contains the :PARM tag.

The address points to an area that consists of a halfword length field followed by the character string. The length value is the length of the character string only. If no string is specified, the value in the length field is zero.

+40 4 Address of an area that contains the RECEIVE completion code -- either an error code, or a string (‘DELETED’) the receiver deleted the file.

The area consists of a halfword length field followed by the completion code. The length value is the length of the code only, and does not include the halfword length field. If the RECEIVE command was successful, the value in the length field is zero.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014