Activating CA 1 and Daily Batch Processing › Remove Tapes from Cycle Control with TMSCYCLE

Remove Tapes from Cycle Control with TMSCYCLE

TMSCYCLE selects all TMC records with an EXPDT subject to Cycle Control (CYCLE/ccc in control statements and online interfaces, or LABEL=EXPDT=99ccc in JCL), to determine if any volumes associated with the data set should be removed from Cycle Control. TMSCYCLE retention is determined by the first file in a volume set only.

To remove volumes from Cycle Control, TMSCYCLE updates the expiration date in the TMC to the current date plus a number of days into the future. This additional number of days is defined in the TMOOPTxx member of hlq.CTAPOPTN (the RC parameter specifies this cycle extension). TMSCYCLE does not consider the generation/version number for GDG data sets. Therefore, GDGs under Cycle Control may expire prior to meeting the GDG limit. TMSCYCLE updates the X'04' bit in FLAG2 to indicate the volume has been expired from Cycle Control. Once expired, the volumes are eligible for scratch processing with the next execution of TMSCLEAN.

Two other parameters in the TMOOPTxx member define the characteristics of a cycle to TMSCYCLE:

• The CDAY parameter can be set to TAPE or DAY. When set to TAPE, each individual creation of a data set under Cycle Control is considered a single cycle. When set to DAY, all creations of a data set with the same creation date are collectively considered a single cycle.
• The CJOB parameter can be set to JOB or DSN. When set to JOB, multiple job names creating the same data set have separate cycles. When set to DSN, the creating job name is not considered by TMSCYCLE.

TMSCYCLE should be executed before TMSCLEAN to determine the scratch eligibility of tapes under Cycle Control.

Note: For information on TMSCYCLE, see the Utilities and Reports Reference Guide.