VTOC Utility screen

The VTOC Utility screen has five areas. The top area lists the utility options. The area below the options displays volume selection parameters for the VTOC list. The Generic Search Function area is used to specify naming criteria that File-AID uses when generating the list. The next area is titled: Catalog to use if other than default system catalog. Use this to specify alternate catalogs. The Display controls area includes two controls:

1. Display confirm delete which controls the display of a confirmation screen when deleting list items
2. Display Volume Summary which specifies whether the Volume Summary portion of the screen should be displayed on the following screens.

VTOC Utility screen

Field Descriptions

OPTION

To select a VTOC option, enter one of the following option codes:

I

Lists volume information. Corresponds to the File-AID/Batch VTOCINFO function.

M

Maps VTOC entries in pack location sequence. This option displays the physical structure of a volume and corresponds to the File-AID/Batch VTOCMAP function.

BLANK

Lists VTOC entries in dataset name sequence. This option displays a list of dataset names and corresponds to the File-AID/Batch VTOCDSN function.

Each option requires you to specify the volume or unit to be processed.

Volume Selection Information:

Specify a Volume serial or a Unit name. The three volume-selection parameters can be used singly or in combination to specify a specific volume or a range of volumes. Multi-volume processing is specified with combinations of values in the Volume serial, Unit name, or Volume status fields.

The volume selection information parameters you specify are all used in selecting Volume Serial Numbers to be processed. An example would be to enter the "I" OPTION with a Volume Serial Mask of TSO, a unit name of 3390 and a volume status of STG. The result would be a volume information list of all 3390 Storage Volumes having volume serial numbers beginning with TSO... If no OPTION (blank) is specified, you must specify a Search Dataset Name when processing multiple volumes. Also, the "M" (Map) OPTION is not allowed when processing multiple volumes.

Volume serial

Specify a volume ID or pattern volume ID to restrict the search to one or more volumes.

The value in this field can have either a unique six-character name or a mask value. You can enter up to six volume serial numbers; separate each by a blank or a comma. A mask of less than six characters that ends in either an asterisk ( * ) or a blank is also valid. Up to 42 characters of masks can be entered in the Volume serial field.

Unit name

Specify a generic volume to restrict the search to one or more unit types.

Up to ten values can be specified in this field; separate each value by either a blank or a comma. Mask values are not allowed.

The File-AID VTOC utility processes unit names as defined in the Eligible Device Table (EDT). File-AID does not find unit names that are not defined in the EDT.

Volume status

Specify one of the following values to restrict the search to volumes having the specified attributes:

PUB - Public

PRV - Private

STG - Storage

BLANK - Allow any one of the three values.

Generic Search Function:

The generic search function limits processing to dataset names that match the specified mask value. The value specified in the Search name field controls the criteria used to select data sets from the VTOCs. File-AID displays only data sets that match the search name value.

Search dataset name

Specify the Search dataset name with explicit characters or a pattern data set mask (fully qualified, no quotes) to define the dataset names to include in the list. A pattern data set mask or name consists of explicit characters or a combination of explicit and pattern characters. The rules used for specifying a Search dataset name are similar to those used in ISPF/PDF’s Dataset List Utility. See Pattern data set names.

Max number of names

Specify the maximum number of data sets to select when searching multiple volumes. Values from 1 to 65532 are valid in this field. Your actual maximum is limited by your logon region size.

Catalog to use if other than Default System Catalog:

Catalog name

Specify the name of the catalog that contains entries for the volume being processed. This name must be specified in order to perform additional functions, such as Show, Delete, Rename, etc., on data sets that cannot be found by a catalog search beginning at the master catalog.

Catalog password

Specify the catalog password if the catalog is password protected. If the data sets will be processed through a catalog that can be found with a search beginning at the master catalog and that catalog is password protected, you may specify the password and leave the Catalog name field blank. If the password is omitted, you are prompted for it as required.

Display Controls:

Display confirm delete

Specify whether the Confirm Delete screen is displayed when deleting data sets. Valid entries are Y (Yes) and N (No).

The value specified in the Display confirm delete field is used in conjunction with the D (delete) line command.

When this field is set to Y (Yes), File-AID displays either the Confirm Dataset Delete screen or the VSAM Confirm Dataset Delete screen (VSAM Confirm Dataset Delete Screen), depending on the type of data set being deleted.

Display Volume Summary

Specify whether the Volume Summary should be displayed on the screens for options blank (dsn list) and M (map). Valid entries are Y (Yes) and N (No).

Commands

File-AID permits the use of line commands on a list of dataset names displayed by the VTOC utility. The following table lists the available line commands.

VTOC Utility Line Commands

The FIND, LOCATE, and P (Print) primary commands can be used on VTOC utility lists.

Printing VTOC Lists

VTOC lists are printed by using the P command. The P (Print) command calls the File-AID print facility to write the list to SYSOUT. SYSOUT is then released for printing. The print facility either uses the values set in the print parameter default options discussed in Print Parameters, or displays a print values prompt screen that can be modified (Print Parameters Screen).