Previous Topic: Two-Day Hold CriteriaNext Topic: Data Set Retention Rules


Scratch and Clean Processing with TMSCLEAN

TMSCLEAN is a multipurpose program that performs different functions depending on parameters specified in the JCL.

TMSCLEAN also processes the TMC for volumes under Days Since Last Used Control (LDATE/ddd in control statements and online interfaces, or LABEL=EXPDT=98ddd in JCL). Tapes that have not been used for ddd number of days, based on the current system date and the last used date, are processed. TMSCLEAN resets the expiration date of the Volume record in the TMC to the current date. TMSCLEAN updates the X'02' bit in FLAG2 to indicate that the volume has been expired by Days Since Last Used control. USER/uuu dates can be processed by TMSCLEAN with the optional user exit TMSXCLN2.

TMSCLEAN also processes the TMC for volumes under Catalog Days Control (CATLG/ddd in control statements and online interfaces, or LABEL=EXPDT=90ddd in JCL). Catalog Days Control retains a data set for the number of days specified. Once the retention days requirement is met, TMSCLEAN resets the expiration date to CATALOG, and then the tape volume is under Catalog Control.

If the OCTLG option has been set to NO and reinitialization of CA 1 options has taken place, the TMSCLEAN processes all files under Catalog Control. The new TMISCAT or DSNBISCA flag bits are checked. If the file is not currently cataloged and either A) it was cataloged (TMCATLOG or DSNBISCA bits) or B) the file was created at least 2 days before, then the expiration date is changed to the current date plus R9.

Criteria for assigning tapes to scratch tape pools and the scratch tape pool names can be defined in the TMOSCRxx and TMONSMxx members of hlq.CTAPOPTN. If you have assigned scratch pools to the TMC, the Scratch and Clean Listing can be segregated by pool name and label type within the pool.

TMSCLEAN counts the tapes that are owned by CA Dynam/T and includes the tapes in the report totals. Tapes controlled by EDMs are included in report totals. CA 1 does not scratch tapes owned by CA Dynam/T or EDMs.