NET/MASTER RMS Management and Operations Guide

Adding a Message Action Rule
Creating and Developing Rulesets and Rules
115415 NonStop NET/MASTER RMS Management and Operations Guide 5–33
Using the Message Threshold for Each Variation of the Message. Instead of applying the
message threshold to the message as a whole, you can apply the threshold to each
variant of the message. To use this feature, specify a key in the Correlation Key field
on the RMS : Message Modification panel. The key can contain any characters except
the vertical bar (|) and can contain the names of variables, for example, the RMS
message variables (see “RMS Message Variables” in Section 11). The Correlation Key
field can accommodate up to 50 characters.
For example, the rule is triggered by the following message:
NNM0686 USER userid FAILED TO PROVIDE CORRECT PASSWORD, AFTER
TRYING n TIMES ON devname
Specify &WORD3 in the Correlation Key field to apply the message threshold to each
different occurrence of the user ID in the message (the value of &WORD3 is the third
word in the message).
Displaying a Help Panel
You can instruct RMS to display a help panel when the message action rule is
triggered. You must create your own help panel. Refer to the NonStop NET/MASTER
NCL Programmer’s Guide for information on how to create a panel.
Your help panel has access to all RMS message variables that are applicable in a
message action rule. See Table 11-2 for a description of the variables.
Ensure that you place your panel in the NonStop NET/MASTER customized panel
library. The name of the library is in the NonStop NET/MASTER MS startup
parameter PNLCUSTSRC. Use the NonStop NET/MASTER MS SHOW PARAM
command on the OCS command line to display the value of PNLCUSTSRC.
You may place the panel in your NonStop NET/MASTER user panel library if you are
the only person who will use this ruleset with a message handler. Your NonStop
NET/MASTER MS user ID definition contains the name of this library.
Note Panels require a terminal for display. If you use panels in a rule within the ruleset, you should start the
message handler in an environment that has access to a terminal. For example, start the message
handler as a MSGPROC in an OCS environment. If the environment does not support panels, the panel
cannot be delivered but the message handler continues operating.
Specify the name of the panel in the Help Panel field on the RMS : Message
Modification panel. You can specify the name explicitly or use a variable to hold the
name.
051
Help Panel .. Alarm ..... (Y/N) Color ....... (B,R,P,G,T,Y,W)
Monitor .....
(Y/N) Intens .... (H/L) Hlight ...... (U,B,R)
NRD .........
(Y/N) Scan ...... (Y/N) Msg Code ....