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
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 Group, Function, Code, Author, 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 Group, Function, Code, Author, and Description fields.
Rule Set Overview panel—view 2
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
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 Stat, Start Time, Interval, Stop Time, Stop Count, and Fired fields.
Rule Set Overview panel—view 4
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 Name, Job Type, Job Class, RACF User-ID, and RACF Group fields.
Rule Set Overview panel—view 5
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 Information, Con Name, Route Code, and Desc Codes fields.
Rule Set Overview panel—view 6
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
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
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 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: