Scanning DASD volumes to find files (3.7 VTOC utility)

File-AID has a convenient DASD utility (3.7 VTOC) for scanning the VTOCs of one or more individual (or ranges of) volumes to find data sets.

Data sets you are looking for may be uncataloged. Special displays let you:

• View a summary of space utilization on your volumes.
• View the extents on a volume in physical sequence.
• Find and list data sets using pattern names including high-level qualifier patterns.

You can also perform many of these functions with File-AID/Batch by submitting JCL to produce reports.

Accessing the VTOC utility (option 3.7)

The VTOC utility is located on File-AID’s Extended Utilities menu (option 3) as utility number 7.

File-AID Extended Utilities Menu. Selecting the VTOC Utility.

From the File-AID Extended Utilities menu (see the previous figure), select option 7 to access the VTOC Utility entry screen.

Specifying VTOC search options

The VTOC Utility entry screen provides several fields and options for specifying your request. In all cases, you must identify the DASD volume(s) to be scanned by using the Volume Selection Information fields.

VTOC Utility - Request Entry Screen

Specifying the OPTION

The OPTION at the top of the screen defines the format of the results display:

I (List Volume Information)

Produces a summary of your volumes showing space used and free. From the list of volumes, you can use the S line command to view the data sets on the volume in name order, or the M line command to view the extents on the volume in pack location sequence.

M (Map VTOC entries in pack location sequence)

Shows physical order of extents on exactly one volume.

(blank) (List VTOC entries in dataset name sequence)

Produces a list of data sets for one volume or a list of all data sets matching the search name pattern on a range of volumes.

Performing VTOC Processing in Batch

File-AID/Batch has several functions corresponding to the OPTIONS of the VTOC utility. Using these functions you can produce hard copy reports of VTOC information. Sample JCL for performing VTOC functions in batch is provided in your sample JCL library (FASAMP.JCL) member name BATVTOC. The functions include:

VTOCINFO (List Volume Information)

Produces a summary of your volumes showing space used and free. Following the summary, each volume is listed in dataset name order.

VTOCMAP (Map VTOC entries in pack location sequence)

Produces a report of one or more volumes by extent in physical order.

VTOCDSN (List VTOC entries in dataset name sequence)

Produces a list of data sets for one volume or a list of all data sets matching the search name pattern on a range of volumes.

Specifying the Volume Selection Information

The Volume Selection Information fields are used to specify the volume(s) to be scanned.

At least one field must contain a value, multiple fields may be used (for example, Volume serial and Unit name).

• Volume Serial

      A list of one or more full or partial volume serial numbers (for example, DISK21,TSO,PROD9). (Asterisk (*) means all volumes currently online.)

• Unit

      A list of one or more valid UNIT names (for example, SYSDA,3390,WORK).

• Volume status

      Valid status codes are PUB, PRV, and STG.

Specifying the Optional Search Name

The Search name field accepts all standard File-AID pattern characters including pattern characters in the high-order node of the data set.

Valid pattern characters are as follows:

? (Question mark)

Single character wildcard (for example, SYS1.DB?LIB)

* (Asterisk)

Multiple character wildcard (for example, SYS1.DB* and SYS1.FA.*.NODEFOUR)

+ (Plus)

Multiple node wildcard (for example, +.NODEFOUR).

Use the "Max number of names" field to limit the search and display of found data sets if your pattern might match a large number of data sets.

Specifying the Catalog to Use

These fields are used only to catalog data sets using a catalog other than the system catalog. It only applies to the C (Catalog) line command.

Using the Display Confirm Delete option

Use the Display confirm delete field to suppress the display of a panel to confirm each delete request. This can be convenient when you are performing DASD maintenance and you do not need a confirmation of your delete requests.

Using the Display Volume Summary option

Use the Display Volume Summary field to control the display of the Volume Summary lines on the screens for options blank (dsn list) and M (map). Valid entries are Y (Yes) and N (No).

Performing the name search

In this example, you scan a volume and list all data sets matching the search pattern +.FASAMP.COMPARE.*. The pattern matches data sets with names:

VTOC Utility - Specifying a Name Search

Steps:

1. Leave the OPTION field blank.
2. Specify the Volume serial as the value you noted earlier in Selecting a Dataset for Processing in Scanning-the-system-catalog-3-4-catalog-utility.
3. Type +.FASAMP.COMPARE.* in the Search dataset name field.
4. Type Y in the Display Volume Summary field.
5. Press Enter. File-AID lists the data sets for the specified volume as shown in the following figure.

Selecting a data set for processing

In order to perform an action on any data set listed, enter a valid line command to the left of the dataset name.

See Catalog Utility. The Dataset List Processing Commands Tutorial Screen in section Scanning the system catalog (3.4 catalog utility) for a list of the valid primary and line commands available for acting on any data set (or extent when viewing pack location sequence) displayed, see the previous figures.

VTOC Utility - list of datasets matching a search name

Ending data set processing

After viewing a list, use the END command to return to the VTOC Utility entry screen. You are done with this example; return to the File-AID Primary Option Menu now.

Use the END command (press PF3) THREE TIMES to display the File-AID Primary Option Menu.