The TMSEXPDT utility is used to assign expiration dates in batch. You may also assign expiration dates in realtime as tape files are being created. For information on assigning expiration dates using the Realtime Expiration feature, see Reset Expiration Dates in the TMC in Realtime.
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), thereby 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 closed by Abend processing by using the ABEND= keyword. The data set name may be fully qualified or may be coded using the CA 1 pattern masking specifications. Parameters are available that allows you to test changes to your RDS and to 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 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 those 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 the new expiration date that have this keyword specified.
If you are using the Retention Data Set, TMSEXPDT must be executed prior to TMSCTLG, TMSCYCLE, and TMSCLEAN in your daily maintenance cycle.
Note: For more information on TMSEXPDT, see the Utilities and Reports Reference Guide.
| Copyright © 2011 CA. All rights reserved. | Email CA Technologies about this topic |