The query_buffer_availability command returns information about the amount of STREAMS
buffer space that SNAplus2 is currently using, the maximum amount
it has used, and the maximum amount available (specified using the set_buffer_availability command). This information enables you to check STREAMS
buffer usage and set the limit appropriately to ensure that sufficient
buffer space is available for SNAplus2 components and for other
programs on the HP-UX computer. The command also returns additional
internal values related to buffer usage for use by SNAplus2 support
personnel.
Supplied Parameters |
 |
Parameter name Type Length Default
[query_buffer_availability]
reset_max_values constant NO
|
Supplied parameter is:
- reset_max_values
Specify whether SNAplus2 should reset the max_* values (after returning them on this command) to match
the current values of these parameters. This ensures that a subsequent query_buffer_availability command will return the maximum values reached since
this command was issued, rather than the maximum values reached
since the system was started (or since the max_* values were last reset). Possible values are:
- YES
Reset the max_* values to match the current values.
- NO
Do not reset the max_* values.
Returned Parameters |
|
Parameter name Type
buf_avail decimal
buf_total_count decimal
buf_total_bytes decimal
max_buf_total_count decimal
max_buf_total_bytes decimal
|
This command returns additional values other than those listed
here; the additional values are for use by SNAplus2 support personnel.
If the command executes successfully, SNAplus2 returns the
following parameters:
- buf_avail
The maximum amount of STREAMS buffer space available
to SNAplus2, in bytes, as defined by a set_buffer_availability command.
- buf_total_count
The total number of buffers currently allocated
to SNAplus2 components.
- buf_total_bytes
The total amount of buffer storage, in bytes, currently allocated
to SNAplus2 components.
- max_buf_total_count
The maximum number of buffers that have been allocated
to SNAplus2 components at any one time.
- max_buf_total_bytes
The maximum amount of buffer storage that has been allocated
to SNAplus2 components at any one time.
Error Return Codes |
|
If the command cannot be executed, SNAplus2 returns a primary
return code to indicate the type of error and a secondary return
code to provide specific details about the reason for unsuccessful
execution.
No parameter errors occur for this command.
Printable version
