VTOCINFO (VTI)

The VTOCINFO function displays volume information including the volume serial number, device type, mount status, percentage of the volume allocated, VTOC statistics, DSCB, and distributed free space statistics. The VTOC statistics include volume size in tracks, percentage of tracks used, and whether or not the volume is indexed. DSCB and distributed free space statistics include the number of data set control blocks, the number of free cylinders, the maximum number of contiguous free cylinders, the number of free tracks, and the maximum number of contiguous free tracks.

You must specify either the VOLSER or UNIT parameter. The VOLSTAT parameter is optional.

The VTOCINFO function is equivalent to File-AID’s online VTOC utility (3.7) option I (List Volume Information). For more information, see 7).

Example:

This example displays volume information for all volumes with volume serial numbers that start with the first four letters PROD and for volume serial number WORK02. The information is further limited to those volumes with a volume status of STG (storage).

"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 (Org code “POE” - Partitioned Dataset Extended” 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 data set 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.