Message Delivery

When a message satisfies the filtering criteria of a rule that is the best fit, the rule controls how the message is delivered. Specify the delivery criteria on the Message Delivery panel.

Set the Deliver Flag

To set the Deliver flag on the Message Delivery panel, specify one of the following values:

YES (the default), if you want to deliver the message to the operating system and the consolidated console, and to log to the system log (SYSLOG) and the activity log
IGN, if you want the region to ignore the message, but deliver it to the operating system and log it to the system log (SYSLOG)
LOG, if you want the message logged to SYSLOG and the activity log, but not displayed on the console
NO, if you want the message suppressed everywhere with the exception of SYSLOG
Z, if you want the message suppressed everywhere, including SYSLOG

Note: Delivery of system messages to the activity log can be suppressed by the LOGFILES parameter group.

Delivery Thresholds

Thresholds determine what actions are taken when multiple messages trigger the rule in a given time period.

You set thresholds on the Message Delivery panel. You can request that the action associated with the rule be performed before these thresholds are reached, after they are reached, or whenever the rule is triggered, by entering a valid value in the Do Action field.

Note: When a threshold is reached, the value of the Deliver flag is effectively reversed. For example, if the flag is set to NO, messages to which the rule applies are suppressed until the threshold is reached, then delivered to the console. If the flag is set to YES, messages are delivered to the console until the threshold is reached, then suppressed. If the flag is set to LOG, messages are sent to the log until the threshold is reached, then delivered to the console.

How You Use Thresholds When Deliver Flag Is YES

You can specify that you do not want to see the same message more than a given number of times within a certain time interval.

For example, if you do not want to see the same message more than ten times within one minute, you enter the following values:

10 in the Maximum Number field
00.01.00 in the Time Interval field.

How You Use Thresholds When Delivery Flag Is NO

You can specify that you only want a message displayed if it starts occurring more frequently than usual. You enter a value in the Time Interval field. If more messages of the same kind than the number specified in the Maximum Number field are received in the specified time interval, the messages are displayed. Otherwise, the messages are not displayed.

For example, you want to see every fifth occurrence of a message. You set the Maximum Number field to four and leave the Time Interval field blank (or set to 0). This setting specifies that, no matter how long the interval between occurrences of this message, every fifth occurrence of the message is displayed. All other occurrences of the message are suppressed.

Correlation Key

To avoid creating separate rules for different versions of the same message, you can specify a correlation key on the Message Delivery panel. The rule keeps separate threshold counts for each instance of the correlation key. The separate counts avoid the possible suppression of important but uncommon versions of a message.

The correlation key can include the following:

A user-defined EventView variable
A reference to a ZMSG system variable, such as &ZMSGWORD3

Note: For more information about the system variables, see the Network Control Language Reference Guide.

Example: Specify a Correlation Key

This example limits the number of messages (from a given job) that trigger the rule to ten for every hour:

 PROD------------------ EventView : Message Delivery --------------------TAPEMON
 Command ===>                                                    Function=UPDATE

 Deliver ..........+ YES

 . Threshold ------------------------------------------------------------------.
 |                                                                             |
 | Maximum Number .. 10                                                        |
 | Time Interval ... 01.00.00                                                  |
 | Do Action ......+ ______                                                    |
 | Correlation Key   &ZMSGJOBNM                                                |
 |                                                                             |
 ’-----------------------------------------------------------------------------’









  F1=Help      F2=Split     F3=File      F4=Save
  F7=Backward  F8=Forward   F9=Swap                  F11=Panels   F12=Cancel

Tell Technical Publications how we can improve this information