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

CPI-C Calls
Wait_For_Conversation (cmwait)
Chapter 3302
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.
conversation_ID This is the identifierfor the conversation on which the
outstanding call completed.
conversation_return_code This is the return code from the completed
call (which previously returned
CM_OPERATION_INCOMPLETE). The possible values for
this parameter depend on which call was outstanding.
For more information, see the description of the specific
call.
This value is not relevant if the return_code
parameter contains a value other than CM_OK.
return_code Possible values are:
CM_OK The Wait_For_Conversation call
executed successfully. The
conversation_return_code
parameter indicates whether the
previous incomplete operation
completed successfully.
CM_PROGRAM_STATE_CHECK There was no incomplete
operation outstanding.
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.”
For Windows CM_SYSTEM_EVENT The call was terminated by an
operating system event, rather than
by the completion of a previous CPI-C
call.
End of Section State When Issued
The call is not associated with a specific conversation, so the
conversation state is not relevant. However, the application must have at
least one conversation with an incomplete operation outstanding.