Using the Tape Retention System (TRS) › Adding Data Sets to Locations

Adding Data Sets to Locations

Example 1

The following statement defines retention for a fully qualified data set named ABC.MAINT.FILE when it has been created by a job called JOB060. The tape containing this data set is to be retained at the data center (DC) under days-since-last-used control (type 8). The number of days is five. Then the tape is to be moved to the first off-site storage location (AB) where it is to be retained under cycle control (type 4). The number of cycles is 3. Then it is to be moved to the second off-site storage location (CD) where it is to be retained under elapsed-days control (type 5). The number of days is five. Then it is to be moved to the last off-site location (EF) where it is to be retained under manual control (type 7). It must be manually scratched and returned to the data center for reuse.

//TLMSRMUP  JOB
//TLMSRMUP  EXEC CATRMFE
//SYSIN     DD *
  ADDRTN DSN(ABC.MAINT.FILE)   JOB(JOB060)  OWNER(TAPE LIBRARIAN)    +
   RTN(8DC0005,4AB0003,5CD0005,7EF)

Example 2

These two statements define retention for all partially qualified data sets that start with the characters PDA.MAN.INV. All tapes that contain these data sets are to be retained at the data center (DC) under date control (type 2). Then they are to be scratched. Since no number of days is specified, they will be retained until their keep date. The keep date for these data sets either defaults to the keep date for all data sets or must be specified in the JCL or in the user date table (TLMSDTAB).

ADDRTN DSN(PDA.MAN.INV-)  OWNER(TAPE LIBRARIAN) +
RTN(2DC)

Example 3

This statement defines retention for all data sets with names starting with LOW.COST.ITEMS.@ and followed by the price. This demonstrates the use to the “#” for specifying a mask for numbers. It also shows the use of the “\” as an escape character. In this case the “@” is the literal value and not the pattern masking character.

ADDRTN DSN(LOW.COST.ITEMS.\@#####)  OWNER(TAPE LIBRARIAN) +
RTN(2DC)

The following data sets would match this pattern:

LOW.COST.ITEMS.@00099
LOW.COST.ITEMS.@00001
LOW.COST.ITEMS.@12345

But not the following:

LOW.COST.ITEMS.@99  (# does not allow the absence of a number in this position)
LOW.COST.ITEMS.@0000A  (alpha character)
LOW.COST.ITEMS.@123456    (only 5 numeric characters allowed in pattern)

More information:

Data Set Naming Standards