FDRABRP Tape VTOC Report


PRINT TVTOC statement

The report generated by the PRINT TVTOC command gives the user access to VTOC information and/or VVDS information from the control records at the beginning of a dump tape created by FDR, FDRDSF, or FDRABR. The type of report is selected by using the LIST= and/or VSAM= operands.

The input tape is identified by a DD statement with a ddname prefixed by “TAPE”. If multiple TAPExxxx DD Statements are present, all of them are processed, unless FRDD= is specified. A VSAMPRT DD Statement is required if you wish to generate a listing of the VVDS information.

PRINT TVTOC statement syntax

PRINT

TVTOC


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


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


,FRDD=ddname


,LINECNT=58|nn


,LIST=ABR|DUMP|NO|VTOC


,SELTERR=NO|YES


,VSAM=DUMP|NO|YES

DSN=

Only data sets or clusters with a name matching one of the names given are selected (1 to 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 Working-with-FDREPORT .

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.

FRDD=

Specifies the name of the DD statement from which to read the backup. This allows a selective execution when the JCL contains multiple TAPExxxx DD Statements.

Default: All TAPExxxx DD Statements are processed.

LINECNT=

nn

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

Default: 58.

LIST=

Specifies the format of the listing of VTOC information.

ABR

The listing of VTOC information is in a format similar to that of program FDRABRP, command PRINT VTOC, FORMAT=PRT.

DUMP

The listing of VTOC information is in a format similar to that of program IEHLIST, command LISTVTOC DUMP.

NO

The listing of VTOC information is not produced.

VTOC

The listing of VTOC information is in a format similar to that of program IEHLIST, command LISTVTOC FORMAT.

Default: ABR.

SELTERR=
NO

Specifies that a condition code of 12 is not set if there are no data sets backed up to the tapes being processed 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 backed up to the tapes being processed that match the selection criteria on this PRINT command.

Default: YES.

VSAM=

Specifies the format of the listing of VVDS information for ICF VSAM data sets. The VSAMPRT DD Statement must be present if this option is specified as other than NO.

DUMP

The listing of VVDS information is in dump format for each VVR, with hexadecimal on the left and EBCDIC on the right.

NO

The listing of VVDS information is not produced.

YES

The listing of VVDS information is in a format similar to that of program IDCAMS, command LISTCAT ALL. ABR fills in as much of this report as is possible from the BACKUP. Some fields, such as paths for Alternate Indexes (AIXs) and password protection, are not available from the backup tape.

Default: YES if VSAMPRT is present; NO if not.

inset_3.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 TVTOC,LIST=ABR” report for backup data set FDRABR.VIDPLB3.C2089305.

//FDREPORT EXEC PGM=FDREPORT,REGION=0M
//SYSPRINT DD SYSOUT=*
//ABRMAP   DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//TAPE0001 DD DISP=SHR,DSN=FDRABR.VIDPLB3.C2089305
//SYSIN    DD *
 PRINT    DATATYPE=TVTOC,RPTYPE=ABRVTOC
/*

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

Sample reports for FDRABRP

Sample TVTOC Report in IEHLIST Format

CARD IMAGE - * PRINT TVTOC,LIST=VTOC
FDR400   AUTOMATIC BACKUP/RECOVERY   VTOC - FDRABRP VER 6.1  - BMC Software Inc  DATE: 2008.323 PAGE -  1
FORMAT 4 DSCB NO AVAIL/MAX DSCB /MAX  DIRECT  NO AVAIL NEXT ALT   FORMAT 6    LAST FMT 1     VTOC EXTENT      THIS DSCB
         VI   DSCBS   PER TRK   BLK PER TRK  ALT  TRK TRK(C-H)   (C-H-R)     DSCB(C-H-R)/LOW(C-H) HIGH(C-H)   (C-H-R)
         89     555       50          45          15  3339   0    0  0  0      0  14  50      0 1      0 14      0 1 1
                                ----UNABLE TO CALCULATE EMPTY SPACE.
---------------DATA SET NAME---------------   ID  SER NO  SEQ NO  CREDT  EXPDT  NO EXT  DSORG  RECFM  OPTCD   BLKSIZE
***ABR MODEL--LAST GEN=0893 FDRABR.VIDPLB3     1  IDPLB3      1  3192008 3651999   0                   00         0
           LRECL  KEYLEN  INITIAL ALLOC  2ND  ALLOC/LAST BLK PTR(T-R-L)  USED PDS BYTES  FMT 2 OR 3(C-H-R)/DSCB(C-H-R)
               0     0     TRKS                  0         0   0 58786           74                 0 0 0     0   2 21
           **--THIS DATASET HAS NO EXTENTS--**
---------------DATA SET NAME---------------   ID  SER NO  SEQ NO  CREDT   EXPDT NO EXT DSORG RECFM OPTCD BLKSIZE
AJM.UNLOAD.JCL                                 1  IDPLB3      1  0441998  0000000  1    PO   FB     00    9440
           LRECL  KEYLEN   INITIAL ALLOC 2ND  ALLOC/LAST BLK PTR(T-R-L)  USED PDS BYTES  FMT 2 OR 3(C-H-R)/DSCB(C-H-R)
              80     0      CYLS                 0        52   5 52462            0              0   0 0      0   5 35
           EXTENTS  NO   LOW(C-H)    HIGH(C-H)
                     0   3061   0     3065 14
                     ----ON THE ABOVE DATA SET THERE ARE 22 EMPTY TRACK(S).

Sample TVTOC VSAM report

CLUSTER ------- TST.MULTIVOL.VSAM.CLUSTER
    IN-CAT --- CATALOG.TICFUSER
    HISTORY
       DATASET-OWNER------(N/A)     CREATION-----------(N/A)
      RELEASE------------(N/A)     EXPIRATION---------(N/A)
    SMSDATA
       STORAGECLASS-----PRIDATA     MANAGEMENTCLASS---(NULL)
      DATACLASS---------(NULL)     LBACKUP----0000.000.0000
    PROTECTION-PSWD------(N/A)     RACF---------------(N/A)
    ASSOCIATIONS
      DATA-----TST.MULTIVOL.VSAM.DATA

  DATA ------- TST.MULTIVOL.VSAM.DATA
    IN-CAT --- CATALOG.TICFUSER
    HISTORY
       DATASET-OWNER------(N/A)     CREATION-----------(N/A)
      RELEASE------------(N/A)     EXPIRATION---------(N/A)
    PROTECTION-PSWD------(N/A)     RACF---------------(N/A)
    ASSOCIATIONS
      CLUSTER--TST.MULTIVOL.VSAM.CLUSTER
    VOLUME
       VOLSER------------IDPLB3     PHYREC-SIZE--------18432     HI-ALLOC-RBA------663552    EXTENT-NUMBER----------1
      DEVTYPE----------3390-3      PHYRECS/TRK------------3     HI-USED-RBA-------663552    EXTENT-TYPE--------X'40'
      VOLFLAG------------PRIME     TRACKS/CA--------------4
      EXTENTS:
       LOW-CCHH-----X'0CD2000A'     LOW-RBA-----------442368     TRACKS-----------------4
      HIGH-CCHH----X'0CD2000D'     HIGH-RBA----------663551
CLUSTER ------- TST.MULTIVOL.VSAMKR.CLUSTER
    IN-CAT --- CATALOG.TICFUSER
    HISTORY
       DATASET-OWNER------(N/A)     CREATION-----------(N/A)
      RELEASE------------(N/A)     EXPIRATION---------(N/A)
    SMSDATA
       STORAGECLASS-----PRIDATA     MANAGEMENTCLASS---(NULL)
      DATACLASS---------(NULL)     LBACKUP----0000.000.0000
    PROTECTION-PSWD------(N/A)     RACF---------------(N/A)
    ASSOCIATIONS
      DATA-----TST.MULTIVOL.VSAMKR.DATA

   DATA ------- TST.MULTIVOL.VSAMKR.DATA
     IN-CAT --- CATALOG.TICFUSER
     HISTORY
        DATASET-OWNER------(N/A)    CREATION-----------(N/A)
       RELEASE------------(N/A)    EXPIRATION---------(N/A)
     PROTECTION-PSWD------(N/A)    RACF---------------(N/A)
     ASSOCIATIONS
       CLUSTER--TST.MULTIVOL.VSAMKR.CLUSTER
     VOLUME
        VOLSER------------IDPLB3     PHYREC-SIZE--------18432    HI-ALLOC-RBA------663552    EXTENT-NUMBER----------1
       DEVTYPE----------3390-3      PHYRECS/TRK------------3    HI-USED-RBA-------663552    EXTENT-TYPE--------X'40'
       VOLFLAG------------PRIME     TRACKS/CA--------------4
       EXTENTS:
        LOW-CCHH-----X'0CD2000E'     LOW-RBA-----------442368    TRACKS-----------------4
       HIGH-CCHH----X'0CD30002'     HIGH-RBA----------663551


 

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