Utilities › TMSDISP Utility—Perform Batch Auxiliary Disposition Processing › Using Batch Auxiliary Disposition

Using Batch Auxiliary Disposition

The CA 1 batch utility TMSDISP is used to perform Batch Auxiliary Disposition processing. Auxiliary Disposition can also be performed in realtime mode. Note: See the Administration Guide for a discussion of Realtime Auxiliary Disposition processing.

Batch Auxiliary Disposition processing requires the data set being processed to have an entry on the system catalog. The corresponding volume entries on the TMC must not be in scratch or inactive status. The system catalog entry may be uncataloged as part of Auxiliary Disposition processing. The TMSDISP program can be executed as the last step of a job, or as a job by itself. TMSDISP will complete with a return code of 16 if any errors are encountered.

A DD statement must be used to reference either in-stream control statements or a data set containing the control statements. The default ddname supplied by CA 1 is TMSDISP; however, this can be changed if your installation standards require the use of a different ddname. For information on on changing the CA 1 system options see the Programming Guide.

The write-to-operator (WTO) issued by Auxiliary Disposition contains the volume serial number associated with the data set being processed. The default route code of the message(s) is 13 but can be changed through control statement specification. The format of the message is:

IECTMS8 dddd.vvvvvv.ssss (area).message.text

Where:

• IECTMS8 is the message ID.
• dddd is the address of the tape VOLSER.
• vvvvvv is the volume serial number.
• ssss is the volume sequence number.
• (area) is the optional out-of-area code and, when used, is enclosed in parentheses for verification purposes.
• message.text is the text copied from the control statement.