Using the vital records retention report

Use the Vital Records Retention Report to check the vital record specifications that match to data sets and to see which versions of the data sets are being retained. The report file lists the required location for each data set and volume. Use the EDGRPTD movement report to identify the destination selected for each volume after VRSEL processing is completed and DSTORE and RPTEXT have been run.

Here is a sample of the report produced by vital record processing. You can use the information in the Vital Records Retention Report and the last reference date in the vital record specification extract records to manage your vital record specifications and delete any that are no longer required.

REMOVABLE MEDIA MANAGER                            VITAL RECORDS RETENTION REPORT                                   PAGE        120
    Copyright IBM CORPORATION 1993,2006          ----- ------- --------- ------                       TIME 11:21:02 DATE 03/22/2006


JOB MASK  DATA SET OR VOLUME MASK (CONTINUED)           OWNER    TYPE RETN   C X   DELETE   DLY COUNT STNUM LOCATION RLSE LASTREF
____________________________________________________________________________________________________________________________________
           *.GDG.*.ICRMT.**                             X002     DSN  CYCLES Y N 12/31/1999   0 99999 99999 LOCAL         03/22/2001

JOB NAME  DATA SET NAME  (CONTINUED)	    2ndVRS   2ndNAME  FSEQ DSEQ VOLUME VSEQ OWNER    CURRENT  REQUIRED PRTY  RETDATE   RETNAME
____________________________________________________________________________________________________________________________________
X015IJIC  DT04.GDG.DSNDB06.ICRMT.SYSSTR.G0001V00             12   12 L01699    1 X015     LOCAL    LOCAL     300 WHILECATLG *
NUMBER OF DATA SETS RETAINED (GROUP STORE) =                                                        1     1

X015IJIC  DT04.GDG.DSNDB06.ICRMT.SYSUSER.G0001V00            11   11 L01699    1 X015     LOCAL    LOCAL     300 WHILECATLG *
NUMBER OF DATA SETS RETAINED (GROUP STORE) =                                                        1     1

X015IJIC  DT04.GDG.DSNDB06.ICRMT.SYSVIEWS.G0001V00           13   13 L01699    1 X015     LOCAL    LOCAL     300 WHILECATLG *
NUMBER OF DATA SETS RETAINED (GROUP STORE) =                                                        1     1

JOB MASK  DATA SET OR VOLUME MASK                       OWNER    TYPE RETN   C X   DELETE   DLY COUNT STNUM LOCATION RLSE LASTREF
____________________________________________________________________________________________________________________________________
         *.GDG.*.IMGCPY2.**                             X002     DSN  CYCLES Y N 12/31/1999   0 99999 99999 LOCAL         03/22/2001

JOB NAME  DATA SET NAME                  2ndVRS   2ndNAME  FSEQ DSEQ VOLUME VSEQ OWNER    CURRENT  REQUIRED PRTY  RETDATE   RETNAME
________________________________________________________________________________________________________________________
QDP0900D  DB2Q1.GDG.DSNDB01.IMGCPY2.DBD01.G0889V00            1    1 L00504    1 OPCESA   LIB1     LOCAL     300 WHILECATLG *
QDP0900D  DB2Q1.GDG.DSNDB01.IMGCPY2.DBD01.G0888V00            1    1 L00358    1 OPCESA   LIB1     LOCAL     300 WHILECATLG *
QDP0900D  DB2Q1.GDG.DSNDB01.IMGCPY2.DBD01.G0887V00            1    1 L01761    1 OPCESA   LIB1     LOCAL     300 WHILECATLG *
QDP0900D  DB2Q1.GDG.DSNDB01.IMGCPY2.DBD01.G0886V00            1    1 L01659    1 OPCESA   LIB1     LOCAL     300 WHILECATLG *
NUMBER OF DATA SETS RETAINED (GROUP STORE) =                                                        4     4
REMOVABLE MEDIA MANAGER                            UNUSED VRS CHAINS REPORT                                        PAGE        121
    Copyright IBM CORPORATION 1993,2006            ------ --- ------ ------                          TIME 11:21:02 DATE 03/22/2006


JOB MASK  DATA SET OR VOLUME MASK                       OWNER    TYPE RETN   C X   DELETE   DLY COUNT STNUM LOCATION RLSE LASTREF
____________________________________________________________________________________________________________________________________
          *.BACKUP.**                                   LIB      DSN  CYCLES Y N 12/31/1999   0 99999 99999 LOCAL         01/23/1992
          *.IMGCPY.IMSDB.**                             LIB      NAME DAYS   N Y 12/31/1999   0 99999 99999 HOME          12/12/2004

          VITAL.**                                      LIB      DSN  CYCLES Y N 12/31/1999   0 99999 99999 CURRENT  IX   05/27/2003

The data columns in the vital records retention report provide this information:

JOB MASK

The job name mask defined for the vital record specification.

DATA SET OR VOLUME MASK

The data set name mask or generic volume serial number defined for the vital record specification. In addition to the data set name mask or the volume serial number, this field can contain descriptive text about a vital record specification chain.

OWNER

Owner ID of the vital record specification owner.

TYPE

Type of vital record specification: one of AND, DSN, GDG, NEXT, PGDG, or VOL.

AND designates a NAME vital record specification that is pointed to by a vital record specification with the ANDVRS operand.
DSN for data set vital record specification.
GDG designates a data set vital record specification with the GDG operand specified.
NEXT designates a NAME vital record specification that is pointed to by a vital record specification with the NEXTVRS operand.
PGDG designates a data set vital record specification with a pseudo-generation data set name mask.
VOL for volume vital record specification.

RETN

Type of retention for data set vital record specifications and name vital record specifications:

BYDAYC: Retention type is BYDAYSCYCLE.
CYCLES: Retention type is CYCLES.
DAYS: Retention type is DAYS since creation.
LRDAYS: Retention type is LASTREFERENCEDAYS.
XDAYS: Retention type is EXTRADAYS.

C

Y if the WHILECATALOG option applies. N if the WHILECATALOG option does not apply.

X

Y if the UNTILEXPIRED option applies. N if the UNTILEXPIRED option does not apply.

DELETE

The date DFSMSrmm deletes the vital record specification.

DLY

The number of days that DFSMSrmm delays the latest copy of a data set or volume before sending it to the named location

COUNT

Total number of retention days or cycles for a data set, total number of retention days for a single volume, total number of volumes for generic volume. The number of days, cycles, or volumes is listed for each vital record specification in the chain that contains retention information. The report lists the total number of data sets retained in the current group at the end of each group of retained data sets.

STNUM

Lists the vital record specification store number value. The store number value is the number of days to retain a data set or volume, the number of data set cycles to retain, or the number of volumes to retain. STNUM is blank for AND vital record specifications. The report lists the total number of data sets in the current group that are requested to be retained outside of their home location.

LOCATION

The location in which the data set or volume should be retained. LOCATION is blank for AND vital record specifications.

RLSE

Lists the vital record specification release options in the data set vital record specification. RLSE can be IX SI, IX, or SI. IX is EXPIRYDATEIGNORE and SI is SCRATCHIMMEDIATE.

LASTREF

Lists the last reference date DFSMSrmm maintains for the vital record specification. The last reference date is the value from the vital record specification records at the start of VRSEL processing. DFSMSrmm only updates the last reference date in a vital record specification after both the REPORT file and VRSEL processing has completed.

JOB NAME

The job that created the data set.

DATA SET NAME OR VOLUME MASK

Data set name. For data set names that exceed 30 characters and that match to a primary vital record specification and a secondary vital record specification, DFSMSrmm splits the output line to display all the data set information.

2ndVRS

Lists the management value vital record specification or management class vital record specification when a data set matches to both a primary and secondary vital record specification. If the management class vital record specification or management value vital record specification is currently retaining the data set, DFSMSrmm puts the name of the vital record specification that is retaining the data set in the 2nd NAME field.

2ndNAME

Lists the name of the first vital record specification in the secondary vital record specification chain that retains the data set. This field is always filled when a data set is retained by a secondary vital record specification. When vital record specifications are chained using AND, DFSMSrmm puts the name of the first vital record specification in this field. This field is blank when a data set is retained by a primary vital record specification.

FSEQ

Physical file sequence number.

DSEQ

Data set sequence number on the named volume.

VOLUME

Volume serial number.

VSEQ

Volume sequence number.

OWNER

Owner ID of the volume and data set owner.

CURRENT

Current location of the volume.

REQUIRED

Destination of the volume based on the matching vital record specification. When there are multiple data sets on a volume, DFSMSrmm displays the destination for the volume using the priority of each of the required locations identified for the volume. The volume's destination is calculated based on the location priorities described in Table 1. If there are multiple data sets on a volume or the volume is retained using multiple vital record specifications, the required location listed in the report might be different from the destination to which DFSMSrmm attempts to move the volume.

When the RETDATE is CATRETPD, this field contains the volume's current location.

PRTY

Defined or defaulted relative priority of the location.

RETDATE

Lists information for individual data sets and volumes. This field contains the retention date calculated by vital record processing. The meaning of the retention date depends on the retention type of the vital record specification. See z/OS DFSMSrmm Managing and Using Removable Media for information about how DFSMSrmm calculates the retention date.

BYDAYSCYCLE: For the BYDAYSCYCLE retention type, RETDATE is displayed as a special date format CYCL/ccccc. ccccc is the COUNT value for cycles used in the vital record specification.
CYCLES: For the CYCLES retention type, RETDATE is displayed as a special cycles date format, CYCL/ccccc, where ccccc is the COUNT value for cycles used in the vital record specification.
DAYS: For the DAYS retention type, RETDATE is displayed as the date calculated by vital record selection processing. This is the COUNT value added to the data set creation date or the volume assigned date.
EXTRADAYS: For the EXTRADAYS retention type, RETDATE is a date calculated by inventory management vital record processing. The RETDATE is the COUNT value in the vital record specification chain added to the date when the subchain started to retain the data set.
LASTREFERENCEDAYS: For the LASTREFERENCEDAYS retention type, RETDATE is displayed as the date calculated by the vital record selection processing. This is the COUNT value added to the date the data set or volume was last referenced.
UNTILEXPIRED: For the UNTILEXPIRED retention type, DFSMSrmm calculates the RETDATE based on the presence of a secondary vital record specification. When a secondary vital record specification retains a data set, the UNTILEXPIRED retention is based on the retention type in the secondary vital record specification. The retention type can be any of the date formats specified for CYCLES, DAYS, LASTRERENCEDAYS, WHILECATALOG, BYDAYSCYCLE, and EXTRADAYS. If the secondary vital record specification contains WHILECATALOG, the retention date is WHILECATLG as long as the data set is cataloged.
WHILECATALOG: Retention date for WHILECATALOG can be the special catalog date format, WHILECATLG or CATRETPD. When the RETDATE is WHILECATLG, the data set is retained by a vital record specification with the WHILECATALOG retention type and the data set is cataloged. CATRETPD is used when the data set is not cataloged and is created within the period defined by the parmlib OPTION CATRETPD operand. DFSMSrmm retains the data set for the catalog retention period if the data set has never been cataloged. DFSMSrmm does not retain the data set if DFSMSrmm detected that the data set was cataloged and then uncataloged during the catalog retention period. DFSMSrmm sets the REQUIRED field to the volume's current location and does not include the data set in the cycle count.

RETNAME

RETNAME displays the name of the current vital record specification in the primary vital record specification chain that retains the data set as follows:

The first vital record specification in the subchain for ANDVRS groups
An * if the retaining vital record specification is a data set name vital record specification in a primary vital record specification
A blank for when a secondary vital record specification retains a data set

NUMBER OF DATA SETS RETAINED (GROUP STORE)

Lists two numbers. The first is the number of data sets or volumes retained by the vital record specification. The second is the number of data sets or volumes retained in a storage location.