When INMRZ06R 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 INMRZ06R receives beginning at offset +36 (decimal).
Figure 1. Exit-dependent
data on entry to INMRZ06R
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 ....
- Reserved
- .... 1...
- RECEIVE is to suppress acknowledgment processing. No acknowledgment
is to be sent to the requesting user, and exit INMRZ05R should not
be invoked. The exit has performed acknowledgment processing itself
or determined that an acknowledgment was not necessary.
- .... .1..
- RECEIVE is to use the receiver's SECLABEL for the acknowledgment
message when this bit is on; otherwise, the sender's SECLABEL will
be used for the acknowledgment message.
- .... ..11
- 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. This parameter may be modified by the exit. Any modification
made to this parameter affects the current acknowledgment only. Changes
are passed along in the acknowledgment transmission, and are also
passed to exit INMRZ05R.
- Node to Which Acknowledgment is Sent (Parameter Entry 19)
- The data field contains the node to which the acknowledgment is
to be sent. This parameter may be modified by the exit. Any modification
made to this parameter affects the current acknowledgment only. Changes
are passed along in the acknowledgment transmission, and are also
passed to exit INMRZ05R.
- 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. This parameter may be modified by the exit. Any modification
made to this parameter affects the current acknowledgment only. Changes
are passed along in the acknowledgment transmission, and are also
passed to exit INMRZ05R.
- Node from Which Acknowledgment is Sent (Parameter Entry 21)
- The data field contains the node from which the acknowledgment
is to be sent. This parameter may be modified by the exit. Any modification
made to this parameter affects the current acknowledgment only. Changes
are passed along in the acknowledgment transmission, and are also
passed to exit INMRZ05R.
- 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. The exit can update the data field to reflect
the number of records transmitted if the exit performed acknowledgment
processing.
- Address of the Sender's Security Token (Parameter Entry 24)
- The data field contains the address of the sender's encrypted
security token. The exit can decrypt the security token using the RACF® TOKENMAP macro. For complete
information about using the TOKENMAP macro, see .