NET/MASTER RMS Management and Operations Guide

Adding a Message Group Rule
Creating and Developing Rulesets and Rules
5–56 115415 NonStop NET/MASTER RMS Management and Operations Guide
For certain actions to be effective, you must also ensure that the control options of the
ruleset allow them. You can enable or disable these actions using the RMS : Control
Options Definition—Run Parms panel. The following table shows the RMS : System
Action panel fields that can be enabled or disabled by fields on the RMS : Control
Options Definition—Run Parms panel:
System Action Panel Fields Run Parms Panel Fields
Command Text System Command—for PROGRUN and OPSYS commands
NonStop NET/MASTER Command—for commands other than
PROGRUN and OPSYS
NCL Proc Name Start NCL Procedure
Exec Cmd Group Exec Command Group
Activate Timer Activate Timer
Set Variables Set Defined Variables
See “Enabling or Disabling Ruleset Features,” earlier in this section, for more
information.
Additionally, the user that owns the message handler that uses the ruleset containing
this rule must have authority to issue the NonStop NET/MASTER MS commands
specified in the rule actions; otherwise, the actions cannot be performed.
If you do not want to specify any actions, leave the fields blank.
Specifying NonStop NET/MASTER MS Commands to Be Issued
You can instruct RMS to issue one or more NonStop NET/MASTER MS commands
when this rule is triggered. Concatenate commands using the semicolon (;). Specify
the commands in the Command Text field on the RMS : System Action panel. The
field accepts up to 59 characters. If the commands you want to issue result in a string
that is too long for the field, use a command group (see “Specifying NonStop
NET/MASTER MS Commands to Be Issued Using a Command Group” later in this
section).
Specifying an NCL Procedure to Be Started
You can instruct RMS to start an NCL procedure when this rule is triggered. The
procedure should be in the NonStop NET/MASTER customized procedure library.
The name of the library is in the NonStop NET/MASTER MS startup parameter
NCLCUSTSRC. Use the NonStop NET/MASTER MS SHOW PARAM command on
the OCS command line to display the value of NCLCUSTSRC.
You may place the procedure in your NonStop NET/MASTER user procedure 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.
Your procedure has access to all RMS message variables that are applicable in a
message group rule. See Table 11-2 in Section 11 for a description of the variables.
Your NCL procedure can set a return code to instruct RMS to retry the rule action.
The NCL procedure can also specify message text to describe the rule action retry and