NAME

netmgt_request_set- send a set request to an agent

SYNOPSIS

bool_t

netmgt_request_set(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_set 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 agent-specific 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

TRUE if the agent verified it will attempt to perform the request, otherwise FALSE. The caller must run as a callback RPC server to receive a report indicating whether the agent succeeded in performing the set request.

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_set_value(3N), netmgt_set_argument(3N), netmgt_set_instance(3N)