HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_KERNEL_MEMORY_LIMIT
3.123.6 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.124 QUERY_KERNEL_MEMORY_LIMIT
This verb returns information about the amount of kernel memory that SNAplus2 is currently using, the maximum
amount it has used, and the configured limit. This allows you to check memory usage and set the limit appropriately,
to ensure that sufficient memory is available for SNAplus2 components and for other programs on the HP-UX
computer.
You can specify the kernel memory limit when starting the SNAplus2 software (for more information,
see the HP-UX SNAplus2 Administration Guide), or modify it later when the node is running (using the
SET_KERNEL_MEMORY_LIMIT verb).
3.124.1 VCB Structure
typedef struct query_kernel_memory_limit
{
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 limit; /* kernel memory limit, 0 => no limit */
AP_UINT32 actual; /* current amount of memory allocated */
AP_UINT32 max_used; /* maximum amount of memory allocated */
unsigned char reset_max_used; /* set max_used = actual */
unsigned char reserv3[8]; /* Reserved */
} QUERY_KERNEL_MEMORY_LIMIT;
3.124.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_KERNEL_MEMORY_LIMIT
reset_max_used
Specify whether SNAplus2 should reset the max_used value (after returning it on this verb) to match the amount
of memory currently allocated. This ensures that a subsequent QUERY_KERNEL_MEMORY_LIMIT verb
will return the maximum amount used since this verb, rather than the maximum amount used since the system
was started (or since the max_used value was last reset). Possible values are:
AP_YES
Reset the max_used value to match the current memory allocation.
AP_NO
Do not reset the max_used value.
470