HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
Prepare_To_Receive (cmptr)
Chapter 3196
The following return codes can occur if the
conversation's prepare-to-receive type is set to
CM_PREP_TO_RECEIVE_CONFIRM or if the
prepare-to-receive type is set to
CM_PREP_TO_RECEIVE_SYNC_LEVEL, and the
conversation's synchronization level is set to
CM_CONFIRM. For an explanation of them, see
Appendix A, “Common Return Codes.”.
CM_CONVERSATION_TYPE_MISMATCH
CM_DEALLOCATED_ABEND
CM_DEALLOCATED_ABEND_SVC
CM_DEALLOCATED_ABEND_TIMER
CM_PIP_NOT_SPECIFIED_CORRECTLY
CM_PROGRAM_ERROR_PURGING
CM_RESOURCE_FAILURE_NO_RETRY
CM_RESOURCE_FAILURE_RETRY
CM_SECURITY_NOT_VALID
CM_SVC_ERROR_PURGING
CM_SYNC_LVL_NOT_SUPPORTED_PGM
CM_SYNC_LVL_NOT_SUPPORTED_LU
CM_TPN_NOT_RECOGNIZED
CM_TP_NOT_AVAILABLE_NO_RETRY
CM_TP_NOT_AVAILABLE_RETRY
State When Issued
The conversation can be in Send or Send-Pending state.
State Change
State changes, summarized in Table 3-6, State Changes for the
Prepare_To_Receive Call,, are based on the value of the return_code
parameter.
Table 3-6 State Changes for the Prepare_To_Receive Call
return_code New state
CM_OK Receive
CM_PROGRAM_ERROR_PURGING
CM_SVC_ERROR_PURGING
Receive