Migrating Rules to Rules Management application

Existing classic Rules can be imported directly from the BBPARM data set(s) where they are currently stored. These classic Rules must be in data sets that are included in the BBIPARM DD concatenation of the PAS to be imported to the Rules Management application.

When you migrate classic Rules into a registry, the BMC AMI Ops Automation PAS must be running in ADMIN or FULL mode so the registry is open for you to populate it with the imported Rules.

Related topic

Option-two-manually-importing-classic-Rules

 Administrative tasks

There are two methods that you can use to migrate existing Rule Sets into the Rules registry:

  • Option one allows you to quickly and easily capture all the Rules automation for a PAS in a Rules registry where it can be directly used or, the automation can be exported (deployed) to a central registry for centralized administration. 
  • Option two is a more manual process where you use a view to selectively import Rule Sets into the Rules registry.  For more information, see Option-two-manually-importing-classic-Rules. 

Choose the option that makes the most sense for your implementation strategy.

Option one: using AutoLoad

This option (also referred to as AutoLoad), is the fastest way to migrate all of your classic Rules automation for an entire PAS into an empty registry. With this option, you invoke the AutoLoad process with keywords in the BBPARM member AAOPLXnn member and restart the BMC AMI OpsA PAS in ADMIN mode. When the PAS completes restarting, restart the BMC AMI OpsA PAS in FULL mode and the newly-populated registry will be the source for your Rules automation. See Restart in FULL mode (below) or Change the USAGE_MODE_RULES parameter to FULL (below) for more information.

If you have classic Rules that do not have a Rule name, during the conversion they are assigned a Rule name of RULnnnnn where nnnnn is the next sequential number within the current Rule Set.

If you have Rules with the same Rule IDs within the same Rule Set, after the first occurrence of the Rule, each subsequent Rule is assigned a new Rule name of RULnnnnn where nnnnn is the next sequential number within the current Rule Set.

Customize the BBPARM member AAOPLXnn

To use the AutoLoad option, edit the following keywords in BBPARM member AAOPLXnn:

BBPARM AAOPLXnn keyword

Definition

AO_NAME

Specifies the name to identify the PAS within the AOPlex.

This parameter is optional. Only use this parameter when you do not want to use the default value of the current PAS SSID.

AOPLEX_NAME

Specifies the name of the AOPlex to which the PAS belongs.

AOPLEX_XCF_GROUP

Specifies the name of the XCF group that the AOPlex will use to communicate.

REGISTRY_DSN

Specifies the data set name of the linear VSAM data set allocated for use by the AOPlex.

The registry named on the REGISTRY_DSN keyword must be a newly allocated completely empty registry.

USAGE_MODE_RULES

Determines how the PAS uses the registry.

Before you use the AutoLoad option, specify USAGE_MODE_RULES=ADMIN.

For more information about the keywords and their values, see BBPARM-member-AAOPLX00-parameters. 

Customize the AutoLoad parameters in BBPARM member AAOPLXnn

To use the AutoLoad option, edit the following AutoLoad keywords in BBPARM member AAOPLXnn:

BBPARM AAOPLXnn keyword

Definition

AUTOLOAD_REGISTRY

Specifies whether an empty registry being used by a PAS running in ADMIN mode     is automatically loaded (initialized) with Rules and Rules Sets from the local BBPARM  

data set.

AUTOLOAD_SETBASE_NAME

Specifies the override name for the name portion of a Setbase ID.

AUTOLOAD_SETBASE_GRP_NAME

Specifies the override name for the group name portion of a Setbase ID.       

AUTOLOAD_PASDEF_NAME

Specifies the override name for the name portion of a PASDef ID.

AUTOLOAD_PASDEF_GRP_NAME

Specifies the override name for the group name portion of a PASDef ID.

For more information about the keywords and their values, see BBPARM-member-AAOPLX00-parameters.

Start (or restart) the BMC AMI OpsA PAS

After you customize the keywords in BBPARM member AAOPLXnn, ensure that you have an empty Rules registry and start the BMC AMI OpsA PAS.

When the PAS has initialized, you should see messages similar to these in the BMC AMI OpsA PAS joblog: 

AGSTX0040I Autoload: Initialization of the registry has commenced
AGSTX0051I Autoload: Initialization type is ALL
AGSTX0055I Autoload: Ruleset AAORULD1 detected
AGSTX0055I Autoload: Ruleset RULCICS detected
AGSTX0055I Autoload: Ruleset RULIMS detected
AGSTX0055I Autoload: Ruleset RULDB2 detected
AGSTX0050I Autoload: Processing ruleset 0: AAORULD1
AGSTX0050I Autoload: Processing ruleset 1: RULCICS
AGSTX0050I Autoload: Processing ruleset 2: RULIMS
AGSTX0050I Autoload: Processing ruleset 3: RULDB2
AGSTX0049I Autoload: Initialization has completed 

After you see message AGSTX0049I, AutoLoad  has completed and you can proceed to the next step.

Verify Registry contents

From the BMC AMI Ops main menu, enter P to enter windows-mode and display the EZAO view.

  1. Use the Rules Administration hyperlink to display the EZAORUL menu

  2. Use each of the following hyperlinks in the  Administration  section to review the automation that the AutoLoad process created: 

    • PAS Definitions:  When viewing the PASDEF view, use the RM  (Ruleset Members ) line command see the Rule Sets that are a member of the associated PASDef.
    • Valid PAS List       
    • All Setbases             
    • Rulesets in Setbase:  In the RULESET view, use the RM  (Ruleset Members ) line command to see the Rules that are a member of the associated Rule Set.            
    • All Rule Pools:  In the RPOOL view, use the S  (Select ) line command to view the Rules in the associated Rule pool

     

  3. Continue to Restart in FULL mode (below) or Change the USAGE_MODE_RULES parameter to FULL (below) to complete migration.

Restart in FULL mode

After you have verified the Rules automation that AutoLoad completed, restart the PAS in FULL registry mode. 

  1. To change to FULL mode, specify USAGE_MODE_RULES=FULL in BBPARM member AAOPLX00 and perform a COLD start of the PAS .
    This fully enables Rules Management in the associated PAS so you can begin managing your Rules automation with the Rules Management application.

    This step completes the process of migrating classic Rules to Rules Management Rules.

Change the USAGE_MODE_RULES parameter to FULL

After you have verified the Rules automation that AutoLoad completed:

  1. Use the AOPLEXP view to change the USAGE_MODE_RULES parameter from ADMIN to FULL. This does not require that you perform a COLD start of the PAS. 
    This fully enables Rules Management in the associated PAS so you can begin managing your Rules automation with the Rules Management application.

    This step completes the process of migrating classic Rules to Rules Management Rules.

 

 

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