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


TRANSMIT log data set pre-allocation exit — INMXZ21R

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

Each time a log data set is to be allocated, the TRANSMIT pre-allocation exit, INMXZ21R, receives control. This exit may be invoked multiple times for each TRANSMIT operation. This exit can allocate the log data set, modify the data set name, or take no action. If the exit chooses to allocate the data set, the exit must pass the file name back to the TRANSMIT command. If the exit modifies the data set name, the TRANSMIT command will then allocate the data set for the exit if the exit has not already done so.

Under normal operations, the TRANSMIT command frees the log data sets automatically. Therefore, even if the exit allocated the log data set, the data set is freed when the command processor terminates normally.

During TRANSMIT processing, the allocation of the log data set occurs after the TRANSMIT command has freed the output file. This is after exit INMXZ03(R) would receive control.

If RACF® is installed, and if you are using security labels, exit INMXZ03 receives control after INMXZ21R.

If the exit is to allocate the log data set, consider the following:
  • TRANSMIT allocates the data set as NEW if it does not exist. This frees users from having to allocate the data set themselves.
  • TRANSMIT allocates the data set with a disposition of NEW or MOD. The exit should also allocate the data set with a disposition of NEW or MOD.
  • If the exit allocates the data set as NEW, the data set must have the characteristics of a log data set. The characteristics of a log data set are:
    • Record Format (RECFM) of VB
    • Logical Record Length (LRECL) of 255
    • Blocksize (BLKSIZE) of 3120

Errors during log processing do not normally terminate command processing. Instead, the command sets a return code of 4, indicating that failure occurred but the transmission was successful. If the exit gives a non-zero return code, TRANSMIT does not terminate processing, but sets a return code of 4, indicating that the logging function encountered an error.

Note: If RACF is installed, and if your installation is using security labels, the TRANSMIT command first opens all log data sets before transmitting the data. If any log data set cannot be opened, TRANSMIT processing will terminate.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014