BMC AMI Recover installation options

The BMC AMI Recover for Db2 product is installed by using the Installation System from BMC. During the installation, the customization process generates a customized installation data set.

This data set contains customized jobs that install BMC AMI Recover into your specific IBM Db2 environment. One of these jobs, $C30DOPT, establishes the default processing option values that BMC AMI Recover uses.

The $C30DOPT job assembles the options macro. The macro contains the BMC AMI Recover processing options and the values for those options that are shipped with BMC AMI Recover. 

Related topics

Checkpoints-for-BMC-AMI-Recover-restart

Determining-sort-work-space-requirements

BMC AMI Recover installation options that affect restart—CHECKPT and CHECKINT

When the Installation System-generated customization job is submitted, it links the AFR$OPTS installation options module in the APF-authorized library that is designated by your site. If any values for these options are changed during customization, the new values override the values from the options macro.

You can customize the installation of BMC AMI Recover by changing the values for the BMC AMI Recover installation options. However, if you change any of the values in $C30DOPT after BMC AMI Recover has been installed, you must rerun the jobs for these changes to take effect.

You can also create additional options modules that allow you to use different values of these options for different executions of BMC AMI Recover. For example, you might use the default installation options module for most jobs but create another options module with customized values for certain options for special situations. For information about specifying an options module at runtime, see Checkpoint override parameter (checkPt). For more information about customizing your installation of BMC AMI Recover, see the Installation System and the Customizing Backup and Recovery.

Installation options macro listing

Click here to see the installation options macro listing for BMC AMI Recover
$AFROPTS  &TBUFFS=1000,          BUFFER MANAGER PAGES                      X
          &PLANRECV=AFRBvvr,     AMI RECOVER MAIN PLAN NAME               X
          &OPNDB2ID=YES,         USE DB2 RACF ID                           X
          &CHECKPT=PHASE,        CHECKPOINT FOR RESTART                    X
          &CHECKINT=0,           INTERVAL BETWEEN CHECKPOINTS (MIN)        X
          &RDB2STAT=YES,         RESTORE ORIGNAL STATUS OF SPACES          X
          &RCLTSK=10,            MAXIMUM RECALL TASKS                      X
          &AMSCAT=NO,            USE CATALOG OPTION IN IDCAMS DEFINE       X
          &INDEXLOG=NO,          SPECIFY RECOVER INDEX BEHAVIOR            X
          &IXRECP=NO,            PUT INDEXES IN RECP STATUS if TS PIT RCVR X
          &OUTCOPY=ASCODED,      SPECIFY HOW TO CREATE OUTPUT IMAGE COPIES X
          &SORTDEVT=,            DEVICE TYPE FOR SORT WORK SPACE           X
          &SORTNUM=,             NUMBER OF ALLOCATED SORT WORK SPACE DSNS  X
          &MAXKSORT=,            MAXIMUM NUMBER OF INDEX KEY SORTS         X
          &MAXLOGS=5,            MAXIMUM LOGS TO ALLOCATE                  X
          &MAXDRIVE=,            MAXIMUM TAPE DRIVES TO BE USED            X
          &SMCORE=(0K,0K),       MEMORY FOR SORT                           X
          &RESINV=0K,            MEMORY RESERVED FOR IDCAMS                X
          &WKUNIT=SYSALLDA,      UNIT TO DYNAMICALLY ALLOCATE WORK FILES   X
          &XBMID=,               XBM SUBSYSTEM ID OR XBM GROUP NAME        X
          &WTOR=YES,             WTOR FOR SPACES IN STOPP STATUS           X
          &ERRCONT=10,           MAXIMUM TIMES TO CONT ON SEVERE ERROR     X
          &TZRULE=NONE           DAYLIGHT SAVINGS TIME (DST) SETTING       X
          &LOCCPSEL=(FC,LP,LB),  LOCAL SITE COPY PRIMARY, SECONDARY        X
          &LOCCASEL=(LP,LB),     LOCAL SITE CHANGE ACCUM PRIMARY,SECONDARY X
          &REMCPSEL=(RP,RB,FC),  REMOTE SITE COPY PRIMARY, SECONDARY       X
          &REMCASEL=(RP,RB),     REMOTE SITE CHANGE ACCUM PRIMARY,SECONDARYX
          &AUTOSIZE=YES,         SIZE OUTPUT COPIES AND OUTPUT ACCUM FILES X
          &CPUMIPS=200,          RATE THAT CPU CAN EXECUTE INSTRUCTIONS    X
          &DISKIORATE=100,       MEGABYTES PER SECOND READ FROM DISK       X
          &FCPPRC=NONE,          Control FOR SNAP=VSAM WITH FLASHCOPY      X
          &SNAP=HW,              RECOVER USING VSAM COPIES                 X
          &USELOGS=(ACT1,ACT2,ARC1,ARC2)    ORDER TO READ LOG FILES        X
          &KEYDSNAM=,            NAME OF KEY DATA SET FOR ENCRYPTION       X
          &BINDQUALIFIER=AFRvvr, AMI RECOVER BIND QUALIFIER               X
  &BMCSYSADM=, SYSADM ID FOR BINDSX
          &PUBLICPLAN=YES,       RUN AMI RECOVER WITH PUBLIC PRIVILEGE    X
          &DATAMVR=,             PROGRAM TO USE FOR NONSNAPPABLE DASD      X
          &HISTORY=YES,          BMC HISTORY TABLE                         X
          &MATCHING=AUTO ENFORCE SCHEMA MATCHING IN IMPORT AND MIGRATEX
          &MAXLSORT=0,           NUMBER OF PARALLEL MERGES AND LOG SORTS   X
          &KSORTSHARE=YES,       SHARE KEY SORTS                           X
          &AUX=NO,               INCLUDE AUXILIARY OBJECTS IN RECOVERY     X
          &BACKOUT=AUTO,         BACKOUT RECOVERY OPTION FOR PIT RECOVERY  X
          &USEHDROBIDS=YES,      USE OBIDS IN HEADER WHEN MIGRATING        X
          &ZIIP=ENABLED,         ENABLE USE OF IBM SYSTEM ZIIPS            X
          &EATTR=,               EXTENDED ATTRIBUTES SEQUENTIAL DATA SET   X
          &STORCLAS=,            SMS STORAGE CLASS                         X
          &DATACLAS=,            SMS DATA CLASS                            X
   &DEFINE=,     INSTANTIATE DEFINE NO OBJECTSX
   &RICHK= CHECK RI OBJECTSX
       &LONGLOG=CONTINUE, ACTION TO TAKE IF LONGLOG CONDITION EXISTS X                                
          &MAXRO=,         MAXIMUM NUMBER OF SECONDS FOR LAST LOG ITERATIONX
  &DELAY=1200,          WAIT TIME IN SECONDS BEFORE PERFORMING THE ACTION SPECIFIED IN LONGLOGX
  &DRNWAIT=,          NUMBER OF SECONDS TO WAIT DURING DRAIN  X                                    
  &DRNRETRY=1,       NUMBER OF DRAIN RETRY ATTEMPTS              X                 
  &DRNDELAY=,            MINIMUM NUMBER OF SECONDS BETWEEN DRAIN ATTEMPTS      X
  &WKSTOR=     SMS STORCLAS FOR SORT WORK DATASETSX

Quick reference of installation options

The following table describes the BMC AMI Recover installation options in alphabetical order and their default values:

BMC AMI Recover installation option

Default value 1

Brief description

NO

Defines use of catalog option in the IDCAMS define operation

YES

Specifies dynamic sizing for output image copies or change accumulation files

NO

Specifies whether the auxiliary objects related to a base table space should be included in recovery if the history table related to a specified system-maintained temporal table is included in the recovery

AUTO

Specifies the backout recovery option

AFRvvr

BMC AMI Recover bind qualifier (for example, AFR111)

None

SYSADM authid for binds

If BMCSYSADM is not set, BMC AMI Recover will default to Install Sysadm.   

0

The interval between checkpoints in minutes

PHASE

Checkpoint for restart

200

The rate at which a CPU can execute instructions in millions of instructions per second (MIPS)

None

SMS data class

None

Provides XBM with the name of the program to use to copy a data set if the data set is not on a snappable DASD

NO

Specifies if DEFINE NO objects should be instantiated

1200

Specifies the wait time in seconds before performing the action specified in LONGLOG

100

Number of megabytes per second that BMC AMI Recover can read from disk

DRNWAIT*DRNRETRY

Specifies the minimum number of seconds between drain attempts.
If you do not specify a value, DRNWAIT*DRNRETRY is considered as the default.

1

Specifies the number of drain retry attempts.

0

Specifies the number of seconds to wait during drain.

If you do not specify any value or you specify 0, it uses the value of the lock timeout subsystem parameter IRLMRWT.

None

Enables extended attributes to allocate an extended format sequential data set (supported by IBM z/OS Version 1.11 or later)

10

Maximum number of times to continue processing after encountering a severe error

None

Controls what happens if you specify SNAP=VSAM and the data sets are on a disk that is capable of IBM FlashCopy

YES

Specifies whether BMC AMI Recover should update the BMCHIST table

NO

Specifies RECOVER INDEX behavior

NO

Puts indexes in RECP status if TS PIT recovery

None

Specifies the name of the key data set that is used for encrypted copies

YES

Specifies whether key sorts should be shared, which determines the number of active key sorts (with MAXKSORT)

(LP, LB)

Resource selection for local site change accumulation files

(FC,LP,LB)

Resource selection for local site copies

CONTINUE

Specifies the action to take if the LONGLOG condition exists.

Auto

Specifies the behavior of IMPORT and MIGRATE commands when the source and target structures are not the same 

0

Specifies the maximum number of tape drives to be used

min((2 * the number of CPUs), 12)

Specifies the maximum number of index key sorts that can run concurrently

5

Specifies the maximum number of logs to allocate

0

Specifies the maximum number of log sorts that can run concurrently and determines the number of MERGE/RESTORE/SNAP phases that can run in parallel, regardless of whether log records are processed

0

Specifies the maximum number of seconds for the last log iteration.

If you specify 0 or do not specify a value, the lock timeout system parameter IRLMRWT is considered as the default value.

COMPAT

Specifies whether to use BMCSORT or AMISORT when sorting is required

YES

Specifies the use of the Db2 RACF ID

ASCODED

Specifies how to create output image copies

AFRBvvr

BMC AMI Recover main plan name

YES

Grants PUBLIC privilege to run BMC AMI Recover

10

Specifies the maximum number of recall tasks

YES

Restores original status of spaces

(RP, RB)

Resource selection for remote site change accumulation files

(RP,RB,FC)

Resource selection for remote site copies

0K

Specifies memory reserves for IDCAMS

NO

Specifies whether BMC AMI Recover should check for referential integrity constraints on the objects being recovered

(0K,0K)

Specifies memory for a sort

HW

Specifies whether BMC AMI Recover should recover using VSAM copies, even if the data set is not on a snappable disk

Determined by BMCSORT installation options

Specifies device type for sort work space

Determined by BMCSORT installation options

Specifies the number of allocated sort work space DSNs

none

SMS storage class

1000

Specifies the number of buffer manager pages

NONE

Specifies the rule that determines when daylight savings time (DST) begins and ends

(Use this installation option to enable DST adjustments.)

YES

Specifies whether the OBIDs in the header are valid.

(ACT1,ACT2,

ARC1,ARC2)

Specifies the order in which to read active and archive logs

None

Specifies a valid DFSMS storage class BMC AMI Recover uses for dynamic allocation of sort work data sets.

SYSALLDA

Specifies the unit to dynamically allocate work files

NO

Specifies whether to enable or disable the writing of diagnostic log records

YES

Specifies whether to issue WTOR if BMC AMI Recover finds spaces in STOPP status

None

Specifies the XBM subsystem ID or XBM group name for Instant Snapshots

ENABLED

Determines whether to enable zIIP processing

1 The default values for the installation options are those generated through the Installation System. You can use the Installation System to customize the default values for your site and save them in the Installation System profile variables.

 

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