Previous Topic: TMSCTLG Utility—Remove Tapes from Catalog ControlNext Topic: User Exit


Special Considerations

Take care to choose the correct mode for an installation. If OS catalog mode is chosen but not all system catalogs were available to the system on which TMSCTLG ran, or the Listing mode is chosen and not all the catalogs were verified, TMSCTLG will expire the data sets not found using either mode. To correct this situation, TMSCLEAN can be executed with a PARM=RESETCAT to return any nonscratched data sets to Catalog Control. For TMC Volume records, the expiration date is reset to CATALOG, and the TMECATLG bit (X'08') in FLAG2 is turned off. For TMC DSNB records (secondary files), the expiration date is reset to CATALOG, and the DSNBECAT bit (X'20') in DSNB FLAG1 is turned off. This method of recovery must be run before TMSCLEAN expires the data sets.

TMSCTLG expires secondary files (DSNB records) once it is determined that they are no longer cataloged, and that the create date is at least 2 days ago. The Catalog Control expiration date (current date plus the R9 option extension), is moved to DSNBEXDT and the DSNBECAT indicator (X'20') is turned on in DSNB FLAG1. This allows you to view the DSNB records belonging to the volume set and see which files are still cataloged. In either mode, TMSCTLG treats data sets cataloged with a file sequence of zero the same as file sequence one.

TMSCTLG ends with a return code equal to the highest return code from the LOCATE macro indicating that a LOCATE error occurred.This applies to the OS catalog mode only.

A flat file in the CA 1 Retention Record format is created for use with a report writer in a subsequent step. For TMSCTLG OS catalog mode, the return code from the LOCATE macro is provided in the RDUNCIND field of the Retention Record in the format LE=xx.