HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_CONVERSATION
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 available 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 your 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 returned overlay may increase in future releases of SNAplus2; using
the returned overlay size ensures that your application will continue to work with future releases.
conv_summary.conv_id
Conversation identifier. The conversation ID was returned by the ALLOCATE verb in the invoking TP, or by
the RECEIVE_ALLOCATE verb in the invoked TP.
conv_summary.local_tp_name
The name of the local TP in the conversation.
conv_summary.partner_tp_name
The name of the partner TP in the conversation. This parameter is returned only if the conversation was
started by the local TP; it is reserved if the conversation was started by the remote TP.
conv_summary.tp_id
The TP identifier of the conversation.
conv_summary.session_id
The session identifier of the session allocated to the conversation.
conv_summary.conv_start_time
The elapsed time in hundredths of seconds between the time when the SNAplus2 node was started and the
time when the conversation was started.
conv_summary.bytes_sent
The number of bytes that have been sent from the local TP to the partner TP since the start of the conversation.
conv_summary.bytes_received
The number of bytes that have been received from the partner TP by the local TP since the start of the
conversation.
conv_summary.conv_state
The current state of the conversation. Values:
AP_CONFIRM_STATE
AP_CONFIRM_DEALL_STATE
AP_CONFIRM_SEND_STATE
368