DD statements for the Create Image Copy 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 Create Image Copy function.

Table 1. DD statements for the Create Image Copy
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
ICEIN	Input	LRECL=80	Required
ICEPRINT	Output	LRECL=133	Required
SYSABEND or SYSUDUMP	Output	LRECL=133	Optional
ICERPRT	Output	LRECL=133	Optional
ICEDLIST	Output	LRECL=133	Optional
`ic-ddname`	Input		Optional ^{(See Note 2)}
`dataout1`	Output	RECFM=FB, VBS, or U	Required ^{(See Note 2)}
`dataout2-dataout7`	Output	RECFM=FB, VBS, or U	Optional ^{(See Note 2)}
`stack1`	Output	RECFM=FB, VBS, or U	Required ^{(See Note 2)}
`stack1-7`	Output	RECFM=FB, VBS, or U	Optional ^{(See Note 2)}
DSSPRINT	Output	LRECL=133	Optional
HPSRETCD	Input	LRECL=80	Optional
FABJDRSN	Input	LRECL=80	Optional
Notes: Do not specify these DD statements if you want the RECON data sets allocated dynamically. 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 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:

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.

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 Create 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).

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 Create Image Copy report. 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).

ic-ddname DD

This statement defines the input image copy data set to be used for creating a new image copy data set. 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, the Image Copy 2 utility, or the HISAM Reorganization Unload utility.)

To have the Create Image Copy function allocate the input data set dynamically, omit this DD statement and specify the DSDALLOC=YES parameter and its associated allocation parameters in the ICEIN 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. 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 volume or a tape.

Standard labels must be used. If the track size of the output direct-access device exceeds 32 KB, and no DCB is explicitly specified, the BLKSIZE of the block in which multiple blocks can reside on a track is used as the default value, unless the database record is larger than the capacity of a half track. If BLKSIZE is specified in the JCL, that BLKSIZE is used.

To have the Create Image Copy function allocate the output data set dynamically, 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.

dataout2 DD or stack2 DD

dataout3 DD or stack3 DD

dataout4 DD or stack4 DD

dataout5 DD or stack5 DD

dataout6 DD or stack6 DD

dataout7 DD or stack7 DD

This statement is required only if the associated utility control statement requests that more than two copies of the dump be created. The name must appear in the control statement, and must be that of either the tape or the direct-access device. Standard labels must be used. If the track size of the output direct-access device exceeds 32 KB and no DCB is explicitly specified, the BLKSIZE of the block in which multiple blocks can reside in a track is used as the default value, unless the database record is larger than the capacity of a half track. If BLKSIZE is specified in the JCL, that BLKSIZE is used.

Once the utility has proceeded beyond the first PUT, all I/O errors caused by either output data set result in RC=08. The Create Image Copy function does not continue to process the subsequent output data sets.

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.