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

CPI-C Calls
Prepare_To_Receive (cmptr)
Chapter 3194
Prepare_To_Receive (cmptr)
The Prepare_To_Receive call changes the state of the conversation for
the local program from Send to Receive. Before changing the
conversation state, this call performs the equivalent of one of the
following:
• The Flush call, sending the contents of the local LU's send buffer to
the partner LU (and program), if either of the following conditions is
true:
— The conversation's prepare-to-receive type is set to
CM_PREP_TO_RECEIVE_FLUSH
— The prepare-to-receive type is set to
CM_PREP_TO_RECEIVE_SYNC_LEVEL and the
conversation's synchronization level is set to CM_NONE
• The Confirm call, sending the contents of the local LU's send buffer
and a confirmation request to the partner program, if either of the
following conditions is true:
— The conversation's prepare-to-receive type is set to
CM_PREP_TO_RECEIVE_CONFIRM
— 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
The prepare-to-receive type is set by the Set_Prepare_To_Receive_Type
call; the synchronization level is set by the Set_Sync_Level call.
After this call has successfully executed, the local program can receive
data.
Function Call
void cmptr (
unsigned char CM_PTR conversation_ID,
CM_RETURN_CODE CM_PTR return_code
);