Space announcement We are no longer updating this space, and you cannot comment on this space. The IMAGE COPY PLUS component is now documented in BMC AMI Backup and Recovery for IMS.

STKIC keyword


Use the STKIC keyword to specify ddnames when you want to stack output image copy data sets.

If the DD statement (for the ddname you specify) is present in the JCL, the utility uses it to dynamically allocate the data sets.

If the DD statement (for the ddname you specify) is not present in the JCL, the utility does the following:

  • dynamically allocates only the tape unit when you specify ICALLOC(Y)
  • abends when you specify ICALLOC(N)

The utility places the output of each copy function that references the same DD statement on the tape volume allocated to that DD statement and writes one copy of the output image copy data set to each ddname listed.

For dynamic allocation, you need to supply a data set name prefix by using the ICPREF keyword or the data set name user exit (ICP$DSN or RCU$DSN). For information about other keywords to use with dynamic allocation, see Dynamic-allocation.

When stacking in asynchronous mode, the utility writes the output to the tape based on the scheduling of the function. The data sets on the tape may not be in the same order from job to job and may not be in the same order as the input control statements. Therefore, if you need to stack the data sets on the tape in a certain order, you must specify the synchronous mode.

Important

For the Image Copy function that is executed under a BMC AMI Reorg for IMS
 solution, the STKIC keyword is invalid.

Uses

Optional on the following control statements:

  • GROUP
  • IC and AIC (Either IC or STKIC is required unless specified on the GROUP control statement.)
  • OIC and AOIC (Either IC or STKIC is required unless specified on the GROUP control statement.)
  • CIC and ACIC (Either IC or STKIC is required unless specified on the GROUP control statement.)
  • IIC and AIIC (Either IC or STKIC is required unless specified on the GROUP control statement.)
  • REC and AREC

Related keywords

If you use the STKIC keyword, do not use the IC keyword; they are mutually exclusive. Refer also to the following keywords:

Syntax

STKIC(ddname,ddname,...)

Values

For the value, specify the ddname (1-8 alphanumeric characters). You can specify a series of up to 10 ddnames, separated with commas. You cannot specify a value that is the same value specified with the NAME keyword on a STACK control statement.

Default

None


Related topic


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*