NAME

netmgt_fetch_event - fetch event report statistics

SYNOPSIS

bool_t

netmgt_fetch_event(event)
        Netmgt_event * event;

DESCRIPTION

netmgt_fetch_event gets event statistics out of an event report and places them into a local buffer event. When a rendezvous receives an event report, the first call to this function fetches the first event statistic in the report. Successive calls get successive statistics.

A returned name string of NETMGT_ENDOFROW marks the end of a row of tabular data. The string NETMGT_ENDOFARGS marks the end of the report. These strings are defined in netmgt_arglist.h. The caller can repeatedly call this function until NETMGT_ENDOFARGS is seen.

INPUT ARGUMENTS

event

pointer to a buffer where individual event statistics are placed. It has the following fields:

name

attribute name.

type

attribute type code, as defined in netmgt_arglist.h.

length

attribute value length, in bytes.

value

attribute value. The value's internal representation is described by type.

relop

relational operator, as defined in netmgt_arglist.h, indicating how the threshold was exceeded. If this attribute didn't trigger the event report, this field will be set to NETMGT_NOP.

thresh_val

threshold value. The threshold's internal representation is described by type.

priority priority of the event. Possible values are NETMGT_LOW_PRIORITY,

NETMGT_MEDIUM_PRIORITY or NETMGT_HIGH_PRIORITY.

RETURN VALUE

TRUE if successful, otherwise FALSE.

DIAGNOSTICS

If FALSE is returned, global variable netmgt_errno indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3N).

FILES

netmgt_arglist.h

SEE ALSO

netmgt_fetch_error(3N)

NOTES

To find out which attributes triggered the event report, cycle through the event statistics via repeated calls to this function. Look for the returned relop value to be something besides NETMGT_NOP.