Utilities

The following lists some utilities that you can use to help you using the Rules Management application.

Customizable back up of Rule Pools, Setbases, PASDefs, CRGs, or the Rules registry with BBSAMP member AAOEXPRT

(BMC.AMIOPS.SPE2510)

BBSAMP member AAOEXPRT contains JCL that you can edit to back up the following items:

Rule Pools
Setbases
PASDefs
CRG definitions
The entire Rules Management Registry

The output from the AAOEXPRT EXEC is readable and after reviewing the output, you can schedule the EXEC on another AOPLEX to import the definitions.

For more information, see Rules Management registry export utility.

Back up the Rules Management Rules registry

BBSAMP provides members that you can use to back up the entire Rules Management registry:

AAOAGSDP member contains JCL that can schedule automatic back ups
AAOAGSBK and AAOAGSRS members contain JCL that you manually use to back up and restore a registry

Automated Rules Management registry backup

(BMC.AMIOPS.SPE2510)

Configure the JCL in BBSAMP member AAOAGSDP to create jobs that will automatically back up the entire Rules Management registry.

The first PAS that initializes in an AOPLEX is considered to be the owner of the Rules registry. If you have multiple PASes in an AOPLEX, you must define backup jobs for each PAS because only the PAS that is the registry owner will produce backups.

The following lists the parameters in BBPARM member AAOPLXxx that control how OpsA will schedule automated Registry backups:

REGISTRY_BACKUP_INTERVAL
REGISTRY_BACKUP_TOD
REGISTRY_BACKUP_STC

For more information about the parameters, see BBPARM member AAOPLX00 parameters.

After you edit these parameters, you must copy the JCL to a system PROCLIB. Match the member name to the value you specify with the REGISTRY_BACKUP_STC parameter. In addition, you must:

Specify the PREFIX parameter to match your site naming conventions
Update the data set attributes such as SPACE, UNIT, VOLSER, or STORCLAS to specify the registry size based on its current size

The JCL also uses the values from the AOPLEX, AONAME, and SSID parameters which are defined in the PAS when it starts the backup.

Manual Rules Management registry backup

We recommend that you use BBSAMP member AAOEXPRT to perform Rules registry backups and restorations because it allows you to review the output before importing to a new AOPLEX and supports more back up options.

Configure BBSAMP members AAOAGSBK and AAOAGSRS that perform the following tasks

AAOAGSBK: contains JCL that creates a flat file backup of the complete registry that you can use to restore the registry when you need it. The resulting output is unreadable. Review the comments in the beginning of the JCL to help you customize the JCL and submit the JCL to create a backup.
AAOAGSRS: contains JCL that restores the registry, either into the registry you backed up from or to a new target registry, from the backup file created by AAOAGSBK.

Note that the target registry can be a newly created and empty registry data set or it can be an already-populated registry data set. In the case of the already populated registry, the restore will merge the backup into the registry, create new items as needed, and replace existing items as needed.

Export Rule Sets from a registry

BBSAMP member QAOEXPRT provides an export utility that you can use to export Rule Sets from an active PAS to a PDS member. The name of the PDS member is the same name as the Rule Set. The output uses a format that is identical to a classic Rules PDS member.

You can then use the exported Rule Sets with a PAS that does not currently use a registry (such as at a disaster recovery site) or you can import the PDS into the same, or a different registry.

The export utility is accessible from any REXX EXEC that you execute in any PAS that has access to the registry with the Rule Set(s) you want to export. The sample EXEC contains documentation that you can use to customize the utility.

Some Rules that you created with Rules Management are not valid in Classic Rules and might fail to be loaded. For example any Rules Management Rules that create emails or collect diagnostics are not valid actions in classic Rules and will fail.

Print audit reports

BBSAMP includes two members that you can use to create and print auditing reports:

AGSAUDTR: creates a Rule change audit report
AGSAUDTD: creates a deployment auditing report

The comment section in each member contains information about how to edit the JCL and run the report.

Print AuxLog records to SYSPRINT or to a data set

You can use choose to print AuxLog records to SYSPRINT or to a predefined sequential data set. For more information, view BBSAMP member AGSLXAUX which contains sample JCL, and edit and specify the parameters for your site.