Creating and running your IMS Database Recovery Facility job

Perform the following steps to create and run an IMS Database Recovery Facility job that produces an incremental image copy (ICR) of an online database.

Before you begin

Important: Because the database is allocated, the result of the ICR might be a concurrent image copy or fuzzy image copy that can contain committed and uncommitted log updates.

To perform an IMS Database Recovery Facility ICR, you must have IMS Database Recovery Facility and IMS High Performance Image Copy installed.
Complete the tasks in sample member FRXITKB.

About this task

This scenario uses the time “20.044 18:25:37.5,” which was extracted from the RECON that has updates being processed.

Procedure

Install and configure the required IMS Database Recovery Facility load libraries and utilities.

For more information, see Installing IMS Recovery Solution Pack libraries
Customize the procedures found in the your.hlq.SFRXSAMP sample library.
For more information, refer to:
- DRFMAS procedure
- DRFPROC procedure
Customize the execution JCL found in the your.hlq.SFRXSAMP sample library.

For more information, see DRFMAS procedure.
The following example shows modified IMS Database Recovery Facility ICR JCL in which an ICR is being taken with the database allocated:
```
^a//DRF      EXEC FRXMAS,DRFMBR=ZZ                                  
//SYSIN DD *                                                      
 REPORT(RPTTYPE=SEP,DRFUNIT=SYSDA,DRFHLQ=MYDRF1)                     
 SORTPARM(ASPREF(AS))   
 DBDSL101(DISP(NEW))                                          
^bOUTPUT(ICR)                                              
 ^cADD DB(DHVNTZ02) DBATRB(DBDSL(101)) -                  
 ^dIC (COMP(Y),-
 COMPRTN(FABJCMP3),-                                              
      DSNTYPE(BASIC),-                                            
      ICHLQ(TEMP.IC),-
      ICNMRULE(Y),-                                               
      UNIT(SYSDA),-                                                
      SPACE(CYL,1,1,RLSE))
 ^eSTART ERROR(CONT) RCVTIME(‘20.044 18:25:37.5')
//  
```
Explanation:
1. When you run IMS Database Recovery Facility, the FRXMAS procedure is invoked.
  DRFMBR=ZZ references the FRXDRFZZ configuration file for IMS Database Recovery Facility.
2. Instruct IMS Database Recovery Facility to generate an ICR.
3. The database name DHVNTZ02 (HIDAM/VSAM), which is identified in step 1, is used to take an ICR by using the ADD DB() parameter.
  You can specify one or more databases for taking an ICR.
4. You can customize the IC keywords to your specifications.
  In this case, the output ICR is compressed by using the FABJCMP3 routine, and the output IC data set name follows the ICNMRULE naming convention (ichlq.ICn.dbdname.ddname.Dyyddd.Thhmmss).
5. Specifying RCVTIME() is optional.
  If you want to run ICR to current time, you do not need to include this parameter because IMS Database Recovery Facility automatically calls IMS HP Image Copy to generate concurrent and fuzzy ICs for the allocated databases that are specified in the ADD DB() statement.
  
  However, if you want to generate a point-in-time ICR that is not the current time, you must input the specific time by using RCVTIME().
  
  In this scenario, the chosen time was inserted.
Submit the IMS Database Recovery Facility job.