NAME

netmgt_fetch_msginfo - fetch received message information

SYNOPSIS

bool_t

netmgt_fetch_msginfo(msginfo)
        Netmgt_msginfo          * msginfo;

DESCRIPTION

netmgt_fetch_msginfo obtains additional message information from a data or event report and places it into a local buffer msginfo.

INPUT ARGUMENTS

msginfo buffer where the message information is placed. It has the following fields:

manager_addr

IP address of the manager that requested the event report.

request_time

time when the agent started the request.

report_time

time when the agent sent the report. Note that the value comes from the system clock where the agent is running, which may not be synchronized with the clock where the caller is running.

delta_time

a relative timestamp the that agent returns. This value should be larger than the value returned in the last report from this agent running this request. If the timestamp is smaller, the agent or managed device has probably been reset.

agent_addr

IP address where the agent is running.

agent_prog

RPC program number of the agent that sent the report.

agent_vers

RPC version number of the agent that sent the report.

status

error code from Netmgt_stat (defined in netmgt_errno.h) indicating any service error.

RETURN VALUE

TRUE if successful, otherwise FALSE.

DIAGNOSTICS

FALSE is returned when a NULL msginfo buffer is passed in. Global variable netmgt_error indicates the error. An error buffer is available by calling netmgt_fetch_error(3N).

FILES

netmgt_errno.h

SEE ALSO

netmgt_fetch_error(3N)