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

CPI-C Calls

Prepare_To_Receive (cmptr)

Chapter 3 195

Function Call for Java CPI-C

public native void cmptr (

byte[] conversation_ID,

CPICReturnCode return_code

);

Supplied Parameters

The supplied parameter is:

conversation_ID

This is the identiﬁer for the conversation. The value of

this parameter is returned by the

Initialize_Conversation, Initialize_For_Incoming, or

Accept_Conversation 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.

return_code

Possible values are:

CM_OK The call executed successfully.

CM_PROGRAM_PARAMETER_CHECK The value speciﬁed by

conversation_ID

is not valid.

CM_PROGRAM_STATE_CHECK One of the following has

occurred:

• The conversation state is not

Send or Send-Pending

• The basic conversation is in Send

state. However, the program did

not ﬁnish sending a logical record

For an explanation of the following return codes, see

Appendix A, “Common Return Codes.”

CM_OPERATION_INCOMPLETE

CM_OPERATION_NOT_ACCEPTED

CM_PRODUCT_SPECIFIC_ERROR