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–25
N if you do not want a message arriving on the day to trigger the rule.
Specifying the Time Range. You can specify up to two time ranges to restrict the message
arrival time. The four fields are Time1 and Time2 for the first range and Time3 and
Time4 for the second range.
The value, if specified, must conform to the following:
The value must be in the range 00:00:00 through 23:59:59. You can omit the 00
strings. For example, ::01 is the same as 00:00:01.
You must specify the value in pairs. The pairs are Time1 and Time2, and Time3
and Time4. For example, if you specify a value for Time1, you must also specify a
value for Time2.
The value of Time1 must be less than the value of Time2.
The value of Time3 must be less than the value of Time4.
The default value for Time1 is 00:00:00, and the default value for Time2 is 23:59:59.
The default values for Time3 and Time4 are blanks.
Implementing User-Defined Criteria
You can use rule trigger criteria that RMS does not provide by using your own
message validation exit NCL procedure. RMS invokes the procedure if a message
satisfies all the RMS rule trigger criteria. The procedure provides a final check on
whether the message will trigger the rule. You must use the EXIT core statement in
your procedure to return a value to RMS. If the return code is nonzero, RMS regards
the message as not satisfying the validation criteria and does not trigger the rule. You
cannot pass parameters to the procedure.
Note The message validation exit NCL procedure executes in line with the message handler. When the
procedure starts executing, all processing within the handler stops until the procedure returns control to
the handler. If the message arrival rate is high, you should avoid introducing operations that may cause
lengthy delays in the procedure (for example, file input-output operations). If the procedure aborts, the
handler also aborts.
Your message validation exit NCL procedure has access to RMS variables with the
prefixes WORD, ZZZ, $RMS, and $UV. You should regard all the variables (except the
$UV-prefixed variables) as read-only variables. Changes to these variables are not
retained when the procedure terminates. Changes to the $UV-prefixed variables,
however, are retained when the procedure terminates.
Place the message validation 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.