Command Reference Guide

Administration Commands
query_conversation
bytes_received decimal
conv_state constant
If the command executes successfully, SNAplus2 returns the following parameters:
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.
local_tp_name
The name of the local TP in the conversation.
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.
tp_id
The TP identifier of the conversation.
sess_id
The session identifier of the session allocated to the conversation.
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.
bytes_sent
The number of bytes that have been sent from the local TP to the partner TP since the start of the conversation.
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_state
The current state of the conversation. Values:
• CONFIRM
• CONFIRM_DEALL
• CONFIRM_SEND
• END_CONV
• PEND_DEALL
• PEND_POST
• POST_ON_RECEIPT
• RECEIVE
• RESET
• SEND
• SEND_PENDING
2.110.3 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.
321