You specify the LIST command with the BACKUPVOLUME parameter to get a list of the information for all the backup volumes that DFSMShsm manages. The command lists the volumes in alphanumeric sequence by volume serial number. You specify LIST BACKUPVOLUME(volser) to get a list of the information for a specific backup volume that DFSMShsm manages. Table 1 explains the output labels for any backup volume.
| Printer Output Label (OUTDATASET or SYSOUT) | Terminal Label | Description |
|---|---|---|
| VOLSER | VOL | This field contains the volume serial number of the backup volume. |
DEVICE |
DEVTYP | This field contains the name of the unit where this volume can be allocated. |
BACKUP |
BACKTYP | DAILY or SPILL indicates the DFSMShsm volume category of the backup volume. AVAIL indicates that the backup category has not been assigned and the volume is available as a daily or spill backup volume when DFSMShsm uses the volume for the first time. |
VOL |
FULL | For a DASD backup volume, a YES indicates that DFSMShsm has failed to back up a data set because the backup volume does not have enough space. For a tape backup volume, a YES indicates that while DFSMShsm is writing to the tape, the end-of-tape marker is reached or a data-movement error has occurred. The volume has been marked full to prevent further use. |
TOTAL |
TOTAL TRKS | This field contains the total track capacity of the DASD volume. This field does not apply to tape. |
FREE |
FREE TRKS | This field contains the number of tracks on the DASD volume available for data sets. This field does not apply to tape. |
| THRESH | THRESH | This field contains the threshold of occupancy for the DASD backup volume. This field does not apply to tape. |
LAST BACKUP |
LAST BACKUP DATE | This field contains the date when the volume was most recently used as a target volume for backup, spill, or recycle processing. |
| PSWD | PSWD | A YES or Y indicates that the tape volume is password protected. This field does not apply to DASD. |
| EXP | EXP | A YES or Y indicates that the tape volume is protected by an expiration date. This field does not apply to DASD. |
| RACF | RACF | A YES or Y indicates that the tape volume is RACF® protected. This field does not apply to DASD. |
| EMPTY | EMPTY | A YES or Y indicates that the tape volume is empty. This field does not apply to DASD. |
| IDRC | IDRC | Y = Volume contains data in the Improved Data Recording Capability
format.
N = Volume does not contain data in the Improved Data Recording Capability format. ** = Volume is empty—not assigned the Improved Data Recording Capability format. |
| DUPLEX ALT | DUPLEX ALT | volser indicates the volume serial number of the duplexed
alternate
*PEND* indicates that an exception condition and an internal TAPECOPY is pending *NONE* indicates that the volume was not created in a duplexing environment NA indicates that the original volumes are DASD rather than tape |
PCT |
PCT FULL | This field contains the percentage of the backup volume used for a tape written using 3590 architecture. A value of **** means the percentage is unknown. |
Figure 1 is a sample printer list of all the backup volumes when you specify the BACKUPVOLUME parameter. If you requested information for only one volume, the list has only one entry.
1- DFSMSHSM CONTROL DATASET - BACKUP VOLUME-- LISTING ----- AT 10:55:46 ON 01/04/03 FOR SYSTEM=3090
VOLSER DEVICE BACKUP VOL TOTAL FREE THRESH LAST BACKUP PSWD EXP RACF EMPTY IDRC DUPLEX PCT
TYPE TYPE FULL TRACKS TRACKS DATE ALT FULL
A00002 3480 DAILY NO ******** ******** *** 00/09/05 YES NO NO NO N *NONE* ****
A00017 3480 DAILY YES ******** ******** *** 00/08/25 YES NO NO NO N *NONE* ****
A00018 3480 DAILY NO ******** ******** *** 00/10/31 YES NO NO NO N *NONE* ****
BACK01 3390 DAILY NO 00000150 00000021 090 01/04/02 *** *** *** *** NA NA NA
BACK02 3390 DAILY NO 00000150 00000023 090 01/04/03 *** *** *** *** NA NA NA
BACK03 3390 SPILL NO 00000150 ******** 090 00/00/00 *** *** *** *** NA NA NA
----- END OF - BACKUP VOLUME - LISTING -----