List VTOC entries in dataset name sequence
Utility VTOC List Screen - Dataset Name Sequence
COMMAND ===> SCROLL ===> PAGE
VTOC: 180 Tracks ( 14 %Used) 7706 Free DSCB'S 1270 Data sets
VOL: 150255 Tracks ( 52 %Used) 15 Tracks/cylinder
FREE: 4748 Cyls (MAX= 1868) 72249 Trks (MAX= 28020) 316 Free Xtnts
--------- D A T A S E T N A M E ---------- Org Trks %Used XTS= Status
AA.R1002.Z85531 PO 1 100 1
AA.R1002.Z89326 PO 5 20 1
AA.R1101.S2.MSG.OBJECTS PO 11 100 1
AA.R1102.COPY.LOAD PO 15 13 1
AA.R1102.SMPM.CNTL PO 273 100 3
AA.R1102.Z88913 PO 5 20 1
AA.R110300.S1.LIST PO 570 99 2
AA.R94.ENDV.UPDT PO 540 100 1
AA.TECH.P190580.C1359056.ISSUE04.JOBLOG PS 6 100 3
AA.TECH.P999999.C1347328.REPORT PS 5 100 2
AC.AC210.S1.ASMSRC PO 165 92 1
AC.R1101.A90033 PO 5 20 1
AC.R1101.Z89603 PO 5 40 1
AC.R1102.PROD.SMPSCDS PO 11 27 1
AC.R1102.S2.MSG.OBJECTS PO 63 100 1
AC.R1102.S2.ZO.GBLMAC PO 1 100 1
AC.R110300.DEV.A87642 PO 5 20 1
AC.R110300.S1.TEXTSTR.OBJECTS PO 3 100 1
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
COMMAND ===> SCROLL ===> PAGE
Datasets selected: 89 , using 6738 Tracks
--------- D A T A S E T N A M E ---------- Org Tracks %Use Volume Status
AA.PTFTAPE.CNTL PO 9 100 TSO927
AA.R1102.SMPM.CNTL PO 273 100 TSO928
AA.SMPM.CNTL PO 17 100 TSO922
AC.R1101.S2.ASM.CNTL PO 1 100 TSO926
AF.R040400.MMFM440.CNTL PO 2 50 TSO923
BCMHWDP.FASAMP.PFCU.CONCAT.CNTL PO 4 100 TSO929
TSOID01.IMS.CNTL PO 15 13 TSO927
TSOID01.JCLSB.CNTL PO 14 100 TSO924
TSOID01.RCT.CNTL PO 2 100 TSO922
TSOID01.TEST.CNTL PO 7 43 TSO927
TSOID01.SALESUP.FXUNLOAD.CNTL PO 11 100 TSO927
TSOID01.JCL.CNTL PO 5 100 TSO921
TSOID03.JCL.CNTL PO 3 100 TSO921
TSOID02.CNTL PO 60 78 TSO928
CF.DEVL.R040500.LCL.CNTL PO 130 100 TSO929
CJ.QA.FD61E.TEST.CNTL PO 2 100 TSO922
CW.TECH.PUB.AA.AC.R1101E.S2.CNTL PO 150 94 TSO927
TSOID06.FR.V040700.CNTL PO 21 52 TSO929
TSOID06.FR.V040701.CNTL PO 11 100 TSO925
DSS.IBMC.DA.JCL.CNTL PO 45 89 TSO927
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.