netmgt_request_set2 manual page
Table of Contents

NAME

netmgt_request_set2- send a set request to an agent

SYNOPSIS

struct timeval *
netmgt_request_set2(agent_host, agent_prog, agent_vers, rendez_host, rendez_prog, rendez_vers, timeout, flags)
char
*agent_host;
u_long
agent_prog;
u_long
agent_vers;
char
*rendez_host;
u_long
rendez_prog;
u_long
rendez_vers; struct timeval timeout;
u_int
flags;

DESCRIPTION

netmgt_request_set2 sends a request to an agent to set the values of one or more group or table attributes. The caller must have previously called netmgt_set_instance(3n) to define the system containing the attributes. In addition, the caller must have previously called netmgt_set_value(3n) to specify the values to set the attributes. If any agentspecific options are to be set, the caller must have previously called netmgt_set_argument(3n).

The request is sent to the agent process on agent_host with RPC program number agent_prog and RPC version number agent_vers. The agent will report the results of the set operation to the rendezvous process on rendez_host with RPC program number rendez_prog and RPC version number rendez_vers.

INPUT ARGUMENTS

agent_host
host where the agent runs.

agent_prog
agent's RPC program number.

agent_vers
agent's RPC version number.

rendez_host
host where the rendezvous runs.

rendez_prog
rendezvous' RPC program number.

rendez_vers
rendezvous' RPC version number.

timeout
maximum time to wait for confirmation from the agent before the call fails.

flags
request option flags. One flag is currently defined:

NETMGT_RESTART
Restart the request if the agent abnormally terminates and is restarted. Otherwise, when the agent restarts, this request is forgotten. This flag is advisory; request restart is not guaranteed. The restart is not attempted until the agent parent is started (asked to start another request, or asked what requests it is working on), when all requests marked for restart will be restarted, if possible.

RETURN VALUE

timestamp of the request, if successful. Otherwise NULL. The caller must run as a callback RPC server to receive a report indicating whether the agent succeeded in performing the set request.

NOTES

netmgt_request_set2 performs the same function as netmgt_request_set. netmgt_request_set2 returns a request timestamp like netmgt_request_data or netmgt_request_event instead of a Boolean value.

DIAGNOSTICS

If NULL 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_set_value(3n),
netmgt_set_argument(3n),
netmgt_set_instance(3n), netmgt_request_set(3n)


Table of Contents