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

CPI-C Calls
Receive (cmrcv)
Chapter 3206
State When Issued
The conversation can be in Receive, Send, or Send-Pending state.
If receive_type is set to CM_RECEIVE_IMMEDIATE, the conversation
must be in Receive state.
For Windows If the application successfully issues the Receive call in nonblocking
mode, the conversation changes state twice. On the initial return of the
call, the conversation changes to Pending-Post state. After CPI-C returns
the results of the call processing, the conversation state change is as
described below.
End of Section Issuing the Call in Send or Send-Pending State
Issuing the Receive call while the conversation is in Send or
Send-Pending state causes the local LU to send the information in its
send buffer and a send indicator to the partner program. Based on
data_received and status_received parameters, the conversation
may change to Receive state for the local program. For more information,
see “State Change”.
State Change
The new conversation state is determined by the following factors:
• The state the conversation is in when the program issues the call
• The return_code parameter
• The data_received and status_received parameters