HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_MDS_STATISTICS
Chapter 4 807
opcode
AP_QUERY_MDS_STATISTICS
Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following
parameters:
primary_rc
AP_OK
alerts_sent
Number of locally originated alerts sent using the MDS
transport system.
alert_errors_rcvd
Number of error messages received by MDS indicating
a delivery failure for a message containing an alert.
uncorrelated_errors_rcvd
Number of error messages received by MDS indicating
a delivery failure for a message containing an alert.
Delivery failure occurs when the error message could
not be correlated to an alert on the MDS send alert
queue. MDS maintains a fixed-size queue where it
caches alerts sent to the problem determination focal
point. Once the queue reaches maximum size, the
oldest alert will be discarded and replaced by the new
alert. If a delivery error message is received, MDS
attempts to correlate the error message to a cached
alert so that the alert may be held until the problem
determination focal point is restored.
NOTE The two counts
alert_errors_rcvd
and
uncorrelated_errors_rcvd
can be used to check that
the size of the send alert queue (specified on
DEFINE_NODE) is appropriate. If the value of
uncorrelated_errors_rcvd
increases over time, this
indicates that the send alert queue size is too small.