SET OPTIONS for ARMBGPV

Reports the resources needed for the recovery of a object set. These resources include image copy data sets, log data sets, and R+/CHANGE ACCUM files. Use this report as a checklist of data sets that must be taken offsite in preparation for disaster recovery.

If the current subsystem is a member of a data sharing object set, the resources report is for the object set. Otherwise, the report is for the current subsystem. The report is written to the data set that is defined by the ARMRESRC DD statement. The default is YES.

Specify a return code that ARMBGPV should issue if it encounters an unrecoverable object during revalidation. The UNRECOVER_RC option is ignored if you choose the RECOVERABILITY NO option.

Valid values are 0 through 254, and the default value is 4. A value of zero causes no return code to be issued and values (even those higher than 4) do not affect the step execution. This return code does not control the overall job return code. If BMC AMI Recovery Manager encounters errors other than unrecoverable data, it sets the return code based on the most severe condition code found.

Unrecoverable objects are listed in the exception report (ARMXCEPT) if you request it using the RECOVERABILITY YES option, whether or not you specify UNRECOVER_RC.

An object is considered to be unrecoverable by ARMBGPV if it exists in any of the following states or if it has missing recovery resources:

• ALTER IX
• BAD TYPE
• DS LEVEL
• ENCRYPTION_REQUIRED
• LOG GONE
• NOCOPIES
• NOTAVAIL
• NOTCTLG
• TSREORP
• TS STAT

(SPE2104) You can use the Health Check option with UNRECOVER_RC. 

• The HEALTHCHECK command must always end with RC 0 unless UNRECOVER_RC is used to override it.
• Use the UNRECOVER_RC n option in conjunction with the EMAIL entry name EOJ_RC n to receive an email notification when a health check finds something that needs to be addressed.
• The changed objects option is not affected by UNRECOVER_RC.

Determines whether the selected reports are generated by using the local site or recovery site resources. The default is LOCAL.

If you specify Db2 Recover (DSNUTILB) as the recovery utility for the object set and if you specify the DSNUTILB site type in the DSNUTILB-specific options, then the SITETYPE option is ignored. Also, if you use BMC AMI Recover alternate resources and you select the RP or RB copy as your first choice for the image copy in the recovery options, BMC AMI Recovery Manager considers the site type to be RECOVERY regardless of what you specify here.

Validates the availability of resources required for a BACKOUT AUTO, BACKOUT NO, or BACKOUT YES recovery. This option is available when using BMC AMI Recover or Db2 RECOVER (DSNUTILB) as the recovery utility.

BACKOUT AUTO is only available when you are using the Recovery Management solution password. The default is AUTO if you are using BMC AMI Recovery Manager as part of the Recovery Management solution. Otherwise, the default is NO.

You must specify QUIESCE or SPECIFIC LOGPOINT as the recovery point to use BACKOUT AUTO or BACKOUT YES. If you specify TOCURRENT, BMC AMI Recovery Manager overrides the BACKOUT AUTO and converts the option to BACKOUT NO.

Specifies whether inflight units of work are to be resolved during a recovery to a user-specified RBA or LRSN. This option is only valid for a recovery using TOLOGPOINT and is available only with the Recovery Management for Db2 solution. For more information, see the section about timestamp recovery in the Recovery Management for Db2 documentation.

(Optional) Enables the user to request email notification. You are required to set up an email entry in the EMAILDST member of the CNTL data set.

• EMAIL entry name SUMMARY:  Use the EMAIL entryName SUMMARY option to email a Summary Report. The entry name must pass the same validation as a PDS member name.

• EMAIL entry name EOJ_RC n: This option specifies the email entry name. The email entry name must pass the same validation as a PDS member name. . In this option, n must be a number from 0 through 254. If the ARMBGPV return code is greater than or equal to the EOJ_RC value, an End of Job email is sent.
  For more information about how to send email notifications, see Setting-email-entries.
  The following is an Email output example: 

  Example

  PGM ARMBGPV IN STEP ARM0000  IN JOB ARMJOB01 J0744296 ENDED WITH RETURN CODE 8

Checks each object in the object set for unrecoverable events, including events that occurred:

• Between the specified recovery point and current time for backout recovery
• From the specified image copy type to the recovery point

The valid values are YES and NO. The default value is NO.

Checks that the required archive logs exist for each object in the object set, including events that occurred:

• Between the specified recovery point and current time for backout recovery
• From the specified image copy type to the recovery point   

The valid values are YES and NO. The default value is NO.

Checks that an image copy has been created within the specified number of hours or days for the specified copy type.

The valid values are YES and NO. The default value is NO.

Checks if objects have been changed since the specified recovery point. Each object in the object set is checked for a log range between the specified recovery point and the current time.

The valid values are YES and NO. The default value is NO.

Checks whether objects in the object sets are encrypted. Each table space in the object set is checked for encryption.

The valid values are YES and NO. The default value is NO.

Checks for each object in the object set for an exception status. EXCEPTION_STATUS is defined as not in RW status.

The valid values are YES and NO. The default value is NO.

Checks for entries in SYSCOPY/BMCXCOPY older than the timestamp. Each object in the object set is checked for SYSCOPY or BMCXCOPY rows older than the specified timestamp. This helps to determine which objects have rows that are obsolete and should be deleted.

The valid values are YES and NO. The default value is NO.

Specifies by Timestamp, Current minus hours, or Current minus days to check for unrecoverable events and verify required archive logs, changed objects, and SYSCOPY/BMCXCOPY entries.

You can choose any one of the following values:

Checks for unrecoverable events, verifying required archive logs, and verifying image copies. The COPY_TYPE values are LP, LB, RP, RB, or FC. The default value is LP.

Specifies whether BMC AMI Recovery Manager should rebuild indexes. This is required to check for unrecoverable events and verify required archive logs and image copies. Rebuild indexes specified as YES or NO. The default value is NO.