HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_CONVERSATION
Chapter 4 555
Identifier of the conversation for which information is
required, or the conversation ID to be used as an index
into the list of conversations. The conversation ID was
returned by the ALLOCATE verb in the invoking TP, or
by the RECEIVE_ALLOCATE verb in the invoked TP.
This parameter is ignored if list_options is set to
AP_FIRST_IN_LIST.
session_id
8-byte identifier of the session. To list only information
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: