NET/MASTER RMS Management and Operations Guide

Adding a Message Action Rule
Creating and Developing Rulesets and Rules
5–38 115415 NonStop NET/MASTER RMS Management and Operations Guide
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 action 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
provide the value of the delay period before the rule action is retried. For further
information on retrying rule action NCL procedures, refer to the subsection “Using
Automatic Retry for Rule Action NCL Procedures,” later in this section.
Specify the name of the procedure, followed by any parameters to be passed, in the
NCL Proc Name field on the RMS : System Action panel. The field accepts up to 60
characters. The procedure must exist. Furthermore, for the procedure to be valid in
this field, the procedure must contain no compilation errors.
Specifying NonStop NET/MASTER MS Commands to Be Issued Using a Command Group
You can instruct RMS to issue a group of NonStop NET/MASTER MS commands
when this rule is triggered. Put these commands in a command group. The command
group must be in the same ruleset as this rule. You create a command group within
the ruleset using option 4 on the RMS : Rule Maintenance panel (see “Developing
Command Groups” in Section 6). The command group contains the commands you
want to issue. Your commands have access to all RMS message variables that are
applicable in a message action rule. See Table 11-2 in Section 11 for a description of
the variables.
Specify the name of the command group in the Exec Cmd Group field on the
RMS : System Action panel. You must have already created the command group in
the ruleset.
Specifying the Region for Submitting Rule Action Procedures
You can instruct RMS to execute specific system actions in a specified background
environment when the rule is triggered. The system actions that can be executed in
the specified background region are NonStop NET/MASTER MS commands, NCL
procedures, and NonStop NET/MASTER MS commands using command groups.
The system action(s) can be executed in either the BMON, BSYS, BLOG, EMSP, or
LOGP background environment.