HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_REQUEST_TO_SEND and REQUEST_TO_SEND
Conversation Deallocated
If the partner TP has deallocated the conversation, APPC returns the following value:
primary_rc
AP_CONVERSATION_ENDED
This verb was issued as a non-blocking verb and was queued behind an earlier verb. The partner TP
issued the [MC_]DEALLOCATE verb as for
AP_DEALLOC_NORMAL
above, and the first verb in the
queue returned with
primary_rc set to
AP_DEALLOC_NORMAL, indicating the end of the conversation.
Any subsequent verbs in the queue then return with primary_rc set to
AP_CONVERSATION_ENDED
,
indicating that the conversation had already ended before the verb could be processed.
Parameter Check
If the verb does not execute because of a parameter error, APPC returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_BAD_CONV_ID
The value of conv_id did not match a conversation identifier assigned by APPC.
AP_BAD_TP_ID
The value of tp_id did not match a TP identifier assigned by APPC.
UNIX
AP_INVALID_FORMAT
The reserved field format was set to a nonzero value.
AP_SYNC_NOT_ALLOWED
The application issued this verb within a callback routine, using the synchronous APPC entry point.
Any verb issued from a callback routine must use the asynchronous entry point.
AP_R_TO_S_INVALID_FOR_FDX
The local TP attempted to use the [MC_]REQUEST_TO_SEND verb in a full-duplex conversation.
This verb can be used only in a half-duplex conversation.
State Check
If the conversation is in the wrong state when the TP issues this verb, APPC returns the following parameters:
primary_rc
AP_STATE_CHECK
secondary_rc
AP_R_T_S_BAD_STATE
The conversation was not in an allowed state when the TP issued this verb.
Other Conditions
If the verb does not execute because other conditions exist, APPC returns primary return codes (and, if applicable,
secondary return codes). For information about these return codes, see Appendix B, Common Return Codes.
Possible return codes are:
204