Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Recovery Manager for Db2 13.1.

BMC AMI Copy backup options


The options are listed alphabetically in the following table along with the defaults which, in this instance, are almost all 

BMC AMI Copy

 defaults.

Important

If configuration option value is indicated as the default value, BMC AMI Recovery Manager does not generate the keyword in the JCL. This enables the BMC AMI Copy configuration option value to be used.

For more detailed information about the BMC AMI Copy utility options that you can use with BMC AMI Recovery Manager, see the BMC AMI Copy for Db2 documentation.

Option/BMC AMI Copy keyword

Default value

Description

ACPGDG data set

Keyword: ACPGDG

Null

Specifies the name of a data set that is used to define a GDG base when no data set is named on the output copy data set options panel

The data set must contain the control cards that are necessary to perform an IDCAMS DEFINE as well as the symbolic variable &BASE, which BMC AMI Copy replaces with the GDG base name.

After Init Phase

Keyword: INIT

CONTINUE

Causes BMC AMI Copy to pause or continue after completing XBM registration of SHRLEVEL CONCURRENT copies

The job halts after all INIT processing for a group of table spaces completes. At that time, all of the affected table spaces are under control of XBM. For more information, see the BMC AMI Copy for Db2 documentation.

Important

Pause is valid only when you specify Shrlevel Concurrent Required and Group Yes

Auto read percent:

Keyword: READPCT

Configuration option value

specifies the percentage of changed pages that must occur to allow escalation from random I/O to full table space scan.

Important

This option is valid only when you specify Readtype and either Full No or Full Auto.

Checkerror

Keyword: CHECKERR

Configuration option value

Specifies an integral number from 1 through 254 to use as a condition code when encountering page checking errors. A code greater than 4 causes job termination at the point of error.

Checktslevel

Keyword: CHECKTSLEVEL

Configuration option value

Specifies the level of table space checking to identify damaged pages during copying, as follows:

0—standard minimal checking

1— intrapage integrity checks for all pages

2— both intrapage and interpage checks for all pages

Cumulative

Keyword: CUMULATIVE

YES

Merges the requested incremental RESETMOD NO copy with the most recent prior incremental RESETMOD NO copy

Important

This option is valid only when you specify Full No or Full Auto.

Day of the week

Keyword: FULLDAY

Null

Specifies a day of the week on which a full copy will be made. Valid values are as follows:

1—Monday

2—Tuesday

3—Wednesday

4—Thursday

5—Friday

6—Saturday

7—Sunday

Important

This option overrides all other Full Auto options and is valid only when you specify Full Auto.

DSSNAP

Keyword: DSSNAP

NO

Specifies making a hardware-based Instant Snapshot copy of Db2 data, as follows:

Yes—make an Instant Snapshot copy

Auto—made a hardware copy if possible, but fall back to a standard copy if the hardware copy fails (for example if XBM, SUF, or the required hardware is not in place)

No—make a standard copy

Important

The BMC BMC AMI Copy and XBM or SUF products are required to use this option. DSSNAP is incompatible with the ENCIPHER option. DSSNAP is incompatible with groups containing compressed indexes. DSSNAP requires RESETMOD NO.

Empty

Keyword: EMPTY

YES

Avoids making a copy when no pages changed since the last incremental copy was made

Important

This option is valid only when you specify Full No or Full Auto.

Full copy

Keyword: FULL

YES

Specifies whether to make full or incremental image copies

  • Yes—full image copy
  • No—incremental copy
  • Auto—automatically escalates to a full copy when it encounters one of the following conditions:
    • An entry in SYSCOPY prohibits an incremental copy.
    • The target object or partition is in copy pending status.
    • The target is a special case catalog or directory table space.
    • A specified number of incremental copies is reached.
    • A specified percentage of changed pages is reached.
    • A specified day of the week occurs.

Important

Full percent

Incremental percent

Keyword:

FULLPCT

INCRPCT

Configuration option value

Use the Full percent and Incremental percent options together to determine whether no copy, an incremental copy, or a full copy is made

Enter the incremental and full percentage values in either decimal or integer format. Valid integer values range from 0 to 100. Valid decimal values are 00.0 to 99.9. A decimal value can only be specified to the tenth’s place (1/10 of a percent).

To create an incremental copy when changed pages are between two limits, provide the lower limit at Incremental percent and the upper limit at Full percent. No copy is made if changed pages are less than or equal to Incremental percent.

To create a full copy when changed pages are equal to or more than a specific limit, provide that limit at Full percent.

Important

This option is valid only when you specify Full Auto.

Group

Keyword: GROUP

NO

Specifies that all spaces in the BMC AMI Recovery Manager group share a common consistent point

Keep previous

Keyword: KEEP

YES

Retains the entry for the most recent prior (merged) incremental copy in the SYSCOPY table

Important

This option is valid only when you specify Full No or Full Auto.

Maximum incrementals

Keyword: MAXINCRS

Configuration option value

Escalates to a full image copy when the number of incremental copies that are registered in SYSCOPY since the last full copy reaches a number that you specify (1 through 100).

Important

This option is valid only when you specify Full Auto.

Maximum tasks

Keyword: MAXTASKS

configuration option value

Specifies the maximum number of tape tasks and the maximum number of tasks that are used by BMC AMI Copy when making image copies.

Important

You must specify Group Yes to be able to use MAXTASKS for multitasking.

Minimum pages

Keyword: MINPAGES

configuration option value

Specifies the minimum number of pages that must exist in a space or partition before an incremental copy can be made.

Valid values are 1 through 999999. If the number of pages is less than this value, a full copy is made.

Important

This option is valid only when you specify Full Auto.

NACTIVE

Keyword: NACTIVE

NO

Specifies whether to update the NACTIVE statistic in SYSIBM.SYSTABLESPACE.

BMC AMI Recovery Manager uses the NACTIVE statistic in SYSIBM.SYSTABLESPACE (which shows the number of active pages in the table space) for sizing and group split optimization.

Important

This option is valid only when you specify Full Yes or Full Auto.

Number of read/write buffers

Keyword: NBRBUFS

configuration option value

Specifies the number of read/write buffers to use

Valid values are integers from 2 through 16.

ON DUPLICATEDS

Keyword: ON DUPLICATEDS

Configuration option value

Specifies what action to take if BMC AMI Copy encounters a copy data set that is already registered in SYSCOPY or BMCXCOPY, as follows:

  • ERROR—terminate processing if the data set is already registered
  • DELETE—continue processing when a data set is already registered. When BMC AMI Copy registers the new copy, it deletes the row containing the duplicate data set in SYSCOPY or BMCXCOPY. Only rows with the same DSNAME, TSNAME (IXNAME), or DSNUM as the new copy are deleted.

ON ERROR BADSTATUS

Keyword: ON ERROR BADSTATUS

configuration option value

Specifies how to proceed when BMC AMI Copy encounters a table space or partition that has an unacceptable status or has a BMC or Db2 utility running against it, as follows:

  • END—terminate processing with a RC=12
  • SKIP—issue a message, skip over the space, and continue processing

ON ERROR ICEXISTS

Keyword: ON ERROR ICEXISTS

Configuration option value

Specifies how to proceed if BMC AMI Copy encounters a table space or partition for which an image copy already exists, as follows:

  • END—terminate processing with a RC=12
  • SKIP—issue a message, skip over the space, and continue processing other spaces as specified.

This option is effective for the COPY IMAGECOPY command.

ON ERROR NOTSUPPORTED

Keyword: ON ERROR NOTSUPPORTED

Configuration option value

Specifies how to proceed if BMC AMI Copy encounters a table space or partition that is of a type that is not supported by BMC AMI Copy, as follows:

  • END—terminate processing with a RC=12
  • SKIP—issue a message, skip over the space, and continue processing other spaces as specified.

This option is effective for both the COPY and COPY IMAGECOPY commands.

Outsize threshold for BIGDDN

Keyword: OUTSIZE

configuration option value

Specifies a size threshold for making copies to an alternate DD or output descriptor

This option can be used to escalate output to tape rather than DASD. OUTSIZE is specified as number of pages from 0 through 999999. The default is 0, which means this option has no effect.

OUTSIZE can be used with any FULL option. The size of the copy is based on the size of a full copy.

Readtype

Keyword: READTYPE

RANDOM

Specifies the method that is used to make incremental copies

Random—use the conventional (random I/O) method of making incremental copies

Fullscan—use full table space scan techniques to identify changed pages

Auto—determine the I/O method based on the number of changed pages

Important

This option is valid only when you specify Full No or Full Auto.

Report statistics

Keyword: REPORT

NO

Reports statistics via SYSPRINT

This option is used in conjunction with the RUNSTATS option.

Resetmod

Keyword: RESETMOD

Configuration option value

Specifies whether to reset the modified page indicators in the table spaces and space maps after you make an image copy.

Resync

Keyword: RESYNC

YES

Instructs XBM or SUF to resynchronize hardware mirroring activities after an Instant Snapshot copy. You can specify No to leave the mirrors unsynchronized during subsequent user processing. If you choose No, you must manually reestablish the mirroring synchronization using XBM or SUF.

Important

This option is ignored if the Instant Snapshot copy is made without hardware mirroring in place.

RUNSTATS

Keyword: RUNSTATS

NO

Updates the Db2 catalog or the BMCSTATS table with statistics that are collected concurrently with the creation of full image copies

If you collect statistics, you can also choose to report statistics (Report statistics option) and specify how the Db2 catalog tables or the BMCSTATS table should be updated.

Important

To use this option, you must specify Yes for at least one of the following two suboptions:

  • Update BMCSTATS
  • Update Db2 catalog

Separate by partition

Keyword: PART

NO

Specifies making copies by partition when backing up partitioned table spaces

Important

  • This option is valid when the objects have not been listed by part
  • This option is invalid with OBJECTSET syntax

Shrlevel

Keyword: SHRLEVEL

Reference

Specifies the level of access to the target spaces that BMC AMI Copy permits during the copy process, as follows:

  • Reference—allows only read-only access by other programs during the copy process.
  • Change—maintains the initial level of access of the spaces.
  • Any—uses Shrlevel Change unless BMC AMI Copy encounters any conditions that require more restrictive access.
  • None—stops all access by other programs to the target spaces during the copy process.
  • Concurrent—utilizes the SUF product to make consistent copies of the table spaces while updates to those table spaces are in progress. You can specify a value of required or preferred for this option.

    • Concurrent required—terminates the copy with a return code of 12 if a consistent point cannot be obtained or maintained.
    • Concurrent preferred—uses Shrlevel Change when a consistent copy cannot be obtained or maintained or if initialization of the SUF or XBM fails.

    Important

    Shrlevel Concurrent is not valid with compressed indexes.

  • Change Consistent Yes—use for Online Consistent Copy. This option requires a solution password and must be set at the group level.

Squeeze

Keyword: SQUEEZE

Configuration option value

Specifies whether to consolidate the rows on each target table space page so that all free space is contiguous

This option is obsolete for BMC AMI Copy version 6.3 and later.

Start message

Keyword: STARTMSG

Null

Writes a string of not more than 50 characters to the operating system system log

This option is valid only with Group Yes and when using SUF to make Shrlevel Concurrent copies,

Important

Do not use quotation marks in the Start message field. Doing so will result in an error message at run time.

Support Full Copy DDs (FULLDDN)

Keyword:

FULLDDN

FULLDSN

Null

Instructs BMC AMI Copy to use an alternative descriptor for COPYDDN when the FULL AUTO FULLPCT settings cause a full copy to be made

If you specify Yes and a full copy is made, the image copy output goes to an alternate set of DDs that are specified with the following keywords:

Support OUTSIZE option (BIGDDN)

Keyword:

BIGDDN/

BIGDSN/

BIGRECDDN/

BIGRECDSN

NO

Instructs BMC AMI Copy to use an alternative descriptor for COPYDDN when the number of pages to copy is equal to or greater than the outsize threshold value

If you specify Yes and the threshold condition is met or exceeded, the image copy output goes to an alternate set of DDs that are specified with the following keywords:

  • BIGDDN
  • BIGDSN
  • BIGRECDDN
  • BIGRECDSN

Unit Count

Keyword: UNITCNT

Null

Specifies the number of units to be allocated for the output image copy data sets. Valid values are 0 to 59. Zero (0) enables you to control the unit count with SMS if required. The default is no unit count at all.

If you are using DSNUTILB COPY, you can cause BMC AMI Recovery Manager to calculate the unit count by setting a value in Max primary allocation.

Update BMCSTATS table

Keyword: BMCSTATS

NO

Collects statistics and update the BMCSTATS table.

This option is used in conjunction with the RUNSTATS option.

Update DB2 catalog

Keyword: UPDATE

ALL

Updates the Db2 catalog as follows:

  • All—updates all appropriate Db2 catalog tables
  • None—makes no update to any tables
  • Accesspath—updates only tables that are used for access path selection
  • Space—updates only those columns that are used to assess table space status

Use COPY IMAGECOPY to make output type

Keyword: none

NO

Uses the BMC AMI Copy COPY IMAGECOPY command after a copy job to make additional image copies from a local site primary copy that is already registered in SYSCOPY, as follows:

  • LB —local site backup copy.
  • RP—recovery site primary copy.
  • RB—recovery site backup copy

Important

You cannot make a copy of a type that is already registered in SYSCOPY. Successful copies are automatically registered in SYSCOPY.

COPY IMAGECOPY is incompatible with compressed indexes.

XBMID

Keyword: XBMID

Configuration option value

Specifies the XBM subsystem ID (1-8 characters) to be used when making Shrlevel Concurrent copies




 

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