Using the Tape Retention System (TRS) › Retention Control Statements › Identifying the Data Sets

Identifying the Data Sets

You must code a retention statement which identifies each data set or data set group.

• To define retention for a specific data set, give the complete name of the data set, in the ADDRTN statement. For example:

  ADDRTN DSN(PDA.MAN.INV.YEAREND.YR2010) OWNER(TAPE LIBRARIAN)
  

  This statement will apply only to a data set with this exact name.

• To define retention for a group of data sets, code all of the common characters followed by a dash to indicate that the definition covers all data sets that start with those characters. For example:

  ADDRTN DSN(PAD.MAN.INV-)      OWNER(TAPE LIBRARIAN)
  

This statement will cover all of these data sets:

PDA.MAN.INV.YEAREND.YR2010
PDA.MAN.INVENTORY

• To define retention for a group of data sets that use the IBM tree structure system of qualification, code the common qualifiers including the dot to indicate that the definition covers data sets that start with all of the characters including the dot:

  ADDRTN DSN(PDA.MAN.INV.-)  OWNER(TAPE LIBRARIAN)
  

  This statement would not cover a data set named PDA.MAN.INVENTORY, but it would cover the following data sets:

  PDA.MAN.INV.YEAREND.YR2010
  PDA.MAN.INV.DMP
  PDA.MAN.INV.BLD
  

  Remember that CA TLMS uses pattern masking for the values specified in the DSN and JOB parameters. See chapter 7 of the Configuration Guide for information about pattern masking. This chapter will explain coding and order of precedence. In general CA TLMS will select the most specific rule and rules where the DSN values are equal and the JOB parameter determines the precedence.

  PDA.MAN.INVE??ORY
  

  should take precedence over:

  PDA.MAN.INV.-
  

  and

  PDA.MAN.INV.-
  

  should take precedence over:

  PDA.MAN.INV-