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

CPI-C Calls

Wait_For_Conversation (cmwait)

Chapter 3 301

Wait_For_Conversation (cmwait)

This function is not available in Java CPI-C. Java CPI-C functions

always operate in blocking mode; that is, the function does not return

control to the application until the requested processing has completed.

The Wait_For_Conversation call waits for completion of aprevious CPI-C

call that returned CM_OPERATION_INCOMPLETE.

If processing for the previous call has already ﬁnished when

Wait_For_Conversation is issued, this call returns immediately;

otherwise it blocks until CPI-C has ﬁnished processing the incomplete

operation. If the application is involved in multiple conversations, this

call waits on all conversations, and returns as soon as a call completes on

any of them.

For Windows New applications written for Windows systems should use

Specify_Windows_Handle to obtain the results of nonblocking calls,

instead of using Wait_For_Conversation. See “Specify_Windows_Handle

(xchwnd)”. The Wait_For_Conversation call is provided for compatibility

with other CPI-C implementations, but is not recommended for use by

Windows applications.

In particular, if the application issues the Receive call in nonblocking

mode and then issues other calls in nonblocking mode on the same

conversation while Receive is outstanding, it must use

Specify_Windows_Handle. It must not issue Wait_For_Conversation

while more than one call is outstanding on the same conversation; the

results of Wait_For_Conversation in this situation are undeﬁned.

End of Section Function Call

void cmwait (

unsigned char CM_PTR conversation_ID,

CM_INT32 CM_PTR conversation_return_code,

CM_RETURN_CODE CM_PTR return_code

);

Supplied Parameters

There are no supplied parameters for this call.