Using the ICOUT keyword

If the ICOUT keyword is specified, the output image copy data sets are created as non-stacked data sets.

The value for the ICOUT keyword can be ddn or an asterisk (*).

Subtopics:

ICOUT=ddn

If you specify the ICOUT keyword with a specific ddname as, for example:

   IC DBD=HDAMDB,DDN=HDAMDD,ICOUT=IC01

IMS HP Image Copy dynamically allocates the output image copy data set if the ICDALLOC=Y parameter is specified (either explicitly or by default) and the corresponding DD statement is not specified in the JCL.

IMS HP Image Copy internally constructs the name of the output image copy data set. See Naming convention for the naming convention of output image copy data sets.

The allocation attribute keywords such as VOLUME, DATACLAS, and UNIT used for dynamic allocation are retrieved from the specified parameters or hardcoded defaults. IMS HP Image Copy tries to allocate the output data set dynamically with the data set displacement of OLD. If the data set is not found, IMS HP Image Copy dynamically allocates the data set with a displacement of NEW. You can control whether to catalog the data set name by name or not, by using the ICCAT keyword.

ICOUT=*

If you specify as an asterisk (*) for the ICOUT keyword, for example:

   IC DBD=HDAMDB,DDN=HDAMDD,ICOUT=*

IMS HP Image Copy dynamically allocates the output image copy data set if the ICDALLOC=Y parameter is specified (either explicitly or by default).

IMS HP Image Copy internally constructs the ddname and the data set name for dynamic allocation. See Naming convention for the naming convention of output image copy data sets.

Other specifications are the same as when a specific ddname is used.

Naming convention

When IMS HP Image Copy dynamically allocates an output image copy data set, it determines the name of the output data set based on the naming template or the value of the ICNMRULE keyword.
  • If the data set naming template is defined and no ICNMRULE keyword is supplied, the data set name is generated based on the naming template.
  • If both the data set naming template is defined and an ICNMRULE keyword is supplied, the data set name is generated based on the naming template.
  • If neither the data set naming template nor the ICNMRULE keyword is supplied, ICNMRULE=N is applied and the data set name is generated following the ICNMRULE=N naming convention.
  • If only the ICNMRULE keyword is supplied, the data set name is generated following the ICNMRULE naming convention.

Data set names generated from the ICNMRULE keyword naming convention:

If ICNMRULE=Y:
ichlq.ICn.dbdname.ddnameDyyddd.Thhmmss
If ICNMRULE=N:
ichlq.ICn.dbdname.ddname

where:

ichlq
The value specified for the ICHLQ keyword.
n
1 or 2, indicating primary or secondary copy.
dbdname
The DBD name or partition DBD name of the database to be copied.
ddname
The DD name of the target data set group or area to be copied.
yyddd
Date.
hhmmss
Time stamp.

First, IMS HP Image Copy tries to dynamically allocate the output data set with a data set displacement of OLD. If the data set is not found, IMS HP Image Copy dynamically then allocates the output data set with a displacement of NEW. You can control whether to catalog the data set name by name or not, by using the ICCAT keyword.