Requesting information for copy pools

You specify the LIST command with the COPYPOOL parameter to get a list of information for each version of each copy pool that has at least one fast replication backup version. The command lists the copy pools in alphanumeric sequence by copy pool name. You specify LIST COPYPOOL(cpname) to get a list of the detailed information for each version of the specified copy pool. The information includes source volume to target volume pairings. Table 1 explains the output labels for copy pools.

Table 1. Output labels when you request information for copy pools
Printer Output Label (OUTDATASET or SYSOUT) Terminal Label Description
CATINFO CATINFO This field indicates whether data set catalog information was captured for this version.

CATINFO=Y/N/P (YES/NO/PARTIAL)

COPYPOOL COPYPOOL This field contains the copy pool name.
*DATA SET NAME Not Supported Data sets backed up in this copy pool version.
DATE DATE This field contains the creation date of the copy pool version.
DCLASS DCLASS This fields contains the changes to existing output formatting.
DUMPCLASS DUMPCLASS This field indicates if the dump class associated with the copy pool is required or optional.
DUMPSTATE DUMPSTATE This field indicates the dump state of volumes in the copy pool.
FASTREPLICATIONSTATE FASTREPLICATIONSTATE This field indicates the fast replication state of the copy pool.
FCFRR FCFRR This field indicates whether the copy is defined allowing fast reverse restore (FCFRR=Y) or not (FCFRR=N).
INCREMENTAL INCREMENTAL This field indicates whether the corresponding version is an Incremental version.
RECOVERYINCOMPLETE RECOVERYINCOMPLETE This field indicates whether the copy pool version was recovered completely.
*SGNAME SGNAME This field contains the storage group name.
*SOURCE SOURCE This field lists source volumes in the storage group.
*TARGET TARGET This field lists target volumes in the storage group.
TIME TIME This field contains the creation time of the copy pool version.
TOKEN (C) TOKEN (C) This field contains the token in alphanumeric format.
TOKEN (H) TOKEN (H) This field contains the token in hexadecimal format.
TOTAL NUM OF VOLUMES TOTAL NUM OF VOLUMES This field lists the total number of volumes backed up for this copy pool version.
VERSION VERSION This field contains the copy pool version number.
VALID VALID This field indicates whether the copy pool version is valid, as follows:
Value
Meaning
Y
Indicates that the copy pool version contains a valid DASD backup copy.
N
Indicates that the copy pool version does not contain a valid DASD backup copy.
*
Indicates that the copy pool version is in a state defined in a z/OS® V1R8 or later environment, and thus, cannot be used for recovery on this host system.
VTOCENQ VTOCENQ This field indicates whether DFSMShsm serialized on the VTOCs of the volumes that were processed.
*Appears only if you specify COPYPOOL(cpname).

Figure 1 is a sample printer list of all the copy pools when you specify the COPYPOOL parameter.

Figure 1. Sample Printer List of All the Copy Pools when You Specify COPYPOOL
-- DFSMShsm CONTROL DATASET --COPY POOL--LISTING --------- AT 00:56:24 ON 09/10/12 FOR SYSTEM=1234

COPYPOOL=CP1                                                                                      
ALLOWPPRCP FRB=PN FRR=PN                                                                          

VERSION  VTOCENQ     DATE           TIME     FASTREPLICATIONSTATE  DUMPSTATE                      
  002      Y      2009/10/12      00:44:36   RECOVERABLE           ALLCOMPLETE                    
TOKEN(C)=C''                                                                                      
TOKEN(H)=X''                                                                                      
TOTAL NUM OF VOLUMES=00002,INCREMENTAL=N,CATINFO=N,FCFRR=Y,RECOVERYINCOMPLETE=N                   

VERSION  VTOCENQ     DATE           TIME     FASTREPLICATIONSTATE  DUMPSTATE                      
  001      Y      2009/10/12      00:20:17   RECOVERABLE           ALLCOMPLETE                    
TOKEN(C)=C''                                                                                      
TOKEN(H)=X''                                                                                      
TOTAL NUM OF VOLUMES=00002,INCREMENTAL=N,CATINFO=N,FCFRR=Y,RECOVERYINCOMPLETE=N                   

COPYPOOL=CP2                                                                                      
ALLOWPPRCP FRB=NO FRR=NO                                                                          

VERSION  VTOCENQ     DATE           TIME     FASTREPLICATIONSTATE  DUMPSTATE                      
  001      Y      2009/10/12      00:54:13   RECOVERABLE           NONE                           
TOKEN(C)=C''                                                                                      
TOKEN(H)=X''                                                                                      
TOTAL NUM OF VOLUMES=00002,INCREMENTAL=N,CATINFO=N,FCFRR=Y,RECOVERYINCOMPLETE=N                   

COPYPOOL=CP4                                                                                      
ALLOWPPRCP FRB=NO FRR=NO                                                                          

VERSION  VTOCENQ     DATE           TIME     FASTREPLICATIONSTATE  DUMPSTATE                      
  001      Y      2009/10/12      00:55:08   RECOVERABLE           NONE                           
TOKEN(C)=C''                                                                                      
TOKEN(H)=X''                                                                                      
TOTAL NUM OF VOLUMES=00002,INCREMENTAL=N,CATINFO=N,FCFRR=Y,RECOVERYINCOMPLETE=N                   

----- END OF -- COPY POOL -- LISTING ----- 

Figure 2 is a sample printer list of a specific copy pool when you specify the COPYPOOL(cpname) parameter.

Figure 2. Sample Printer List of a Specific Copy Pool when You Specify COPYPOOL(cpname)
-- DFSMShsm CONTROL DATASET --COPY POOL--LISTING --------- AT 01:05:02 ON 09/10/12 FOR SYSTEM=1234      
                                                                                                        
COPYPOOL=CP1                                                                                            
ALLOWPPRCP FRB=PN FRR=PN                                                                                
                                                                                                        
VERSION  VTOCENQ     DATE           TIME     FASTREPLICATIONSTATE  DUMPSTATE                            
  002      Y      2009/10/12      00:44:36   RECOVERABLE           ALLCOMPLETE                          
TOKEN(C)=C''                                                                                            
TOKEN(H)=X''                                                                                            
TOTAL NUM OF VOLUMES=00002,INCREMENTAL=N,CATINFO=N,FCFRR=Y,RECOVERYINCOMPLETE=N                         
                                                                                                        
SGNAME   SOURCE - TARGET  SOURCE - TARGET  SOURCE - TARGET  SOURCE - TARGET                             
SGRP1    SRC01B - TGT03B  SRC02B - TGT04B                                                               
                                                                                                        
DUMPCLASS   REQUIRED   DUMPSTATE   VOLSSUC     EXPDATE    AVAILABLE                                     
DCL1           Y       COMPLETE     00002     2009/11/11      Y                                         
                                                                                                        
            HWCOMP  ENCRYPT  ENCTYPE    RSAKEY/KPWD                                                     
            NO      NONE     *********  ****************************************************************
                                                                                                        
SOURCE   DUMPVOLS                                           DEVICE TYPE                                 
SRC01B   A00732                                               3490                                      
FILE SEQ=001, DSNAME=DFHSM.DMP.DCL1.VSRC01B.D09285.T364400                                               
SRC02B   A00733                                               3490                                      
FILE SEQ=001, DSNAME=DFHSM.DMP.DCL1.VSRC02B.D09285.T364400                                               
                                                                                                        
VERSION  VTOCENQ     DATE           TIME     FASTREPLICATIONSTATE  DUMPSTATE                            
  001      Y      2009/10/12      00:20:17   RECOVERABLE           ALLCOMPLETE                          
TOKEN(C)=C''                                                                                            
TOKEN(H)=X''                                                                                            
TOTAL NUM OF VOLUMES=00002,INCREMENTAL=N,CATINFO=N,FCFRR=Y,RECOVERYINCOMPLETE=N                         
                                                                                                        
SGNAME   SOURCE - TARGET  SOURCE - TARGET  SOURCE - TARGET  SOURCE - TARGET                             
SGRP1    SRC01B - TGT01B  SRC02B - TGT02B                                                               
                                                                                                        
DUMPCLASS   REQUIRED   DUMPSTATE   VOLSSUC     EXPDATE    AVAILABLE                                     
DCL1           Y       COMPLETE     00002     2009/11/11      Y                                         
                                                                                                        
            HWCOMP  ENCRYPT  ENCTYPE    RSAKEY/KPWD                                                     
            NO      NONE     *********  ****************************************************************
                                                                                                        
SOURCE   DUMPVOLS                                           DEVICE TYPE                                 
SRC01B   A00730                                               3490                                      
FILE SEQ=001, DSNAME=DFHSM.DMP.DCL1.VSRC01B.D09285.T172000                                               
SRC02B   A00731                                               3490                                      
FILE SEQ=001, DSNAME=DFHSM.DMP.DCL1.VSRC02B.D09285.T172000                                               
                                                                                                        
----- END OF -- COPY POOL -- LISTING -----                   

Figure 3 shows a sample output for the LIST command with DATASETS option. You can use this command to find data sets that were backed up but have been deleted. Data sets are listed in alphabetical order by catalog.

Figure 3. Sample Output for the LIST COPYPOOL(cpname) DATASETS command
 -- DFSMShsm CONTROL DATA SET -- COPY POOL -- LISTING -- AT 13:36:18 ON 09/03/23 FOR SYSTEM=3090                         
                                                                                                                         
 COPYPOOL=CP1                           ,VER=001,GEN=000,CATINFO=Y                                                       
 CATALOG INFORMATION DATA SET NAME=DFHSM.HSMCIDS.D09082.T103126.C001                                                     
 TKN(C)=C''                                                                                                              
 TKN(H)=X''                                                                                                              
                                                                                                                         
 CATALOG NAME = CPOOL1Z.USERCAT                                                                                          
                                                                                                                         
 DATA SET NAME                                                                                                           
 CPOOL1.FRE.N01.KSDS                                                                                                     
 CPOOL1.FRE.N02.ESDS                                                                                                     
 CPOOL1.FRE.N03.RRDS                                                                                                     
 CPOOL1.FRE.N04.PSFB                                                                                                     
 CPOOL1.FRE.N05.POFB                                                                                                     
 CPOOL1.FRE.N07.POU                                                                                                      
 CPOOL1.FRE.N08.DAF                                                                                                      
 CPOOL1.FRE.N09.DAU                                                                                                      
                                                                                                                         
                                                                                                                         
 TOTAL NUMBER OF DATA SETS =          8