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

CPI-C Calls
Receive (cmrcv)
Chapter 3 199
— One logical record transmitted in a basic conversation with the
conversation's fill characteristic set to CM_FILL_LL
— A buffer of data received independent of its logical record format
in a basic conversation with the fill characteristic set to
CM_FILL_BUFFER
Once a complete unit of data has been received, the local program
can manipulate it.
• The local program determines the next action to be taken based on
the control information received through the status_received
parameter. The local program may need to issue the Receive call
again to receive the control information.
The conversation type is set by the Set_Conversation_Type call; the fill
characteristic is set by the Set_Fill call.
Function Call
void cmrcv (
unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR buffer,
CM_INT32 CM_PTR requested_length,
CM_DATA_RECEIVED_TYPE CM_PTR data_received,
CM_INT32 CM_PTR received_length,
CM_STATUS_RECEIVED CM_PTR status_received,
CM_INT32 CM_PTR request_to_send_received,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmrcv (
byte[] conversation_ID,
byte[] buffer,
CPICLength requested_length,
CPICDataReceivedType data_received,
CPICLength received_length,
CPICStatusReceived status_received,
CPICControlInformationReceived request_to_send_received,
CPICReturnCode return_code
);