Parameter descriptions for INMRZ05R

When INMRZ05R receives control, register 1 points to the standard exit parameter list. The parameter list is described in TSO/E standard exit parameter list. Note that the TRANSMIT and RECEIVE exits do not use the new command buffer field in the parameter entry pointed to at offset +4. Following is a description of the exit-dependent data that INMRZ05R receives beginning at offset +36 (decimal).

Figure 1. Exit-dependent data on entry to INMRZ05R

Parameter entries 10 and 12 (RECEIVE PARM string and message text for message ID INMR151I, respectively) are the same for all RECEIVE exits. For a description of those parameter entries, see Parameter descriptions for INMRZ01R. Following are descriptions of the other parameter entries:

Action Flags (Parameter Entry 11)

The data field contains a word of action flags, which the exit can set to control RECEIVE processing after it returns. The flags in byte 0 are defined as follows. Bytes 1, 2, and 3 are reserved.

Bit: Action
1... ....: RECEIVE is to issue message INMR151I, using the text contained in the parameter entry pointed to at offset +44.
.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: already sent an appropriate message to the user; set return code 12, which causes message IKJ79154I to be issued; or requested that RECEIVE issue message INMR151I, using the text contained in the parameter entry pointed to at offset +44.
..11 1111: Reserved

Status Flags (Parameter Entry 13)

The data field contains a word of status flags in which RECEIVE passes indicators to the exit. The flags in byte 0 are defined as follows. Bytes 1, 2 and 3 are reserved.

Bit: Meaning
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

Address of User Notification String (Parameter Entry 14)

If the TRANSMIT initialization exit (INMRZ01R or INMRZ01) passes a notification string in the transmission, this data field contains the address of that string.

If a string was specified:

KEY:: X'00000002'
LEN:: Length of the string

If no string was specified:

KEY:: X'00000000'
LEN:: X'00000004'

For more information about how you can use the notification string, see Installation-defined parameters.

Transmitted Data Set Name (Parameter Entry 15)

The name of the data set that was transmitted. If the data was transmitted as a message, the field contains the string, ‘***MESSAGE*** ’.

Address of Text Unit Pointer List (Parameter Entry 16)

The data field contains the 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.

Address of PARM Tag String (Parameter Entry 17)

The data field might contain the address of a 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.

If a string was specified:

KEY:: X'00000002'
LEN:: Length of the string

If no string was specified:

KEY:: X'00000000'
LEN:: X'00000004'

User ID to Which Acknowledgment is Sent (Parameter Entry 18)

The data field contains the user ID to which the acknowledgment is to be sent. Because the acknowledgment is sent before this exit gets control, RECEIVE ignores any changes the exit makes to this data field.

Node to Which Acknowledgment is Sent (Parameter Entry 19)

The data field contains the node to which the acknowledgment is to be sent. Because the acknowledgment is sent before this exit gets control, RECEIVE ignores any changes the exit makes to this data field.

User ID from Which Acknowledgment is Sent (Parameter Entry 20)

The data field contains the user ID from which the acknowledgment is to be sent. RECEIVE ignores any changes the exit makes to this field.

Node from Which Acknowledgment is Sent (Parameter Entry 21)

The data field contains the node from which the acknowledgment is to be sent. RECEIVE ignores any changes the exit makes to this field.

Time of Original Transmission (Parameter Entry 22)

The data field contains the timestamp of when the original transmission occurred. The time is in standard GMT format. RECEIVE ignores any changes the exit makes to this field.

Number of JES OUTPUT Records (Parameter Entry 23)

The data field contains the number of JES output records transmitted in the acknowledgment. RECEIVE ignores any changes the exit makes to this field.