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

CPI-C Calls

Send_Data (cmsend)

Chapter 3 217

Send_Data (cmsend)

The Send_Data call puts data in the local LU's send buffer for

transmission to the partner program.

The data collected in the local LU's send buffer is transmitted to the

partner LU (and partner program) when one of the following occurs:

• The send buffer ﬁlls up.

• The local program issues a Flush, Conﬁrm, orDeallocate call or other

call that ﬂushes the LU's send buffer. (Some send types, set by the

Set_Send_Type call, include ﬂush functionality.)

The data to be sent can be either of the following:

• A complete data record on a mapped conversation. A complete data

record is a string of the length speciﬁed by the

send_length

parameter.

• A complete logical record, or part of a logical record, on a basic

conversation. The length of a complete logical record is determined

by the LL value. (One logical record can end and a new one begin in

the middle of the string of data to be sent.)

Function Call

void cmsend (

unsigned char CM_PTR conversation_ID,

unsigned char CM_PTR buffer,

CM_INT32 CM_PTR send_length,

CM_Request_to_Send_Received CM_PTR request_to_send_received,

CM_RETURN_CODE CM_PTR return_code

);

Function Call for Java CPI-C

public native void cmsend (

byte[] conversation_ID,

byte[] buffer,

CPICLength buffer_length,

CPICControlInformationReceived request_to_send_received,

CPICReturnCode return_code

);