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.
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. |
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. |
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 |
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 |
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 |
Empty Keyword: EMPTY | YES | Avoids making a copy when no pages changed since the last incremental copy was made |
Full copy Keyword: FULL | YES | Specifies whether to make full or incremental image copies
|
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. |
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 |
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). |
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. |
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. |
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. |
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:
|
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:
|
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:
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:
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 |
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. |
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. |
Separate by partition Keyword: PART | NO | Specifies making copies by partition when backing up partitioned table spaces |
Shrlevel Keyword: SHRLEVEL | Reference | Specifies the level of access to the target spaces that BMC AMI Copy permits during the copy process, as follows:
|
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, |
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:
|
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:
|
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:
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 |
Related topics