NET/MASTER RMS Management and Operations Guide

Adding a Message Group Rule
Creating and Developing Rulesets and Rules
5–58 115415 NonStop NET/MASTER RMS Management and Operations Guide
no execution limit for rule actions sent to an NCL queue that you have not yet defined
or if you explicitly specify no NCL queue name.
See Section 2, “Message Handlers, Timers, Rulesets, and Rules,” for more information
about how rule actions are queued. See Section 3, “Planning for, Installing, and
Managing RMS,” for information about defining NCL queues and setting the
execution limit.
Specifying a Time-Based Rule to Be Activated
You can instruct RMS to load a pending time-based rule when this rule is triggered.
The time-based rule must be part of the ruleset. Create a time-based rule within the
ruleset using option 3 on the RMS : Rule Maintenance panel.
Specify the name of the time-based rule in the Activate Timer field on the
RMS : System Action panel.
Specifying a Ruleset to Be Loaded
You can instruct RMS to replace the ruleset containing this rule with a another ruleset
when this rule is triggered. The message handler then uses the new ruleset to process
future messages.
Specify the name of the ruleset to be loaded in the Load Ruleset field on the
RMS : System Action panel. The ruleset must exist in the RMS database.
Implementing User-Defined Actions
You can implement actions that RMS does not directly support using a rule action exit
NCL procedure. When the rule is triggered, RMS invokes the procedure before
performing any other processing. If the return code is nonzero, RMS stops any further
rule processing. You cannot pass parameters to the procedure.
Note Unlike the rule action exit NCL procedures for message action rules, rule action exit NCL procedures for
message group rules execute separately from the message handler.
Your procedure has access to RMS variables with the prefix $RMS. You can change a
$RMS-prefixed variable to dynamically change the characteristics of the rule.
Place the rule action exit NCL procedure 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.
To use a rule action exit NCL procedure, specify the name of your exit NCL procedure
in the NCL Exit Name field on the RMS : System Action panel. The procedure must
exist. Furthermore, for the procedure to be valid in this field, the procedure must
contain no compilation errors.