Requesting information from the tape table of contents (TTOC)

You specify LIST TAPETABLEOFCONTENTS(volser) to get a list of the information contained in the TTOC for a tape backup or migration level 2 volume managed by DFSMShsm. Preceding the list is an echo of the LIST command issued.

Table 1 explains the output labels when you request information from the TTOC.

Table 1. Output labels when you request information from the tape table of contents
Printer Output Label (OUTDATASET or SYSOUT)	Terminal Label	Description
VOLSER	VOLSER	This field contains the volume serial number of the tape volume.
UNIT NAME	UNIT NAME	This field contains the name of the unit where this volume can be allocated.
VOL TYPE	VOL TYPE	This field contains the DFSMShsm volume category of the tape volume. SPILL indicates a spill backup volume. D(nn) indicates a backup volume assigned to day nn in the backup cycle. UNASS indicates that the volume has not been assigned as a daily or spill backup volume, or that it has been assigned as a daily backup volume but not to a specific day in the backup cycle. ML2 indicates that the volume is a tape migration level 2 volume.
REUSE CAPACITY	CAPACITY	This field contains the nominal number of blocks that DFSMShsm could write to this tape if it were emptied and written again. It is the actual average in this HSMplex for all full tapes of its cartridge type, recording technology, and function as calculated by the reporting host when it last started DFSMShsm. The blocks are 16 384 bytes each. ****** indicates that no ML2 or backup tape volumes marked full exist.
VALID BLKS	VALID BLOCKS	This field contains the number of blocks of data on the tape volume that are still valid.
PCT VALID	PCT VALID	This field contains the percent that this tape's valid blocks are of the reuse capacity. A value of 100 is shown for tapes whose number of valid blocks exceed the reuse capacity.
VOL STATUS	VOL STATUS	Empty under this heading indicates that the tape is empty. Full under this heading indicates that while DFSMShsm was writing to tape, either an end-of-tape marker was reached or a data-movement error occurred, and the volume was marked full to prevent further use. Partial under this heading indicates that the tape is neither empty nor full. The tape has been written to but may or may not contain valid data.
RACF	RACF	YES or Y indicates that the tape volume is RACF® protected.
PREV VOL	PREV VOL	If this field contains a volume serial number, the first data set on this tape volume is valid and does not begin on this volume, but is a continuation of the last data set on the indicated previous volume. If the field contains NONE, either the first data set is not valid or it begins on this volume.
SUCC VOL	SUCC VOL	If this field contains a volume serial number, the last data set on this tape volume is valid and does not end on this volume. The data set is continued on the indicated succeeding volume as the first data set on that volume. If the field contains NONE, either the last data set is not valid or it ends on this volume.
NUM REC	NUM REC	This field contains the number of offline control data set T records, including the base and extension records, used to contain this TTOC.
ONE FILE	ONE FILE	A YES or Y indicates that the tape volume has a single file containing the user data sets. A NO or N indicates that each user data set on the tape volume is in a separate tape data set. An *** indicates the ONE FILE is irrelevant because DFSMShsm has not written on the volume.
ALT VOL	ALTVOL	Volume serial number of duplicate tape copy created by DFSMShsm TAPECOPY command; NONE if duplicate tape is not so created; ****** indicating that the information is not known. If the optional parameter SELECT (DISASTERALTERNATEVOLUMES) is specified, this field shows the alternate tape volume that has been flagged as disaster alternate volume.
LIB	LIB	This field contains the tape library information for the volume. The field can be: Value Meaning library name the library with which the tape volume is associated. NO LIB the tape volume is not associated with a tape library. ERROR* an error occurs when the library information is retrieved. Check the command activity log for additional messages.
STORAGE GROUP	STORAGE GROUP	This field contains the name of the storage group. If there is a library name for the volume, there must be a storage group name. Connected tape volumes must be in the same storage group and library. The storage group field can be: Value Meaning storage group name storage group name associated with the tape volume. *NO SG a storage group is not associated with this volume. ERROR* an error occurs when the library information is retrieved. Check the command activity log for additional messages.
DATA SET NAME	DATA SET NAME	This field contains the name of the data sets on the volume. If the data set is on a tape backup volume, this name is the DFSMShsm-generated backup version name. If a data set is on a tape migration level 2 volume, this name is the original data set name, not the migrated data set name that DFSMShsm generates.
NUM BLOCKS	NUM BLOCKS	This field contains the number of blocks used on this volume for this data set.
RELATIVE FBID	REL FBID	This field contains the file sequence number of this data set or the set of blocks relative to the beginning of the single tape volume. For example, the first data set or data set segment on the tape volume has a relative FBID of 4 independent of any predecessor tapes.
VSAM	VSAM	YES or Y indicates that the data set is a backup version or a migration copy of a VSAM data set.
RACF	RACF	YES or Y indicates that the data set is discretely RACF-protected.
LAST REF DATE	LAST REF DATE	This field contains the last date when the migrated data set was referred to. This field does not apply to backup versions.
EXP DATE	EXP DATE	This field contains the expiration date of the user’s data set. This field does not apply to backup versions. For ML2 tapes, asterisks means the date is a never expire date.
A field containing only **** is not applicable to this volume (see individual field descriptions in the sample lists.)

Note: The LIST TTOC volser ODS dsn command can take an extensive amount of time to complete processing when trying to write out over 1 million data set entries in the ODS dsn. You can only get a million records if you are using extended TTOCs.

Nine reports are possible for the LIST TTOC display output. The report columns are all the same. Only the header and trailer inserts will change to indicate what type of report has been requested on the input command.

If the input command is issued for a list of tape volumes that have DISASTERALTERNATEVOLUMES, the header and trailer insert will be DISASTER ALTERNATE - LISTING.
If the input command is issued for a list of tape volumes that have failed recycle, then the header and trailer insert will be FAILED RECYCLE - LISTING.
If the input command is issued for a list of tape volumes that have failed create, then the header and trailer insert will be FAILED CREATE - LISTING.
If the input command is issued for tape volumes that contain data sets that span four or more volumes, then the header and trailer insert will be EXCESSIVE VOLUME - LISTING.
If the input command is issued for a list of tape volumes that have TAPETABLEOFCONTENTS SELECT(CONNECTED), then the trailer insert will be ***END OF CONNECTED TAPE VOLUME SET ***.
If the input command is issued for a list of ML2 volumes taken away by RECALL or ABACKUP, then the header and trailer insert will be RECALL TAKE AWAY — LISTING.
If the input command is issued for a list of volumes having alternate tapes in a library, then the header and trailer insert will be LIBRARY(ALTERNATE) — LISTING.
If the input command is issued for a list of volumes having alternate tapes not in a library, then the header and trailer insert will be NOLIB(ALTERNATE) — LISTING.
If the input command issued is other than those listed above, the header and trailer insert will be TAPE VOLUME TTOC - LISTING.

Figure 1 is a sample of an ODS output dataset list when you have specified the TAPETABLEOFCONTENTS SELECT(CONNECTED) parameter.

Figure 1. Sample Printer List when You Specify TAPETABLEOFCONTENTS SELECT(CONNECTED)

 - DFSMSHSM CONTROL DATASET - TAPE VOLUME TTOC - LISTING - AT 15:05:37 ON 11/05/23 FOR SYSTEM=SYSA

 VOLSER    UNIT    VOL      REUSE     VALID   PCT    VOL    RACF  PREV    SUCC    NUM  ONE   ALT     LIB       STORAGE
           NAME    TYPE   CAPACITY    BLKS    VALID  STATUS       VOL     VOL     REC  FILE  VOL                GROUP
 A00200   3490    D(01) 0000124000 0000000017 001    FULL    NO   *NONE*  A00300  001  YES   *NONE*  *NO LIB*  **NO SG*
 A00300   3490    D(01) 0000124000 0000000009 001    FULL    NO   A00200  *NONE*  001  YES   *NONE*  *NO LIB*  **NO SG*
 ***END OF CONNECTED TAPE VOLUME SET ***
 A00800   3490    D(01) 0000124000 0000000007 001    FULL    NO   *NONE*  A00700  001  YES   *NONE*  *NO LIB*  **NO SG*
 A00700   3490    D(01) 0000124000 0000000005 001    FULL    NO   A00800  A00600  001  YES   *NONE*  *NO LIB*  **NO SG*
 A00600   3490    D(01) 0000124000 0000000004 001    FULL    NO   A00700  *NONE*  001  YES   *NONE*  *NO LIB*  **NO SG*
 ***END OF CONNECTED TAPE VOLUME SET ***
 ----- END OF - TAPE VOLUME TTOC   - LISTING -----

Figure 2 is a sample of a terminal list when you have specified TAPETABLEOFCONTENTS, NODATASETINFORMATION and TERMINAL parameter.

Figure 2. Sample Terminal List when You Specify TAPETABLEOFCONTENTS, NODATASETINFORMATION and TERMINAL

 VOLSER=A00363  UNITNAME=3590-1    VOL TYPE=D(07)  CAPACITY=0000008800
 RACF= NO
 VALID BLKS=0000003874 PCT VALID= 045 VOL STATUS= FULL   PREV VOL=*NONE*
 SUCC VOL=*NONE*  NUM REC=001  ONE FILE=YES  ALTVOL=*NONE*
 LIBRARY=*NO LIB*   STORAGE GROUP=**NO SG*
 
 ARC0140I LIST COMPLETED,      5 LINE(S) OF DATA
 ARC0140I (CONT.) OUTPUT

Figure 3 is a sample of a printer list when you have specified the TAPETABLEOFCONTENTS parameter with DATASETINFORMATION.

Figure 3. Sample Printer List when You Specify TAPETABLEOFCONTENTS with DATASETINFORMATION

 - DFSMSHSM CONTROL DATASET - TAPE VOLUME TTOC - LISTING - AT 15:05:37 ON 11/05/23 FOR SYSTEM=SYSA

 VOLSER    UNIT    VOL      REUSE     VALID   PCT    VOL    RACF  PREV    SUCC    NUM  ONE   ALT     LIB       STORAGE
           NAME    TYPE   CAPACITY    BLKS    VALID  STATUS       VOL     VOL     REC  FILE  VOL                GROUP
 BATP01   3480X   D(01) 0000031000 0000000006 001    FULL    NO   *NONE*  *NONE*  001  YES   *NONE*  *NO LIB*  **NO SG*

             DATA SET NAME                          NUM BLOCKS  RELATIVE FBID  VSAM  RACF   LAST REF DATE  EXP DATE
    DFHSM.BACK.T380306.HSMATHO.F2553L03.I1001       0000000001     0000001     NO    NO       ********     ********
    DFHSM.BACK.T550306.HSMATHO.F2553L03.I1001       0000000001     0000002     NO    NO       ********     ********
    DFHSM.BACK.T560306.HSMATHO.F2553L03.I1001       0000000001     0000003     NO    NO       ********     ********
    DFHSM.BACK.T153306.HSMATHO.F2553L03.I1001       0000000003     0000004     NO    NO       ********     ********
 ----- END OF - TAPE VOLUME TTOC   - LISTING -----

Figure 4 is a sample of a terminal list when you have specified TAPETABLEOFCONTENTS, DATASETINFORMATION and TERMINAL parameter.

Figure 4. Sample Terminal List when You Specify TAPETABLEOFCONTENTS, DATASETINFORMATION and TERMINAL

 VOLSER=A00363  UNITNAME=3590-1    VOL TYPE=D(07)  CAPACITY=0000008800
 RACF= NO
 VALID BLKS=0000003874 PCT VALID= 045 VOL STATUS= FULL   PREV VOL=*NONE*
 SUCC VOL=*NONE*  NUM REC=001  ONE FILE=YES  ALTVOL=*NONE*
 LIBRARY=*NO LIB*   STORAGE GROUP=**NO SG*

 DATA SET NAME=DFHSM.BACK.T094109.HSMATH1.VSAM.A1137        NUM
 BLOCKS=0000000043
 REL FBID=0000021 VSAM=NO   RACF=NO   LAST REF DATE=********  EXP
 DATE=********

 DATA SET NAME=DFHSM.BACK.U094112.HSMATH1.VSAM.A1137        NUM
 BLOCKS=0000000040
 REL FBID=0000022 VSAM=NO   RACF=NO   LAST REF DATE=********  EXP
 DATE=********

 DATA SET NAME=DFHSM.BACK.T124119.HSMATH7.SMSDS3.A1137      NUM
 BLOCKS=0000003652
 REL FBID=0000064 VSAM=NO   RACF=NO   LAST REF DATE=********  EXP
 DATE=********

 ARC0140I LIST COMPLETED,      17 LINE(S) OF DATA
 ARC0140I (CONT.) OUTPUT

Figure 5 is a sample printer list when you have specified TAPETABLEOFCONTENTS, SELECT, NOALTERNATEVOLUMES, and LIBRARY parameters.

Figure 5. Sample Printer List when You Specify TAPETABLEOFCONTENTS, SELECT, NOALTERNATEVOLUMES, and LIBRARY

 - DFSMSHSM CONTROL DATASET - TAPE VOLUME TTOC - LISTING - AT 15:05:37 ON 11/05/23 FOR SYSTEM=SYSA

 VOLSER    UNIT    VOL      REUSE     VALID   PCT    VOL    RACF  PREV    SUCC    NUM  ONE    ALT     LIB       STORAGE
           NAME    TYPE   CAPACITY    BLKS    VALID  STATUS       VOL     VOL     REC  FILE   VOL                GROUP
 M2TP02   3490    ML2   0000124000 0000000002 001    FULL    YES  *NONE*  *NONE*  001  *NONE* *NONE* ATLL1B01  ATLSG001
 M2TP03   3490    ML2   0000124000 0000000002 001    PART    NO   *NONE*  *NONE*  001  *NONE* *NONE* ATLL1B01  ALTSG001
 ----- END OF - TAPE VOLUME TTOC   - LISTING -----

Figure 6 is a sample printer list when you have specified TAPETABLEOFCONTENTS, SELECT, and DISASTERALTERNATEVOLUMES parameter. The volumes under the heading ALT VOL are disaster alternate volumes.

Figure 6. Sample Printer List when You Specify TAPETABLEOFCONTENTS, SELECT, and DISASTERALTERNATEVOLUMES

 - DFSMSHSM CONTROL DATASET - DISATER ALTERNATE - LISTING - AT 15:05:37 ON 11/05/23 FOR SYSTEM=SYSA

 VOLSER    UNIT    VOL      REUSE     VALID   PCT    VOL    RACF  PREV    SUCC    NUM  ONE    ALT     LIB       STORAGE
           NAME    TYPE   CAPACITY    BLKS    VALID  STATUS       VOL     VOL     REC  FILE   VOL                GROUP
 M2TP02   3490    ML2   0000124000 0000000002 001    FULL    YES  *NONE*  *NONE*  001  *NONE* M2TP12 ATLL1B01  ATLSG001
 M2TP03   3490    ML2   0000124000 0000000002 001    PART    NO   *NONE*  *NONE*  001  *NONE* M2TP13 ATLL1B01  ALTSG001
 ----- END OF - DISATER ALTERNATE  - LISTING -----

Figure 7 is a sample of a printer list when you have specified TAPETABLEOFCONTENTS, SELECT, ML2 and FAILEDRECYCLE parameters.

Figure 7. Sample Printer List when You Specify TAPETABLEOFCONTENTS, SELECT, ML2 and FAILEDRECYCLE.

 - DFSMSHSM CONTROL DATASET - FAILED RECYCLE - LISTING - AT 15:05:37 ON 11/05/23 FOR SYSTEM=SYSA

 VOLSER    UNIT    VOL      REUSE     VALID   PCT    VOL    RACF  PREV    SUCC    NUM  ONE    ALT     LIB       STORAGE
           NAME    TYPE   CAPACITY    BLKS    VALID  STATUS       VOL     VOL     REC  FILE   VOL                GROUP
 M2TP03   3490    ML2   0000124000 0000000003 001    FULL    YES  *NONE*  *NONE*  001  YES    *NONE* *NO LIB*  **NO SG*
 M2TP04   3490    ML2   0000124000 0000000003 001    FULL    YES  *NONE*  *NONE*  001  YES    *NONE* *NO LIB*  **NO SG*
 BATP04   3490    ML2   0000124000 0000000003 001    FULL    YES  *NONE*  *NONE*  001  YES    *NONE* *NO LIB*  **NO SG*
 ----- END OF - FAILED RECYCLE  - LISTING -----

Figure 8 is a sample of a printer list when you have specified TAPETABLEOFCONTENTS and FAILEDCREATE parameters.

Figure 8. Sample Printer List when You Specify TAPETABLEOFCONTENTS and FAILEDCREATE

 - DFSMSHSM CONTROL DATASET - FAILED CREATE - LISTING - AT 15:05:37 ON 11/05/23 FOR SYSTEM=SYSA

 VOLSER    UNIT    VOL      REUSE     VALID   PCT    VOL    RACF  PREV    SUCC    NUM  ONE    ALT     LIB       STORAGE
           NAME    TYPE   CAPACITY    BLKS    VALID  STATUS       VOL     VOL     REC  FILE   VOL                GROUP
 BATP01   3490    D(01) 0000124000 0000000009 001    YES     NO   *NONE*  *NONE*  001  NO     *NONE* *NO LIB*  **NO SG*

 *** ARC0378I TTOC RECORD AND TAPE MEDIA CONTENTS ARE INCONSISTENT ON TAPE VOLUME BATP01 ***
 *** REUSE CAPACITY, VALID BLOCKS, PCT VALID, AND NUM REC DO NOT CONTAIN VALUES          ***
 *** CONSISTENT WITH THE TAPE MEDIA                                                      ***

 M2TP01   3480X   ML2   0000031000 0000000014 001    YES     NO   *NONE*  *NONE*  001  NO     *NONE* *NO LIB*  **NO SG*
 *** ARC0378I TTOC RECORD AND TAPE MEDIA CONTENTS ARE INCONSISTENT ON TAPE VOLUME M2PTO1 ***
 *** REUSE CAPACITY, VALID BLOCKS, PCT VALID, AND NUM REC DO NOT CONTAIN VALUES          ***
 *** CONSISTENT WITH THE TAPE MEDIA                                                      ***
 ----- END OF - FAILED CREATE  - LISTING -----

Figure 9 is a sample printer list for the EXCESSIVEVOLUMES parameter.

Figure 9. Sample Printer List when You Specify EXCESSIVEVOLUMES

 - DFSMSHSM CONTROL DATASET - EXCESSIVE VOLUMES - LISTING - AT 15:05:37 ON 11/05/23 FOR SYSTEM=SYSA

 VOLSER    UNIT    VOL      REUSE     VALID   PCT    VOL    RACF  PREV    SUCC    NUM  ONE    ALT     LIB       STORAGE
           NAME    TYPE   CAPACITY    BLKS    VALID  STATUS       VOL     VOL     REC  FILE   VOL                GROUP
 BATP01   3490    D(01) 0000124000 0000000783 001    FULL    NO   *NONE*  BATP02  001  NO     *NONE* *NO LIB*  **NO SG*
 BATP02   3490    D(01) 0000124000 0000000783 001    FULL    NO   BATP01  BATP03  001  NO     *NONE* *NO LIB*  **NO SG*
 BATP03   3490    D(01) 0000124000 0000000783 001    FULL    NO   BATP02  BATP04  001  NO     *NONE* *NO LIB*  **NO SG*
 BATP04   3490    D(01) 0000124000 0000000783 001    FULL    NO   BATP03  BATP05  001  NO     *NONE* *NO LIB*  **NO SG*
 BATP05   3490    D(01) 0000124000 0000000783 001    PART    NO   BATP04  BATP06  001  NO     *NONE* *NO LIB*  **NO SG*
 ----- END OF - EXCESSIVE VOLUMES - LISTING -----

Figure 10 is a sample printer list for the SELECT(NOTASSOCIATED) parameter.

Figure 10. Sample Printer List when You Specify SELECT(NOTASSOCIATED)

 - DFSMSHSM CONTROL DATASET - TAPE VOLUME TTOC - LISTING - AT 15:05:37 ON 11/05/23 FOR SYSTEM=SYSA

 VOLSER    UNIT    VOL      REUSE     VALID   PCT    VOL    RACF  PREV    SUCC    NUM  ONE    ALT     LIB       STORAGE
           NAME    TYPE   CAPACITY    BLKS    VALID  STATUS       VOL     VOL     REC  FILE   VOL                GROUP
 100058   3590    ML2   0002464400 0001125520 046    PART    NO   *NONE*  *NONE*  009  YES    100071 LIB01     ATLSTRGP
 100459   3590    ML2   0002464400 0000880269 036    PART    NO   100778  *NONE*  004  YES    100503 LIB01     ATLSTRGP
 100511   3590    ML2   0002464400 0001215931 050    PART    NO   101812  *NONE*  008  YES    100638 LIB01     ATLSTRGP
 100855   3590    ML2   0002464400 0002410026 098    PART    NO   *NONE*  *NONE*  022  YES    100885 LIB01     ATLSTRGP
 101916   3590    ML2   0002464400 0001856704 076    PART    NO   *NONE*  *NONE*  038  YES    101967 LIB01     ATLSTRGP
 102409   3590    ML2   0002464400 0000474331 020    PART    NO   *NONE*  *NONE*  008  YES    102490 LIB01     ATLSTRGP
 102563   3590    ML2   0002464400 0002725093 100    PART    NO   101714  *NONE*  014  YES    102620 LIB01     ATLSTRGP
 ----- END OF - TAPE VOLUME TTOC   - LISTING -----