Example 1: creating a Rule with MLSEG Minor = ALL
In this example, an IMS MLSEG message is processed by the Rule as a complete entity because MLWTO Minor ===> ALL is specified on the Selection Criteria panel.
The Rule in this example uses the Variable Dependencies panel and the variables &LINEx_WORDn. The Rule fires based on content within the MLSEG such as the message ID of the major segment, the job name, and some additional information in the third minor segment of the message.
When all of the selection and variable dependency criteria is met, this example Rule creates an ALERT with the appropriate text.
The IMS MLSEG message is DFS2503W:
D 978 00000090 (DFS2503W) DATASET NAME AAO.IMS111.DE2PCUST
E 978 00000090 (DFS2503W) DATABASE BE2PCUST REASON CODE 1708
Fill in the Selection Criteria - IMS panel as follows:
BMC Software ------------- Selection Criteria - IMS ------------ BMC AMI OpsA
COMMAND ===> TGT --- NS7A
Rule-set === AAORUL01 Rule-id === DFS2503W
Text Description:
Text ID ===> DFS2503W First word of message
Text String (Enter Below):
Issuer Identification:
Job name ===> IMS11PRD Jobname of IMS
Type ===> (JOB, STC, or TSO)
Jobclass ===> Job class of issuer
Acct Info ===> Job accounting information
RACF User ===> RACF Userid
RACF Group ===> RACF Group name
MLSEG Minor ===> ALL All/Single
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changesWhen MLSEG Minor ===> ALL is specified all the lines of IMS multisegment message are processed by the Rule as a single entity. BMC Software recommends that you use the variables &LINEx_WORDn on the Variable Dependencies panel so that the Rule can fire based on specific content of the MLSEG.
With the &LINEx_WORDn variables, x is set for every segment of the MLSEG and n is set for every word in a segment.
Press Enter; the Variable Dependencies - IMS panel is displayed as shown in the following figure.
BMC Software ------------ Variable Dependencies - IMS ---------- BMC AMI OpsA
COMMAND ===> TGT --- NS7A
Rule-set === AAORUL01 Rule-id === DFS2503W
OR/
Variable-name Op Variable-Value AND
LINE3_WORD3:1:4_________________ EQ BE2P_______________________________ AND
LINE3_WORD6_____________________ EQ 1708_______________________________ AND
LINE2_WORD4_____________________ EQ AAO*_______________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________ ___
________________________________ __ ___________________________________
--> ATTENTION: Use ASV command to add ASV criteria to the rule <--
Press ENTER to continue, END return to Detail Control, CANCEL to cancel changesWhen you specify variable &LINE3_WORD3:1:4, the Rule Processor checks the value of the first four characters of the third word, in segment three of the IMS MLSEG message. If this value resolves to characters BE2P, and if the sixth word of the same segment (&LINE3_WORD6) resolves to 1708, and the value of the fourth word of the second segment starts with 'AAO', the Rule fires.
Press Enter until the Alert Action(s) I - IMS panel is displayed as shown in the following figure.The following entry on the Alert Action(s) II - IMS panel specifies that when the Rule fires, a BMC AMI Ops Automation ALERT will be created.
BMC Software -------------- Alert Action(s) I - IMS ------------- BMC AMI OpsA
COMMAND ===> TGT --- NS7A
Rule-set === AAORUL01 Rule-id === DFS2503W
Function ===> ADD (ADD, DELETE, DELETEQ)
Key ===> PROD&IMFOJOB
Text ===> PRODUCTION IMS &IMFOJOB - ALLOCATION FAILED FOR DATASET: &LINE2_
WORD4, DATABASE: &LINE3_WORD3
Queues ===> PRODQUE Alert Queue Name(s)
Priority ===> WARN (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 ===> Alert Publishing Mode
* Enter a question mark(?) and blank for more options.
Press ENTER to continue, END return to Detail Control, CANCEL to cancel change- Press Enter and finish completing the Rule.
Related topic