Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

Option two: manually importing classic Rules

Use this option to manually import one or more Rule Sets into a registry that may (or may not) already have any Rules Sets loaded into it. You can use this process any time and it is not limited to the initial migration to Rules Management.

All of the Rule Sets are stored in the Rules Management registry in Setbases. You might decide to move all of your classic Rules and Rule Sets into a single Setbase (such as the DEFAULT Setbase) or you can import them into any number of Setbases. A single Setbase named DEFAULT is provided in the registry.

First, complete the following steps to restart the BMC AMI Ops Automation PAS in ADMIN mode. 

  1. Specify USAGE_MODE_RULES=ADMIN in BBPARM member AAOPLXxx.
    If the keyword is set to OFF, the registry is not available to the PAS so the import utility will not function. The PAS must be running in ADMIN or FULL mode to use the import utility.
  2. Restart the BMC AMI OpsA PAS.
    No automation from registry-based Rules will occur while the PAS is in ADMIN mode. Automation from classic Rules will continue to function normally.

To import classic Rules

  1. Select Import Ruleset(s) from the Tools portion of the EZAORUL view. 

    The IMPTRSET view is displayed. For more information about this view, place the cursor on the view name and press PF1.

    ddmmmyyyy  13:11:50 ------ BMC AMI OpsA WINDOW INTERFACE (Vv.r.mm) ----------------

    COMMAND  ===>                                                                                                      SCROLL ==
    CURR WIN ===> 1        ALT WIN ===>
    >W1 =IMPTRSET==========JO8R=====*========yyyy/mm/dd=13:15:59====MVAO=====D===75=============================================
    - Import Rulesets
      Default Setbase                                  Hyperlinks:.............
       Name.........: JO8FSETBASE                      ..Review Import Messages
       Group........: JOBIAG81                         ..Review Import Errors..

    CMD Ruleset  Suggestd Rule   Description                              Import Results         Vers Serial  Where Found
    --- Name---- Status-- Count- ---------------------------------------  ---------------------- ---- Number- ------------------
        RULIMS00 ENABLED       5                                                                 0801 0000007 JAB2.JO8R.BBPARM
        AAORUL00 ENABLED      16                                                                 0704 0000017 JAB2.JO8R.BBPARM
        RULTIME1 ENABLED      32                                                                 0704 0000046 JAB2.JO8R.BBPARM
        AAORULBA DISABLED
        AAORULBB DISABLED
        AAORULBC DISABLED
        AAORULBD DISABLED

    This view displays a list of all of the classic Rule Sets that are defined to the BBIPARM DD concatenation. You can use the utility to import any Rule Set in this list, regardless if it is ENABLED or DISABLED.  

    The Suggested Status value shown for each Rule Set is based on the contents of the RULESET= keyword in BBPARM member AAOPRMxx that is used by the target PAS. As a result, the value in the Suggested Status field might not represent the Rule Sets that are currently active in the target PAS. BMC recommends that you review the values in the Suggested Status field, however, because the goal of the import is to recreate the RULESET= keyword's contents in the registry.

  2. Enter the TAG line command in the CMD field next to the Rule Sets you want to import.

  3. Enter IMPORT on the COMMAND line and press ENTER.
    The Ruleset Import Options dialog is displayed. 

                    Ruleset Import Options 
    COMMAND ===>                                              SCROLL ===> CSR

    Selected Ruleset
     Name........: AAORUL00
     From Dataset: JAB2.JO8R.BBPARM

    Target Ruleset
     Name.....: AAORUL00  (enter ? to select)
     Desc.....:

    Target Rule Pool
     Pool Name: AAORUL00.Rule.Pool                (enter ? to select)
     Desc.....: Pool created by import of AAORUL00 from JO8R
     Options..: S Create Rule Pool
                  Replace existing Rule Pool
                  Append Rules to existing Pool
                  Validate within Rule Pool

    Target Setbase
     Setbase..: JO8FSETBASE                       (enter ? to select)
     Group....: JOBIAG81
     Options..:   Add Ruleset to Setbase
                S Replace Ruleset in Setbase
                  Append Rules to Ruleset in this Setbase
                  Bypass all Ruleset changes in this Setbase

    Target PAS Definition
     Name.....: JO8R.PAS.Definition               (enter ? to select)
     Group....: BBPLEX01
     Desc.....:
     Strategy.:   All        First    S Individual
     Honor MPF:   Yes      S No
     Init Mode: S Enabled    Disabled
     Options..: S Create PASDef and append Ruleset
                  Replace Ruleset in existing PASDef
                  Append Ruleset to PASDef
                  Bypass all PASDef Changes

    Valid PAS List Entry
     Tgt Name.: JO8R
     AOPlex...: JO81PLEX
     AO Desc..: Created by import
     VPL......:   Create  (default is BYPASS)

    END    to import the ruleset
    CANcel to abandon the import
    HELP   to view related help

    The dialog provides default specifications and suggests names and settings for items such as the Rule pool to house the Rules, the Rule Set's name and Setbase, a PASDef to use (or create), and so on.

  4. Review the suggested options on the dialog, make any modifications, and enter the END command to initiate the import process.

  5. Enter END command for each Rule Set that you selected to import.

Verifying the imported Rules

Once all of the classic Rules have been imported, you can use the following views to review them.

  • RPOOL view: use this view to display a list of Rule pools.

    You can select a Rule pool to view the Rules within the pool

  • RULESET view: use the RULESET view to see and confirm the list of Rule Sets that were imported.

    On this view, you can use the RM line command against a Rule Set to see a list of Rules within a Rule Set.

  • PASDEF view: use the PASDEF view to see a list of PASDefs, including the one you just created.

    Use the VP (View PAS) line command to see a list of PASes that are defined to the PASDef. Use the RM (Ruleset Members) line command to see a list of Rule Set members of the PASDef.

As you review the imported elements, evaluate which Rule names work well for your site and which (if any) you might like to change. You can then stop the PAS, redefine the registry data set, restart the PAS, and use the import utility to import your Rule Sets using new Rule pool names, Rule Set names, and so on.

Activating the imported Rules

After you review the imported Rules and Rule Sets, you can deploy and activate the Rules, Rule Sets, and PASDefs in a PAS that is running in FULL mode. If the PAS you are using is already running in FULL mode, you can complete one of the following  steps to start the imported Rules automation:

  • Use the deployment feature to deploy the PASDef for the PAS to activate the PASDef
  • Restart the PAS with  a COLD start

If the PAS that will be using the newly imported Rules and Rule Sets is running in ADMIN mode, specify USAGE_MODE_RULES=FULL in BBPARM member AAOPLXxx. The next time the BMC AMI OpsA PAS is has a COLD start, the BMC AMI OpsA PAS will use the Rules and Rule Sets from the registry instead of from the BBPARM libraries

You can also specify YES for the AUDIT_STARTUP_RULESETS parameter in BBPARM member AAOPLXxx and when the PAS is COLD started, the PAS issues the message AGSIA4050I with a list of the Rule Sets that the PAS will use.

 

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