Parameter descriptions for INMRZ13

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

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 ....` Reserved `.... 1...` RECEIVE is not to issue the REPRO command. Either the exit deciphered the data, or no deciphering is required. If the exit deciphered the data, RECEIVE assumes that the exit copied the data from the file identified by the enciphered data ddname to the file identified by the plain text data ddname. Those ddnames are contained in the parameter entries pointed to at offsets +48 and +52, respectively. `.... .1..` Reserved `.... ..1.` All processing on the current file is complete. If the return code from the exit is zero, no more processing is done on the file. RECEIVE can delete the file from the JES spool and process the next file, if one exists. If the return code is non-zero, RECEIVE ignores this bit. `.... ...1` 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 user entered a character string on the PARM keyword in response to the RECEIVE prompt, this parameter 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 length value is zero.
+28	4	Address of a text unit pointer list. The list points to copies of text units that describe the incoming data.
+32	4	Address of another text unit pointer list. The list points to copies of text units that identify the originator of the transmission.
+36	4	Address of a string taken from the :PARM tag in the addressee's nickname entry in the sender's NAMES.TEXT data set.
+40	4	The TRANSMIT initialization exit (INMXZ01R or INMXZ01) can pass a user string to the RECEIVE data set exits, including INMRZ12. If it does, this data field contains the address of that string.
+44	4	Address of an area that contains the options the user specified on the DECIPHER keyword of the REPRO command. RECEIVE uses that information to build a REPRO control statement that looks like: `REPRO INFILE(infile) OUTFILE(outfile) DECIPHER (options specified by user and INMRZ13R)` The exit can modify the DECIPHER options. The modified information is used in decryption processing. If the exit changes the length of the string, it must put the new length value in the length field. The maximum length allowed is 253 bytes. If the length of the data inserted is greater than 253 bytes, RECEIVE uses only the first 253 bytes, and sets the length to 253.
+48	4	Address of an 8-byte field that contains the ddname of the file that contains the encrypted data. The data set that corresponds to the ddname is a temporary data set that RECEIVE allocated. Do not modify this field.
+52	4	Address of an 8-byte field that contains the ddname of the file to which the deciphered data is to be written. The file might or might not be the final output of RECEIVE processing. (For example, if partitioned data sets are being transmitted, the file contains them in their unloaded form.) Do not modify this field.
+56	4	The TRANSMIT data set encryption exit (INMXZ03R or INMXZ03) can pass a user string to this exit. If it is does, this data 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 length value is zero.