Requesting data set information from the BCDS

Table 1 explains the output labels for a list of all data sets, all data sets that have the same first qualifier, a specific data set, or list of any copy pools that a volume is a part of.

Table 1. Output labels when you request data set information from the BCDS
Printer Output Label (OUTDATASET or SYSOUT) Terminal Label Description
DSNAME DSN This field indicates the data set name of the data set that was backed up.
BACKUP FREQ BACK FREQ This field indicates the number of days that must elapse after DFSMShsm backs up a data set before DFSMShsm can automatically back up the data set again. "***" indicates that the data set is SMS-managed.
MAX ACTIVE BACKUP VERSIONS MAX VERS This field indicates the maximum number of backup versions of the data set that DFSMShsm is to keep. If more than one data set has backup versions with the same data set name, DFSMShsm can list more than the maximum number of backup versions. "**" indicates that the data set is SMS-managed.
BACKUP VERSION DATA SET NAME BDSN This field indicates the data set name of the backup version.

BACKUP
VOLUME

 BACKVOL This field indicates the volume serial number of the volume the backup version is on. The volume can be a backup volume or a migration level 1 volume.

FROM
VOLUME

 FRVOL This field indicates the volume serial number of the primary volume where the data set is when DFSMShsm makes the backup version. If the data set is migrated at the time of backup, this field contains the volume serial number of the primary volume from which the data set migrates.

BACKUP
DATE

 BACKDATE This field indicates the date the backup version was created.

BACKUP
TIME

 BACKTIME This field indicates the time the backup version was created.

SYS
CAT

 CAT This field indicates (YES or NO) that the backup version was made from a cataloged data set.

GEN
NMBR

 GEN This field indicates the generation number of the backup version. The most recent backup version is 0, the next most recent is 1, and so forth. "***" indicates that the version is a retained backup copy.

VER
NMBR

 VER This field indicates the version number of the backup version. This is an absolute number that uniquely identifies this backup version during its life span. The numbering begins at 1 for the first backup version of the data set. "***" indicates that the version is a retained backup copy.

UNS/
RET

 UNS/RET This field indicates special or exception conditions.
Value
Meaning
UNS
indicates that the data set was unserialized when backed up.
RET
indicates that the version listed is a retired version.
U/R
indicates an unserialized, retired version.
NO
indicates a version that is neither unserialized nor retired.

RET
DAYS

RETDAYS This field indicates the RETAINDAYS keyword was active at the time of the backup. The value represents the minimum number of days that DFSMShsm maintains the backup copy. "*****" indicates that RETAINDAYS was not specified.
  RACF IND This field indicates (YES or NO) if the RACF® indicator was on at the time of backup.
Note: The RACF IND field is displayed only when the output destination is TERMINAL.

BACKUP
PROF

 BACK PROF This field indicates (YES or NO) if a RACF discrete backup profile exists.

NEW
NAME

   This field consists of three single-character placeholders. The single-character placeholders are explained:
First character
indicates (Y or N) if NEWNAME was specified at the time of backup.
Second character
The values of the second character are:
Y
indicates the data set is a VSAM data set with an associated AIX/PATH and with SPHERE(NO) specified.
N
indicates the data set is a VSAM data set with an associated AIX/PATH and without SPHERE(NO) specified.
*
indicates the data set is a non-VSAM or VSAM data set with no associated AIX/PATH.
Third character
The values of the second character are:
Y
indicates the data set is a VSAM data set, is uncataloged or migrated, and the backup was processed with the GVCN(YES) option.
N
indicates the data set is a VSAM data set, is uncataloged or migrated, and the backup was processed with the GVCN(NO) option.
*
indicates the data set is a non-VSAM or VSAM data set and is cataloged, but not migrated.
Note: The NEWNAME field is displayed only when the output destination is OUTDATASET or SYSOUT.
  NEWNM This field indicates (YES or NO) if NEWNAME was specified at the time of backup.
Note: The NEWNM field is displayed only when the output destination is TERMINAL.
  NOSPH This field indicates:
Value
Meaning
YES
if the data set is a VSAM data set with an associated AIX/PATH and with SPHERE(NO) specified.
NO
if the data set is a VSAM data set with an associated AIX/PATH and without SPHERE(NO) specified.
***
if the data set is a non-VSAM or VSAM data set with no associated AIX/PATH.
Note: The NOSPH field is displayed only when the output destination is TERMINAL.
  GVCN This field indicates:
Value
Meaning
YES
if the data set is a VSAM data set, is uncataloged or migrated, and the backup was processed with the GVCN(YES) option.
NO
if the data set is a VSAM data set, is uncataloged or migrated, and the backup was processed with the GVCN(NO) option.
***
if the data set is a non-VSAM or VSAM data set and is cataloged, but not migrated.
Note: The GVCN field is displayed only when the output destination is TERMINAL.
TOTAL BACKUP VERSIONS TOTAL BACKUP VERSIONS This field indicates the total number of data set backup versions.
Figure 1 is sample printer list output of information for a specific data set when you issue the LIST DATASETNAME(dsname) BACKUPCONTROLDATASET command. If you do not specify a data set name, the list will contain information for all data sets.
Figure 1. Sample Printer List Output for the LIST DATASETNAME(dsname) BACKUPCONTROLDATASET Command
- DFSMSHSM CONTROL DATASET - BACKUP DATASET-- LISTING ----- AT 14:32:30 ON 10/02/25 FOR SYSTEM=3090             
                                                                                                                
                                                                                                                
DSNAME = OAYYYYY.SAM.S.DS1                             BACKUP FREQ = 000, MAX ACTIVE BACKUP VERSIONS = 002      
                                                                                                                
BACKUP VERSION DATA SET NAME                 BACKUP FROM   BACKUP   BACKUP   SYS GEN  VER  UNS/ RET  BACKUP NEW 
                                             VOLUME VOLUME DATE     TIME     CAT NMBR NMBR RET  DAYS PROF   NAME
                                                                                                                
DFHSM.BACK.T312914.OAYYYYY.SAM.A0056         A07335 PRIM01 10/02/25 14:29:31 YES 000  002   NO 00200 NO     N** 
DFHSM.BACK.T142814.OAYYYYY.SAM.A0056         A07335 PRIM01 10/02/25 14:28:14 YES 001  001   NO ***** NO     N** 
                                                                                                                
TOTAL BACKUP VERSIONS = 0000000002                                                                              
                                                                                                                
                                                                                                                
----- END OF - BACKUP DATASET - LISTING -----
Figure 2 is sample terminal output of information for a specific data set when you issue the LIST DATASETNAME(dsname) BACKUPCONTROLDATASET command.
Figure 2. Sample Terminal Output for the LIST DATASETNAME(dsname) BACKUPCONTROLDATASET Command
DSN=OAYYYYY.SAM.S.DS1                             BACK FREQ = 000  MAX 
ACTIVE BACKUP VERSIONS = 002                                           
                                                                       
 BDSN=DFHSM.BACK.T312914.OAYYYYY.SAM.A0056        BACKVOL=A07335       
FRVOL=PRIM01                                                           
 BACKDATE=10/02/25  BACKTIME=14:29:31  CAT=YES  GEN=000  VER=002       
UNS/RET= NO                                                            
 RACF IND=NO  BACK PROF=NO  NEWNM=NO  NOSPH=*** GVCN=*** RETDAYS=00200 
                                                                       
 BDSN=DFHSM.BACK.T142814.OAYYYYY.SAM.A0056        BACKVOL=A07335       
FRVOL=PRIM01                                                           
 BACKDATE=10/02/25  BACKTIME=14:28:14  CAT=YES  GEN=001  VER=001       
UNS/RET= NO                                                            
 RACF IND=NO  BACK PROF=NO  NEWNM=NO  NOSPH=*** GVCN=*** RETDAYS=***** 
                                                                       
TOTAL BACKUP VERSIONS = 0000000002
Figure 3 is sample printer list output for all data sets with the same first qualifier when you issue the LIST LEVEL(qualifier) BACKUPCONTROLDATASET command.
Figure 3. Sample Printer List Output for the LIST LEVEL(qualifier) BACKUPCONTROLDATASET Command
- DFSMSHSM CONTROL DATASET - BACKUP DATASET-- LISTING ----- AT 14:43:34 ON 10/02/25 FOR SYSTEM=3090             
                                                                                                                
                                                                                                                
DSNAME = OAYYYYY.SAM.S.DS1                             BACKUP FREQ = 000, MAX ACTIVE BACKUP VERSIONS = 002      
                                                                                                                
BACKUP VERSION DATA SET NAME                 BACKUP FROM   BACKUP   BACKUP   SYS GEN  VER  UNS/ RET  BACKUP NEW 
                                             VOLUME VOLUME DATE     TIME     CAT NMBR NMBR RET  DAYS PROF   NAME
                                                                                                                
DFHSM.BACK.T312914.OAYYYYY.SAM.A0056         A07335 PRIM01 10/02/25 14:29:31 YES 000  002   NO 00200 NO     N** 
DFHSM.BACK.T142814.OAYYYYY.SAM.A0056         A07335 PRIM01 10/02/25 14:28:14 YES 001  001   NO ***** NO     N** 
                                                                                                                
TOTAL BACKUP VERSIONS = 0000000002                                                                              
                                                                                                                
                                                                                                                
DSNAME = OAYYYYY.SAM.S.DS2                             BACKUP FREQ = 000, MAX ACTIVE BACKUP VERSIONS = 002      
                                                                                                                
BACKUP VERSION DATA SET NAME                 BACKUP FROM   BACKUP   BACKUP   SYS GEN  VER  UNS/ RET  BACKUP NEW 
                                             VOLUME VOLUME DATE     TIME     CAT NMBR NMBR RET  DAYS PROF   NAME
                                                                                                                
DFHSM.BACK.T143014.OAYYYYY.SAM.A0056         A07335 PRIM01 10/02/25 14:30:14 YES 000  001   NO 00200 NO     N** 
                                                                                                                
TOTAL BACKUP VERSIONS = 0000000001                                                                              
                                                                                                                
                                                                                                                
DSNAME = OAYYYYY.SAM.S.DS3                             BACKUP FREQ = 000, MAX ACTIVE BACKUP VERSIONS = 002      
                                                                                                                
BACKUP VERSION DATA SET NAME                 BACKUP FROM   BACKUP   BACKUP   SYS GEN  VER  UNS/ RET  BACKUP NEW 
                                             VOLUME VOLUME DATE     TIME     CAT NMBR NMBR RET  DAYS PROF   NAME
                                                                                                                
DFHSM.BACK.T403014.OAYYYYY.SAM.A0056         A07335 PRIM01 10/02/25 14:30:40 YES 000  001   NO 00100 NO     N** 
                                                                                                                
TOTAL BACKUP VERSIONS = 0000000001                                                                              
                                                                                                                
                                                                                                                
----- END OF - BACKUP DATASET - LISTING -----
Figure 4 is sample terminal output for all data sets with the same first qualifier when you issue the LIST LEVEL(qualifier) BACKUPCONTROLDATASET command.
Figure 4. Sample Terminal Output for the LIST LEVEL(qualifier) BACKUPCONTROLDATASET Command
DSN=OAYYYYY.SAM.S.DS1                             BACK FREQ = 000  MAX 
ACTIVE BACKUP VERSIONS = 002                                           
                                                                       
 BDSN=DFHSM.BACK.T312914.OAYYYYY.SAM.A0056        BACKVOL=A07335       
FRVOL=PRIM01                                                           
 BACKDATE=10/02/25  BACKTIME=14:29:31  CAT=YES  GEN=000  VER=002       
UNS/RET= NO                                                            
 RACF IND=NO  BACK PROF=NO  NEWNM=NO  NOSPH=*** GVCN=*** RETDAYS=00200 
                                                                       
 BDSN=DFHSM.BACK.T142814.OAYYYYY.SAM.A0056        BACKVOL=A07335       
FRVOL=PRIM01                                                           
 BACKDATE=10/02/25  BACKTIME=14:28:14  CAT=YES  GEN=001  VER=001       
UNS/RET= NO                                                            
 RACF IND=NO  BACK PROF=NO  NEWNM=NO  NOSPH=*** GVCN=*** RETDAYS=***** 
                                                                       
TOTAL BACKUP VERSIONS = 0000000002                                     
                                                                       
                                                                       
DSN=OAYYYYY.SAM.S.DS2                             BACK FREQ = 000  MAX 
ACTIVE BACKUP VERSIONS = 002                                           
                                                                       
 BDSN=DFHSM.BACK.T143014.OAYYYYY.SAM.A0056        BACKVOL=A07335       
FRVOL=PRIM01                                                           
 BACKDATE=10/02/25  BACKTIME=14:30:14  CAT=YES  GEN=000  VER=001       
UNS/RET= NO                                                            
 RACF IND=NO  BACK PROF=NO  NEWNM=NO  NOSPH=*** GVCN=*** RETDAYS=00200 
                                                                       
TOTAL BACKUP VERSIONS = 0000000001                                     
                                                                       
                                                                       
DSN=OAYYYYY.SAM.S.DS3                             BACK FREQ = 000  MAX 
ACTIVE BACKUP VERSIONS = 002                                           
                                                                       
 BDSN=DFHSM.BACK.T403014.OAYYYYY.SAM.A0056        BACKVOL=A07335       
FRVOL=PRIM01                                                           
 BACKDATE=10/02/25  BACKTIME=14:30:40  CAT=YES  GEN=000  VER=001       
UNS/RET= NO                                                            
 RACF IND=NO  BACK PROF=NO  NEWNM=NO  NOSPH=*** GVCN=*** RETDAYS=00100 
                                                                       
TOTAL BACKUP VERSIONS = 0000000001
Parent topic: Requesting information for data sets