HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE_AND_POST and RECEIVE_AND_POST
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_INVALID_CALLBACK_HANDLE
The callback parameter was set to a null pointer, and the verb was issued using the synchronous entry
point (or using the asynchronous entry point with a null pointer to a callback routine). For more
information, see Section 4.10.9, Usage Notes.
AP_RCV_AND_POST_BAD_FILL
This return code applies only to the basic-conversation RECEIVE_AND_POST verb. The fill parameter
was set to a value that was not valid.
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
Possible values are:
AP_RCV_AND_POST_BAD_STATE
The conversation was not in Receive, Send, or Send_Pending state when the TP issued this verb.
AP_RCV_AND_POST_NOT_LL_BDY
This return code applies only to the basic-conversation RECEIVE_AND_POST verb. The conversation
was in Send state; the TP began but did not finish sending a logical record.
Verb Canceled
This return code cannot be returned as the initial return code, but only as the subsequent return code if the initial
return code is
AP_OK.
If the verb did not execute because it was canceled by another verb issued by the TP, APPC returns the following
parameter:
primary_rc
AP_CANCELLED
The local TP issued one of the following verbs while in Pending_Post state:
• DEALLOCATE with dealloc_type set to AP_ABEND_PROG, AP_ABEND_SVC,or
AP_ABEND_TIMER
• MC_DEALLOCATE with dealloc_type set to AP_ABEND
• [MC_]SEND_ERROR
• TP_ENDED
Issuing one of these verbs while in Pending_Post state causes the [MC_]RECEIVE_AND_POST verb to
be canceled. The callback routine is not called. The local TP is no longer receiving data asynchronously
from the partner TP.
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:
primary_rc
AP_ALLOCATION_ERROR
168