HP-UX SNAplus2 R7 APPC Programmer's Guide

Appendix CAPPC State Changes
Notes
1. In the Return codes column of the table, the abbreviation AP_ERROR
is used for:
AP_BACKED_OUT
AP_PROG_ERROR_TRUNC
AP_PROG_ERROR_NO_TRUNC
AP_PROG_ERROR_PURGING
AP_SVC_ERROR_TRUNC
AP_SVC_ERROR_NO_TRUNC
AP_SVC_ERROR_PURGING
2. The conversation always enters Reset state if one of the following return codes is
received.
AP_ALLOCATION_ERROR
AP_COMM_SUBSYSTEM_ABENDED
AP_COMM_SUBSYSTEM_NOT_LOADED
AP_CONV_FAILURE_RETRY
AP_CONV_FAILURE_NO_RETRY
AP_DEALLOC_ABEND
AP_DEALLOC_ABEND_PROG
AP_DEALLOC_ABEND_SVC
AP_DEALLOC_ABEND_TIMER
AP_DEALLOC_NORMAL
3. The following non-OK return codes do not cause any state change. The conversation
always remains in the state in which the verb was issued.
AP_CONVERSATION_TYPE_MIXED
AP_INVALID_VERB
AP_PARAMETER_CHECK
AP_STATE_CHECK
AP_TP_BUSY
AP_UNEXPECTED_SYSTEM_ERROR
AP_UNSUCCESSFUL
4. After [MC_]RECEIVE_AND_POST has been issued and has received the initial
primary_rc of
AP_OK, the conversation changes to Pending_Post state. Once the
supplied callback routine has been called, to indicate that the verb has completed,
the new conversation state depends on the primary_rc and what_rcvd parameters as in
Note 5.On Win16 systems, the same comments apply to [MC_]RECEIVE_AND_WAIT
issued to the asynchronous entry point.
5. The state change after one of the RECEIVE verbs depends on both the primary_rc and
what_rcvd parameters.
If the primary_rc parameter is
AP_PROG_ERROR, AP_SVC_ERROR,or
([MC_]RECEIVE_IMMEDIATE only)
AP_UNSUCCESSFUL, the new state is
Receive.
If the primary_rc parameter is
AP_DEALLOC, the new state is Reset.
If the primary_rc parameter is
AP_OK, the new state depends on the value of the
what_rcvd parameter:
AP_DATA
, AP_DATA_COMPLETE,
AP_DATA_INCOMPLETE
Receive state
AP_SEND
Send state
AP_DATA_SEND, AP_DATA_COMPLETE_SEND
Send Pending state
AP_CONFIRM_WHAT_RCVD, AP_DATA_CONFIRM, AP_DATA_COMPLETE_CONFIRM
Confirm state
AP_CONFIRM_SEND, AP_DATA_CONFIRM_SEND, AP_DATA_COMPLETE_CONFIRM_SEND
Confirm Send state
AP_CONFIRM_DEALLOCATE, AP_DATA_CONFIRM_DEALLOCATE,
AP_DATA_COMPLETE_CONFIRM_DEALL
Confirm Deallocate state
292