Parameter descriptions for INMXZ03R

When INMXZ03R receives control, register 1 points to the standard exit parameter list. For more information about the parameter list, see 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 INMXZ03R receives beginning at offset +36 (decimal).

Figure 1. Exit-dependent data on entry to INMXZ03R

Note that many of the parameter entries are the same as those that INMXZ01R receives. Their descriptions are not repeated here. See Parameter descriptions for INMXZ01R for more information about them. Following are descriptions of only those parameter entries that are different.

Action Flags (Parameter Entry 11)

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

Bit

Action

1... ....

TRANSMIT is to issue message INMX151I, 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), TRANSMIT 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 TRANSMIT issue message INMX151I, using the text contained in the parameter entry pointed to at offset +44.

..11 ....

Reserved

.... 1...

TRANSMIT is not to issue the REPRO command. Either the exit did the encryption, or none is required.

If terminal input is to be encrypted, it is sent as a data set with the name ‘prefix.DDNAME.TERMIN’. If the exit sets this bit to one and encrypts the input, the data set name remains ‘prefix.DDNAME.TERMIN’.

Setting this bit to one does not prevent TRANSMIT from prompting the user for encryption options. TRANSMIT prompts for those options before invoking this exit.

.... .1..

The encrypted data is now in the sequential file identified by the ddname in the parameter entry pointed to at offset +72.

If the exit sets this bit to one, it also needs to set bit X'08' to one. If this bit is one and bit X'08' is zero, TRANSMIT invokes the REPRO services, and specifies the file pointed to at offset +68 as the input file and the file pointed to at offset +72 as the output file. The file pointed to at offset +72 is overwritten. If both bits are one, TRANSMIT builds an INMR02 control record for the encryption process which results in exit INMRZ13 or INMRZ13R gaining control during RECEIVE to decrypt the data set.

.... ..11

Reserved

Address of the Addressee Chain (Parameter Entry 16)

This parameter entry is the same as the parameter entry 16 that INMXZ01R receives. Like INMXZ01R, this exit can alter subsequent processing by changing the information in the chain.

Address of REPRO Options (Parameter Entry 17)

The data field points to an area that contains the options the user specified on the ENCIPHER keyword of the REPRO command. TRANSMIT uses that information to build a REPRO control statement that looks like the following.

REPRO INFILE(infile) OUTFILE(outfile) ENCIPHER(options
specified by user and INMRZ03R)

The exit can modify the ENCIPHER options. The modified information is used in encryption processing.

If the exit changes the length of the options string, it must also change the value in the length field accordingly. The maximum length allowed is 253 bytes. If length of the data inserted is greater than 253 bytes, TRANSMIT uses only the first 253 bytes, and sets the length to 253.

Ddname of Plain Text File (Parameter Entry 18)

The data field contains the ddname of the file that contains the data to be encrypted.

Ddname of File for Encrypted Data (Parameter Entry 19)

The data field contains the ddname of the file to which the encrypted data is to be written.

Address of a String for INMRZ13R (Parameter Entry 20)

This exit can pass a user string to the RECEIVE data set decryption exit (INMRZ13R or INMRZ13). If the exit passes a string, it must also put the following values in the key and length fields:

KEY:: X'00000002'
LEN:: Length of the string. The maximum length is 253 bytes.