DD statements for the Recovery function

DD statements are used to identify the source of input and the placement of output information. The following DD statements are supported for the Recovery function that is run by the FABJMAIN program.

Table 1. DD statements for the Recovery function
DDNAME Use Format Required or optional
STEPLIB Input PDS Optional
DFSRESLB Input PDS Optional
IMSDALIB Input PDS Optional
RECON1
RECON2
RECON3		 Input/Output KSDS Required if DBRC=Y (See Note 1)
IMS Input PDS Required (See Note 2)
ICEIN Input LRECL=80 Required
ICEPRINT Output LRECL=133 Required
ICERPRT Output LRECL=133 Optional
SYSABEND or SYSUDUMP Output LRECL=133 Optional
DFSPRINT Output LRECL=122 Required
SYSPRINT Output LRECL=122 Optional
dataset Output   Required (See Note 3)
DFSUDUMP Input   Required (See Note 3)
DFSUCUM Input   Required (See Note 3)
DFSULOG Input   Required (See Note 3)
DFSVSAMP Input LRECL=88 Optional
DSSPRINT Output LRECL=133 Optional
HPSRETCD Input LRECL=80 Optional
FABJDRSN Input LRECL=80 Optional
FABJRDMP Output LRECL=(RECON CI size)+4, RECFM=VBA Optional
Notes:
  1. Do not specify these DD statements if you want the RECON data sets allocated dynamically.
  2. IMS DD statement is not required when the IMS management ACBs is enabled.
  3. IMS HP Image Copy supports dynamic allocation for these data sets. If you want these data sets allocated dynamically, do not specify these DD statements.
STEPLIB DD
This statement points to two load module library data sets. The data sets must be in the following sequence: 
//STEPLIB  DD   DISP=SHR,DSN=HPS.SHPSLMD0
//         DD   DISP=SHR,DSN=IMS.SDFSRESL

where:

HPS.SHPSLMD0
The name of the library that contains the load modules of IMS HP Image Copy.
IMS.SDFSRESL
The name of the library that contains the IMS nucleus and required action modules.

To enable IMS-managed ACBs, you must include the IMS Tools Generic Exits library in the STEPLIB concatenation.

To use IMS HP Image Copy site default table, you must specify the library that contains the IMS HP Image Copy site default table.

If STEPLIB is unauthorized because it specifies libraries concatenated to IMS.SDFSRESL, you must specify a DFSRESLB DD statement.

DFSRESLB DD
This statement points to an authorized library that contains the IMS SVC modules.
IMSDALIB DD
This statement specifies the dynamic allocation members for the database, the index, and the RECON data sets. Allocation of these data sets is attempted in the following order:
  1. DD statements found in the JCL stream
  2. Dynamic allocation members in the IMSDALIB concatenation
  3. Dynamic allocation members in the JOBLIB or STEPLIB concatenation
For dynamic allocation of HALDB databases, RECON data sets are used instead of this DD statement.
RECON1 DD
RECON2 DD
RECON3 DD
These statements specify the DBRC RECON data sets. These statements are required if HALDB exists in the databases and the RECON data sets are not allocated dynamically, or if DBRC parameter is Y and the RECON data sets are not allocated dynamically. Do not specify these RECON data set DD statements if you want RECON data sets allocated dynamically using the DFSMDA macro.
IMS DD
This statement defines the library that contains the DBD describing the database to dump, generally DSNAME=IMS.DBDLIB. The data set must reside on a direct-access volume.

This statement is not required when the IMS management ACBs is enabled.

ICEIN DD
This statement is required. It specifies the input control statement data set. The data set can reside on a tape or a direct-access volume, or it can be routed through the input stream (DD * or DD DATA).

For details, see ICEIN control statements. For a list of control statement keywords, see Control statement keywords for the Recovery function.

ICEPRINT DD
This statement is required. It specifies the output messages data set. The IMS HP Image Copy main module generates messages in this data set. The data set can reside on a tape, a direct-access volume, or a printer, or it can be routed through the output stream (SYSOUT).
SYSABEND DD
SYSUDUMP DD
These statements define a dump data set. If both statements are present, the last occurrence is used for the dump.
ICERPRT DD
This statement specifies the optional report data set. This data set contains the Recovery Process report. It can reside on a tape, a direct-access volume, or a printer, or it can be routed through the output stream (SYSOUT).
DFSPRINT DD
This statement specifies the required output message data set. The data set contains messages from the IMS HP Image Copy module that has alias name DFSURDB0. The data set can reside on a tape, a direct-access volume, or a printer, or it can be routed through the output stream (SYSOUT).
If this DD statement is not specified, IMS HP Image Copy ends abnormally with U3905.
SYSPRINT DD
If you need to review complete messages from the DBRC modules, write the messages in a permanent data set by specifying so on the DD statement, or route the messages through the output stream (SYSOUT).
dataset DD
This statement defines the data set to be recovered. The ddname must be the same as the one in the DBD that describes this data set. It must also be in the utility control statement.

For DEDBs, this DD statement defines the area data set of the area to be recovered. The ddname must be the same as the one in the DBD that describes this area. If an area is registered to the DBRC RECON data set, the ddname and dsname must match the names registered to the ADS list of the target area. If an area is not registered to the DBRC RECON data set and this data set contains the NOFORCER attribute, the ddname must be the same as the area name and must be present in the utility control statement.

To have the Recovery function dynamically allocate the output data set, omit this DD statement and specify the DBDALLOC=YES parameter and its associated allocation parameters in the ICEIN data set.

DFSUDUMP DD
This statement defines the input image copy data set, if any, to be used for recovery. It can be a data set created by either the Image Copy function of IMS HP Image Copy or the original Image Copy utility. (The original Image Copy utility can be the Batch Database Image Copy utility, the Online Database Image Copy utility, or the HISAM Reorganization Unload utility.)

To have the Recovery function dynamically allocate the input image copy data set, omit this DD statement and specify the DSDALLOC=YES parameter and its associated allocation parameters in the ICEIN data set.

Notes:
  • If you specify TIMESTMP=LASTIC or TIMESTMP=LASTICALL, you must allocate the input image copy data set with dynamic allocation. This statement must not be coded in JCL.
  • If you specify TIMESTMP=timestamp, use dynamic allocation for the image copy data set. If the image copy data set specified is not the one registered to DBRC, the Recovery function fails.
DFSUCUM DD
This statement defines the accumulated change input data set. If no accumulated change input is supplied, this statement must be coded as DD DUMMY. This data set can reside on a tape or a direct-access volume.

To have the Recovery function dynamically allocate the input data set, omit this DD statement and specify the DSDALLOC=YES parameter and its associated allocation parameters in the ICEIN data set.

If you specify TIMESTMP=timestamp, use dynamic allocation for the accumulated change input data set. If the accumulated change data set specified is not the one registered to DBRC, the Recovery function fails.

DFSULOG DD
This statement defines the log change input. If there are no log changes, this statement must be coded as DD DUMMY. This data set can reside on a tape or a direct-access volume.

To have the Recovery function dynamically allocate the data set, omit this DD statement and specify the DSDALLOC=YES parameter and its associated allocation parameters in the ICEIN data set.

If you specify TIMESTMP=timestamp, use dynamic allocation for the log change input data set. If the log change data set specified is not the one registered to DBRC, the Recovery function fails.

You can use multiple logs as input by concatenating the data sets.

The DD statements must be in the date and time sequence. DBRC verifies that the log data sets are in chronological order according to their STOP TIME.

DFSVSAMP DD
This statement describes the data set that contains the buffer information required by the DL/I buffer handler. This DD statement is required:
  • If only change accumulation input is used.
  • If log input is used.
  • For recovering a VSAM ESDS with data from HISAM unload for the input.
  • For recovery when a null image copy data set is used for input.

For more information about the control statement format and the buffer pool structure, see IMS System Definition.

The data set can reside on a tape or a direct-access device, or it can be routed through the input stream (DD * or DD DATA).

DSSPRINT DD
This statement specifies the output messages data set for the messages that DFSMSdss generates when the Advanced Image Copy Services is used. If this statement is present, DFSMSdss issues messages that are prefixed with ADR to the data set. These messages provide processing information and any errors that occurred during processing.
HPSRETCD DD
This statement is a function-unique DD statement for the Return Code Handling option. This optional input data set contains the user-specified control statements that define the return codes of the IMS HP Image Copy process.
For details, see HPSRETCD control statement.
FABJDRSN DD
This statement specifies the input data set that contains the user-specified control statements for defining the error reason code (S99ERROR) and the SMS reason code (S99ERSN) for dynamic allocation.
For details, see FABJDRSN control statement.
FABJRDMP DD
This statement specifies the output data set for storing the RECON REPRO output (in QSAM format) for diagnosis use. IMS HP Image Copy runs REPRO and stores the RECON data set into the data set that this DD points to, if the DD is defined and the following conditions are met:
  • DBDS record is found in RECON, but its corresponding database record is not found by the Image Copy function or the Recovery function.
  • IC record is found in RECON, but its corresponding DBDS record is not found by the Recovery function.

Tape drives are not supported.

This DD is optional.

The specification is as follows: 

//FABJRDMP DD  DISP=OLD,DSN=dataset_name

where dataset_name is the data set name where REPRO output is stored.