NAME

netmgt_save_request, netmgt_restore_request - save and restore current request state

SYNOPSIS

bool_t

netmgt_save_request (request_info)
        Netmgt_request * request_info;
bool_t
netmgt_restore_request (request_info)
        Netmgt_request * request_info;

DESCRIPTION

netmgt_save_request copies information about the current request state into the buffer pointed to by 'request_info'.

netmgt_restore_request sets the current request state from the contents of the buffer pointed to by 'request_info'.

typedef struct

{

struct in_addr manager_addr ;

/* manager IP address * /

struct timeval request_time ;

/* request timestamp * /

u_int type ;

/* request type * /

u_int manager_id ;

/* manager ID * /

u_int flags ;

/* request flags * /

u_int priority ;

/* request priority * /

struct in_addr rendez_addr ;

/* rendezvous IP address * /

u_long rendez_prog ;

/* rendezvous RPC program number * /

u_long rendez_vers ;

/* rendezvous RPC version number * /

u_long proto;

/* transport protocol * /

struct timeval interval ;

/* reporting interval * /

u_int count ;

/* reporting count * /

char system [NETMGT_NAMESIZ] ;

/* system * /

char group [NETMGT_NAMESIZ] ;

/* group * /

char key [NETMGT_NAMESIZ] ;

/* key * /

u_int num_arguments ;

/* number of optional arguments * /

u_int num_thresholds ;

/* number of event thresholds

or data attributes * /

u_int num_setvals ;

/* number of set arguments * /

}

Netmgt_request ;

The members of this structure are:

manager_addr

IP address of manager that sent the request

request_time

Time when the manager sent the request

type

Request type. See netmgt_arglist.h

manager_id

ID of the manager that sent the request

flags

Request flags. See netmgt_msg.h and netmgt_request.h

priority

Request priority (currently unused)

rendez_addr

IP address of report rendezvous

rendez_prog

RPC program number of report rendezvous

rendez_vers

RPC version number of report rendezvous

proto

Transport protocol used to send the request (either IPPROTO_UDP or IPPROTO_TCP)

interval

Report interval

count

Report count

system Target system name

group

Schema group if a data or event request

key

Table key if a data or event request for tabular group

num_arguments

Number of optional arguments

num_thresholds

Number of thresholds if an event request or number of attributes in case of a data request

num_setvals

Number of set arguments if a set request

RETURN VALUE

TRUE if successful, otherwise FALSE.

DIAGNOSTICS

If false is returned, global variable netmgt_errno indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3N).

FILES

netmgt_arglist.h, netmgt_msg.h, netmgt_request.h

SEE ALSO

netmgt_fetch_error(3N), netmgt_save_argument(3N), netmgt_save_threshold(3N)

NOTES

Only agents may call this function.