VERIFY output

The output of the VERIFY function is written to the RPTVERFY DD.

If you do not specify the RPTVERFY DD in the JCL, it is dynamically allocated to SYSOUT=*. Report output can be written to SYSOUT or to a data set. The characteristics of the output are RECFM=FBA,LRECL=133. Report output can also be written to the IMS Tools Knowledge Base by specifying the REPORT(ITKBOUT(YES)) keyword and parameter.

The default is REPORT(ITKBOUT(YES)).

The Verify Asset report consists of three main report sections. The following figure shows the sections of the Verify Asset report.

Figure 1. Example of an IMS Database Recovery Facility Extended Functions Verify Asset report
IMS DATABASE FACILITY EXTENDED FUNCTIONS V2.1.0 (5655-V86)                                  
IMS DATABASE FACILITY EXTENDED FUNCTIONS VERIFY ASSETS REPORT        Run Time:  11/19/2021 14:35
                                                                       
                                                                       
                                                                       
*******************************************************************************
 -> Invocation Parameters                                                       
 *******************************************************************************
                                                                                
 PROCESS : VERIFY(OPEN)         TYPE    : TSR                                   
 SOURCE  : PRI                  RCVTIME : 2021.323 14:01:01.100000 -08:00       
                                                                                
                                                                                
                                                                                
 *******************************************************************************
 -> Summary Report                                                              
 *******************************************************************************
                                                                                
                                                                                
Database Name  DD/Area Name   DSID  Data Set Type    Status                    
-------------------------------------------------------------------------------
F2O2P1         F2O2P11         0    Full Function    No errors encountered     
F2O2P1         F2O2P12         0    Full Function    No errors encountered     
                                                                               
                                                                               
                                                                               
*******************************************************************************
-> Data Set I/O Report                                                         
*******************************************************************************
                                                                               
 Recover to point: 2021.323 14:01:01.100000 -08:00  
                           
                                            Volume  IC        Status of        
Image Copy Data Set Name                    Serial  Type      Allocate/Open    
-------------------------------------------------------------------------------
IMSTOOL.IMSRE.QA.Q91A.F2O2P1.F2O2P11.IC1    IMT203  STD       OPEN RC  =   0   
IMSTOOL.IMSRE.QA.Q91A.F2O2P1.F2O2P12.IC1    IMT187  STD       OPEN RC  =   0   
                                                                               
                                            Volume            Status of        
Change Accum Data Set Name                  Serial            Allocate/Open    
-------------------------------------------------------------------------------
                                                                               
TEMP.IMSRE.QA.CAF2O2P1.D21323.T125904       IMSTL4            OPEN RC  =   0   
                                                                               

                                            Volume  IMS       Status of
Log Data Set Name                           Serial  SYSID     Allocate/Open
-------------------------------------------------------------------------------
                                                                       
TEMP.V00FF02E.IEFRDER4                      IMT178  V00FF02E  OPEN RC =    0 
  Prilog: 2021.323 13:01:25.4                                   

The major report sections are described here:

Invocation Parameters
This section of the report shows the options that VERIFY used for its processing.
PROCESS
This field indicates what kind of verification is done on the assets (LIST, ALLOC, or OPEN).
SOURCE
This field displays whether to verify primary or secondary image copy records. In the last report sample, the primary image copies are verified.
RCVTIME
This field displays the recovery time during which you want to verify assets for this recovery.
TYPE
This field is the type of recovery, either TSR or PITR, that is requested.
Summary Report
This section of the report displays the databases that were selected for verification and the overall status of each database and DD name. The following list describes the column fields that are displayed:
Database Name
This column specifies the database name.
DD/Area Name
This column specifies the area name for fast path databases or the partition name for HALDB databases. This column is blank for full function databases.
DSID
This column specifies the data set identification number that is associated with this DD or AREA name.
Data Set Type
This column specifies the type of database: full-function, Fast Path, or HALDB.
Status
This column specifies the overall status of all of the assets that were verified.
Data Set I/O Report
This section of the report displays the individual status of each asset that has been processed by VERIFY. It begins by showing the Recover-To Point, which is the value that you specified on the VERIFY keyword. This report consists of three sections. Each section shows a different type of recovery asset:
  • Image copy data sets
  • Change accumulation data sets
  • Log data sets
Image Copy Data Sets
Image Copy Data Set Name
This column specifies the name of the image copy data set for each database data set that was verified.
Volume Serial
This column specifies the volume serial number of the image copy data set for each database data set that was verified.
IC Type
This column specifies the type of image copy for each database data set that was verified. Valid values for this field are shown in the following table:
Table 1. Valid values for IC Type in the Verify Asset report
IC Type listed Meaning
STD Standard Image Copy
IC2 Image Copy 2
IC EXT Extended Image Copy
HISAM UNL HISAM Unload
SLB-CIC-O * The System Level Backup is concurrent and is offloaded to a sequential device. For the ALLOC or OPEN process, the offload data set names are the ones operated and reported on; not the data set name in the RECON IC record.
SLB-CIC-F * The System Level Backup is concurrent and is on a fast-replication capable volume.
SLB-BAT-O * The System Level Backup is batch and is offloaded to a sequential device. For the ALLOC or OPEN process, the offload data set names are the ones operated and reported on; not the data set name in the RECON IC record.
SLB-BAT-F * The System Level Backup is batch and is on a fast-replication capable volume.
SLB-RECON * This IC type indicates that the data set name on the report is symbolic only and represents the fact that a RECON IC record exists for the SLB. Because this data set name is symbolic only, it cannot be allocated or opened. This data set name is always displayed for VERIFY(LIST).
Note: * If IMS Recovery Expert is available and USESLBIC(YES) is specified, the VERIFY function causes IMS Recovery Expert to write an image copy record to the RECON which represents the System Level Backup. The image copy record receives a data set name in the form of SLB.Ixxxx.Dxxxx.dbdname.ddname, and this image copy record is used during VERIFY function processing.

If there is already an image copy record for the System Level Backup, or if no System Level Backup is available relative to the specified RCVTIME parameter, no image copy record is written to the RECON.

If USESLBIC(Y) is set, and either VERIFY(ALLOC) or VERIFY(OPEN) is specified, and the SLB has been offloaded from the fast-replication device, then the offload data sets display if they exist.

Status of Allocate/Open
This column displays the return code from the ALLOC or OPEN process. If the process was successful, the return code is zero.
Change Accumulation Data Sets
Change Accum Data Set Name
This column specifies the name of the change accumulation data set for each database data set that was verified.
Volume Serial
This column specifies the volume serial number of the change accumulation data set for each database data set that was verified.
Status of Allocate/Open
This column shows the return code from the ALLOC or OPEN process. If the process was successful, the return code will be zero.
Log Data Sets
Log Data Set Name
This column specifies the name of the log data set for each database data set that was verified.
Volume Serial
This column specifies the volume serial number of the log data set for each database data set that was verified.
IMS SYSID
This column shows the SYSID that is associated with the IMS that created the log.
Status of Allocate/Open
This column shows the return code from the ALLOC or OPEN process. If the process was successful, the return code is zero.