Utilities › TMSIDATA Utility—Build a TMC from VSAM or Operating System Catalog Listing › Exit Processing

Exit Processing

During TMSIDATA processing, the following exits are invoked:

• TMSXITU
• TMSXITE
• EXITPGM

Two exit routines, TMSXITU and TMSXITE, are provided in CA 1 to accommodate volume serial numbers that are not six-digit numerics. As each volume record is processed, TMSXITU is invoked to perform the required alphanumeric to numeric translation. The six-digit numeric volume serial number is used internally by CA 1 to access the volume record in the TMC. The nonnumeric volume serial number is still used externally to reference the volume.

• If the volume serial number is not numeric after TMSXITU processing, an error message is printed and the record is bypassed.
• If the volume serial number is numeric after TMSXITU processing, the TMSXITE exit is invoked to translate the numeric back to the external volume serial number. TMSIDATA compares this number to the input volume serial number from the catalog listing. This comparison check ensures that your TMSXITU and TMSXITE exits are functioning correctly. If the numbers are different, an error message is printed and the record is bypassed.

Resolve any error messages that are generated during TMSXITU or TMSXITE processing before you continue building the TMC.

Important! TMSXITU, TMSXITE, and the optional output Volume record exit must reside in STEPLIB or must be in a link listed data set.

The optional EXITPGM= user exit can be coded to modify the converted TMC data, to fill additional TMC fields or to bypass volumes from the conversion. If specified, this exit is called before each data record is written to the VOLUME or DSNB output data set.

Note: For more information about the exits, see the Programming Guide.