FDREPORT Volume Examples


This section shows examples that produce volume-level reports (DATATYPE=VOLDATA). All examples in this section are found in the JCL library installed with FDR. The member names are EX5444x.

Volume usage report example

Report on the percentage of the volume allocated, plus percentage used for the VTOC, VTOCIX, and VVDS, for all PROD volumes.

//REPORT   EXEC PGM=FDREPORT,REGION=0M
//SYSPRINT DD SYSOUT=*
//ABRMAP   DD SYSOUT=*
//SYSIN    DD *
 TITLE    LINE='PRODUCTION VOLUME USAGE'
 XSELECT  VOL=PROD*
 SORT     FIELDS=(VLVOLSER)
 REPORT   FIELDS=(VLVOLSER,VLUNIT,VLDEVTYP,VL%UTRKS,
                 VL%UDSCB,VL%UINDX,VL%UVVDS)
 PRINT    SORTALLOC=YES,DATATYPE=VOLDATA
/*

The generated report looks like:

PRODUCTION VOLUME USAGE
VOLSER UADR DEVTYPE %TU %DU %IU %VU
------ ---- ------- --- --- --- ---
PROD07 8055 3390-27 100   1  43   3
PROD12 8052 3390-9  100   1  23   3


Volume status report example

Report on the mount, usage, and SMS status of every online volume. The FASTPATH option improves FDREPORT performance when reporting on many volumes.

//REPORT   EXEC PGM=FDREPORT,REGION=0M
//SYSPRINT DD SYSOUT=*
//ABRMAP   DD SYSOUT=*
//SYSIN    DD *
 REPORT   FIELDS=(VLVOLSER,VLUNIT,VLDEVTYP,
                  VLUSEATR,VLMOUSTA,VLSMSTAT,VLSMSVST)
 PRINT    ENABLE=(ONLINE,FASTPATH),DATATYPE=VOLDATA
/*

The generated report looks like:

VOLSER UADR DEVTYPE USEATTR MOUNT    SMS STA VOLUM STATUS
------ ---- ------- ------- -------- ------- ------------
TSO123 0230 3390-9  PRIVATE RESIDENT NONE    NONE
DBLRG1 0400 3390-2  PRIVATE RESIDENT MANAGED ENABLED

Identify disabled indexed VTOCs example

Identify volumes that have an Indexed VTOC (VTOCIX) that has been disabled. A status of “YES” indicates that the VTOCIX exists but is not active.

//REPORT   EXEC PGM=FDREPORT,REGION=0M
//SYSPRINT DD SYSOUT=*
//ABRMAP   DD SYSOUT=*
//SYSIN    DD *
 TITLE    LINE='VOLUMES WITH DISABLED VTOC INDEXES'
 XSELECT  VLINDSTA=YES
 REPORT   FIELDS=(VLVOLSER,VLINDSTA)
 PRINT    ENABLE=ONLINE,DATATYPE=VOLDATA
/*

The generated report looks like:

VOLUMES WITH DISABLED VTOC INDEXES
VOLSER VTINDX
------ ------
TSO123 YES
DBLRG1 YES


DASD utilization statistics for import example

Generate statistics for all online DASD with the UNITNAME of SYSALLDA in a Comma Separated Values (CSV) format for import into another program, such as SAS. If this is done at regular intervals, the other program might be used to keep a history of the values, generating history, statistical, and trend reports. You might also download the report file to a PC for analysis by PC-based programs such as EXCEL. The tabular format contains no titles or page breaks; it contains one set of headings but you can add DISABLE=HEADINGS to suppress them.

//CSVDATA  EXEC PGM=FDREPORT,REGION=0M
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//ABRCSV   DD DSN=DASD.USAGE(+1),UNIT=DISK,
//         SPACE=(TRK,3),DISP=(,CATLG)
//SYSIN    DD *
 DEFAULT  ENABLE=(LARGEDISK,ONLINE),BYTEFORMAT=MEGABYTES
 XSELECT  UNITNAME=SYSALLDA,UCBSTATS=ONLINE
 REPORT   FIELDS=(VLVOLSER,UNIT,VL%UTRKS,VLBYTVOL,
                  VLALOBYT,DEVTYPE,UNITNAME)
 SORT     FIELDS=(UNITNAME,VLVOLSER)
 PRINT    DATATYPE=VOLDATA,RPTYPE=CSV
/*

The generated ABRCSV file looks like:

VOLSER,UADR,%TU,BYTES PER VOLUME,ALLOCATED BYTES,DEVTYPE,UNITNAME
ARCH01,080A,1,1892010960,2493216,3390-2,SYSALLDA
ARCH02,080B,1,1892010960,2323224,3390-2,SYSALLDA
ARCH03,080C,1,1892010960,2323224,3390-2,SYSALLDA
BMRK03,185B,12,27844689600,3158564688,3390-27,SYSALLDA
BMRK04,185C,83,27844689600,22911635088,3390-27,SYSALLDA
BMRK05,185D,83,27844689600,22911635088,3390-27,SYSALLDA
BMRK06,185E,83,27844689600,22911635088,3390-27,SYSALLDA
BMRK10,1910,1,27844689600,7649640,3390-27,SYSALLDA
BMRK11,1911,83,27844689600,22911181776,3390-27,SYSALLDA
BMRK12,1912,1,27844689600,7649640,3390-27,SYSALLDA
BMRK13,1913,83,27844689600,22836951936,3390-27,SYSALLDA
BMRK14,1914,83,27844689600,22906875312,3390-27,SYSALLDA
BMRK16,1916,83,27844689600,22911465096,3390-27,SYSALLDA
BMRK17,1917,83,27844689600,22911465096,3390-27,SYSALLDA
BM1800,1800,1,1892010960,15299280,3390-2,SYSALLDA
BM21DA,21DA,1,1892010960,963288,3390-2,SYSALLDA
BM21DB,21DB,1,1892010960,963288,3390-2,SYSALLDA
BM21D8,21D8,1,1892010960,963288,3390-2,SYSALLDA
BM21D9,21D9,1,1892010960,963288,3390-2,SYSALLDA
BM23C3,23C3,1,27844689600,1926576,3390-27,SYSALLDA
BM23C4,23C4,1,27844689600,1076616,3390-27,SYSALLDA
BM23C5,23C5,1,27844689600,1076616,3390-27,SYSALLDA
BM23C6,23C6,1,27844689600,1076616,3390-27,SYSALLDA

Volume summary report examples

The VOLSUMMARY operand allows you to create reports that summarize data from many volumes, instead of reporting on individual volumes. You can summarize based on SMS storage group, volume serial or unit address prefix, device type, or all volumes. The values from the various volumes are totaled, averaged, or maxed depending on the meaning of the field. Fields that are unique to a volume (such as volume serial number) are simply blanked.

//REPORT   EXEC PGM=FDREPORT,REGION=0M
//SYSPRINT DD SYSOUT=*
//ABRMAP   DD SYSOUT=*
//SYSIN    DD *
 TITLE    LINE='VOLUME SUMMARY BY STORAGE GROUP'
 REPORT   FIELDS=(VLSMSSTG,VLCYLVOL,VLFRECYL,VLDSCB1)
 PRINT    DATATYPE=VOLDATA,VOLSUMMARY=STORGRP,ENABLE=(ONLINE,FASTPATH)
/*

Generates a report showing the total data cylinders, total free cylinders, and total data sets in each group (the blank group includes all non-SMS volumes).

VOLUME SUMMARY BY STORAGE GROUP
STORGRP  CYL VOLUME    FREE CYL  FMT1 DSCBS
-------- ----------- ----------- -----------
           1090368      779068       16242
PRODRSVD      99057       95883          26
PROD0         25599        7091        1424
PROD1         23373       10091        1170
PROD10        60705       22730         496
PROD11        70119       70076          19
PROD12         6678        5548         144
TITLE  LINE='VOLUME SUMMARY BY DEVICE TYPE'
REPORT FIELDS=(VLDEVTYP,VLCYLVOL,VLFRECYL,VLLRGCYL)
PRINT  DATATYPE=VOLDATA,VOLSUMMARY=DEVTYPE,ENABLE=(ONLINE,FASTPATH)

Generates a report showing total data cylinders, total free cylinders, and largest free area for each type:

VOLUME SUMMARY BY DEVICE TYPE
DEVTYPE CYL VOLUME    FREE CYL LRGFREECYLS
------- ----------- ----------- -----------
3380-2        57876      56707     9552007M
3380-3        76797      47514    14332306M
3390         209218     203375     4776004M
3390-A     13062168   11513024     4795271G
3390-2       396228    349163      9556302M
3390-27     4306428   3308276    140694539M
3390-3       604359    521250     14336601M
3390-54     2806524   2523927    281397668M
3390-9      1240091   1004429     43014098M
--
          22759689  19527665      4795271G

 

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