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–37
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.
Caution When automating tasks, you must allow for rules performing actions that have already been performed.
This occurs, for example, if EMSPROC fails and is restarted. Event messages are resent from slightly
before the last message processed before the failure. A duplicate event message may trigger a rule that
has already been triggered to perform the required actions.
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 60 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).
Note As a special case, you can also use the NCL verb INTCMD in the Command Text field of a message
action rule definition. The feature is useful when an INT-type message handler uses the ruleset. The
message handler can read the results of the INTCMD verb from its dependent queue, and the results may
trigger more rules.