High Availability Monitors Version A.03.02 Release Notes
NOF API Verbs (QUERY Verbs)
QUERY_CONVERSATION
Chapter 4 543
about conversations associated with a specific session,
specify the session identifier. To obtain a complete list
for all sessions, set this field to binary zeros.
Returned Parameters: Successful Execution
If the verb executes successfull, SNAplus2 returns the following
parameters:
primary_rc
AP_OK
buf_size
Length of the information returned in the supplied
buffer.
total_buf_size
REturned value indicating the size of buffer that would
have been required to return all the list information
requested. A value greater than buf_size indicates that
not all the available entries were returned.
num_entries
Number of entries returned in the data buffer.
total_num_entries
Total number of entries available. A value greater than
num_entries indicates that not all the vailable entries
were returned.
Each entry in the data buffer consists of the following
parameters:
conv_summary.overlay_size
The size of the returned conv_summary structure, and
therefore the offset to the start of the next entry in the
data buffer.
When you r application needs to go through the
returned buffer to find each conv_summary structure
in turn, it must use this value to move to the correct
offset for the next data structure, and must not use the
C sizeof () operator. This is because the size of the