List VTOC entries in dataset name sequence (BLANK)

To display a list of dataset names from single or multiple disk packs, use option BLANK: List VTOC entries in dataset name sequence.

Leave the OPTION field blank, and specify a volume or multiple volumes in the Volume serial, Unit name, and/or Volume status fields on the VTOC Utility screen. Optionally, specify a Search Dataset name. When you press Enter, File-AID displays the Utility VTOC List screen as shown in the following figure. The pack information at the top of the screen does not scroll away, and line commands are allowed.

To process a generic search and display all matching data sets in dataset name order, specify a search name on the VTOC Utility screen. When a search name is specified, only the data sets matching the mask are listed on the Utility VTOC List screen. The VTOC list can be generated from a single or multiple disk packs.

Utility VTOC List Screen - Dataset Name Sequence

The top line of the Utility VTOC List screen displays the disk pack name and type (in parentheses), and the number of data sets in the list. Information about the disk pack contents is shown in the next three lines, entitled VTOC, VOL, and FREE.

The data set list area of the screen shows the data sets in the volume. If the Search dataset name field was specified, the displayed list matches the specified name.

If no data set name matched the specified name, File-AID displays the message: NO DATASET FOUND in the upper-right corner of the VTOC Utility screen.

Field Descriptions describes the information displayed on the screen. The screen is scrollable. Enter line commands to the left of the dataset name. See Commands for a table of commands. Use the END command (PF3) to return to the VTOC Utility screen.

Example

Display data sets that end in CNTL and reside on any storage class volume beginning with volume name TSO.

Leave the OPTION field blank and specify TSO in the Volume serial field and STG in the Volume status field on the VTOC Utility screen. In this case, TSO represents the first three characters of the volume IDs to be searched.

Conversely, you can enter the generic unit name of the volumes you wish to search in the unit name field (SYSDA, for example) rather than a VOL mask. Specify +.CNTL in the Search data setname field and 33 in the Max number of names field. When you press Enter, File-AID displays the VTOC Dataset List screen as shown in the following figure.

VTOC Dataset List Screen - Multi-Volume Dataset Search

The data sets on the VTOC Dataset List screen are listed in alphabetical sequence, all have a suffix of CNTL. The VOLUME column on the right side of the display indicates the disk pack on which the data set resides. For multi-volume searches, the length of the list is controlled by the value in the MAX NUMBER OF NAMES field.

The DATASETS SELECTED field provides the number of data sets matching the selection criteria and the total amount of space allocated for these data sets.

"VTOC Utility ER398 on Dataset" Error

When the File-AID/Batch VTOCDSN function is issued, File-AID will search the VTOC for the dataset name and attributes for all data sets. If the data set is VSAM or VSAM-like, File-AID will then search the default catalog structure for the attributes of the file.

A PDSE (see Org code POE - Partitioned Extended (PDSE)) has a completely different directory than a normal PDS. They are actually very similar to VSAM attributes. When File-AID detects a PDSE, it will first get the file name from the VTOC and then search the default catalog. If the file cannot be found on the default catalog, IBM Services (IGW) sends File-AID an error message (i.e. IGWFAMS FAILED RC R15=0012, REA R0=0805).

File-AID will still print the PDSE dataset name within the output and will give all of its attributes except for %USED. This information can only be obtained from the proper catalog.

In order to determine which data sets received the ER398 message, go through the list of data sets and look for the organization of POE and also look for %USED ?. From this you can gather the dataset names that match that criteria and then enter them in separately into the VTOCDSN VOLSER=RES200, DSN=FULL.DATASET.NAME and if you receive the ER398 message, it will confirm that this is the dataset name that failed.