Obtaining copy pool information

You can obtain information about all copy pool fast replication backup versions by using the following command:

LIST COPYPOOL

This request provides version information for each copy pool that has at least one attempted backup. The list of source and target volume pairs is not included as part of this list request. The list output consists of the following information:

• Copy pool name
• Version number
• Valid or invalid
• VTOCENQ
• Token
• Backup date and time
• Dump, DASD copy, or both

You can obtain information about a specific copy pool by using the following command:

LIST COPYPOOL(cpname)

This request provides detailed version information for each valid or invalid backup version for the specified copy pool. The date and time fields are zero when the PREPARE subparameter is used with the FRBACKUP command. The list output consists of the following information:

• Copy pool name
• Version number
• Valid or invalid
• VTOCENQ
• Token
• Backup date and time (for Prepare versions these fields display a value of zero)
• Source and target volume pairs
• File sequence number
• Dump data set name
• Dump class availability
• Tape device type

You can use keywords FRVOLS, NOVOLS, DUMPVOLS, or ALLVOLS to specify what type of volume information is to be displayed.

• The FASTREPLICATIONVOLS keyword, the default value, indicates that the source/target pairs should be listed.
• The NOVOLS keyword doesn't list any volume pairs data, but lists the dump class information if there is a dump copy version.
• The DUMPVOLS keyword indicates that source and dump volser data for all dump versions should be listed.
• The ALLVOLS keyword indicates all volume pairs should be listed.

  The GENERATION(gennum) keyword only applies to a situation when the ALLVOLS keyword is specified. The default (GENERATION(gen0)) indicates that the most recent DASD and dump versions are to be listed. The gennum parameter is required, it means only the indicated generation should be listed. ALLVERS indicates that all DASD and dump versions are to be listed. TOKEN(token) refers to a version.

FRSTATE indicates information that is wanted based on the FRBACKUP DASD copy.

• RECOVERABLE indicates that the copy pool volumes can be recovered from the DASD version.
• NONRECOVERABLE indicates that the copy pool volumes cannot be recovered from the DASD version.
• FAILED indicates that the DASD version is NONRECOVERABLE due to a failure during the FRBACKUP or WITHDRAW was done before all volumes in the copy pool were successfully copied
• NONE indicates that a DASD copy does not exist.

DUMPSTATE indicates information that is wanted based on the FRBACKUP DUMP.

• ALLCOMPLETE indicates that all volumes have been successfully dumped to all dump classes specified.
• REQUIREDCOMPLETE indicates that all volumes have been successfully dumped to at least all REQUIRED dump classes.
• PARTIAL indicates that some volumes of a copy pool have been successfully dumped.
• NONE indicates that no dumps are associated with the copy pool.

You can obtain information of volume pairs of all copy pool volumes that are recoverable from the DASD version by using the following command:

LIST CP(CPA) ALLVOLS(ALLVERS) SELECT(FRSTATE(REC)) ODS(LIST.CPA)

You can obtain information about the volumes contained in a specific copy pool backup storage group by using the following command:

LIST COPYPOOLBACKUPSTORAGEGROUP(cpbsgname)

This request provides a list of each volume in the copy pool backup storage group that DFSMShsm has selected as a target volume. Volumes that are defined to the storage group that are not listed have not been selected as target volumes. In addition, the name of the source volume that each target volume is a target for will be listed.

You can obtain information about which copy pool a volume is associated with by using the following command:

LIST PRIMARYVOLUME BCDS

This request provides information about the copy pools that a primary volume is associated with. Specify either the BCDS or BOTH parameter for this request to process correctly. Use the LIST COPYPOOL(cpname) command to determine which target volumes are associated with a particular source volume.

You can obtain information about which copy pools the volume is associated with by using the following command:

LIST PVOL BCDS

When you use the PVOL parameter, with either the BCDS or BOTH subparameters, DFSMShsm returns information about which copy pools the volume is associated with. With ALLDUMPS or BCDS subparameters, should also consider copy pool dumps. Copy pool dumps versions should include the name of the source copy pool. If the volume is in a copy pool, associated information needs to be displayed. Target volumes of a copy pool source/target pair do not display information. To determine which target volumes are associated with a particular source volume, you can use the LIST COPYPOOL(cpname) command.

You can obtain information about whether the volume resides in a copy pool by using the following command:

LIST DVOL

You can obtain information about whether the dump class associated with the copy pool is required or optional by using the following command:

LIST DUMPCLASS

You can obtain information about the host holding a copy pool resource by using the following command:

LIST HOST

When you use the HOST parameter, DFSMShsm lists the host holding a copy pool resource. If subparameter RESET is specified, DFSMShsm resets associated serialization fields.