Activating CA 1 and Daily Batch Processing › Reset Expiration Dates in the TMC with TMSEXPDT

Reset Expiration Dates in the TMC with TMSEXPDT

The TMSEXPDT utility is used to assign expiration dates in batch. You can also assign expiration dates in real time as tape files are being created. For more information about assigning expiration dates using the Real-time Expiration feature, see Reset Expiration Dates in the TMC in Real Time.

TMSEXPDT enables you to enforce data set retention standards without modifying the JCL used to create tape data sets. If the JCL does not specify an EXPDT, RETPD, or an ACCODE date specification, CA 1 assigns the default retention which is defined using the RP parameter in the TMOOPTxx member of hlq.CTAPOPTN. When the CA 1 default retention is used, TMSEXPDT has the capability to reset the date if the Retention Data Set (RDS) has an entry for the data set name.

Optionally, you can override EXPDT or RETPD values supplied by the JCL by setting the Retention Override (RO) parameter in TMOOPTxx to YES. The eligible for RDS override bit in FLAG1 is turned on for all tape data sets, allowing you to enforce your data set retention standards. If the Retention Override option is set to NO, the eligible for RDS override bit in FLAG1 is not turned on (when the JCL specifies an EXPDT or RETPD), preventing RDS override action.

The RDS is a sequential file containing 80-byte records describing the SMS Management Class or the data set name, and optional qualified job name and the desired EXPDT or RETPD. A separate retention can be assigned to data sets that are closed by Abend processing by using the ABEND= keyword. The data set name can be fully qualified or can be coded using the CA 1 pattern masking specifications. Parameters are available that enable you to test changes to your RDS and enforce retention for secondary files (TMSEXPDT defaults to override only file 1).

When TMSEXPDT queries the TMC to determine if an RDS override should be applied, it first verifies that the record is eligible for RDS override processing. The X'01' bit in the FLAG1 field must be on for the record to be eligible for RDS override processing. Once the Volume record is processed, the X'01' bit in FLAG1 is turned off. The X'04' bit in the FLAG3 (default expiration date that is used at open) in the TMC indicates whether the default retention field was assigned when the data set was created.

A keyword of SELECT=ALL allows all data sets (even data sets that were previously processed by TMSEXPDT) to be reprocessed. This keyword is specified at the data set level in the RDS. Thus, TMSEXPDT updates all data sets, with this keyword specified, with the new expiration date.

If you are using the Retention Data Set, execute TMSEXPDT before TMSCTLG, TMSCYCLE, and TMSCLEAN in your daily maintenance cycle.

Note: For more information about TMSEXPDT, see the Utilities and Reports Reference Guide.