CBLVCAT Examples Menu

The final example illustrates the flexibility of CBLVCAT, by combining output from all catalogs and all VTOCs in the system, and using a subset to select only files you require.

We will produce a single report, over the whole system, on all DSN's which contain the string 'TEST' anywhere in its name. This type of report could be part of a housekeeping operation, for instance.

This example uses the REF=ALL parameter which is only available to MVS ICF users. VSAM users should specify each catalog separately.

 ___________________________________________________________________________________
|                                                                                  /
|   CBLVCAT REL 2.10 AT COMPUTE (Bridgend) Ltd - Wales         2003/09/26 15:03  PA\
| o --------------------------------------------------         ----------------  --/
|                                                                                  \
|        REPORT VTOC       DSN 30  VOLUME 10                                       /
| o                                                                                \
|        REPORT VCAT  SORT DSN 30  VOLUME 10  CATALOG  * Sort by DSN.              /
|                                                                                  \
| o      LISTVTOC DEV=ALL    MERGE  * 1st MERGE to combine all VTOC REPORTS.       /
|                 KEY=/TEST  MERGE  * 2nd MERGE to combine with next command.      \
|                                                                                  /
| o      LISTVCAT REF=ALL MERGE  KEY=/TEST                                         \
|                                                                                  /
|                                                                                  \
| o DATASET NAME                  VOLUME    CATALOG                                /
|   ------------                  ------    -------                                \
|                                                                                  /
| o BUZZ.TESTHARN.LINEAR          CBLI04    ICFCAT.CBLI04                          \
|   GD.TEST.PRC0                  CBLI02    CAT.ICF.MASTCAT.CBLI02                 /
|   GD.TEST.TBL0                  CBLI02    CAT.ICF.MASTCAT.CBLI02                 \
| o INPUT.KKK.TEST2 F5            CBLT02                                           /
|   MASTERFIL TEST2F5             CBLT02                                           \
|   PAGE.VCBLI02.TEST01           CBLI02    CAT.ICF.MASTCAT.CBLI02                 /
| o PRODN TEST C                  CBLT01                                           \
|   PRODN TEST T                  CBLT01                                           /
|/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\\

Notes:

For MVS systems the DEV=ALL parameter will produce a VTOC report for each DASD device belonging to the esoteric group SYSALLDA.

For VSE systems the DEV=ALL parameter will produce a VTOC report for every disk drive that has a current programmer logical unit assignment.

The REF=ALL parameter produces a report for all catalogs. Non ICF users must specify each catalog with separate LISTVCAT commands.

Use of the three MERGE parameters causes one single combined report to be created.

The user should note that if the files required are not system wide but contained in few known catalogs and VTOCS, then merging separate LISTVCAT and LISTVTOC commands is more efficient than scanning all catalogs and VTOCS.

VTOC output of course will have no catalog name.