Map VTOC entries in pack location sequence


The Map VTOC entries in pack location sequence function (option M) shows a physical display list of all contents on the volume. In addition to the data sets and their extents, option M also displays the VTOC, its pointer, and lost or free space.

Because this option displays information by its physical sequence on a volume, it can only display entries of a single disk pack.

Enter an M in the OPTION field and specify a single volume number in the Volume serial field on the VTOC Utility screen. When you press Enter, File-AID displays the physical structure of the disk pack on the Utility VTOC List screen as shown in the following figure.

To process a generic search and display the physical structure of a disk pack, specify a search name on the VTOC Utility screen. Then, only the data sets matching the search mask (pattern dataset name) are listed on the Utility VTOC List screen.

Related topics

Utility VTOC List Screen - Volume-Location Sequence

File-AID - Utility VTOC List for PRD987 (3390)  -------      1352 LINES LISTED
 COMMAND ===>                                                  SCROLL ===> PAGE
  VTOC:     69 Tracks (  30 %Used)    2413 Free DSCB'S           1013 Data sets
  VOL:   50085 Tracks (  84 %Used)      15 Tracks/cylinder          
  FREE:    505 Cyls (MAX= 197)        7882 Trks (MAX= 2955)        91 Free Xtnts
   CCCCC-HH -------- D A T A S E T   N A M E ----------- Org   Trks   XofY  Stat
   00000 00 VTOC POINTER                                 VP       1   1   1     
   00000 00 DFHBJS0.PLANS                                PS       0   0   0     
   00000 00 MISDEV.TECH.EMPTY.NUPDATE                    PS       0   0   0     
   00000 00 SFHRMO0.C120007A                             PS       0   0   0     
   00000 01 VTOC                                         VT      69   1   1     
   00004 10 SYS1.VTOCIX.PRD987                           PS      20   1   1     
   00006 00 SYS1.VVDS.VPRD987                            VS      15   1   1     
   00007 00 DSS.RV.FR.V4R3M0.ALLJOBS.BASE.QC             PS       1   1   1     
   00007 01 STG00266.DSNDBD.DBMXSDB.DM63TABL.I0001.A001  VS       1   1   1     
   00007 02 STG00287.DSNDBD.TS640D1.XUM02200.I0001.A001  VS       1   1   1     
   00007 03 D61MMIS.DSNDBD.CDSP001.SP221003.I0001.A001   VS       1   3   3     
   00007 04 D61MMIS.DSNDBD.CDSP001.SP209002.I0001.A001   VS       1  19  25     
   00007 05 X2.PROD.MLXW500.APPROVED.SMPHOLD             PS       1   1   1     
   00007 06 D61MMIS.DSNDBD.CDSP001.SP311001.I0001.A001   VS       1   1   1     
   00007 07 FA.OV.BP157047.LAYOUTS.QC                    PO       1   1   1     
   00007 08 D701.DSNDBD.DSNDB06.SQLACX01.I0001.A001      VS       1   3   4     
   00007 09 VP.ATV.HS771DEV.DTL.NCSTESTS.D08025.T1521    PS       1   1   1     
   00007 10 DB2DMIS.DSNDBD.DVSP001.SP206004.I0001.A001   VS       1  12  15

Utility VTOC List Screen - Volume-Location Sequence for EAV DASD

File-AID - Utility VTOC List for PRD923 (3390)  -------      1654 LINES LISTED
 COMMAND ===>                                                  SCROLL ===> PAGE
VTOC:       180 Tracks (  14 %Used)       7778 Free DSCBs        1205 Data Sets
VOL:     150255 Tracks (  81 %Used) 15 Trks/Cyl   0 Cyl/MCU        
FREE:      1828 Cyls(Max       240)      28325 Trks(Max       3607)    253 Xtnts
 Track-managed free space (below Cylinder 0):                                   
              0 Cyls(Max         0)          0 Trks(Max          0)      0 Xtnts
 Cylinder-managed free space:                0 Cyls(Max          0)      0 Xtnts
 Cylinder-managed space is allocated in units of 0 Cylinders     
      Cyl-Trk -------- D A T A S E T    N A M E ---------- Org    Tracks  X of Y
   0000000-00 VTOC POINTER                                 VP          1   1   1
   0000000-00 FA.BASE.V9R0M1.FIX.DEV                       PS          0   0   0
   0000000-00 FD.BASE.V4R9M0.FIX.MTL                       PS          0   0   0
   0000000-01 SYS1.VTOCIX.PRD923                           PS         59   1   1
   0000004-00 VTOC                                         VT        180   1   1
   0000016-00 SYS1.VVDS.VPRD923                            VS         45   1   1
   0000019-00 STG00366.DSNDBD.FRSMPDB.ORDLRIDX.I0001.A001  VS          1   1   1
   0000019-01 ENTQA.FR.PUBLIC.QA.#117.CONTACTT.INDEX       VS          1   1   1
   0000019-02 STG00266.DSNDBD.PARDB04.TAXSRRUL.I0001.A001  VS          1   1   1
   0000019-03 VP.AT.TCPSC.P71494F.BASELINE.SYSTSPRT        PS          1   1   1
   0000019-04 STG00387.DSNDBD.FRRDX.XDEPT3.I0001.A001      VS          1   1   1
   0000019-05 PFHKYC0.DAODO.OUT                            PS          1   1   1
   0000019-06 SAPMWK0.FASAMP.PLISRC.NEW                    PO          1   1   1
   0000019-07 MFHSXM0.CREQUEST                             PS          1   1   1

The top line of the Utility VTOC List screen displays the disk pack name with the type (in parentheses), and the number of data sets in the list.

When Display Volume Summary is set to Y, the volume summary information is displayed in the following lines, beginning with the headings: VTOC, VOL, and FREE. A fourth volume information line is displayed if a generic search is specified.

The next four lines only display for EAV DASD and show track- and cylinder-managed free space information.

If the Search dataset name field was specified, the displayed list matches the specified name. The data set list area is organized in columns. Field Descriptions describes the information displayed on the screen. If no dataset name matched the specified name, File-AID displays the message: NO DATASET FOUND in the upper-right corner of the VTOC Utility screen.

Overlapping Extents and Lost Space

The File-AID VTOC utility allows you to map a DASD device online showing the data sets and free space extents in ascending CCC-HH order. Look at this information as a snapshot of the device’s VTOC; that is, a picture of the VTOC at the time File-AID processes it. File-AID processes the VTOC without issuing enques while collecting the extent information.

After collating the extents into ascending order, File-AID formats the display table and checks for LOST SPACE. The next data set/free space extent location is checked against the last data set/free space ending location and File-AID notes any extent overlaps (OVERLAPPING EXTENTS) or gaps (LOST SPACE).

An area on a disk pack is considered "lost" when it is unaccounted for in the VTOC. This area physically exists, but is not recognized by the VTOC as belonging to a file or free space. The File-AID VTOC Utility recognizes this condition and flags it as lost space with the message: * * * L O S T S P A C E * * * in the DATASET NAME area of the Utility VTOC List screen. When this message is displayed, specify FIND L O S T in the COMMAND field and press Enter. File-AID positions the display to the first lost space area. The following figure shows you this display.

Utility VTOC List Screen for Lost Space and Free Space

File-AID - Utility VTOC list for TSOI01 (3390) -------------- Row 271 of 568
 COMMAND ===>                                                  SCROLL ===> CSR
  VTOC:     29 Tracks   (  31 % Used) 1053 Free DSCB'S            471 Data sets
  VOL:   13290 Tracks   (  98 % Used    15 Tracks/cylinder         
  FREE:      6 Cyls   (MAX= 2)         219 Tracks (MAX= 36)        26 Free Xtnts
   CCCCC-HH -------- D A T A S E T   N A M E ----------- Org   Trks   XofY  Stat
   00696 01 * * * L O S T   S P A C E * * *              ??       4   ?   ? >UNA
   00696 05 VS.TEST.MAPLIB                               PO      10   1   1
   00697 00 VSV.CICSS.REPTFILX.DATA                      VS      15   1   1
   00698 00 CVSCOB2.COB2LIB                              PO      50   1   1
   00701 05 VS.AA.R502.MXA.SORCMAC                       PO      38   1   1
   00703 13 TSOID01.X.IBMDFILE                           PS      20   9  16
   00705 03 TSOID03.X.IBMDFILE                           PS      16  13  16
   00706 04 TSOID01.RRC.SOURCE                           PO      36   1   1
   00708 01 * * * F R E E   S P A C E * * *              FS       1   0   0
   00708 10 VS.SNUB.PROD.MACLIB                          PO      34   1   1
   00710 14 XX.YY.LOAD.TEST                              PO      16   1   1
   00712 00 VSV.CICSR.ERL.REPTFILX.DATA                  VS      15   1   1
   00713 00 TSOID01.TEST.JANEPDS                         PO      33   1   1
   00715 03 TSOID03.CALL.BKLOG                           PS      11   1   1
   00715 14 TSOID01.FIND.MACROS                          PO       1   1   1
   00716 00 VSV.XX.TEST.TEMPRCB.DATA                     VS      15   1   1
   00717 00 TSOID01.YYY.TREPORT                          PO      26   1   1

When a lost space area is displayed on the Utility VTOC List screen, the STATUS column displays the message: >UNACT to indicate that this area on the disk pack is currently unaccounted for.

You can find free space entries by entering: FIND F R E E in the COMMAND field of the Utility VTOC List screen.

Enter the RFIND command to scroll the display to the next free space area.

If required, scroll down the data set list to the desired data set. VTOC Utility Line Commands lists the line commands that you can enter on a list of data set names.

Press END (PF3) to return to the VTOC Utility screen.

Example

Search volume TSOI01 for the location and extents of all data sets on the volume with names ending with SOURCE. Only data sets that match the search dataset name mask value are shown.

Enter M in the OPTION field, TSOI01 in the Volume serial field, and +.SOURCE in the Search dataset name field on the VTOC Utility screen.

When you press Enter, File-AID scans the indicated disk pack VTOC and lists only the dataset names with SOURCE as a suffix on the Utility VTOC List screen as shown in the following figure.

Utility VTOC List Screen for Source Datasets - Volume-Location Sequence

File-AID - Utility VTOC List for TSOI01 (3390)  -------------- Row 1 to 9 of 9
 COMMAND ===>                                                  SCROLL ===> PAGE
  VTOC:    180 Tracks (  14 %Used)    7706 Free DSCB'S              6 Data sets
  VOL:  150255 Tracks (  52 %Used)      15 Tracks/cylinder          
  FREE:   4746 Cyls (MAX= 1868)      72229 Trks (MAX= 28020)      315 Free Xtnts
  Selected Datasets:     931 Tracks, using   1 % of volume                      
   CCCCC-HH -------- D A T A S E T   N A M E ----------- Org   Trks   XofY  Stat
   00042 10 TSOID01.UNLP.SOURCE                          PO       1   1   1     
   00053 05 TSOID01.XT.SOURCE                            PO       1   1   1     
   00073 08 TSOID01.IMS.GEN.SOURCE                       PO       5   1   1     
   00153 02 TSOID01.FA89TEST.SOURCE                      PO       3   1   1     
   00336 11 TSOID01.CSS86.PGM.SOURCE                     PO      30   4   4     
   00377 00 XX.SAMPLES.SOURCE                            PO      27   1   1     
   00390 00 TSOID01.CSS86.PGM.SOURCE                     PO      30   2   4     
   00473 00 TSOID01.CSS86.PGM.SOURCE                     PO      30   3   4     
   07580 10 TSOID01.CSS86.PGM.SOURCE                     PO     804   1   4     
 ******************************* Bottom of data ********************************

The format of the display is the same as that of a non-generic search. However, the list now shown is a partial list of the disk pack. Notice that the DATASET NAME field is shown and the list does not indicate free space. Press END (PF3) to return to the VTOC Utility screen.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*