When you specify the EXPROC execution parameter, an optional SYSIN file EXPROC command allows you to select the subset of available locations and volume entries to be processed during expiration. By default, all volumes in all eligible locations are processed. You do not need to specify a subset of system-managed libraries and volumes simply because some libraries or volumes are not managed on the current system. DFSMSrmm automatically detects the system-managed libraries that are available and skips volumes that cannot be successfully returned to scratch on the current system.

>>-EXPROC--+---------------------+------------------------------>
           |           .-NO--.   |   
           '-EDGSPLCS(-+-YES-+-)-'   

>--+--------------------------------+--------------------------->
   |            .-,-------------.   |   
   |            V               |   |   
   '-LOCATIONS(---location_name-+-)-'   

>--+-----------------------+------------------------------------>
   |          .-,------.   |   
   |          V        |   |   
   '-VOLUMES(---volser-+-)-'   

>--+-----------------------------------------------+-----------><
   |               .-,-------------------------.   |   
   |               V                           |   |   
   '-VOLUMERANGES(---'startvolser':'endvolser'-+-)-'   

EXPROC

Use this command to specify the selection criteria for EXPROC processing. The selection criteria you specify selects volumes for processing by EXPROC that includes these aspects of expiration processing:

• Releasing expired volumes.
• Setting and processing individual release actions.
• Returning volumes to scratch status.

If you specified the EXPROC parameter and SYSIN command EXPROC, but neither the VRSEL nor the DSTORE parameters were specified, global confirmed actions and moves are not processed.

If this run of EDGHSKP includes parameters other than EXPROC:

• DFSMSrmm processes all volumes, but only the selected volumes are subject to EXPROC.
• Global confirmed actions and moves are completed if the DSTORE or VRSEL parameters are specified.

By default, all volumes are processed. Only one EXPROC command can be specified for the parameter EXPROC.

These optional operands can be specified:

EDGSPLCS

EDGSPLCS(YES|NO) specifies whether DFSMSrmm should return system-managed volumes to scratch during EXPROC processing or to write volume scratch statements in the EDGSPLCS file to be used with the EDGSPLCS utility.

When you specify EDGSPLCS(YES), EDGHSKP writes a scratch (S) statement to the EDGSPLCS file for each volume for which DFSMSrmm processing would normally have issued a CUA request to OAM to return the volume to scratch. The statements always include the ‘Q’ verify request option to enable serialization of the return to scratch processing performed by EDGSPLCS. The EDGSPLCS utility can use these scratch statements to perform asynchronous processing, such as concurrent updating of multiple libraries and parallel processing within a library. If the EDGSPLCS DD name is missing, EDGHSKP issues message EDG6101E and ends with return code 12.

When you specify EDGSPLCS(NO), each system-managed volume to be returned to scratch is returned to scratch during EXPROC using a CUA request to OAM.

The default value is NO.

LOCATIONS

LOCATIONS(location_name) specifies a subset of the available volumes based on the volume's current location for processing. The location names specified should be a storage location defined with LOCDEF, an available system-managed library on the current system, or shelf. Volumes to be released can be in any location, but volumes can only be returned to scratch while not in transit, and resident in a system managed library, shelf, or their home location. A location_name is one-to-eight characters and can be a location name mask. Each location_name can be specified in one of these ways:

• Specify a specific location using one-to-eight character names.
• Specify all locations using a single asterisk (*).
• Specify all locations that begin or end with specific characters, such as ATL* or *DR, or multiple locations by using * within a location name.
• Use % (percent sign) in the location name to replace a single character. You can specify up to eight % in a location name mask.

DFSMSrmm does not validate the specified location names against the DFSMSrmm LOCDEF entries or the names of the SMS libraries.

You can specify a list of up to eight values.

VOLUMES

VOLUMES(volser) specifies a list of volumes to be processed. You can specify the volumes as fully qualified or as a volser prefix ending in *. A fully qualified volume is one-to-six alphanumeric, national or special characters, but the first character must not be blank. Quotation marks are required for special characters. Any value ending in *, even if it is enclosed in quotation marks, is considered to be a volser prefix. You can specify a list of up to eight values.

VOLUMERANGES

VOLUMERANGES(startvolser:endvolser) specifies a subset of volumes based on the starting and ending volser to be processed. The volser must be one-to-six alphanumeric, national, or special characters, but the first character must not be blank. Quotation marks are required for each value regardless of the use of special characters. The end of range must not be lower than the start of the range. You can specify a list of up to eight values.