HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_RECEIVE and RECEIVE Verbs
4.8.8 State Change
State changes, summarized in the following table, are based on the value of the primary_rc parameter.
primary_rc
New state
AP_OK
Receive
AP_PARAMETER_CHECK
AP_STATE_CHECK
AP_CONVERSATION_TYPE_MIXED
AP_INVALID_VERB
AP_INVALID_VERB_SEGMENT
AP_STACK_TOO_SMALL
AP_TP_BUSY
AP_UNEXPECTED_DOS_ERROR
No change
AP_ALLOCATION_ERROR
Reset
AP_CONV_FAILURE_RETRY
AP_CONV_FAILURE_NO_RETRY
Reset
AP_DEALLOC_ABEND_RESET
AP_DEALLOC_ABEND_PROG
AP_DEALLOC_ABEND_SVC
AP_DEALLOC_ABEND_TIMER
Reset
AP_PROG_ERROR_PURGING_RECEIVE
AP_SVC_ERROR_PURGING
Receive
4.8.9 Usage Note
The conversation does not change to Send or Send_Pending state for the partner TP until the partner TP receives
one of the following values through the what_rcvd parameter of a subsequent receive verb:
•
AP_SEND, AP_DATA_SEND
, AP_DATA_COMPLETE_SEND
•
AP_CONFIRM_SEND, AP_DATA_CONFIRM_SEND
,orAP_DATA_COMPLETE_CONFIRM_SEND
(and replies with
[MC_]CONFIRMED)
The RECEIVE verbs are [MC_]RECEIVE_AND_WAIT, [MC_]RECEIVE_IMMEDIATE, and
[MC_]RECEIVE_AND_POST.
4.9 MC_RECEIVE and RECEIVE Verbs
APPC provides three different verbs which are used to receive data from the partner TP. Most of the parameters
and return codes are the same for all three verbs, but each operates in a different way and provides a different
function. Common information which applies to all three verbs are explained together in this section; each verb is
then explained in detail.
The three RECEIVE verbs are:
• [MC_]RECEIVE_IMMEDIATE
• [MC_]RECEIVE_AND_WAIT
• [MC_]RECEIVE_AND_POST
157