NAME
netmgt_send_error - send an error report
SYNOPSIS
bool_t
netmgt_send_error(error)
Netmgt_error *error;
DESCRIPTION
netmgt_send_error sends an error report to the rendezvous, indicating that an error occurred while handling a request. Two kinds of errors can be sent: generic errors, defined in include file netmgt_errno.h, and errors specific to the agent, defined in the agent schema agentErrors record.
Agent-specific errors can be warnings or fatal errors. Generic errors are always fatal.
INPUT ARGUMENTS
error
pointer to a structure with the following fields:
service_error
generic error code from Netmgt_stat, listed in the include file netmgt_errno.h. Non-generic (agentspecific) errors should use NETMGT_WARNING or NETMGT_FATAL and list the agent error code in the agent_error parameter.
NETMGT_WARNING indicates an agent-specific nonfatal error. The agent will continue to process the request.
NETMGT_FATAL indicates an agent-specific fatal error. The agent will terminate the request.
agent_error
agent-specific error code corresponding to the agentErrors record in the agent schema. For generic errors, set this field to zero.
message
optional, null-terminated string containing additional information about the error. Use this field for information that cannot be included in the agent schema, such as the device name involved in the error.
RETURN VALUE
TRUE if successful, otherwise FALSE.
DIAGNOSTICS
If FALSE is returned, global variable netmgt_error indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3n).
FILES
netmgt_errno.h
SEE ALSO
netmgt_fetch_error(3n)