Copy utility options

The general copy options enable you to specify the utilities to be used during a backup. Most apply to all supported copy utilities.

Option

Description

COPY_UTILITY

Select the backup utility to be used, as follows:

ACPMAIN—BMC AMI Copy
AFRMAIN—BMC AMI Recover - OUTCOPY
DSNUTILB—IBM Db2 COPY

REGION_SIZE

Specify the amount of virtual storage used by the copy utility. The default value is 4 MB. The valid range is -1 through 2047 MB.

A value of -1 specifies that BMC AMI Recovery Manager will not generate region size at the step level. BMC AMI Recovery Manager JCL generation recognizes the -1 value and does not generate REGION=.

Important

For best performance, we recommend a region size of 0 MB, in which case the amount of virtual storage needed to run the job is automatically made available when the recover utility runs. Some data centers do not allow a region size of 0 MB, so 4 MB usually ensures adequate storage.

QUIESCE_BEFORE

Establish a quiesce point for each table space in the object set before the copy process starts.

QUIESCE_AFTER

Establish a quiesce point for each space in the object set immediately after the copy process completes.

QUIESCE_GROUP

Establish a common quiesce point for all table spaces within the current object set. This option is ignored if QUIESCE_BEFORE and QUIESCE_AFTER are set to NO.

QUIESCE_WRITE

Instruct Db2 to finish writing any pending transactions for the target spaces before applying the quiesce. This option is ignored if QUIESCE_BEFORE and QUIESCE_AFTER are set to NO.

COPY_INDEX_SPACES

Specify whether to back up eligible index spaces. YES specifies to back up all eligible indexes. AUTO specifies to back up indexes as large or larger than the size specified by the INDEX_SIZE_THRESHOLD option.

Index spaces are eligible for backup if the following conditions exist:

For BMC AMI Copy, the Db2 release is Version 5.1 or greater and FULL YES is specified.
For IBM Db2 COPY, the Db2 release is Version 6.1 or greater, FULL YES is specified, and the index has the COPY YES attribute.

INDEX_SIZE_THRESHOLD_TYPE

Specify the unit of measure for the threshold size, as follows:

K - Kilobytes
M - Megabytes
G - Gigabytes

INDEX_SIZE_THRESHOLD

Specify the size threshold at which you want indexes backed up rather than rebuilt. This option is used in conjunction with COPY_INDEX_SPACE AUTO. You can enter the size as follows:

0-4194303 if using M as the index size threshold type
0-4294967295 if using K as the index size threshold type
0-4095 if using G as the index size threshold type

OUTPUT_TYPE_copyType

Specify the types of image copies to be made for the spaces in the object set, where copyType is

LP—local site primary
LB—local site backup
RP—recovery site primary
RB—recovery site backup
You cannot make a backup copy unless you make a corresponding primary copy. Similarly, you cannot make a recovery site copy without making a local copy.
Important
Online Consistent Copy does not support LB, RP, or RB copies. If you select BMC AMI Copy as the copy utility with SHRLEVEL Change Consistent, BMC AMI Recovery Manager overrides requests for those copies, which will not be made. You can make LB, RP, and RB copies using COPY IMAGECOPY in the BMC AMI Copy options. BMC AMI Recovery Manager will use BMC AMI Copy to make the copies from the copy created by Online Consistent Copy.

SCOPE

Specify the scope of the copy operation for the specified objects. This option is only displayed when working with Db2 Version 10 or later, and when you use DSNUTILB as the backup utility.

Value	Description
ALL	(Default) indicates that all specified objects should be copied.
PENDING	Indicates that only objects in Db2 status of COPY-pending (COPY) or information COPY-pending (ICOPY) will be copied.

This section contains the following topics:

Copy utility options

On this page