Creating a Rule


This section describes creating a new Rule. You can also import classic Rules. For more information, see the section Migrating-Rules-to-Rules-Management-application

The first thing you have to do is select the Rule Pool where the Rule will exist.

To select the Rule Pool where the new Rule will be stored

  1. Select All Rule Pools from the EZAORUL view.


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

  2. Issue the S line command in the CMD field next to the Rule Pool where you want to store the Rule.

    W1 =RPOOL=============NS81=====*========ddmmmyyyy==15:10:36====MVAO=====D====2=======================
    CMD Rule Pool Name                   Rule  Description                             LastChg  LastChg   
    --- -------------------------------- Count --------------------------------------- User---- Date-----
        AAORUL01.AAONS81.Rule.Pool          62 Pool created by import of AAORUL01 from BAONIS5  10AUG2016
        AAORUL02.AAONS81.Rule.Pool          49 Pool created by Repeat against AAORUL01 BAONIS5  11APR2016

    The RULES view is displayed. For information about this view, place the cursor on the view name and press PF1. The name of the selected Rule Pool is remembered by the interface so the next time, you can go directly to the RULES view without stopping at the RPOOL view.

  3. Enter ADD on the COMMAND field.

    ddmmmyyyy 11:22:54 ------ BMC AMI OpsA WINDOW INTERFACE (Vv.r.mm) ----------------
    COMMAND  ===>    add                                          SCROLL ===> CSR  
    CURR WIN ===> 1        ALT WIN ===>                                            
    >W1 =RULES=============NS81=====*========ddmmmyyyy==11:22:54====MVAO=====D===64
    - Rules List                                                                   
      Pool Name: AAORUL01.AAONS81.Rule.Pool                                        
                                                                                  
    CMD RuleName Rule Initial  Text-id          EXEC     Description               
    --- -------- Type Mode---- ---------------- -------- --------------------------
        AAABBBC  EXT  Disabled AAABBBC                                             
        AAOSSUP  JRNL Enabled  PM0010I          STARTTOM                           
        ALERTASV ALRT Disabled NEVITEST                  @AOTRACE@                 
        AU1034E  JRNL Enabled  AU103*                                              
        AU1034EM MSG  Enabled  AU103*                                              
        BBSECSAF JRNL Enabled  AA32+++                                             
        BQO1127A IMS  Disabled A52              BPO99743                           
        CICSLONG CICS Disabled WURD01                                              
        CICSTEST CICS Disabled *                                                   
        DAVELEVY TIME Disabled                                                     
        DFHZC596 CICS Disabled DFHZC5966                                           
        DFHZC693 CICa Disabled DFHZC6935        NEWCICS                            
        DFS3466I IMS  Disabled DFS3466I                                            
        DFS4445I IMS  Disabled DFS4445I                                            
        DFS4445M MSG  Disabled DFS4445I

    The Rule Processor Detail Control dialog is displayed.

  4. Use the Rule Processor Detail Control dialog to enter information about the Rule.

    (BMC.AMIOPS.SPE2307)

                Rule Processor Detail Control - Rule ADD
    COMMAND ===>                                              SCROLL ===> CSR  
                                                                       MORE: +
    Rule Identification:                                                       
     Rule Pool...: AAORUL01.AAONS81.Rule.Pool                                                                                          
     Rule Name...: ________  (Required)
     Event Type..: ____      (Required)
     Initial Mode: S Enabled _ Disabled _ Test

    Criteria Match Rate Threshold
     If Matched..: ___    (Max times matched within INTERVAL, 0-100)
     in seconds..: _____  (Interval length, 1-99999 seconds)
     then status.: _ Suspend _ Disable _ Noaction

    Application Information
     Group...: ________
     Function: ________
     Code....: __
     Author..: ________
     Desc....: ____________________________________________________________
     CD Level: 00000

     Add Rsn: ____________________________________________________________  

    User Notes:  
    _________________________________________________________________________  
    _________________________________________________________________________  
    _________________________________________________________________________  
    _________________________________________________________________________  
    _________________________________________________________________________  
    _________________________________________________________________________  
    _________________________________________________________________________  
                                                                         
    Extended User Notes:
    Line Cmd: Edit, Insert, Remove, Up, Down, Top, Bottom (press ENTER/REFRESH)  

    Cmd Subject (partial)                By       Date      Time
    --- -------------------------------- -------- --------- --------                                                                                       -  
                                                                               
    Next to set additional parameters END to exit and save changes
    CANcel to exit without saving changes
    HELP to view related help
    S1 to jump to Selection Criteria
    SV to jump to Variable Dependencies
    A1 to jump to Event Actions
    CD to jump to Collect Diagnostics
    AV to jump to Set Variables
    AA to jump to Alert Actions
    BZ to jump to BEIM Actions/Alerts
                Rule Processor Detail Control - Rule ADD
    COMMAND ===>                                              SCROLL ===> CSR  
                                                                        MORE: +
     Rule Identification:                                                           
      Rule Pool...: AAORUL01.AAONS81.Rule.Pool                                                                                          
      Rule Name...: ________  (Required)
      Event Type..: ____      (Required)
      Initial Mode: S Enabled _ Disabled _ Test

     Criteria Match Rate Threshold
      If Matched..: ___    (Max times matched within INTERVAL, 0-100)
      in seconds..: _____  (Interval length, 1-99999 seconds)
      then status.: _ Suspend _ Disable _ Noaction

     Application Information
      Group...: ________
      Function: ________
      Code....: __
      Author..: ________
      Desc....: ____________________________________________________________
      CD Level: 00000

      Add Rsn: ____________________________________________________________  
                     
     User Notes:  
     _________________________________________________________________________  
     _________________________________________________________________________  
     _________________________________________________________________________  
     _________________________________________________________________________  
     _________________________________________________________________________  
     _________________________________________________________________________  
     _________________________________________________________________________                                                     

     Next to set additional parameters            
     END to exit and save changes                 
     CANcel to exit without saving changes        
     HELP to view related help                    
     S1 to jump to Selection Criteria             
     SV to jump to Variable Dependencies          
     A1 to jump to Event Actions                  
     AV to jump to Set Variables                  
     AA to jump to Alert Actions                  
     BZ to jump to BEIM Actions/Alerts

    You can see that the rules editor dialog provides shortcuts to other parts of the dialog to help you skip the sections your Rule might not need. Navigate through the Rule creation dialogs, enter values in the fields for the Rule, and enter END to save the Rule.

  5. On the RULES view, enter the AR command in the CMD field next to the newly created Rule to add the Rule to a Rule Set. This must be done so that the Rule can be loaded into a BMC AMI Ops Automation PAS.

    ddmmmyyyy  11:22:54 ------ BMC AMI OpsA WINDOW INTERFACE (Vv.r.mm) ----------------
    COMMAND  ===>                                                 SCROLL ===> CSR  
    CURR WIN ===> 1        ALT WIN ===>                                            
    >W1 =RULES=============NS81=====*========ddmmmyyyy==11:22:54====MVAO=====D===64
    - Rules List                                                                   
      Pool Name: AAORUL01.AAONS81.Rule.Pool                                        
                                                                                  
    CMD RuleName Rule Initial  Text-id          EXEC     Description               
    --- -------- Type Mode---- ---------------- -------- --------------------------
        AAABBBC  EXT  Disabled AAABBBC                                             
        AAOSSUP  JRNL Enabled  PM0010I          STARTTOM                           
        ALERTASV ALRT Disabled NEVITEST                  @AOTRACE@                 
        AU1034E  JRNL Enabled  AU103*                                              
        AU1034EM MSG  Enabled  AU103*                                              
        BBSECSAF JRNL Enabled  AA32+++                                             
        BQO1127A IMS  Disabled A52              BPO99743                           
        CICSLONG CICS Disabled WURD01                                              
     AR CICSTEST CICS Disabled *                                                   
        DAVELEVY TIME Disabled                                                     
        DFHZC596 CICS Disabled DFHZC5966                                           
        DFHZC693 CICa Disabled DFHZC6935        NEWCICS                            
        DFS3466I IMS  Disabled DFS3466I                                            
        DFS4445I IMS  Disabled DFS4445I

    The Add to Ruleset(s) dialog is displayed.

  6. Enter the S line command next to the Rule Sets that you want the Rule to belong to and enter END.

                       Add to Ruleset(s)  
     COMMAND ===>                                              SCROLL ===> CSR   
                                                                        MORE: +  
     Instructions                                                                
        Select one more Rulesets and use END to add the rule to all the          
        selected rulesets. Use the filter to quickly locate the desired          
        ruleset(s) if needed.                                                    
                                                                                
     Rule Identification;                                                        
      Rule Name: CICSTEST                                                        
      Rule Pool: AAORUL01.AAONS81.Rule.Pool                                      
                                                                                
     Ruleset Change Reason                                                       
      ChgRsn:                                                                    
                                                                                
      Filter: *                                                                  
                                                                                
                                                                                
     Cmd Ruleset  Setbase Name                     Group    Desc (partial)       
     --- -------- -------------------------------- -------- -------------------  
     s   AAORUL01 NevenaTestSetbaseAO81Rules       SCOFFICE                      
     _   AAORUL01 IMS.Production.Rules             SCOFFICE                      
     s   AORULIMS DEFAULT                          BBPLEX01 Ruleset for IMS and
     _   AORULIMS IMS.Production.Rules             SCOFFICE Ruleset for IMS and
                                                                               
     END to complete the request                                                
     CANCEL to abandon the request                                              
     HELP to view related help

    The Rule is added to the Rule Sets you selected.

  7. To associate the Rule Set with a PASDef where you want the Rule to be active, display the PASDEF view from the EZAORUL menu. Issue the RM command next to the PASDef.

    ddmmmyyyy   11:38:02 ------ BMC AMI OpsA WINDOW INTERFACE (Vv.r.mm) ----------------
     COMMAND  ===>                                                 SCROLL ===> CSR  
     CURR WIN ===> 1        ALT WIN ===>                                            
     >W1 =PASDEF============NS81=====*========ddmmmyyyy==11:38:02====MVAO=====D====2
     CMD PASDef Name                      Group    Description              Val PAS
     --- -------------------------------- Name---- ------------------------ --Count
     RM  AAONS81.PAS.Definition           BBPLEX01 Created by import              1
         AAONS81.Second.PAS.Definition    SCOFFICE Testing alternate PASDef       0

    The PASDSMBR view is displayed.

  8. Enter EDIT in the COMMAND field on the PASDSMBR view to switch the mode from BROWSE to EDIT and allow you to make changes.The mode is displayed on the top of the view.

  9. To add a Rule Set, enter the INSERT command on the COMMAND line.

    ddmmmyyyy  11:41:39 ------ BMC AMI OpsA WINDOW INTERFACE (Vv.r.mm) ----------------
     COMMAND  ===>                                                 SCROLL ===> CSR  
     CURR WIN ===> 1        ALT WIN ===>                                            
     >W1 =PASDSMBR==========NS81=====*========(00 BROWSE        )====MVAO=====D====1
     - PASDef Rulesets                                                              
                                                                                   
       PASDef Name...: AAONS81.PAS.Definition                                       
       Group Name....: BBPLEX01                                                     
       Description...: Created by import                                            
                                                                                   
       Last Change...: (none)                                                       
       Change Reason.:                                                              
                                                                                   
     CMD Ruleset  SeqNo Initial  Ruleset  Fltr Fltr       Rule Description          
     --- -------- ----- Mode---- Strategy ---- Mode---- -Count ---------------------
         AAORUL01     0 Enabled  All      No                66

    The List Rulesets dialog is displayed.

  10. Enter the S line command next to the Rule Set you want to add to the PASDef and enter END on the COMMAND line.

                           List Rulesets
     COMMAND ===>                                              SCROLL ===> CSR
                                                                             
     Instructions                                                             
        Select one or more rulesets from the supplied list to be              
        inserted into the PASDef. Use the rule filter to quickly              
        locate the desired ruleset(s).                                        
                                                                             
     Source Setbase                                                           
      Setbase: DEFAULT                                                        
      Group..: BBPLEX01                                                       
                                                                             
      Filter: *                                                               
                                                                             
     Cmd Ruleset  Description                                                 
     --- -------- --------------------------------                            
         AORULIMS Ruleset for IMS and IMSplex Rule                            
                                                                             
     BACK to return to previous list                                          
     END to complete the request                                              
     CANCEL to abandon the request                                            
     HELP to view related help

    The PASDSMBR view is displayed.

  11. Enter SAVE on the COMMAND line to save your changes.To begin using the Rule you just created, you must deploy and activate the PASDef.

  12. Refer to Deployment-of-Rules-Rule-Sets-and-PASDefs for more information about deploying the Rule after you have created it

 

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

BMC AMI Ops Automation 8.4