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.