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

CPI-C Calls
Set_Return_Control (cmsrc)
Chapter 3282
Set_Return_Control (cmsrc)
The Set_Return_Control call is issued by the invoking program to specify
whether the Allocate call returns immediately if a session is not
available, or waits for a session to be allocated.
This call overrides the default return control established by the
Initialize_Conversation call. By default, CPI-C waits for the session to be
allocated. This call cannot be issued after the Allocate call has been
issued.
For further information about sessions, see Chapter 2, “Writing CPI-C
Applications.”
Function Call
void cmsrc (
unsigned char CM_PTR conversation_ID,
CM_RETURN_CONTROL CM_PTR return_control,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmsrc (
byte[] conversation_ID,
CPICReturnControl return_control,
CPICReturnCode return_code
);
Supplied Parameters
The supplied parameters are:
conversation_ID This is the identifier for the conversation. The value of
this parameter is returned by the
Initialize_Conversation call.
return_control This parameter specifies when the local LU, acting on
the Allocate call, should return control to the local
program. The following are allowed values: