ICPREF


The ICPREF keyword is optional on the GLBL, GROUP, IC, and AIC commands.

This keyword is available in ICPSYSIN; it is also available in global and database-specific options modules. The following table describes the keyword.

Output image copy data set name prefix keyword

To do this

Specify this in ICPSYSSIN

Identify a data set name prefix for the output image copy data set.

ICPREF(dsnprefix)

Internal default: None

A data set name prefix is required when you dynamically allocate an output image copy data set by using the ICALLOC(Y) and IC(*) keywords (as described in ICALLOC and IC). The prefix can be 1-33 characters. This prefix is the high-level qualifier of the data set name. The prefix can include periods and must conform to normal data set naming standards; it cannot end with a period.

For dynamic allocation, you must provide a data set name prefix or use a data set name user exit (ICP$DSN or RCU$DSN) that does not require a data set name prefix. For more information, see Using-the-image-copy-data-set-name-user-exit.

Do not specify prefixes SYS, PLUS, and DFS when using preallocated GDGs; the Image Copy function ignores ddnames with these prefixes.

Error
Warning

Even though the ICPREF keyword allows up to 33 characters for identifying the data set name prefix, the entire data set name can be only 44 characters. Because of the concatenations, a GDG or stacked data set name could easily exceed the 44-character limit. A data set name with more than 44 characters causes the Image Copy function to abend.

For more information about dynamic allocation, see Dynamic-allocation-of-image-copy-data-sets.

 

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

BMC AMI Online Reorg for IMS 5.1