netmgt_register_rendez manual page
Table of Contents

NAME

netmgt_register_rendez - register with the event dispatcher

SYNOPSIS

bool_t
netmgt_register_rendez(event_host, rendez_host, rendez_prog, rendez_vers, agent_prog, priority, timeout)
char
*event_host;
char
*rendez_host;
u_long
rendez_prog;
u_long
rendez_vers;
u_long
agent_prog;
u_int
priority; struct timeval timeout;

DESCRIPTION

netmgt_register_rendez instructs the event dispatcher on event_host to start sending event reports with priority priority and higher from agents with RPC program number agent_prog to the rendezvous with RPC program number rendez_prog and RPC version number rendez_vers on rendez_host.

INPUT ARGUMENTS

event_host
name of the system where the event dispatcher is running.

rendez_host
name of the system where the rendezvous is running.

rendez_prog
RPC program number of the rendezvous.

rendez_vers
RPC version number of the rendezvous.

agent_prog
RPC program number of the agent of interest. If agent_prog is NETMGT_ANY_AGENT, event reports from all agents will be sent. If agent_prog is NETMGT_DBMGR_PROG, only trap reports that indicate the addition, modification, or deletion of elements in the runtime database will be sent.

event_priority
lowest priority of event reports the rendezvous process wants to receive. priority can be one of three values: NETMGT_LOW_PRIORITY, NETMGT_MEDIUM_PRIORITY or NETMGT_HIGH_PRIORITY.

timeout

maximum time to wait for confirmation from the event dispatcher.

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).

SEE ALSO

netmgt_fetch_error(3n),
netmgt_unregister_rendez(3n), na.event(8)

NOTES

The caller must call netmgt_unregister_rendez(3n) before it exits or when it is no longer interested in getting event reports. Otherwise, a copy of the event dispatcher will continue to run.


Table of Contents