ICOUT keyword

The ICOUT keyword specifies the DD name of the output image copy data set.

Functions that support this keyword

Image Copy function
Create Image Copy function

Statements that support this keyword

GLOBAL statement
GROUP statement
IC/AIC statement
CIC/ACIC statement
CRC statement

Either the ICOUT or the STACK keyword is required in these statements.

Site default option

Supported

Related keyword

None.

Format

To create no image copy data sets:

To create only the primary image copy data set:

To create the primary and the secondary image copy data sets:

To create three image copy data sets:

To create four or more image copy data sets:

ddname1

The DD name of the primary output data set.

ddname2

The DD name of the secondary output data set.

%NO

Runs HASH Check but does not create output image copy data sets. You can specify this parameter only for the Image Copy function.

%STACK

The keyword parameter for the secondary image copy data set that is stacked when the process for the primary image copy is Advanced Image Copy Services and the output format is Fast Recovery image copy format.

%STACK is effective under the following conditions:

FASTIC=(REQ|PREF,COPY): The format of the primary image copy data set is Fast Recovery image copy format.
OFFLDTYPE=S and OFFLDSTACK=* or OFFLDSTACK=ddname: The secondary image copy data set is stacked.

ddname3

The DD name of the third output data set.

ddname4

The DD name of the fourth output data set.

ddname5

The DD name of the fifth output data set. You can specify this parameter only for the Create Image Copy function.

ddname6

The DD name of the sixth output data set. You can specify this parameter only for the Create Image Copy function.

ddname7

The DD name of the seventh output data set. You can specify this parameter only for the Create Image Copy function.

*

Specifies that the DD name of the output image copy is determined internally. The output image copy data set is dynamically allocated.

(*,*,*,...,*)

Specifies that output image copy data sets (one for each asterisk) are allocated dynamically.

Examples:

To create two image copy data sets with specific data set names, specify the keyword as follows:
```
ICOUT=(ICOUT1,ICOUT2)
```
where ICOUT1 DD and ICOUT2 DD define the actual data set names.
To create four image copy data sets without specifying their names, specify the keyword as follows:
```
ICOUT=(*,*,*,*)
```
To create three image copy data sets and to specify the name only for the third image copy data set, specify the keyword as follows:
```
ICOUT=(*,*,ICOUT3)
```
where ICOUT3 DD defines the actual data set name.

Default value

None.

Usage notes

The ICOUT and the STACK keywords are mutually exclusive.
The value for ICOUT or STACK can be defined in the site default table.
ICOUT=ddn and ICOUT=(ddn1,ddn2,..) cannot be specified in the GLOBAL statement and in the site default table.
ICOUT=%NO cannot be specified in the site default table.
ICOUT=* is the default value for the Image Copy function under IMS Database Reorganization Expert and IMS Database Recovery Facility.
If ICOUT=%NO is specified for all databases when the HASH Check option is not requested, the image copy processing ends with a return code of 16, and error message FABJ0252E is issued.
Checkpoint Restart cannot be enabled for the database or the area when ICOUT=%NO. Even when Checkpoint Restart is requested and a process error is found during the job, the database or the area is not reprocessed by Checkpoint Restart.
If you request more than two image copies and if DBRC=Y is specified, only the primary and secondary image copy data sets are registered to the DBRC RECON data set.
If an error is found in the primary or the secondary image copy data set while processing the Image Copy function, the third and the fourth image copies are not registered to the DBRC RECON data set.
When one of the following conditions is met, the maximum number of image copy data sets that the Image Copy function can create for each database data set in a single run is two.
- Fast Recovery image copy format of Advanced Image Copy Services is requested (FASTIC=(opt,COPY))
- IMS HP Image Copy process is called from one of the following IMS Tools:
  - Parallel Reorganization Service of IMS Database Reorganization Expert
  - IMS HP Fast Path Utilities
  - IMS Database Recovery Facility
  - IMS Online Reorganization Facility