Requesting information for dump volumes

To get a list of the information for a specific dump volume managed by DFSMShsm, specify the LIST command with the DUMPVOLUME(volser) parameter. To get a list of the information for the dump volumes of the requested status managed by DFSMShsm, specify the LIST command with the DUMPVOLUME parameter without the volume serial number and with a status parameter (AVAILABLE, UNAVAILABLE, EXPIRED, UNEXPIRED, or NORETENTIONLIMIT). The command lists the volumes in alphanumeric sequence by volume serial number.

Table 1 explains the output labels for any dump volume. These fields are listed for each dump volume and for each dump copy stacked on the volume.

Table 1. Output labels when you request information for dump volumes
Printer Output Label (OUTDATASET or SYSOUT)	Terminal Label	Description
DUMP VOLSER	DUMPVOL	This field contains the volume serial number of the dump volume.
VOL STATUS	STAT	This field contains the status of the dump volume. Possible values are: Value Meaning AVAIL An available volume is one that has been added to DFSMShsm's inventory but never used or that has been used but has since been invalidated and remains under DFSMShsm ownership. UNAVA An unavailable volume is one that has had its contents invalidated, but was not eligible to be automatically reused. EXPIR An expired volume is one that contains parts of one or more valid dump copies, and has reached or passed its expiration date. UNEXP An unexpired volume is one that contains parts of one or more valid dump copies, and has not reached its expiration date. NORET No retention limit.
UNIT TYPE	UNIT	This field contains the unit type of the dump volume.
SEQ	FILESEQ	This field contains the number of the file containing the dump copy. If the field contains "***", then the file shown is continued from another dump tape.
SOURCE VOLSER	SOURCEVOL	This field contains the volume serial number of the source for this dump copy.
SMS	SMS	This field indicates whether a volume is SMS-managed. Value Meaning Yes Identifies the volume as SMS-managed No Identifies the volume as non-SMS-managed.
CLASS	CLASS	This field contains the dump class of the dump volume.
DUMPED DATE	DUMPED DATE	This field contains the date of the dump copy.
DUMPED TIME	DUMPED TIME	This field contains the time of the dump copy.
EXP DATE	EXPDATE	This field contains the expiration date of the dump volume.
IDRC	IDRC	Value Meaning 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.
LIBRARY	LIBRARY	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.
PCT FULL	PCT FULL	This field contains the percentage of the dump volume used by all its dump copies. A value of '100' means the last dump copy spans to another volume. A value of '***' means the percentage is unknown.
SET OF DUMP VOLSERS	DUMPVOLS	This field contains a list of volume serial numbers for the tape volumes used to dump the source volume.
HWCOMPRESS	HWCOMP	This field indicates (YES or NO) whether the data was compressed before it was encrypted.
ENCRYPT	ENCRYPT	This field contains the encryption method used (RSA, KEYPASSWORD, or NONE).
ENCRYPTION TYPE	ENCTYPE	This field contains the type of encryption performed (CLRAES128, CLRTDES, or ENCTDES). This field only appears in LIST DUMPVOLUME (volser) output.
RSA KEY LABEL/ RSAKEY/KPWD	KEYPASSWORD	This field contains either the RSA key label, or the password used to encrypt the dump. This field only appears in LIST DUMPVOLUME(volser) output.

Figure 1 is a sample printer list of the specified dump volume when you specify the DUMPVOLUME(volser) parameter.

Figure 1. Sample Printer List for DUMPVOLUME(volser)

 ---- DFSMShsm CONTROL DATASET -DUMP VOLUME-BCDS--- LISTING   --- AT 16:18:44 ON 98/09/12 FOR SYSTEM=381A

DUMP   VOL    UNIT     FILE  SOURCE              DUMPED     DUMPED                           PCT   SET OF DUMP  HW  ENC
VOLSER STATUS TYPE     SEQ   VOLSER SMS CLASS    DATE       TIME     EXP DATE IDRC LIBRARY   FULL  VOLSERS      Y   RSA
A00359 UNEXP  3490                      BITON                        1998/10/12 N  STORE001   18
                       001   PRIM01 N            1998/01/14 16:17:55                               A00359 ******

	ENCTYPE 	   RSAKEY/KPWD
	CLRAES128  	CCA.CRT08.INT.ENC.1024S0F
 ----- END OF - DUMP VOLUME - LISTING -----

Figure 2 is a sample printer list for all available volumes when you specify the SELECT(AVAILABLE) parameters.

Figure 2. Sample Printer List for all Available Volumes when You Specify SELECT(AVAILABLE)

---- DFSMShsm CONTROL DATASET -DUMP VOLUME-BCDS--- LISTING      --- AT 16:18:52 ON 98/09/12 FOR SYSTEM=381A

 DUMP   VOL    UNIT     SOURCE              DUMPED      DUMPED                              PCT      SET OF DUMP
 VOLSER STATUS TYPE SEQ VOLSER SMS  CLASS   DATE        TIME     EXP DATE  IDRC  LIBRARY    FULL     VOLSERS
 A00400 AVAIL  3590  ** ****** *    BITON   **********  **:**:** *********  **   STORE001   ***
 A00423 AVAIL  3590  ** ****** *    TO3     **********  **:**:** *********  **   STORE001   ***
 A00500 AVAIL  3490  ** ****** *    T100    **********  **:**:** *********  **   *NO LIB*   ***
 A00618 AVAIL  3490  ** ****** *    T100    **********  **:**:** *********  **   *NO LIB*   ***
----- END OF - DUMP VOLUME - LISTING -----

Figure 3 is a sample printer list of all dump volumes when you specify the DUMPVOLUME parameter without (volser).

Figure 3. Sample Printer List of all Dump Volumes when You Specify DUMPVOLUME without (volser)

---- DFSMShsm CONTROL DATASET -DUMP VOLUME-BCDS--- LISTING      --- AT 16:18:52 ON 91/09/12 FOR SYSTEM=381A

DUMP   VOL    UNIT     FILE  SOURCE              DUMPED     DUMPED                           PCT  HW ENC  SET OF DUMP
VOLSER STATUS TYPE     SEQ   VOLSER SMS CLASS    DATE       TIME     EXP DATE IDRC LIBRARY   FULL         VOLSERS
A00359 UNEXP  3490                      BITON                        1998/12/31 N  STORE001   22  Y  RSA
                       001   PRIM01 N            1998/01/14 16:17:55                                      A00359 ******
                       002   SMS001 Y            1998/01/14 16:20:55                                      A00359 ******
A00100 AVAIL  3490                      BITON                        ********** N  STORE001  ***  Y  RSA
A01000 UNEXP  3590                      T01                          1998/12/31 N  STORE200  100  Y  PWD
                       001   PRIM02 N            1998/02/20 04:10:30                                      A01000 ******
                       002   SMS001 Y            1998/02/20 04:12:15                                      A01000 ******
                       003   SMS002 Y            1998/02/20 04:14:20                                      A01000 ******
                       004   SMS003 Y            1998/02/20 04:14:20                                      A01000 A01012
A01012 UNEXP  3590                      T01                          1998/12/31 N  STORE200   5   Y  PWD
                       001   SMS003 Y            1998/02/20 04:14:20                                      A01000 A01012
                       005   SMS004 Y            1998/02/20 04:16:46                                      A01012 ******


---- END OF - DUMP VOLUME - LISTING -----