Example report: Image copy or incremental image copy output

The report example shows the image copy or incremental image copy output.

D A T A B A S E   R E C O V E R Y   F A C I L I T Y   C O M M A N D S / C O N T R O L   S T A T E M E N T S

FRD7201I   DBDSL101(DISP(NEW))
FRD7201I   OUTPUT(ICR)
FRD7201I   REPORT(RPTTYPE=SEP,DRFUNIT=SYSDA,DRFHLQ=DRBXAG1)
FRD7201I   UTILGBL(COMP=Y,DSN(&ICHLQ..&DBD..&DDN.),UNIT(3390),-
FRD7201I          ICBUF(15),VOLSER(222222),COMPRTN(FABJCMP3))
FRD7201I   ADD DB(DEDBJN23)                           -
FRD7201I       IC(ICHLQ(TEMP),SPACE(CYL,1,1)) -
FRD7201I             DBATRB(DBDSL(101))
FRD7201I   START ERROR(CONT)


D A T A B A S E   R E C O V E R Y   F A C I L I T Y   R E C O V E R Y   P A R A M E T E R S

PROCESS : RCVTOIC            RECOVERY OPTIONS
SOURCE  : PRI                  RCVTIME : Not Specified
READNUM : 03,03                TYPE    : Full                 LOGNUM  : 03,03                ICNUM   : 03,03
ERROR   : CONT                 CHECK   : Yes                  OUTPUT  : ICR                  TAPECHK : No
RCVTOKEN: DRF03                TIME FMT: LCL                  CATDS   : No
DRFPROC : DRFV3                LBI     : No                   SPSIZE  :     1024             CACHE   : No

----------  Sort-Related Parameters  ----------

NUM     :        3             MAINSIZE:      30              AVGRLEN :      256
FILSZ   :    21000             HIPRMAX : OPTIMAL              ASPREF  :     DRFI             ASGNAME :      N/A
DYNALLOC:      N/A , N/A


D A T A B A S E   R E C O V E R Y   F A C I L I T Y   S U M M A R Y   R E P O R T

Database   DD/Area    DSID        --------- Records Read ---------     Records Subord.   STC  Final
Name       Name                         IC          CA         LOG     Written Reg Name   #   Status

DEDBJN23   DB23AR0     1               180           0        1227           0 DRFI0001   385 No errors encountered
DEDBJN23   DB23AR1     2                21           0        1226           0 DRFI0002   386 No errors encountered
DEDBJN23   DB23AR2     3               147           0           0           0 DRFI0003   387 No errors encountered
DEDBJN23   DB23AR3     4               147           0           0           0 DRFI0001   385 No errors encountered
DEDBJN23   DB23AR4     5               231           0           0           0 DRFI0002   386 No errors encountered
DEDBJN23   DB23AR5     6                99           0           0           0 DRFI0003   387 No errors encountered
DEDBJN23   DB23AR6     7               165           0           0           0 DRFI0001   385 No errors encountered
DEDBJN23   DB23AR7     8                21           0           0           0 DRFI0002   386 No errors encountered

SUBORDINATE ADDRESS SPACE LIST                                                                                     
                                                                                                                     
JOBNAME  JOBID    TYPE                                                                                             
-------  -------- ----
DRFI0001 STC00385 RSS
DRFI0002 STC00386 RSS
DRFI0003 STC00387 RSS

FRD0000I IMS RECOVERY SOLUTION PACK V1R1 : IMS Database Recovery Facility            Date: 01/14/2025 Time: 16:31    Page: 2


D A T A B A S E   R E C O V E R Y   F A C I L I T Y   U T I L I T Y   R E P O R T

Database   DDN        Database Data Set Name                        IC   PC/DP IB   PR   Utility Final Status
------------------------------------------------------------------------------------------------------------------
DEDBJN23   DB23AR0    IMSTESTL.DB23AR0                              00   N/A   N/A  N/A
DEDBJN23   DB23AR1    IMSTESTL.DB23AR1                              00   N/A   N/A  N/A
DEDBJN23   DB23AR2    IMSTESTL.DB23AR2                              00   N/A   N/A  N/A
DEDBJN23   DB23AR3    IMSTESTL.DB23AR3                              00   N/A   N/A  N/A
DEDBJN23   DB23AR4    IMSTESTL.DB23AR4                              00   N/A   N/A  N/A
DEDBJN23   DB23AR5    IMSTESTL.DB23AR5                              00   N/A   N/A  N/A
DEDBJN23   DB23AR6    IMSTESTL.DB23AR6                              00   N/A   N/A  N/A
DEDBJN23   DB23AR7    IMSTESTL.DB23AR7                              00   N/A   N/A  N/A

Final Return (RC) and Reason (RSN) Codes

---IC---    ---PC---    ---DP---    ---IB---    ---PR---    ---LIU--
RC   RSN    RC   RSN    RC   RSN    RC   RSN    RC   RSN    RC   RSN

00   00     N/A  N/A    N/A  N/A    N/A  N/A    N/A  N/A    N/A  N/A

FRD0000I IMS RECOVERY SOLUTION PACK V1R1 : IMS Database Recovery Facility            Date: 01/14/2025 Time: 16:31    Page: 3


D A T A B A S E   R E C O V E R Y   F A C I L I T Y   I C / I C R   O U T P U T   R E P O R T

Database DD/Area  IC / ICR Data Set Name                       Compr    Volume File  IC   IC                          Compr Compr
Name     Name     --------.--------.--------.--------.-------- Count    Serial Seq.  Type Time                        Ratio Routine
DEDBJN23 DB23AR0  TEMP.DEDBJN23.DB23AR0                             178 222222 00001 Con. 20.013 11:16:53.8     -0800   2.5 FABJCMP3
DEDBJN23 DB23AR1  TEMP.DEDBJN23.DB23AR1                              19 222222 00001 Con. 20.013 11:16:53.8     -0800  13.1 FABJCMP3
DEDBJN23 DB23AR2  TEMP.DEDBJN23.DB23AR2                             145 222222 00001 Con. 20.013 11:16:53.8     -0800   4.6 FABJCMP3
DEDBJN23 DB23AR3  TEMP.DEDBJN23.DB23AR3                             145 222222 00001 Con. 20.013 11:16:53.8     -0800   4.6 FABJCMP3
DEDBJN23 DB23AR4  TEMP.DEDBJN23.DB23AR4                             229 222222 00001 Con. 20.013 11:16:53.8     -0800   5.9 FABJCMP3
DEDBJN23 DB23AR5  TEMP.DEDBJN23.DB23AR5                              97 222222 00001 Con. 20.013 11:16:53.8     -0800   8.9 FABJCMP3
DEDBJN23 DB23AR6  TEMP.DEDBJN23.DB23AR6                             163 222222 00001 Con. 20.013 11:16:53.8     -0800   6.9 FABJCMP3
DEDBJN23 DB23AR7  TEMP.DEDBJN23.DB23AR7                              19 222222 00001 Con. 20.013 11:16:53.8     -0800  12.6 FABJCMP3

FRD0000I IMS RECOVERY SOLUTION PACK V1R1 : IMS Database Recovery Facility            Date: 01/14/2025 Time: 16:31    Page: 4


D A T A B A S E   R E C O V E R Y   F A C I L I T Y   D A T A   S E T   I / O   R E P O R T

Recover to point: Not Specified

Image Copy Data Set Name                        Volume     IC DS      IC        ---------------- Time Stamp Range -----------------
---------.---------.---------.---------.-----   Serial   Read Count  Type             1st Record                 Last Record

IMSVS.DEDBJN23.DB23AR0.IC.IC111249              222222         180    STD
IMSVS.DEDBJN23.DB23AR1.IC.IC111249              222222          21    STD
IMSVS.DEDBJN23.DB23AR2.IC.IC111249              222222         147    STD
IMSVS.DEDBJN23.DB23AR5.IC.IC111250              222222          99    STD
IMSVS.DEDBJN23.DB23AR3.IC.IC111249              222222         147    STD
IMSVS.DEDBJN23.DB23AR4.IC.IC111249              222222         231    STD
IMSVS.DEDBJN23.DB23AR6.IC.IC111250              222222         165    STD
IMSVS.DEDBJN23.DB23AR7.IC.IC111250              222222          21    STD

Change Accum Data Set Name                      Volume     CA DS                ---------------- Time Stamp Range -----------------
---------.---------.---------.---------.-----   Serial   Read Count                   1st Record                 Last Record

No data available for this type data set

Log Data Set Name                               Volume     Log DS     IMS       ---------------- Time Stamp Range -----------------
---------.---------.---------.---------.-----   Serial   Read Count  SYSID            1st Record                 Last Record

IMSVS.RLDSP.IMS1.D20013.T1116000.V00            000000         344  IMS1        2020.013 11:16:00.085956 -02020.013 11:16:09.347812
  Prilog: 2020.013 11:13:43.900000
IMSVS.RLDSP.IMSA.D20013.T1117015.V00            000000         817  IMSA        2020.013 11:17:01.514320 -02020.013 11:17:49.476351
  Prilog: 2020.013 11:14:53.000000
IMSVS.RLDSP.IMSA.D20013.T1116576.V03            000000           0  IMSA        2020.013 11:17:00.048405 -02020.013 11:17:01.514320
  Prilog: 2020.013 11:14:53.000000
IMSVS.RLDSP.IMSA.D20013.T1115306.V00            000000         817  IMSA        2020.013 11:15:30.696015 -02020.013 11:16:57.653660
  Prilog: 2020.013 11:14:53.000000
IMSVS.RLDSP.IMSA.D20013.T1116576.V02            000000           0  IMSA        2020.013 11:16:57.653660 -02020.013 11:17:00.048405
  Prilog: 2020.013 11:14:53.000000
IMSVS.RLDSP.IMS1.D20013.T1115211.V00            000000         475  IMS1        2020.013 11:15:21.111820 -02020.013 11:16:00.085956
  Prilog: 2020.013 11:13:43.900000
IMSVS.RLDSP.IMS1.D20013.T1116093.V00            000000           0  IMS1        2020.013 11:16:09.347812 -02020.013 11:16:53.864245
  Prilog: 2020.013 11:13:43.900000

Following is an explanation of the image copy or incremental image copy output example. There are 6 sections to the report:

1 - COMMANDS / CONTROL STATEMENTS
This section displays the images of the control statements read from the SYSIN file. Six control statements were read from the SYSIN file.
2 - RECOVERY PARAMETERS
This section lists the parameters used to direct the recovery. The recovery parameters were supplied via one of the following three mechanisms, in ascending order of selection priority:
1. Explicitly coded in the SYSIN control statements.
  - These values can be seen in the Control Statements part of the report:
    PROCESS: RCVTOIC
    
    A TOIC-type recovery was selected.
    
    This parameter was not specified. The recovery facility default parameter was used.
    
    SOURCE: PRI
    
    The primary log and image copy data sets are to be used as the source of input.
    
    This parameter was not specified. The recovery facility default parameter was used.
    
    READNUM: 03,03
    
    The maximum number of devices to be used is 03. Of these, up to 03 can be tape devices.
    
    The maximum number of total devices and the number of allowable tape devices were specified in the FRXDRFxx member.
    
    ERROR: CONT
    
    Should an error be encountered on one database during recovery, processing should continue for other databases.
    
    This parameter was not specified. The recovery facility default parameter was used.
    
    RCVTOKEN: DRF03
    
    The recovery token used during recovery is DRF03.
    
    DRFPROC : DRFV3
    
    The procedure for the RSS is contained in member DRFV3 in the PROCLIB PDS.
    
    RCVTIME: Not Specified
    
    A recovery time was not specified.
    
    TYPE: Full
    
    A full recovery was requested.
    
    This parameter was not specified. The recovery facility default parameter was used.
    
    CHECK: YES
    
    A check will be performed to ensure that, should a DBDS be in a recovery group, all of the DBDSs within that recovery group need to be included in the list.
    
    This parameter was not specified. The recovery facility default parameter was used.
    
    TIME FMT: LCL
    
    Time format is local.
    
    LBI: No
    
    Large Block Interface processing was not requested.
    
    LOGNUM: 06,20
    
    The maximum number of tape drives used for reading change accumulation data sets is 6. Of these, up to 20 can be read instances which can be initiated in parallel.
    
    OUTPUT: ICR
    
    The output type is incremental image copy.
    
    SPSIZE: 1024
    
    The SPSIZE specified is 1024.
    
    ICNUM: 06,20
    
    The maximum number of tape drives used for reading image copy data sets is 6. Of these, the maximum number of read instances that can be initiated in parallel is 20
    
    TAPECHK: No
    
    The availability status of tape devices before DBDS allocation is not checked.
    
    This parameter was not specified. The recovery facility default parameter was used.
    
    CACHE: No
    
    No image copy data sets are located on a VTS device.
    
    This parameter was not specified. The recovery facility default parameter was used.
3 - SUMMARY REPORT
This section presents statistics and summarizes the results of the recovery for each of the data sets associated with each database.

The three databases included in the recovery consisted of 5 database data sets. For each of these data sets, the following information is listed:

Database Name

The database name is listed.

DD/AREA Name

The DD name or Area name associated with each image copy data set is listed.

DSID

The data set ID number is listed.

Records Read

The number of records read from the image copy, change accumulation and log data sets for application in the recovery are listed. If FlashCopy, the read count will be 'N/A'.

Records Written

The number of records written to the database data set is listed.

Subord. Reg Name

The name of the started task which was responsible for sorting the records being written for the indicated data set is listed.

STC

The started task control number.

Final Status

The status of the conclusion of the recovery is listed.

SUBORDINATE ADDRESS SPACE LIST

JOBNAME and JOBID from the recovery sort subordinate address spaces (RSS) or utility address spaces (UAS) are listed.
4 - UTILITY REPORT

Database Name

The database name is listed.

DDN

The DDNAME is listed.

Database Data Set Name

The database data set name is listed.

IC

The IMS HP Image Copy auxiliary utility return code is listed.

PC/DP

The IMS HP Pointer Checker / DEDB Pointer Checker auxiliary utility return code is listed.

IB

The IMS Index Builder auxiliary utility return code is listed.

PR

The DFSPREC0 auxiliary utility return code is listed.
5 - IC / ICR OUTPUT REPORT

Database Name

The database name is listed.

DD/Area Name

The DD name or Area name associated with each image copy data set is listed.

IC / ICR Data Set Name

The output image copy or incremental image copy data set name is listed.

Compr Count

The number of records written to the data set. If a compression routine is in use, it reflects the number of records resulting from compression.

Volume Serial

The volume serial number upon which the data set was written.

If there are multiple volumes, then there is one report line for each volume. If this is the case, the same data set name is listed on each succeeding report line.

File Seq.

The file sequence number for each data set.

IC Type

The image copy type is listed, where Bat. is for batch, Con. is for concurrent, and UIC for user image copy.

IC Time

The image copy time recorded in the image copy record in the RECONs. If the image copy is not registered because NOTIFY(N) was specified, then this field is left blank.

Compr Ratio

If an image copy compression routine is used, the compression ratio is listed.

Compr Routine

If an image copy compression routine is used, the name of the routine is listed.

6 - DATA SET I/O REPORT

As was seen in earlier sections of the report, no recovery time was specified. This fact is reflected in the Recover to Point in this section.

The data set I/O report is divided into three sections:

Image Copy Data Set Name

For each image copy data set used during the recovery, the following information is listed:

Image Copy Data Set Name

The data set name is listed.

Volume Serial

The volume or volumes upon which the data sets were found.

DS Count

The number of records read from the data set is listed. If FlashCopy, the read count will be 'N/A'.

IC Type

The image copy type is listed. Allowable values for this field include:

Table 1. Valid values for IC Type
IC Type listed	Description
STD	Standard Image Copy
IC2	Image Copy 2
IC EXT	Extended Image Copy
HISAM UNL	HISAM Unload
Time Stamp Range	Although this heading appears, this field has no significance for image copy data sets.
SLB-CIC-O *	The System Level Backup is concurrent and is offloaded to a sequential device. For Recovery, VERIFY(ALLOC) and VERIFY(OPEN), 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 Recovery, VERIFY(ALLOC) and VERIFY(OPEN), 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). 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.

Note: * If IMS Recovery Expert is available and USESLBIC(YES) is specified, the VERIFY option 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 for Recovery and Recovery with the VERIFY option.

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(N) is in effect, then there is no attempt to operate on this symbolic data set name. The report reflects N/A in the Status column.

Change Accumulation Data Set Name
For each change accumulation data set used during the recovery, the following information is listed:

Change Accum Data Set Name

The data set name is listed.

Volume Serial

The volume or volumes upon which the data sets were found.

DS Count

The number of records read from the data set is listed.

Time Stamp Range

Although this heading appears, this field has no significance for image copy data sets, except when a System Level Backups was used for the recovery.
When SLBs are being processed, this header is changed to SLB IC DSN RECON. The data set name from the image copy record representing the SLB is listed underneath.

If there is an SLB Offload data set, it is listed in the Image Copy Data Set Name column so that the two can be correlated.

To determine whether the Offload data set or the SLB on the fast-replication volume was used in the recovery, refer to the SLB IC DSN RECON column. If the fast-replication volume was used, then the SLB image copy data set name is preceded with the characters '->'.
Log Data Set Name
For each log data set used during the recovery, the following information is listed:

Log Data Set Name

The data set name is listed.

Volume Serial

The volume or volumes upon which the data sets were found.

DS Count

The number of records read from the data set is listed.

IMS SYSID

The SYSID associated with the IMS which created the log is listed.

Time Stamp Range

The range of times which are covered by the log is listed. The time stamp on the first and last records in the log is listed.

PRILOG:

The PRILOG time listed in RECON for the log is listed.

The difference between the log records read and the log records applied values in the recovery report are due to the update records read that generate multiple output records. The IMS Database Recovery Facility creates multiple update records for expedited processing when certain internal conditions are recognized.