The EDGRVCLN procedure accepts these parameters:

LIST(CURRENT)

Use this parameter to list all vital record specifications that specify LOCATION(CURRENT).

The procedure searches for all vital record specifications and lists each one that includes the LOCATION(CURRENT).

Prior to being designated as a DFSMSrmm reserved location name, the location name CURRENT was free to be used a storage location name. You may have had a LOCDEF for LOCATION(CURRENT) in the past and now removed it. Any VRSs that were added while the LOCDEF was in use, redefined to ensure the correct processing for the now reserved DFSMSrmm location name. Use the LIST(CURRENT ) parameter to identify any vital record specifications that use the location name CURRENT. You can edit the commands produced by running EDGRVCLN to change the location name from CURRENT to a new location name.

LIST(CYCLES)

Use this parameter to list all vital record specifications that specify a retention type of CYCLES. This includes those vital record specifications that include WHILECATALOG where CYCLES is used as the default retention type.

The procedure searches for all data set vital record specifications and lists each one that includes the CYCLE retention type. You can use the output generated by LIST(CYCLES) to identify the vital record specifications and optionally change some vital record specifications. You can use FIX(BYDAYSCYCLE) to convert ALL CYCLE vital record specifications to BYDAYSCYCLE vital record specifications.

LIST(DSNCHAIN)

Use this parameter to list all vital record specification chains.

The procedure searches for all data set vital record specifications. The output includes all data set vital record specifications and all name vital record specifications in the chain. You can use this option to see a consolidated list of all existing VRSs presented as chains so that you can see what policies are implemented. You can also use the commands created by the LIST option as a basis for making changes to your policies. Also refer to the LIST(FILTER) option, which does further analysis of your policies.

EDGRVCLN does not include a parameter to fix the vital record specifications chains. EDGRVCLN provides commands that you can use to add and delete vital record specifications if you want to make any changes to the vital record specification chains.

LIST(ERROR)

Use this parameter to list all name vital record specifications that contain incorrect or incomplete retention information. The procedure assumes that any name vital record specification containing a retention type or count value is in error. This is the default value.

The procedure searches for all name vital record specifications and lists each one that includes any retention type or count value.

LIST(FILTER)

Use this parameter to list all data set VRSs that are candidates for exploitation of the use of COUNT(0).

The procedure searches for all data set name VRSs that do not specify COUNT(0) and accumulates together those that have common delay, retention, and movement requirements, and NEXT/ANDVRS specified in the first VRS in the chain.

FIX(CYCLEBYDAYS)

Use this parameter to change all CYCLES vital record specifications to use the CYCLEBYDAYS retention type.

FIX(ERROR)

Use this parameter to correct all name vital record specifications that contain incorrect or incomplete retention information as found by LIST(ERROR). The corrections are made by deleting and re-adding the vital record specifications that contain errors. Only use this option when you are ready to correct the errors listed by the LIST(ERROR) option.

FIX(FILTER)

Use this parameter to implement the changes recommend by LIST(FILTER).

The procedure creates one or more retention NAME VRSs for each of the common groups of retentions found, and then uses the CHANGEVRS subcommand to set COUNT(0) and the NEXTVRS to chain to the new NAME VRS(es) created. If DELAY was in use, a retention name VRS is created for the DELAY using DAYS since creation and a NEXTVRS to the retention name VRS(es) for the retention and location pulled from the DSNAME VRS.