Example 1: creating a suppression Rule
To write a Rule that suppresses the $HASP395 message, follow these steps:
From the Automation Control panel, use the Enable line command to enable the Rule Set to which you want to add the Rule.You can add Rules only to enabled Rule Sets.
Figure 1. Creating a suppression Rule (1): Automation Control panel
BMC Software ---------------- Automation Control ------------ RULMAGIE ENABLED
COMMAND ===> TGT ===> AOAO
Primary commands: ADD, STATSHOW, CMDSHOW, PARMSHOW, Locate, DATE --- YY/MM/DD
EXPAND TIME --- 17:48:38
Automation Status ===> ACTIVE (Active, Inactive)
Automation Strategy ===> INDIVIDUAL (Individual, All, First)
Honor MPF Suppression ===> NO (NO/YES)
Automation Statistics
Total Events 48,538 Display suppressed 67
Events Handled 22,407 Hardcopy suppressed 0
Current arrival rate 2 / sec Rule generated Alerts 22,223
Peak arrival rate 99 / sec Rule invoked Execs 276
Automation Library
LC CMDS --- (S)elect, (E)nable, (D)isable, (T)est, (SA)ve
(M)ove, (B)efore or (A)fter, (F)ilter Criteria
LC Rule-Set Status Rules Fired Filtered Date Time Strategy
___ AAORULMY ENABLED 15 22,223 48,573 DD-MMM-YY 08:18:59 FIRST
___ AAORULBC ENABLED 54 188 48,573 DD-MMM-YY 08:18:59 FIRST
___ AAORULCM ENABLED 52 59 48,573 DD-MMM-YY 08:18:59 FIRST
___ RULCICS ENABLED 25 1 48,573 DD-MMM-YY 08:19:00 FIRST
e_ RULMAGIE DISABLED 8 0 38 DD-MMM-YY 14:14:38 FIRST
___ AAORULBA DISABLED N/A N/A N/A N/A N/A
___ AAORULBB DISABLED N/A N/A N/A N/A N/A
*********************** END OF DATA ***********************The Rule Set is enabled.
Select the Rule Set with the S line command (for Select) in the LC field next to the Rule Set name.
Figure 2. Creating a suppression Rule (1): Automation Control panel
BMC Software ---------------- Automation Control ------------ RULMAGIE ENABLED
COMMAND ===> TGT ===> AOAO
Primary commands: ADD, STATSHOW, CMDSHOW, PARMSHOW, Locate, DATE --- YY/MM/DD
EXPAND TIME --- 17:48:38
Automation Status ===> ACTIVE (Active, Inactive)
Automation Strategy ===> INDIVIDUAL (Individual, All, First)
Honor MPF Suppression ===> NO (NO/YES)
Automation Statistics
Total Events 48,538 Display suppressed 67
Events Handled 22,407 Hardcopy suppressed 0
Current arrival rate 2 / sec Rule generated Alerts 22,223
Peak arrival rate 99 / sec Rule invoked Execs 276
Automation Library
LC CMDS --- (S)elect, (E)nable, (D)isable, (T)est, (SA)ve
(M)ove, (B)efore or (A)fter, (F)ilter Criteria
LC Rule-Set Status Rules Fired Filtered Date Time Strategy
___ AAORULMY ENABLED 15 22,223 48,573 DD-MMM-YY 08:18:59 FIRST
___ AAORULBC ENABLED 54 188 48,573 DD-MMM-YY 08:18:59 FIRST
___ AAORULCM ENABLED 52 59 48,573 DD-MMM-YY 08:18:59 FIRST
___ RULCICS ENABLED 25 1 48,573 DD-MMM-YY 08:19:00 FIRST
s_ RULMAGIE ENABLED 8 0 38 DD-MMM-YY 14:14:38 FIRST
___ AAORULBA DISABLED N/A N/A N/A N/A N/A
___ AAORULBB DISABLED N/A N/A N/A N/A N/A
*********************** END OF DATA ***********************The Rule Set Overview panel is displayed. The following figure shows an example of a Rule Set named RULMAGIE and the Rules that it contains.
Figure 3. Creating a suppression Rule (1): Rule Set Overview panel
BMC Software ------------- Rule Set Overview ------------- MAINVIEW AutoOPERATOR
COMMAND ===> add TGT --- AOAO
Rule Set ID: RULMAGIE Ruleset Strategy ===> FIRST DATE --- YY/MM/DD
Primary commands: Add, Save, Sort, Unsort, Reset, Filter TIME --- HH:MM:SS
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
________ _ ________________ ____ ________ ________ _____ ________
___ DUMMY001 DIS $HASP* MSG 0 YY/MM/DD 14:58 BAOMXY2
___ RUL00001 ENA *TEST JRNL 0 YY/MM/DD 15:00 BAOMXY2
___ RUL98888 ENA $HASP395 MSG 0 YY/MM/DD 15:20 BAOMXY2
___ RUL98887 ENA IEF450I MSG 0 YY/MM/DD 14:07 MES1
___ RUL98886 ENA TIME 0 YY/MM/DD 14:14 MES1
___ RUL98885 SUS TIME 0 YY/MM/DD 14:15 MES1
___ *TEST ENA *TEST ALRT 0 YY/MM/DD 14:43 MES1
___ TESTRULE ENA IEF403I MSG 0 YY/MM/DD 17:47 BAOMXY2
************************* END OF DATA **************************To add a new Rule, use the ADD primary command on the COMMAND line.The Rule Processor Detail Control panel is displayed as shown in the following figure.
BMC Software ------- Rule Processor Detail Control ------- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
TIME --- HH:MM:SS
The following options are displayed in sequence, or may DATE --- YY/MM/DD
be selected by entering the two-character code
S1 - Selection Criteria AV - Set Variable(s)
SV - Variable Dependencies AA - Alert Action(s) I
A1 - Action Specification(s) I AD - Alert Action(s) II
A2 - Action Specification(s) II BA - Event Action(s) - BEIM
AE - Alert Action(s) III - BEIM
Rule ID ===>
Event Type ===> Type of event ( ? for list)
Initial Mode ===> ENABLED (ENABLED/DISABLED/TEST)
Criteria match rate threshold:
If matched ===> (Maximum # times matched within INTERVAL, 0-100)
in seconds ===> (Interval length, 1-99999 seconds)
then status ===> (SUSPEND, DISABLE, NOACTION)
Application information:
Group ===> Func ===> Code ===>
Author ===> BAOMXY1 Desc ===>
Last Modified by on at
Press ENTER to continue, END to apply changes, CANCEL to cancel changesEnter the name of the new Rule (the Rule ID) and the event type of the new Rule.The following figure shows adding a new Rule named NEWRULE1 with an event type of MSG.
BMC Software -------- Rule Processor Detail Control ------ MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
TIME --- HH:MM:SS
The following options are displayed in sequence, or may DATE --- YY/MM/DD
be selected by entering the two-character code
S1 - Selection Criteria AV - Set Variable(s)
SV - Variable Dependencies AA - Alert Action(s) I
A1 - Action Specification(s) I AD - Alert Action(s) II
A2 - Action Specification(s) II BA - Event Action(s) - BEIM
AE - Alert Action(s) III - BEIM
Rule ID ===> NEWRULE1
Event Type ===> MSG Type of event ( ? for list)
Initial Mode ===> ENABLED (ENABLED/DISABLED/TEST)
Criteria match rate threshold:
If matched ===> (Maximum # times matched within INTERVAL, 0-100)
in seconds ===> (Interval length, 1-99999 seconds)
then status ===> (SUSPEND, DISABLE, NOACTION)
Application information:
Group ===> Func ===> Code ===>
Author ===> BAOMXY2 Desc ===>
Last Modified by on at
Press ENTER to continue, END to apply changes, CANCEL to cancel changesPress Enter; the Selection Criteria - MSG panel is displayed as shown in the following figure.Specify the event criteria that the Rule must match to cause the Rule to fire.
Figure 4. Creating a suppression Rule (1): Selection Criteria panel
BMC Software --------- Selection Criteria - MSG -------- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule-set === RULMAGIE Rule-id === NEWRULE1
Text Description:
Text ID ===> Ignore leading plus: Y
Text String (Enter Below):
Issuer Identification:
Job name ===> Name of issuer
Type ===> (JOB, STC, or TSO)
Jobclass ===> Job class of issuer
Acct Info ===> Job accounting information
RACF User ===> RACF Userid
RACF Group ===> RACF Group name
Route Codes ===>
Desc Codes ===>
Console Name ==> Destination Console Name
MLWTO Minor ===> Single/All
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changesEnter $HASP395 in the Text-ID field and BAO* in the Job Name field.
BMC Software -------- Selection Criteria - MSG ---------- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule-set === RULMAGIE Rule-id === NEWRULE1
Text Description:
Text ID ===> $HASP395 Ignore leading plus: Y
Text String (Enter Below):
Issuer Identification:
Job name ===> BAO* Name of issuer
Type ===> (JOB, STC, or TSO)
Jobclass ===> Job class of issuer
Acct Info ===> Job accounting information
RACF User ===> RACF Userid
RACF Group ===> RACF Group name
Route Codes ===>
Desc Codes ===>
Console Name ==> Destination Console Name
MLWTO Minor ===> Single/All
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changesPress Enter; the Variable Dependencies - MSG panel is displayed as shown in the following figure.
Figure 5. Creating a suppression Rule (1): Variable Dependencies panel
BMC Software -------- Variable Dependencies - MSG ------- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule-set === RULMAGIE Rule-id === NEWRULE1
OR/
Variable-name Op Variable-Value AND
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________
--> ATTENTION: Use ASV command to add ASV criteria to the rule <--
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changesThis example Rule does not use variables: press Enter; the Action Specification(s) I - MSG panel is displayed.Specify the actions that the Rule will take when it is fired.
BMC Software ------ Action Specification(s) I - MSG ----- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule-set === RULMAGIE Rule-id === NEWRULE1
Display at dest. ===> YES Journal ===> SYSLOG Display ===>
Aux Log ===>
* Exec Name/Parms ==>
* Cmd(Type MVS ) ===>
Reword Msg ===>
* Issue Msg( WTO ) =>
DOM Message ===> (Yes/No)
POST Target ===>
POST ID ===>
POST Parms ===>
* Enter a question mark(?) and blank in any field on the line for more options.
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changesTo specify that the Rule is suppressed from the console and a message is written to the BBI-SS PAS Journal:
- Enter NO for Display at dest. field to suppress the message from appearing on the console.
- Enter YES for Journal to write the message to the BBI-SS PAS Journal. See Figure 6.
Figure 6. Creating a suppression Rule (1): Action Specification I panel
BMC Software ------ Action Specification(s) I - MSG ----- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule-set === RULMAGIE Rule-id === NEWRULE1
Display at dest. ===> NO Journal ===>YES SYSLOG Display ===>
Aux Log ===>
* Exec Name/Parms ==>
* Cmd(Type MVS ) ===>
Reword Msg ===>
* Issue Msg( WTO ) =>
DOM Message ===> (Yes/No)
POST Target ===>
POST ID ===>
POST Parms ===>
* Enter a question mark(?) and blank in any field on the line for more options.
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changes- Press Enter; the Action Specification(s) II - MSG panel is displayed as shown in the following figure.
Specify that a notification is sent to a TSO user ID, BAOMES1, in the Send (TSO IDs) field.
Figure 7. Creating a suppression Rule (1): Action Specification II panel
BMC Software ---------- Action Specification(s) II - MSG ------- AutoOPERATOR
COMMAND ===> TGT --- DL72
Rule-set === RULMAGIE Rule-id === NEWRULE1
Send (TSO IDs) ===> BAOMES1
DOM Id ===> Delete Operator Message
Console Name ===> Dest. Console ID Name
Route codes ===>
Descriptor codes ===>
Update Rout/Desc Codes ===> (ADD/REPL)
Color ===>
Hilite ===>
Intensity ===>
Set IOA Variable ===>
Value ===>
CTM Force Job: Table..: Job.: Date:
Library:
CTM Set Cond.: Name...: Date: Action:
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changesPress Enter; the Action: Set Variables - MSG panel is displayed as shown in the following figure.
Figure 8. Creating a suppression Rule (1): Action: Set Variables - MSG panel
BMC Software -------- Action: Set Variables - MSG -------------- AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule-set === RULMAGIE Rule-id === NEWRULE1
Variable-Name Variable-Value(functions/equations allowed)
_________________________________ ___________________________________________
_________________________________ ___________________________________________
_________________________________ ___________________________________________
_________________________________ ___________________________________________
_________________________________ ___________________________________________
_________________________________ ___________________________________________
_________________________________ ___________________________________________
_________________________________ ___________________________________________
_________________________________ ___________________________________________
_________________________________ ___________________________________________
Press END to return to AV with changes or CANCEL to cancel changesThis Rule will not set variables; press Enter and the Alert Action(s) I- MSG panel is displayed as shown in the following figure.
Figure 9. Creating a suppression Rule (1): Alert Action(s) I panel
BMC Software ---------- Alert Action(s) I - MSG --------- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule-set === RULMAGIE Rule-id === NEWRULE1
Function ===> (ADD, DELETE, DELETEQ)
Key ===>
Text ===>
Queues ===> Alert Queue Name(s)
Priority ===> (CRIT,MAJ,MIN,WARN,INFO,CLEAR)
Color ===> RED,PINK,YEL,DKBL,LTBL,GRE,WHI
PCMD ===>
System ===> Return to target after PCMD
* Exec ===> Follow-up EXEC
Help ===> Associated HELP Panel
Targets ===> Target System
Udata ===> User Data
Origin ===> Origin
User ===> Userid
Alarm ===> Sound Alarm (YES/NO)
Publish ===> Messages (ADD/REPLACE/NO)
* Enter a question mark(?) and blank for more options.
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changeThis Rule will not issue an ALERT; press Enter and the Alert Action(s) II - MSG panel is displayed as shown in the following figure.
Figure 10. Creating a suppression Rule (1): Alert Action(s) II panel
BMC Software --------- Alert Action(s) II - MSG --------- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule-set === RULMAGIE Alert Rule-id === NEWRULE1
Auto Delete ===> Yes/No
Retain ===> Yes/No
Escalate Direction ===> Up/Down
Interval ===>
===>
===>
===>
===>
===>
Disposition ===> Keep/Delete
* Final Act( )=>
* Enter a question mark(?) and blank in any field on the line for more options.
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changesPress Enter until the Rule Processor Detail Control panel is redisplayed.
BMC Software -------- Rule Processor Detail Control ------ MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
TIME --- HH:MM:SS
The following options are displayed in sequence, or may DATE --- YY/MM/DD
be selected by entering the two-character code
S1 - Selection Criteria AV - Set Variable(s)
SV - Variable Dependencies AA - Alert Action(s) I
A1 - Action Specification(s) I AD - Alert Action(s) II
A2 - Action Specification(s) II BA - Event Action(s) - BEIM
AE - Alert Action(s) III - BEIM
Rule ID ===> NEWRULE1
Event Type ===> MSG Type of event ( ? for list)
Initial Mode ===> ENABLED (ENABLED/DISABLED/TEST)
Criteria match rate threshold:
If matched ===> (Maximum # times matched within INTERVAL, 0-100)
in seconds ===> (Interval length, 1-99999 seconds)
then status ===> (SUSPEND, DISABLE, NOACTION)
Application information:
Group ===> Func ===> Code ===>
Author ===> BAOMXY2 Desc ===>
Last Modified by on at
Press ENTER to continue, END to apply changes, CANCEL to cancel changesPress END to apply changes; the Rule Set Overview panel is displayed as shown in the following figure.
Figure 11. Creating a suppression Rule (1): Rule Set Overview panel
BMC Software ------------- Rule Set Overview ------------- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
Rule Set ID: RULMAGIE Ruleset Strategy ===> FIRST DATE --- YY/MM/DD
Primary commands: Add, Save, Sort, Unsort, Reset, Filter TIME --- HH:MM:SS
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
________ _ ________________ ____ ________ ________ _____ ________
___ NEWRULE1 ENA $HASP395 MSG 0 YY/MM/DD 15:00 BAOMXY2
___ RUL98888 ENA $HASP395 MSG 2 ES YY/MM/DD 16:12 BAOMXY2
___ RUL98887 ENA IEF450I MSG 0 YY/MM/DD 14:07 MES1
___ RUL98886 ENA TIME 7 YY/MM/DD 14:14 MES1
___ RUL98885 SUS TIME 0 YY/MM/DD 14:15 MES1
___ *TEST ENA *TEST ALRT 0 YY/MM/DD 14:43 MES1
************************* END OF DATA **************************The Rule is enabled and will begin to fire when the $HASP395 message is issued from any job beginning with the characters BAO but at this point it is not saved to disk.
To save the Rule, enter the SAVE primary command on the COMMAND line.If you do not enter the SAVE primary command, the following warning is displayed when you press PF3:
Figure 12. Creating a suppression Rule (1): Confirming Rule Set Modifications panel
BMC Software -------- Confirm Rule Set Modifications ------- MAINVIEW AutoOPERATOR
COMMAND ===> TGT --- AOAO
+----------------------------------------------------------------------------+
+ WARNING! Changes made to Rule Set RULMAGIE have not been saved. Those +
+ changes were one or more of the following: +
+ +
+ o A Rule was changed. +
+ o The status of a Rule was modified. +
+ o A Rule was added, deleted, inserted, or copied. +
+ o A Rule was moved. +
+ o The individual Rule Set strategy changed. +
+ o A FILTER was added or modified. +
+ +
+ Please do one of the following: +
+ +
+ - Enter SAVE to save RULMAGIE to the BBIPARM dataset. +
+ - Enter NOSAVE to exit WITHOUT saving RULMAGIE to the BBIPARM dataset. +
+ - Press END to return to Rule Set Overview. +
+----------------------------------------------------------------------------+The options are as follows:
- To save the Rule, enter SAVE.
- To cancel saving the newly created Rule, enter NOSAVE.
- To return to the Rule Set Overview panel, press END.
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*