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

CPI-C Calls
Check_For_Completion (cmchck)
Chapter 3132
Check_For_Completion (cmchck)
For Unix This function is not available in Java CPI-C.
The Check_For_Completion call checks whether a previous call that
returned with CM_OPERATION_INCOMPLETE has since completed. This call
returns immediately whether or not the previous call has completed; the
application can then continue with other processing if the previous call
has not yet completed, or call Wait_For_Conversation to obtain the
results of the previous call if it has completed.
If the application is involved in multiple conversations, this call acts
across all conversations, and returns a “successful” return code if a
previous call has completed on any of them.
This call is not part of the standard CPI-C specification, and may not be
available in other implementations. The standard method for obtaining
the results of an outstanding call is to issue Wait_For_Conversation,
which operates in blocking mode and waits until a call has completed.
Function Call
void cmchck (
unsigned char CM_PTR
conversation_ID,
CM_RETURN_CODE CM_PTR return_code
);
Supplied Parameters
There are no supplied parameters for this call.
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 The identifier for the conversation on which a
previous outstanding call has completed. For more
information, see “Usage Notes”.