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.

Using the Rule Set Overview panel to manage Rules in Rule Sets


This section explains how to copy or move Rules within a single Rule Set and between Rule Sets.

What the Rule Set Overview panel is

Use the Rule Set Overview panel to display and manage Rules within a specific Rule Set.

Rules are grouped into Rule Sets based on criteria such as the following criteria:

  • All of the Rules are used for a single automation procedure (for example, CSM)
  • All of the Rules were created by the same department
  • All of the Rules address the same MVS component (for example, allocation)

Use the Rule Set Overview panel to add, delete, enable, disable, or modify individual Rules within a specific Rule Set. Rule Set Filtering also can be enabled or disabled from this panel. For more information about Rule Set filtering, refer to Filtering-events-for-Rule-Sets.

Access the Rule Set Overview panel by selecting a Rule Set from the Automation Control panel. You can scroll this list of Rules either up/down or right/left. The following figure shows the Rule Set Overview panel when you access it from the Automation Control panel.

Rule Set Overview panel—view 1

BMC Software  ------------------ Rule Set Overview --------------- BMC AMI OpsA
COMMAND ===>                                                 TGT  --- JO81     
Rule Set ID: AAORUL00    Ruleset Strategy ===> FIRST         DATE --- YY/MM/DD
Primary commands: Add, Save, Sort, Unsort, Reset, Filter     TIME --- 14:14:49
LC CMDS -- (S)elect, (BR)owse, (E)nable, (D)isable, (T)est, (DE)lete, (I)nsert
           (C)opy/(CC)opy, (M)ove/(MM)ove, (B)efore or (A)fter, (R)epeat, GO   
Rule Set Desc.:                                                                
Sort Criterion:                                            Scroll right/left   
                                                                              
LC  Rule-id Stat Text-id          Type   Fired EXEC        Changed      ID     
    ________ _   ________________ ____         ________ ________ _____ ________
___ README   ENA .PM0010I         JRNL       0 READ                            
___ $JESP100 DIS $HASP100         MSG        0 $HASP100                        
___ $JESP150 DIS $HASP150         MSG        0 $HASP150                        
___ $JESP395 DIS $HASP395         MSG        0 $HASP395                        
___ $JESP250 DIS $HASP250         MSG        0                                 
___ $JESP373 DIS $HASP373         MSG        0 $HASP373                        
___ $HASP426 DIS $HASP426         MSG        0 $HASP426                        
___ IST020I  DIS IST020I          MSG        0 IST020I                         
___ $JESP098 DIS $HASP098         MSG        0 $HASP098                        
___ SHUTDOWN DIS SHUTDOWN         CMD        0 @SHUTSYS                        
___ IMLUDEV1 ENA IEF234E          MSG        0                                 
         ************************* END OF DATA **************************

Scroll left to see the GroupFunctionCodeAuthor, and Description columns as shown in Rule Set Overview panel—view 2. The fields on this view of the panel are as follows.

Field

Description

Rule-id

The 1- to 8-character unique ID assigned to this Rule at its creation

Stat

The Rule status, which can be one of the following: ENA, DIS, TST, or SUS

SUS status applies when the Rule is suspended through the use of the If matched, in seconds, and then status fields on the Rule Processor Detail Control panel. Refer to Criteria-match-rate-thresholds.

Text-id

The 1- to 16-character first word of the message or command defined for this Rule

Type

The origin of the event, which can be one of the following types: ALRT, ALRM, CICS, CICa, CMD, DB2, EXT, HWTO, IMP, IMS, IMSa, IMSs, JRNL, MQS, MSG, MSGa, MSGs, NVC, NVM, TIME, or VAR

Fired

The number of times the Rule was triggered

EXEC

The name of the EXEC that will be scheduled if the Rule fires

If the EXEC name specified in the Rule is a variable, its length may be more than 8 characters

Changed

The date (YY/MM/DD) and time (HH:MM:SS) the Rule was last modified

This data is stored in the Rule.

ID

The user ID that made the most recent change to this Rule

This data is stored in the Rule.

Scrolling left shows the GroupFunctionCodeAuthor, and Description fields.

Rule Set Overview panel—view 2

BMC Software ----------------- Rule Set Overview ----------------- BMC AMI OpsA
COMMAND ===>
Rule Set ID: AAORULST    Ruleset Strategy ===> FIRST         DATE --- YY/MM/DD
Primary commands: Add, Save, Sort, Unsort, Reset, Filter     TIME --- 14:21:30
LC CMDS --- (S)elect, (BR)owse, (E)nable, (D)isable, (T)est, (DE)lete, (I)nsert
            (C)opy/(CC)opy, (M)ove/(MM)ove, (B)efore or (A)fter, (R)epeat, GO
Rule Set Desc.:
Sort Criterion:               Filter ENABLED               Scroll right/left

LC  Rule-id Status    Group    Function Code Author   Description
    ________ _        ________ ________  __  ________ _________________________
___ IS0834I  DIS      STRTTERM DB2START  DB  BOB      SCHEDULE DB2START EXEC
___ IS0836I1 DIS      STRTTERM DB2TERM   DB  BOB      SCHEDULE DB2TERM EXEC
___ DFS9940  DIS
___ IM0001I  DIS
___ IMSCHCK  ENA
___ RUL00001 ENA
___ IS0861I  ENA
         ************************* END OF DATA **************************

The following table describes the fields on this view of the panel.

Field

Description

Rule-id

The one- to eight-character unique ID assigned to this Rule at its creation

Stat

The Rule status, which can be one of the following statuses: ENA, DIS, TST, or SUS

SUS status applies when the Rule is suspended through the use of the If matched, in seconds, and then status fields on the Rule Processor Detail Control panel. Refer to Criteria-match-rate-thresholds.

Group

The one- to eight-character group name defined for this Rule

Function

The one- to eight-character function name defined for this Rule

Code

The two-character code ID defined for this Rule

Author

The one- to eight-character name of the author defined for this Rule

Description

The description defined for this Rule. This field can be up to 40 characters but on the Rule Set Overview panel, the display is limited to show only the first 25 characters of the description

The Rule Processor Detail Control panel shows the full 40 character description.

Scroll right once to display the Text-ID and Text-String fields.

Rule Set Overview panel—view 3

BMC Software ------------------ Rule Set Overview ---------------- BMC AMI OpsA
COMMAND ===>
Rule Set ID: AAORULST    Ruleset Strategy ===> FIRST         DATE --- YY/MM/DD
Primary commands: Add, Save, Sort, Unsort, Reset, Filter     TIME --- 14:21:30
LC CMDS --- (S)elect, (BR)owse, (E)nable, (D)isable, (T)est, (DE)lete, (I)nsert
            (C)opy/(CC)opy, (M)ove/(MM)ove, (B)efore or (A)fter, (R)epeat, GO  
Rule Set Desc.:
Sort Criterion:               Filter ENABLED                  Scroll right/left

LC  Rule-id  Text-ID          Text-String
    ________ ________________ _________________________________________________
___ IS0834I
___ IS0836I1
___ DFS9940
___ IM0001I
___ IMSCHCK
___ RUL00001
___ IS0861I
         ************************* END OF DATA **************************

The following list describes the fields on this view of the panel.

Field

Description

Rule-id

The 1- to 8-character unique ID assigned to this Rule at its creation

Text-ID

The 1- to 16-character first word of the message or command defined for this Rule

Text-String

The text string defined for this Rule; can be up to 26 characters and includes the Text ID

For information about Text-ID and Text-String, see Enabling-filtering-and-Rule-Set-match-rate-for-Rule-Sets.

Scroll right once displays StatStart TimeIntervalStop TimeStop Count, and Fired fields. 

Rule Set Overview panel—view 4

BMC Software ------------------ Rule Set Overview --------------- BMC AMI OpsA
COMMAND ===>                                                  TGT --- DLAO
Rule Set ID: AAORULST    Ruleset Strategy ===> FIRST         DATE --- YY/MM/DD
Primary commands: Add, Save, Sort, Unsort, Reset, Filter     TIME --- 14:21:30
LC CMDS --- (S)elect, (BR)owse, (E)nable, (D)isable, (T)est, (DE)lete, (I)nsert
            (C)opy/(CC)opy, (M)ove/(MM)ove, (B)efore or (A)fter, (R)epeat, GO  
Rule Set Desc.:
Sort Criterion:               Filter ENABLED                 Scroll right/left
                   Start               Stop      Stop
LC  Rule-id  Stat  Time      Interval  Time      Count      Fired
    ________ _     ________  ________  ________  _________
___ IS0834I  DIS                                                  0
___ IS0836I1 DIS                                                  0
___ DFS9940  DIS                                                  0
___ IM0001I  DIS                                                  0
___ IMSCHCK  ENA                                                  0
___ RUL00001 ENA                                                  0
___ IS0861I  ENA                                                  1
         ************************* END OF DATA **************************

The fields on this view of the panel are as follows:

Field

Description

Rule-id

The one- to eight-character unique ID assigned to this Rule at its creation

Stat

The Rule status, which can be one of the following values: ENA, DIS, TST, or SUS

SUS status applies when the Rule is suspended through the use of the If matched, in seconds, and then status fields on the Rule Processor Detail Control panel. Refer to Criteria-match-rate-thresholds.

Start Time

Displays (in hours, minutes, and seconds) at what clock time a time-initiated Rule begins firing

This field contains data only for Rules whose Event type is TIME.

Interval

Displays (in hours, minutes, and seconds) how often the Rule fires

For example, an interval of 00:05:00 means the Rule will fire at the Start Time and every five minutes thereafter until the Stop Time or Stop Count value is reached.

The minimum interval is five seconds.

Stop Time

Displays (in hours, minutes, and seconds) at what clock time the Rule should stop firing

Stop Count

Specifies the number of times the Rule is to be fired from the Start Time

For example, a Stop Count value of 12 means that the Rule will begin firing at the specified Start Time and continue firing (at a rate determined by the Interval field) 12 times.

Fired

Shows how many times the Rule was fired

Scroll right once displays Job NameJob TypeJob ClassRACF User-ID, and RACF Group fields.

Rule Set Overview panel—view 5

BMC Software ------------------ Rule Set Overview ----------------- BMC AMI OpsA
COMMAND ===>
Rule Set ID: AAORULST    Ruleset Strategy ===> FIRST         DATE --- YY/MM/DD
Primary commands: Add, Save, Sort, Unsort, Reset, Filter     TIME --- 14:21:30
LC CMDS --- (S)elect, (BR)owse, (E)nable, (D)isable, (T)est, (DE)lete, (I)nsert
            (C)opy/(CC)opy, (M)ove/(MM)ove, (B)efore or (A)fter, (R)epeat, GO  
Rule Set Desc.:
Sort Criterion:               Filter ENABLED                Scroll right/left
             Job      Job  Job   RACF     RACF
LC  Rule-id  Name     Type Class User-ID  Group
    ________ ________ _    _     ________ ________
___ IS0834I
___ IS0836I1
___ DFS9940
___ IM0001I
___ IMSCHCK
___ RUL00001
___ IS0861I
         ************************* END OF DATA **************************

The following list describes the fields on this view of the panel.

Field

Description

Rule-id

The one- to eight-character unique ID assigned to this Rule at its creation

Job Name

The name of the originating batch job, TSO user ID, or Started Task defined for this Rule Blank means any.

Job Type

The type of originator defined for this Rule: JOB, STC, or TSO

Job Class

The job class of the job defined for this Rule

RACF User-ID

The user ID defined for this Rule, if RACF or CA-TOPSECRET or ACF2 is installed

RACF GROUP

The name of the RACF Group defined for this Rule

Scrolling right once displays Accounting InformationCon NameRoute Code, and Desc Codes fields.

Rule Set Overview panel—view 6

BMC Software  ----------------- Rule Set Overview ---------------- BMC AMI OpsA
 COMMAND ===>                                                 TGT  --- DLAO     
 Rule Set ID: AAORUL00    Ruleset Strategy ===> FIRST         DATE --- YY/MM/DD
 Primary commands: Add, Save, Sort, Unsort, Reset, Filter     TIME --- 11:41:21
LC CMDS --- (S)elect, (BR)owse, (E)nable, (D)isable, (T)est, (DE)lete, (I)nsert
             (C)opy/(CC)opy, (M)ove/(MM)ove, (B)efore or (A)fter, (R)epeat, GO  
 Rule Set Desc.:
 Sort Criterion:                                            Scroll right/left   
                                                 Con     Rout       Desc     
 LC  Rule-id  Accounting Information             Name    Code       Code     
     ________                                    ________ __________ ________
 ___ README                                                                     
 ___ ALRMSTRT                                                                   
 ___ ALRMSTOP                                                                   
 ___ EM0939E                                                                    
 ___ RESTEST                                                                    
           ************************* END OF DATA **************************

The following list describes the fields on this view of the panel.

Field

Description

Accounting Information

The one- to eight-character unique ID assigned to this Rule at its creation

Con Name

The accounting entered on the Account Info field of the Selection Criteria panel

Rout Code

The MVS console name for messages or commands

Job Class

The MVS route code associated with the WTO or WTOR

Desc Code

The MVS descriptor code associated with the WTO or WTOR

Scrolling right once displays BiiZ Send and BiiZ Class fields.

Rule Set Overview panel—view 7

BMC Software  ----------------- Rule Set Overview --------------- BMC AMI OpsA
 COMMAND ===>                                                 TGT  --- DLAO    
 Rule Set ID: AAORUL00    Ruleset Strategy ===> FIRST         DATE --- YY/MM/DD
 Primary commands: Add, Save, Sort, Unsort, Reset, Filter     TIME --- 12:04:19
 LC CMDS --- (S)elect, (BR)owse, (E)nable, (D)isable, (T)est, (DE)lete, (I)nsert
             (C)opy/(CC)opy, (M)ove/(MM)ove, (B)efore or (A)fter, (R)epeat, GO  
 Rule Set Desc.:
 Sort Criterion:                                            Scroll left        
              BiiZ BiiZ                                                        
 LC  Rule-id  Send Class                                                       
     ________ _    ________________________________                            
 ___ README                                                                    
 ___ ALRMSTRT                                                                  
 ___ ALRMSTOP                                                                  
 ___ EM0939E                                                                   
 ___ RESTEST                                                                   
           ************************* END OF DATA **************************

The following list describes the fields on this view of the panel.

Field

Description

Rule-id

The one- to eight-character unique ID assigned to this Rule at its creation

BiiZ Send

Shows whether events are to be sent to the BMC Impact Manager cell

BiiZ Send

Shows the class name mask used to select Rules

Primary and line commands for the Rule Set Overview panel

You can enter the following primary commands on the COMMAND line of the Rule Set Overview panel.

Command

Description

ADD

Displays the Rule Processor Detail Control panel

SORT

Sorts the display in either ascending or descending order using the field name as the sort field

For example, the following command sorts the display by Fired count in descending order, thus the Rules that fired most frequently will appear at the top of the display:

SORT FIRED D

You can also sort and filter the display based on

  • Rule-id
  • Stat
  • Text-ID
  • Type
  • EXEC
  • ID

The default is Ascending | A order for all these fields, except Fired and Changed in which case the default is Descending | D.

UNSORT

Reverses the Sort command and returns the display to its original order; by physical location of the Rule within the Rule Set

This command must be issued before a Move | M, Copy | C, Repeat | R, or Insert | I can be issued.

RESET

Enables you to cancel any pending move or copy line commands that you might have

Filter

Enables you to invoke the Rule Set filter panels to specify filtering selection criteria for the Rule Set

For more information about Rule Set filtering, refer toFiltering-events-for-Rule-Sets.

Using line commands from the Rule Set Overview panel

You can use the following line commands in the LC column.

Command

Description

Select | S

Transfers you directly into the Rule Processor Detail Control panel

Browse | BR

View a Rule in browse mode (the Rule cannot be edited.)

Enable | E

Activates a Rule and effectively starts the selection criteria filtering process

Disable | D

Stops the selection criteria filtering process for this Rule

Test | T

Sets the Rule to test mode. Use the Enable or Disable command to get the Rule out of test mode

Using test mode enables you to see if the Rule fires as expected but the actions specified for the Rule are not taken.

DElete | DE

Deletes a Rule

Insert | I

Transfers directly into the Rule Processor Detail Control panel to create a new Rule before or after the line against which this command is issued

Copy | C | CC

Copies Rules to another location in the Rule Set or to another Rule Set

The Rules can be enabled or disabled.

When you are trying to duplicate a Rule within the same Rule Set, you must use the Repeat | R command. The Copy command will not work.

For more information, refer to Copying-or-moving-Rules.

Move | M | MM

Moves Rules to another location in the Rule Set or to another Rule Set

The Rules can be enabled or disabled.

For more information, refer to Copying-or-moving-Rules.

Before | B

Indicates the line within the Rule List before which a Rule is copied or moved with the Move | M | MM or Copy | C | CC line commands

For more information, refer to Copying-or-moving-Rules.

After | A

Indicates the line within the Rule List after which a Rule is copied or moved with the Move| M | MM or Copy | C | CC line commands

For more information, refer to Copying-or-moving-Rules.

Repeat | R

Creates a new Rule by using the active pattern of a specified Rule

Use this command to create Rules that need only minor modifications rather than re-entering the information for each Rule.

GO

Starts (or restarts) a TIME-initiated Rule that has ATSTART specified as its start time

Note

The Rule must have a status of ENA or SUS.

Use the GO line command when you need to immediately start an existing ATSTART TIME Rule and you cannot restart the BBI-SS PAS. You can also use GO to start a new ATSTART TIME Rule.

This section contains the following topic:

 

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