HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_BUFFER_AVAILABILITY
Text strings describing UDP events
AP_BCK_TCP_TEXT
Text strings describing TCP events
AP_BCK_TEXT
Text strings describing other events
AP_BCK_MS_TRACE
Tracing on TRANSFER_MS_DATA verbs (passed to the MS library on the server)
3.93.4 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists combinations of primary and secondary return codes that are common to
all NOF verbs.
3.94 QUERY_BUFFER_AVAILABILITY
This verb returns information about the amount of STREAMS buffers that SNAplus2 is currently using, the maximum
amount it has used, and the maximum amount available (specified using the SET_BUFFER_AVAILABILITY verb).
This allows you to check STREAMS buffer usage and set the limit appropriately, to ensure that sufficient buffers
are available for SNAplus2 components and for other programs on the HP-UX computer. The verb also returns
additional internal values relating to buffer usage, for use by SNAplus2 support personnel.
3.94.1 VCB Structure
typedef struct query_buffer_availability
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
AP_UINT32 reset_max_values; /* set stored max values to */
/* current */
AP_UINT32 buf_avail; /* maximum buffer space */
/* available */
AP_UINT32 buf_total_count; /* current buffer usage - count */
AP_UINT32 buf_total_bytes; /* current buffer usage - bytes */
AP_UINT32 buf_rsrv_count; /* buffers reserved - count */
AP_UINT32 buf_rsrv_bytes[2]; /* buffers reserved - bytes */
AP_UINT32 buf_res_use_count; /* usage of reserved buffers */
/* - count */
AP_UINT32 buf_res_use_bytes; /* usage of reserved buffers */
/* - bytes */
AP_UINT32 peak_usage; /* peak usage */
AP_UINT32 peak_decay; /* peak decay */
unsigned char throttle_status; /* throttle status */
unsigned char buf_use_status; /* congestion status */
AP_UINT32 max_buf_total_count; /* maximum buffer usage - count */
AP_UINT32 max_buf_total_bytes; /* maximum buffer usage - bytes */
AP_UINT32 max_buf_rsrv_count; /* max buffers reserved - count */
AP_UINT32 max_buf_rsrv_bytes[2]; /* max buffers reserved - bytes */
AP_UINT32 max_buf_res_use_count; /* max rsrv buffer usage - count */
353