SYSIN file for VERIFY and MEND processing

An optional SYSIN file allows you to select the subset from the available locations, and volume entries during verification of volumes. Verification of volumes includes VERIFY/MEND(SMSTAPE/VOLCAT), VERIFY or MEND, VERIFY/MEND(ALL), and VERIFY/MEND(VOL) processing. By default, all volumes are verified.

The SYSIN commands in Figure 1 can be used to select the subset of volumes.

Figure 1. EDGUTIL SYSIN file


>>-+-INCLUDE-+--| include/exclude_parameters |-----------------><
   '-EXCLUDE-'                                   

include/exclude_parameters

   .-+---+---------------------------------------------.   
   | '-,-'                                             |   
   V                                                   |   
|----+-----------------------------------------------+-+--------|
     |            .-+---+-------------.              |     
     |            | '-,-'             |              |     
     |            V                   |              |     
     +-LOCATIONS(-----location_name---+-)------------+     
     |          .-+---+------.                       |     
     |          | '-,-'      |                       |     
     |          V            |                       |     
     +-VOLUMES(-----volser---+-)---------------------+     
     |               .-+---+---------------------.   |     
     |               | '-,-'                     |   |     
     |               V                           |   |     
     '-VOLUMERANGES(---'startvolser':'endvolser'-+-)-'

EXCLUDE

Specifies the exclusion criteria for EDGUTIL processing. You can specify this command one time only. You can specify INCLUDE and EXCLUDE commands in any order.

You can specify one or more of these optional operands:

LOCATIONS(location_name)

Specifies volumes to be excluded based on the volume's current location. For 3-way audit and VOLCAT processing, specify the system-managed library location names. For VOL processing, any system-managed library, storage location name known to DFSMSrmm, or SHELF can be specified. 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.

When validation of a location name fails, the EDGUTIL utility stops processing and ends with the return code of 12.

Any location_names specified are used to exclude volumes based on the TCDB volume record library name and the DFSMSrmm volume record current location. You can specify a list of values.

VOLUMES(volser)

Specifies a list of volumes to be excluded. 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 values.

VOLUMERANGES('startvolser':'endvolser')

Specifies a subset of volumes based on the starting and ending volsers to be excluded. The volsers must be one-to-six alphanumeric, national, or special characters, but the first character must not be blank. Single 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 values.

The default is that no volumes are excluded.

INCLUDE

Specifies the inclusion criteria for EDGUTIL processing. You can specify this command one time only. You can specify INCLUDE and EXCLUDE commands in any order.

You can specify one or more of these optional operands:

LOCATIONS(location_name)

Specifies a subset of the available volumes based on the volume's current location for processing. For 3-way audit and VOLCAT processing, specify the system-managed library location names. For VOL processing, any system-managed library, storage location name known to DFSMSrmm, or SHELF can be specified. 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.

When validation of a location name fails, the EDGUTIL utility stops processing and ends with the return code of 12.

Any location_names specified are used to select volumes based on the TCDB volume record library name and the DFSMSrmm volume record current location. You can specify a list of values.

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 values.

VOLUMERANGES(startvolser:endvolser)

Specifies a subset of volumes based on the starting and ending volsers to be processed. The volsers 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 values.

Here are some examples of using the SYSIN command to select a subset of volumes:

//SYSIN DD *
INCLUDE VOLUMES(ABC001,ABC002) LOCATIONS(ATL1)
/*

//SYSIN DD *
INCLUDE VOLUMERANGES('XYZ001':'XYZ099') VOLUMES(001*)
/*

//SYSIN DD *
INCLUDE VOLUMES(Z*,B*,VOL001)
EXCLUDE VOLUMES(B5*)
/*

The default is that all volumes defined in the TCDB (when 3-way audit or VOLCAT processing is requested) and all volumes defined to DFSMSrmm are processed.

The EDGUTIL utility processes the SYSIN file to determine if a subset of volumes is to be processed. EDGUTIL processing is independent of the order of the commands. As each volume is about to be processed, it is checked first against the INCLUDE selection and then against the EXCLUDE selection. The volume selection process applies to all volume processing in EDGUTIL. For 3-way audit processing, the library names known to the volume catalogs and DFSMSrmm control data set volume records determine the system-managed libraries volume details to be retrieved, unless the LOCATIONS operand has restricted the subset to specific libraries. The library manager volume details are retrieved directly from the candidate system-managed libraries as needed.