IMS Database Recovery Facility

The Image Copy function integrates with IMS Database Recovery Facility and creates image copies while the IMS Database Recovery Facility job is running.

If you request the image copy process in the recovery job of IMS Database Recovery Facility, the Image Copy function starts and creates the following image copies:
  • Image copy data sets of recovered database data sets.
  • Incremental Image Copy (ICR) where a new image copy is created from an image copy, a log, and/or a change accumulation input data sets for every database data set in the recovery list that uses the recovery process. Actual database recovery is not done and the databases are not accessed.

Supported image copy features

The following table summarizes the image copy features that are supported for IMS Database Recovery Facility.

Table 1. Image copy features for IMS Recovery Solution Pack: IMS Database Recovery Facility
Feature Feature is supported?
Format of output image copy data set Batch image copy Yes
Compressed image copy Yes
Fast Recovery image copy -
Data access method Advanced Image Copy Services support -
High Performance Input/Output interface -
OS access method -
Processing type Parallel processing Yes
Dynamic allocation of output image copy data sets Note 1 Yes
Batch image copy and concurrent image copy Batch/CIC Note 2
Processing option Stacking output image copies Yes
Checkpoint Restart -
Creating multiple image copies at one time (maximum number of image copies) Yes (2)
Virtual image copy process Yes
Processing option control Site default table Yes
IMS command interface Integration with IMS Tools Online System Interface -
IMS Tools KB support Central management of reports -
Notes:
  1. The naming rule for the image copy data set that IMS HP Image Copy dynamically allocates conforms to the data set naming template. For more information, see Data set naming template.
  2. CIC can be scheduled by the incremental image copy function of IMS Database Recovery Facility. IMS Database Recovery Facility determines the process type automatically.

How to request and control the image copy process

  • The IC() keyword on the ADD command indicates that an image copy is to be created for each recovered database.
  • The OUTPUT(ICR) keyword indicates that an incremental image copy is created using the prior image copy and archived logs or change accumulation data sets as input.

Control statements for the image copy process are read from the following resources:

  • UTILGBL control statement of IMS Database Recovery Facility JCL stream
  • IC keyword parameter of the ADD command of IMS Database Recovery Facility JCL stream
  • IMS HP Image Copy site default table, if the site default module is found in the STEPLIB concatenation

If you want to add keywords or replace the default keyword values for controlling the image copy process, specify the values in one of these resources. ICEIN DD statement is not supported.

For information about invoking the Image Copy function in IMS Database Recovery Facility jobs, see the IMS Recovery Solution Pack IMS Database Recovery Facility User's Guide.

Supported keywords and default values for the image copy process

For some keywords, the default value applied is different from the value applied to stand-alone Image Copy function jobs. The following table summarizes the keywords that you can use to control the image copy process in IMS Database Recovery Facility jobs. It also summarizes the default values applied to the image copy process.

Table 2. Supported keywords and default values for IMS Database Recovery Facility
Keyword Can be specified as site default Acceptable values System default value under IMS Database Recovery Facility Topic
COMP Yes Y or N N COMP keyword
COMPRTN Yes routine FABJCMP3 COMPRTN keyword
DATACLAS No class-name None DATACLAS keyword
DSN Yes expression None DSN keyword
DSN2 Yes expression None DSN2 keyword
EXPDT No yyyyddd or yyddd None EXPDT keyword
ICBUF Yes 0 - 255 50 ICBUF keyword
ICCAT Yes Y or N Y ICCAT keyword
ICHLQ Yes hlq1 or (hlq1,hlq2) None ICHLQ keyword
ICHLQ2 No hlq2 None ICHLQ2 keyword
ICNMRULE Yes Y or N N ICNMRULE keyword
KEYLABEL Yes encryption_key_label None KEYLABEL keyword
MGMTCLAS No name None MGMTCLAS keyword
RETPD No nnnn None RETPD keyword
SPACE Yes (CYL|TRK|blk, primary, secondary) None SPACE keyword
STACK Yes One of the following formats:
  • ddname
  • (dd1,dd2)
  • *
  • (*,*)
None STACK keyword
STACKBASE No TEMP|REAL TEMP STACKBASE keyword
STORCLAS No name None STORCLAS keyword
UNIT Yes unit-name or (unit-name,unit-count) SYSALLDA UNIT keyword
UNIT2 No unit-name or (unit-name,unit-count) SYSALLDA UNIT2 keyword
VIC Yes Y or N N VIC keyword
VICDSN Yes dsname None VICDSN keyword
VOLCNT No nnn 1 VOLCNT keyword
VOLSER No volser or (vol1,vol2,...) None VOLSER keyword
VOLSER2 No volser or (vol1,vol2,...) None VOLSER2 keyword
WAITMSG Yes Y or N Y WAITMSG keyword
WAITTIME Yes nnnn 30 WAITTIME keyword