Utilities › TMSBLDUE Utility—Build TMSXITU and TMSXITE Definitions

TMSBLDUE Utility—Build TMSXITU and TMSXITE Definitions

Use the TMSBLDUE utility to assist in building TMMVOLDF statements for use with the CA 1 supplied exits TMSEXITU and TMSEXITE for an old format TMC. An old format TMC is one that is not converted by TMSXTEND. If you run TMSBLDUE against a new format TMC, one that is converted by TMSXTEND, the standard report is not produced. The utility ends with a good return code.

Important! With the introduction of the TMSXTEND utility in R11.0, users may no longer have to implement user exits TMSXITU and TMSXITE to provide support for alphanumeric volume serial numbers. If the TMSXTEND utility is run to create a new Extended Format TMC, volume definition records are added to the TMC and standard routines are employed to convert alphanumeric VOLSERs to the proper internal volume serial number.

TMSBLDUE evaluates the TMC, determines the type, and produces both a report describing how the TMC was formatted and what VOLSERs were found. The utility also generates TMMVOLDF statements to be assembled and link-edited to produce exits TMSXITU and TMSXITE. For both TMSBLDUE and TMMVOLDF to support a TMC, all VOLSERs must conform to certain rules:

1. Length of VOLSER must be four, five, or six characters.
2. 4- and 5-character VOLSERs can have blanks on left or right but not both.
3. Must be either all numeric or of the form AAANNN where AAA is a 1- to 5-character fixed alphanumeric prefix followed by a 1- to 5-character numeric portion. The alphanumeric portion must be made up from 0-9, A-Z or @$#.

TMSBLDUE will build a set of statements which reflect a definition of what is in the TMC. The statements may not be the only or the best definition or they may not correctly interpret unformatted areas that are reserved for future use. Review all output to ascertain the exit definitions and the requirements of your tape library.

The output from this utility (SYSPUNCH DD) should be used to update member TMSVOLDF of CAI.CTAPJCL and apply the TMSVLDF USERMOD. If USERMODs TMSXITE and TMSXITU (for user written exits) are already installed, they must be removed by doing an SMP RESTORE before installing TMSVOLDF.

Note: For information about the TMMVOLDF macro and the user exits, see the Programming Guide.

More information:

TMSXTEND Utility—Dynamic TMC Extend Process Control Program