FDRABRP VTOC Report


PRINT VTOC statement

The report generated by the PRINT VTOC statement provides current information about existing data sets taken from the VTOCs of specific volumes, including: data set name, DASD volume serial, last ABR cycle, volume sequence number, last reference date, special ABR indicators, data set attributes and allocation information. The SUMPFX option allows summarization by high-level index.

PRINT VTOC statement syntax

PRINT

VTOC


,AGE=30|nnn


,AGEINC=30|nnn


,COMBINE


,DETAIL=NO|YES


,DSG=dsg|(dsg,…,dsg)


,DSN=dsn|(dsn,…,dsn)


,FORMAT=CRT|PRT


,LINECNT=58|nn


,ONLINE


,SELTERR=NO|YES


,SUM=NO|YES


,SUMPFX=ALL|YES


,VOL=vol|(vol,…,vol)


,VOLG=volg|(volg,…,volg)

AGE=

nnn

If the summary report is printed, AGE= specifies the number of days (1 to 999) since a data set has been referenced as used by the aging summary for the VTOC report.

Default: 30.

AGEINC=

nnn

If the summary report is printed, AGEINC= specifies the number of days (1 to 999) added to the value to derive the next control break in the aging summary for the VTOC Report. The summary report displays four aging breaks.

Default: 30.

COMBINE

Specifies that the report is produced in data set/volume serial number sequence, merging the various DASD volumes into one combined report.

Important

The use of COMBINE requires that the execution Job Control include SORT-related DD statements as described in FDRABRP-JCL-Requirements.

Default: Each volume processed has its own separate report.

DETAIL=
NO

Results in ONLY a track utilization and data set aging summary to be printed. The SUM=YES option must also be active otherwise no reports are output. The reporting of DSCB information related to each data set is bypassed.

YES

A complete detailed report is printed.

Default: DETAIL=YES.

DSN=

Only data sets or clusters with a name matching one of the names given are selected (1-44 characters). Multiple values are specified in parentheses separated by commas.

Important

FDRABRP does not support data set name masking (patterns). For similar reports using masking, see FDREPORT-Generalized-Report-Writer.

DSG=

Only data sets or clusters beginning with one of the prefixes given are selected (1 to 44 characters). Multiple values are specified in parentheses separated by commas.

There is a special form of the DSG operand. Leading periods “.” after DSG= indicate that the group name starts after one or more index levels. Each period indicates that one index level is to be bypassed.

Example: DSG=..TST selects any data set with a third index level starting with “TST”.

Important

  • DSN and DSG operands may be repeated and/or intermixed. A total of up to 200 strings may be specified. Specifies one or more data set names from 1 to 44 characters in length. Only data sets or clusters having a name that match one of the names are selected.
  • FDRABRP does not support data set name masking (patterns). For similar reports using masking, see FDREPORT-Generalized-Report-Writer.
FORMAT=
CRT

Produces a 79 character line formatted for a TSO terminal.

PRT

Produces a 121 character line formatted for a printer.

Default: CRT if executing under TSO; PRT otherwise.

LINECNT=

nn

Specifies the maximum number of lines each report page can contain, from 28 to 99 inclusive.

Default: 58.

ONLINE

Causes all online DASD volumes to be included in the report.

Default: If neither ONLINE nor VOL/VOLG is specified, the default is that only DASD volumes pointed to by DISKxxxx DD Statements are included.

SELTERR=
NO

Specifies that a condition code of 12 is not set if there are no data sets that match the selection criteria on this PRINT command.

YES

Specifies that a condition code of 12 is set if there are no data sets that match the selection criteria on this PRINT command.

Default: YES.

SUM=
NO

Suppresses the track utilization and data set aging summary. Only the information from the DSCBs for the data sets on the volumes selected are printed. You must insure that the DETAIL=YES option is active.

YES

Print the track utilization and data set aging summary along with the information from the DSCBs for the data sets on the volumes selected.

Default: YES.

SUMPFX=

Specifies that the report on ABRSUM summarize by high-level data set index.

ALL

Also produce AGING information for the higher data sets by index level.

YES

Produces only a report by index level.

VOL=
VOLG=

Only volumes matching the specified volume serial “VOL=” or volume serial prefix “VOLG=” are selected. Multiple values are specified in parentheses separated by commas.

Important

VOL and VOLG operands may be repeated and/or intermixed. A total of up to 100 strings may be specified.

inset_5.jpgThe FDRABRP program has been functionally stabilized, but is still available; however, this report can be produced with FDREPORT and enhanced with all the features available in FDREPORT and the flexibility to modify the reports as desired. This is the JCL and control statements to produce the equivalent FDREPORT for FDRABRP “PRINT VTOC,VOL=IDPLB2” report.

//FDREPORT EXEC PGM=FDREPORT,REGION=0M //SYSPRINT DD SYSOUT=* //ABRMAP DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //SYSIN DD * XSELECT VOL=IDPLB2 SORT FIELD=DSN,SEQUENCE=A PRINT DATATYPE=VTOC,RPTYPE=ABRVTOC,SUMLEVEL=REPORT, DISABLE=NEWSUMFORMAT,AGEACC=4,AGEINC=30 /*

This FDREPORT example can be found in the JCL library installed with FDR. The member name is EX5307A.

Sample reports for FDRABRP

Sample VTOC report

CARD IMAGE - * PRINT VTOC,VOL=IDPLB2
FDR400 AUTOMATIC BACKUP/RECOVERY VTOC LIST - FDRABRV VER 5.4/91P - INNOVATION DATA PROCESSING DATE- 2008.323 PAGE- 1

 VTOC LIST OF VOLUME SERIAL NUMBER IDPLB2 - DEVICE TYPE 3390-3

 VOLUME LS VOL LAST REF ABR D/S BLOCK TRACKS EXTENT DESCRIPTORS
DATA SET NAME SERIAL CY SEQ DATE IND ORG RECFM SIZE LRECL ALLOC FREE CT CCC-HH CCC-HH
---- --- ---- ------ -- --- ---- --- --- ----- ---- ----- ----- ---- -- --- -- --- --
****VTOC IDPLB2 001 0000.000 0 0 14 0 1 00000-01 00000-14
***ABR MODEL--LAST GEN=0151 IDPLB2 05 001 2008.322 0 0 0 0 0
FDRABR.VIDPLB2
AJM.XMIT.LOG IDPLB2 00 001 2003.162 PS VB 3120 255 1 0 1 01928-04 01928-04
BAB.IXFP.TABLES IDPLB2 00 001 2008.114 PO FB 27920 80 2 1 1 01928-10 01928-11
BGR.V5467P.LIST IDPLB2 00 001 2008.214 PO VBA 27952 137 2460 10 1 01657-00 01820-14
***CLUSTER---CATALOG.STEEL
CATALOG.STEEL IDPLB2 05 001 2008.323 EF U 4096 0 15 0 1 00423-00 00423-14
CATALOG.STEEL.CATINDEX IDPLB2 05 001 1998.296 EF U 4096 0 1 0 1 00364-05 00364-05

SYSP.XPORTED.PMASTER IDPLB2 00 001 2007.101 PS VBS 27998 32404 2 0 1 01929-07 01929-08
SYSP.XTREMC6.TABLES IDPLB2 00 001 2008.067 PO FB 6160 80 2 1 1 01928-06 01928-07
***CLUSTER---SYSPSMS.SJP.ACTIVE.SCDS
SYSPSMS.SJP.ACTIVE.SCDS. IDPLB2 00 001 2007.299 EF U 4096 0 90 0 1 00002-00 00007-14
DATA

 ABR INDICATORS --
A=ALWAYS BACKUP/NEVER ARCHIVE R=ARCHIVING REQUESTED C=NO CURRENT BACKUP
 N=NORMAL BACKUP/NEVER ARCHIVE U=UPDATE INDICATED X=EXCLUDE FROM ABR
 I=INSTANT (SNAP/SPLIT) BACKUP ATTEMPTED
IN SUMMARY - VOLUME IDPLB2 --- DEVICE TYPE 3390-3
**** TRACK UTILIZATION **** PER **** DATA SET STATISTICS ****
 TOTAL TRACKS-----------50085
ALLOCATED TRACKS-------30805 62% TOTAL DATA SETS-----------160
PS/PO ALLOCATED-----16960 PS/PO DATA SETS--------130
PS/PO USED-------14470
PS/PO UNUSED------2490 14%
OTHER ALLOCATED-----13844 OTHER DATA SETS---------30
FREE TRACKS------------19280 38% TOTAL EXTENTS-------------228
**** DATA SET AGING SUMMARY -- BASED ON LAST REFENCED DATE ****
DAYS SINCE DATA ALLOC USED UNUSED
 LREFDATE REFERENCED SETS TRACKS TRACKS TRACKS
-------- ---------- ---- ------ ------ ------
2008.293 1 - 30 71 23239 21622 1617
2008.263 31 - 60 9 623 476 147
2008.233 61 - 90 5 248 89 159
****.*** 91 - *** 75 6694 6127 567
FDR426 PROCESSING OF VOLUME IDPLB2 COMPLETED

Sample VTOC report from TSO

DSN-****VTOC VOL-IDPLB2 3390-3 VSEQ---1
LAST REF--0000.000 LAST CYC---** EXT COUNT---1 ALLOC------14 FREE------0
DSORG----- RECFM--- BLKSIZE-----0 LRECL-----0
EXTENT-----------0 BEGINNING CCHH------00000-01 ENDING CCHH-------00000-14


DSN-***ABR MODEL--LAST GEN=0151 FDRABR.VIDPLB2 VOL-IDPLB2 3390-3 VSEQ---1
LAST REF--2008.322 LAST CYC----5 EXT COUNT---0 ALLOC-------0 FREE------0
DSORG----- RECFM--- BLKSIZE-----0 LRECL-----0


DSN-AJM.XMIT.LOG VOL-IDPLB2 3390-3 VSEQ---1
LAST REF--2003.162 LAST CYC----0 EXT COUNT---1 ALLOC-------1 FREE------0
DSORG-----PS RECFM---VB BLKSIZE--3120 LRECL---255
EXTENT-----------0 BEGINNING CCHH------01928-04 ENDING CCHH-------01928-04

 

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