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

CPI-C Calls
Set_Receive_Type (cmsrt)
Chapter 3 281
CM_RECEIVE_AND_WAIT The local program receives any
data that is currently available from
the partner program. If no data is
currently available,the local program
waits for data to arrive.
CM_RECEIVE_IMMEDIATE The local program receives
any data currently available from the
partner program. If no data is
available, the local program does not
wait.
Returned Parameters
After the verb executes, SNAplus2 returns parameters to indicate
whether the execution was successful and, if not, to indicate the reason
the execution was unsuccessful.
return_code Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK The value specified by
conversation_ID or receive_type
is not valid.
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.”
State When Issued
The conversation can be in any state except Reset.
State Change
There is no state change.
Usage Notes
If the return_code is not CM_OK, the receive_type conversation
characteristic is unchanged.