TLMS044 is an optional report, available when you execute CATTRS to run the tape retention system. It reports how volumes are currently being retained by their controlling data sets, where they are currently located, and what their disposition will be when their current retention criteria are met. (The word "current" refers to the status resulting from the TRS run that produced the report.) Additionally, it provides a list of all manually controlled volumes for auditing purposes.
You must specify whether you want to list all active volumes, or just those data sets whose status has changed. Optional parameters let you limit the report to data sets defined by specific retention types.
TLMS044 lists the controlling data sets for each volume (or set) in sequence by data set name, and within creation date/time, location, retention modifier (see chart below) and retention type.
|
If the retention type is: |
Data sets are listed in order according to: |
|---|---|
|
Keep date control (type 2 or B) or catalog/date control (type 3 or C) |
CA TLMS keep date |
|
Cycle control (type 4) |
Number of cycles |
|
Elapsed days control (type 5) |
Number of days to elapse |
|
Days since last used control (type 8) |
Number of days since last used |
This report may be used to forecast tape retention status by executing CATTRS in forecast mode, providing the FORECAST control statement in TLMSTRS. TLMS044 must be the first control statement in the SYSIN of CATTRS.
This command has the following format:
TLMS044 ,[ALL|CHG] [,n...]
List the entire library of active volumes. If omitted, CHG must be specified.
List only data sets whose status has just changed during this TRS run. If omitted, ALL must be specified.
Specifies the number of one or more retention types, except type 6 and 9. For example, specify 2 for type 2 date control. This will limit the report to data sets that have been defined with that retention type.
Example 1
TLMS044,ALL
Lists all active controlling data sets for all retention types.
Example 2
TLMS044,ALL,2,3,7
Lists all active controlling data sets for retention types 2, 3, and 7.
Example 3
TLMS044,CHG
Lists only those active controlling data sets whose status has changed with the current TRS process (that is, they have moved) for all retention types.
Example 4
TLMS044,CHG,1,3,4
Lists only those active controlling data sets whose status has changed with the current TRS process (that is, they have moved) for retention types 1, 3, and 4.
CA, INC ALL VOLUMES BY CURRENT RETENTION METHOD TYPE = ELAPSED DAYS (5) TLMS044 PAGE 1 CA TLMS NN.n yymmTLrrr mm/dd/yyyy hh.mm.ss FILE VOLUME VOL CURRENT NEXT I----- CREATE -----I I------- LAST -------I I------------- DATASET NAME ---------------I SEQ. SERIAL CNT LOC CCSS LOC DATE TIME MOVED USED -------------------------------------------- ---- ------ --- -- ---- -- ---------- -------- ---------- ---------- ****************************** DAYS = 3 *************************************** PROD1.EOV.DSN 1 TRN013 1 L1 VTS KP mm/dd/yyyy 12.32.51 mm/dd/yyyy mm/dd/yyyy PROD1.EOV.DSN 1 TST003 1 L1 VTX KP mm/dd/yyyy 10.52.24 mm/dd/yyyy mm/dd/yyyy ****************************** DAYS = 30 *************************************** SAVE.KKTDSN 1 TRN006 1 AR A104 KP mm/dd/yyyy 07.29.56 mm/dd/yyyy mm/dd/yyyy
CA, INC ALL VOLUMES BY CURRENT RETENTION METHOD TYPE = MANUAL (7) TLMS044 PAGE 2 CA TLMS NN.n yymmTLrrr mm/dd/yyyy hh.mm.ss FILE VOLUME VOL CURRENT NEXT I----- CREATE -----I I------- LAST -------I I------------- DATASET NAME ---------------I SEQ. SERIAL CNT LOC CCSS LOC DATE TIME MOVED USED -------------------------------------------- ---- ------ --- -- ---- -- ---------- -------- ---------- ---------- CATAPE.HOLDS.EXPORTED.VIRTUAL.TAPES.VTRN010 1 TRN010 1 KP KA00 ** mm/dd/yyyy 08.10.42 mm/dd/yyyy mm/dd/yyyy HSM.BACKUP.DFDSS 1 TDI067 4 AR A103 ** mm/dd/yyyy 07.13.25 mm/dd/yyyy mm/dd/yyyy PROD2.EOV.DSN 1 TST001 2 DC VTX ** mm/dd/yyyy 10.52.24 mm/dd/yyyy mm/dd/yyyy PROD2.EOV.DSN 1 TST002 1 DC VTS ** mm/dd/yyyy 10.52.24 mm/dd/yyyy mm/dd/yyyy
|
Copyright © 2014 CA.
All rights reserved.
|
|