DD statements for creating image copies

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

Table 1. DD statements for the Image Copy 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
DFSPRINT	Output	LRECL=122	Required
ICERPRT	Output	LRECL=133	Optional
ICEDLIST	Output	LRECL=133	Optional
FABJSTAT	Output	LRECL=133	Optional
`datain`	Input	VSAM or OSAM	Required ^{(See Note 3)}
`areain`	Input	ESDS	Required ^{(See Note 3)}
`dataout1`	Output	RECFM=FB or VBS	Required ^{(See Note 3)}
`dataout2`	Output	RECFM=FB or VBS	Optional ^{(See Note 3)}
`stack1`	Output	RECFM=FB or VBS	Required ^{(See Note 3)}
`stack2`	Output	RECFM=FB or VBS	Optional ^{(See Note 3)}
DSSPRINT	Output	LRECL=133	Optional
DSSSTATS	Output	LRECL=133	Optional
CHKPTDD	Input/Output	LRECL=4096 or greater, RECFM=VB	Optional
HPSRETCD	Input	LRECL=80	Optional
FABJDRSN	Input	LRECL=80	Optional
FABJHRDD	Input/Output	RECFM=VB	Optional
FABJRDMP	Output	LRECL=(RECON CI size)+4, RECFM=VBA	Optional
SYSABEND or SYSUDUMP	Output	LRECL=133	Optional
Notes: Do not specify these DD statements if you want the RECON data sets allocated dynamically. IMS DD statement is not required when the IMS management of ACBs is enabled. 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 that 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 use IMS HP Image Copy site default table, you must specify the library that contains the IMS HP Image Copy site default table.

To enable the following functions, you must concatenate the appropriate load module libraries to the STEPLIB DD:

The IMS Tools Generic Exits library to run the job in the IMS-managed ACBs environment
The IMS Tools KB library to store the reports in the central repository
The IMS Tools Generic Exits and IMS Tools Online System Interface libraries to use the following features:
- To use the IMS command interface through IMS Tools Online System Interface
- To collect VSAM statistics from full-function databases with the DB Sensor function
- To collect VSAM statistics from full-function databases by using the HASH Check option with Space Monitor
The IMS Tools Generic Exits library to offload workload to zIIP processors
The IMS HP Pointer Checker library to enable the HASH Check option or the logical relation search option (DBALL)
All of the following libraries to use the DB Sensor function to collect sensor data from full-function databases:
- Either IMS Database Solution Pack libraries or IMS Database Utility Solution libraries
- IMS Database Reorganization Expert library
- IMS Tools KB library
The IMS Fast Path Solution Pack library to enable the DEDB HASH Check option
The IMS Fast Path Solution Pack library and the IMS Tools KB library to use the DB Sensor function to collect sensor data from Fast Path databases

If IMS HP Pointer Checker is called with the HOMECHK, CHAINDIST, or COMPFACT option, you must specify the library that contains the randomizer or the segment edit/compression routine.

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:

DD statements found in the JCL stream
Dynamic allocation members in the IMSDALIB concatenation
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 Image Copy 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).

DFSPRINT DD

This statement is required. It specifies the output message data set. The data set contains messages from the IMS HP Image Copy module that has alias name DFSUDMP0 or 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.

ICERPRT DD

This statement specifies the report data set. The Image Copy Dump Process report is generated in this data set. It can reside on a tape, a direct-access volume, or a printer, or it can be routed through the output stream (SYSOUT).

ICEDLIST DD

This statement specifies the output messages data set. The DBRC report for DBRC commands, such as the NOTIFY.IC, the NOTIFY.UIC, and the CHANGE.IC commands, is generated in this data set. It can reside on a tape, a direct-access volume, or a printer, or it can be routed through the output stream (SYSOUT).

FABJSTAT DD

This statement specifies the report data set. The Data Set Statistics report is generated in this data set. It can reside on a tape, a direct-access volume, or a printer, or it can be routed through the output stream (SYSOUT).

datain DD

This statement defines the input data set to be dumped. The ddname (datain) of this statement must be the same as the one in the DBD that describes this data set.

You can request the Image Copy function to dynamically allocate the input data set using the DFSMDA member. To dynamically allocate the data set, omit this DD statement and specify the DBDALLOC=YES parameter in the ICEIN data set. IMS HP Image Copy determines the optimal buffer size for each data set.

areain DD

You can specify up to seven areain DD statements to specify multiple DEDB area data sets. If the area is registered to the RECON data set, the ddname specified to each areain DD statement must not be the area name. If the area is not registered, the ddname specified to the areain DD statement must be the area name (ddname operand in the DBD area macro).

You can request the Image Copy function to dynamically allocate the input data set using the DFSMDA member or the ADS list information in the RECON data set. To dynamically allocate the data set, omit this DD statement and specify the DBDALLOC=YES parameter in the ICEIN data set. IMS HP Image Copy determines the optimal buffer size for each data set.

dataout1 DD or stack1 DD

This statement defines the first copy of the dumped output data set.

One DD statement is required for each data set to be dumped unless the output data set is dynamically allocated. The ddname can be any 1- to 8-character string, but the ddname must appear in the associated utility control statement. The output device must be either a direct-access device or a tape.

Standard labels must be used. If the output is a direct-access device, BLKSIZE is determined by the system to optimize output DASD BLKSIZE. If BLKSIZE is specified in the JCL, that BLKSIZE is used.

You can request the Image Copy function to allocate the output data set dynamically by omitting this DD statement and specifying the ICDALLOC=YES parameter and its associated allocation parameters in the ICEIN data set.

For details, see ICOUT keyword and STACK keyword.

dataout2 DD or stack2 DD

This statement is required only if the associated utility control statement requests two copies of the dump. The name must appear in the control statement. The name must be that of either the tape or the direct-access device. Standard labels must be used. If the output is a direct-access device, BLKSIZE is determined by the system to optimize output DASD BLKSIZE. If BLKSIZE is specified in the JCL, that BLKSIZE is used.

If either of the two output copies has an "open" problem (message DFS301A) or fails the first PUT operation to either output data set (message DFS319A), the current control statement is terminated and the next control statement is processed.

Once the utility has proceeded beyond the first PUT, all I/O errors caused by output data set result in RC=08, but the utility continues to copy to the remaining output data set. Each image copy control statement is treated as an independent copy; the last return code is the highest received for the job.

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

For details, see ICOUT keyword and STACK keyword.

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.

DSSSTATS DD

This statement specifies the optional output message data set for messages on statistics of DFSMSdss User Interaction module (UIM) processing when Advanced Image Copy Services is used. If this statement is present, IMS HP Image Copy creates the DFSMSDSS User Interaction Module (UIM) Statistics report, which includes information about UIM processing, such as the start and the end time, task ID, and target database name.

CHKPTDD DD

This statement is a function-unique DD statement for the Checkpoint Restart option. The DD statement is effective when RESTART=Y|N|C is specified. This statement defines the checkpoint file. It must be the same file used for both a particular checkpoint and for the associated attempted subsequent restarts. Additionally, the file must be preallocated and cataloged before the requested checkpoint or restart. If the checkpoint file (CHKPTDD) is not defined in the job step or is DD DUMMY, then the Checkpoint Restart processing is bypassed. However, the requested functions are attempted.

For details, see RESTART keyword.

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.

FABJHRDD DD

This statement is a function-unique DD statement for Checkpoint Restart. It is used with the HASH option of the RESTART keyword. This DD statement is effective when RESTART=(Y,HASH) and HDPC=Y are specified. The file must be preallocated and cataloged before running the requested checkpoint or restart. If the HASH record file (FABJHRDD) is not defined in the job step or is DD DUMMY, the HASH record validation that uses FABJHRDD is bypassed.

This DD defines the validation of the HASH record file, which is used at restart time. It must be the same file that is used for both a particular checkpoint and for the associated attempted subsequent restarts. If HASH Check finds, at the restart time, the same hash error as in the previous run, IMS HP Image Copy regards it as the database having fatal error, and does not restart the next run.

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.

SYSABEND DD

SYSUDUMP DD

These statements define a dump data set. If both statements are present, the last occurrence is used for the dump.