Skip to Content
Information
Space announcement We are no longer updating this space, and you cannot comment on this space. The CHANGE ACCUMULATION PLUS component is now documented in BMC AMI Backup and Recovery for IMS.

CAPREF keyword

The CAPREF keyword identifies the data set name prefix of the change accumulation output data set if you use dynamic allocation.

The prefix name is combined with the change accumulation group name to create the new change accumulation output data set name. The basic format of the generated data set name is as follows:

'prefix.CAn .group.GnnnnV nn'

Uses

Global options module. Optional on these control statements:

  • GLBL
  • GROUP

Related keywords

If you use CAALLOC(Y) to dynamically allocate the change accumulation output, you must also use either the CAPREF keyword or the Data Set Name user exit. Refer to Data-Set-Name-user-exit and to the following keywords:

Syntax

CAPREF(value)

Value

dsnprefix

1-33 alphanumeric characters that identify 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. If generation data groups (GDGs) are used, the generation number (GnnnnVnn) is concatenated to the end of the name. If stacking is used, the date and time (DyydddThhmmm) are concatenated to the end of the name.

Error
Warning

Even though the CAPREF 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 Change Accumulation utility to abend.

Default

None


Related topic

CAPSYSIN keywords


 

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

CHANGE ACCUMULATION PLUS 5.1