Running vital record processing

Vital records processing identifies the volumes that should be retained and how they should be moved based on the vital record specifications you define. Only the volumes with retention method VRSEL, and the data sets on these volumes that do not have the VRSELEXLCUDE attribute on, are considered for vital record processing. Use the EDGRMMxx parmlib OPTION VRSMIN operand to specify the minimum number of vital record specifications that must be defined in order to run inventory management vital record processing. The default number of vital record specifications is 1. You can also set other parmlib OPTION operands to control how DFSMSrmm performs vital record processing as described in Defining system options: OPTION. You can retain data sets and volumes in several ways. For example, you can retain volumes by generic volume serial number, data sets for as long as they are cataloged, or by the job name that created the data set. For more information about moving and retaining volumes with vital record specifications, see z/OS DFSMSrmm Managing and Using Removable Media.

DFSMSrmm can create a report describing data sets and volumes being retained and the location where the data set or volume resides. See Using the vital records retention report for an example of this report.

You can also request an ACTIVITY file as described in Using the inventory management ACTIVITY file. DFSMSrmm can write details to the ACTIVITY file about changes to data set information made during vital record processing. The ACTIVITY file is optional except when the VERIFY EXEC parameter is used to request that DFSMSrmm performs a trial run of vital record processing.

To help you establish the settings for these EDGRMMxx parmlib options when you run VRSEL processing and have not disabled the limit checking, DFSMSrmm counts and calculates how many volumes are affected and lists this information in the MESSAGE file. You can see how many volumes and what percentage of these volumes are affected. In particular, look at messages:

EDG2242I: This message shows how many volumes are VRS-retained as VRSEL starts.
EDG2243I: This message shows how many volumes are newly assigned as VRSEL starts.
EDG2244I: This message shows the number of volumes to be dropped from VRS retention and the percentage of the initially VRS-retained volumes.
EDG2245I: This message shows the number of newly assigned volumes to be retained for VRS and the percentage of the initially newly assigned volumes.
EDG2246I: This message shows how many data sets are excluded from VRSEL processing
EDG2427I: This message shows how many volumes are expiration date retained at the start of expiration processing.
EDG2428I: This message shows the number of volumes to be dropped from EXPDT retention and the percentage of the initially expiration date retained volumes.

Analyze several runs to determine your normal expectations and then use these expectations to set the thresholds, the limits, and the actions that you require.

1EDG6001I INVENTORY MANAGEMENT STARTING ON 01/11/2010 AT 04:24:44 - PARAMETERS IN USE ARE
          DATEFORM(A),VRSEL,CATSYNCH,DSTORE(LOCATION(*:*)),EXPROC
 EDG6013I THE SYSIN OPTIONS CURRENTLY IN USE ARE
          EXPROC
          EDGSPLCS(YES)
          VOLUMES(A039*)
 EDG2309I THE PARMLIB OPTIONS CURRENTLY IN USE ARE
          VRSEL(NEW)
          VRSJOBNAME(2)
          VRSMIN(1,FAIL)
          VRSCHANGE(INFO)
          VRSDROP(PERCENT(10),INFO) VRSRETAIN(PERCENT(80),INFO) EXPDTDROP(PERCENT(10),INFO)
          SMSTAPE(PURGE(ASIS) UPDATE(EXITS,SCRATCH,COMMAND))
          CATRETPD(12)
          UNCATALOG(S)
          TPRACF(N)
          NOTIFY(Y)
          SYSID(EZU0000)
          CATSYSID(*)
          RETAINBY(VOLUME)
          MOVEBY(VOLUME)
          GDG(CYCLEBY(GENERATION),DUPLICATE(BUMP))
 EDG2308I CHANGES HAVE BEEN MADE TO VRS POLICIES SINCE THE PREVIOUS INVENTORY MANAGEMENT RUN
 EDG2229I NUMBER OF VRS RECORDS READ IS 8
 EDG2238I NUMBER OF UNUSED VRS RECORDS IS 2
 EDG2246I NUMBER OF DATA SET RECORDS EXCLUDED FROM VRSEL =          1  25%
 EDG2242I INITIAL NUMBER OF VRS RETAINED VOLUMES         =          0   0%
 EDG2244I NUMBER OF VRS RETAINED VOLUMES TO BE DROPPED   =          0   0%
 EDG2243I INITIAL NUMBER OF NEWLY ASSIGNED VOLUMES       =         18 100%
 EDG2245I NUMBER OF NEWLY ASSIGNED VOLUMES TO BE RETAINED=          6  33%
 EDG2234I DFSMSrmm CDS CATALOG STATUS UNKNOWN FOR RMMUSER.CATCDSN VOLUME A03971 FILE 1 SYNCHRONIZED TO CATALOG STATUS YES
 EDG2234I DFSMSrmm CDS CATALOG STATUS UNKNOWN FOR RMMUSER.CATCDSY VOLUME A03972 FILE 1 SYNCHRONIZED TO CATALOG STATUS YES
 EDG2307I INVENTORY MANAGEMENT TASK CATSYNCH COMPLETED SUCCESSFULLY
 EDG2444I EXIT PROCESSING DISABLED FOR THIS EXPROC RUN - NO ACTIVE EXIT MODULE FOR EXIT EDG_EXIT200
 EDG2427I INITIAL NUMBER OF EXPDT RETAINED VOLUMES       =         14  44%
 EDG2428I NUMBER OF EXPDT RETAINED VOLUMES TO BE DROPPED =         14 100%
 EDG2420I PHYSICAL VOLUMES READ                          =         21  54%
 EDG2420I LOGICAL  VOLUMES READ                          =         11  28%
 EDG2420I STACKED  VOLUMES READ                          =          7  18%
 EDG2420I RM_VRSEL VOLUMES READ                          =         22  56%
 EDG2420I RM_EXPDT VOLUMES READ                          =         17  44%
 EDG2420I TOTAL    VOLUMES READ                          =         39 100%
 EDG2421I PHYSICAL VOLUMES UPDATED                       =         21 100%
 EDG2421I LOGICAL  VOLUMES UPDATED                       =         11 100%
 EDG2421I RM_VRSEL VOLUMES UPDATED                       =         18  82%
 EDG2421I RM_EXPDT VOLUMES UPDATED                       =         14  82%
 EDG2421I TOTAL    VOLUMES UPDATED                       =         32  82%
 EDG2422I PHYSICAL VOLUMES, THIS RUN, KEPT FOR VRS       =          6  29%
 EDG2422I TOTAL    VOLUMES, THIS RUN, KEPT FOR VRS       =          6  15%
 EDG2423I PHYSICAL VOLUMES, THIS RUN, ASSIGNED TO STORES =          1   5%
 EDG2423I TOTAL    VOLUMES, THIS RUN, ASSIGNED TO STORES =          1   3%
 EDG2435I PHYSICAL VOLUMES SELECTED FOR EXPROC           =         21 100%
 EDG2435I LOGICAL  VOLUMES SELECTED FOR EXPROC           =         11 100%
 EDG2435I RM_VRSEL VOLUMES SELECTED FOR EXPROC           =         18  82%
 EDG2435I RM_EXPDT VOLUMES SELECTED FOR EXPROC           =         14  82%
 EDG2435I TOTAL    VOLUMES SELECTED FOR EXPROC           =         32  82%
 EDG2424I PHYSICAL VOLUMES SET PENDING RELEASE           =         15  71%
 EDG2424I LOGICAL  VOLUMES SET PENDING RELEASE           =         11 100%
 EDG2424I RM_VRSEL VOLUMES SET PENDING RELEASE           =         12  67%
 EDG2424I RM_EXPDT VOLUMES SET PENDING RELEASE           =         14 100%
 EDG2424I TOTAL    VOLUMES SET PENDING RELEASE           =         26  81%
 EDG2425I PHYSICAL VOLUMES RETURNED TO SCRATCH           =          7  33%
 EDG2425I LOGICAL  VOLUMES RETURNED TO SCRATCH           =          5  45%
 EDG2425I RM_EXPDT VOLUMES RETURNED TO SCRATCH           =         12  86%
 EDG2425I TOTAL    VOLUMES RETURNED TO SCRATCH           =         12  38%
 EDG2426I PHYSICAL VOLUMES - SCRATCH RECORDS WRITTEN     =          2  10%
 EDG2426I RM_EXPDT VOLUMES - SCRATCH RECORDS WRITTEN     =          2  14%
 EDG2426I TOTAL    VOLUMES - SCRATCH RECORDS WRITTEN     =          2   6%
 EDG2429I MAIN INVENTORY MANAGEMENT UPDATES HAVE COMPLETED SUCCESSFULLY
 EDG2307I INVENTORY MANAGEMENT TASK VRSEL    COMPLETED SUCCESSFULLY
 EDG2307I INVENTORY MANAGEMENT TASK DSTORE   COMPLETED SUCCESSFULLY
 EDG2307I INVENTORY MANAGEMENT TASK EXPROC   COMPLETED SUCCESSFULLY
 EDG6901I UTILITY EDGHSKP COMPLETED WITH RETURN CODE 0