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

CPI-C Calls
Send_Data (cmsend)
Chapter 3218
Supplied Parameters
The supplied parameters are:
conversation_ID This is the identifier for the conversation. The value of
this parameter was returned by the
Initialize_Conversation, Initialize_For_Incoming, or
Accept_Conversation call.
buffer This parameter specifies the address of the buffer
containing the data to be put in the local LU's send
buffer.
send_length This is the number of bytes of data to be put in the local
LU's send buffer.
The range for this value is 0–32,767.
For mapped conversations, if send_length is set to 0,a
null data record is sent to the partner program.
For basic conversations, if send_length is set to 0
(zero), no data is sent. The buffer parameter is ignored.
However, the other parameters are valid.
Returned Parameters
After the verb executes, SNAplus2 returns the following parameters:
request_to_send_received This is the request-to-send-received
indicator. Possible values are:
CM_REQ_TO_SEND_RECEIVED The partner program has
issued the Request_To_Send call,
which requests the local program to
change the conversation to Receive
state.
CM_REQ_TO_SEND_NOT_RECEIVED The partner program
has not issued the Request_To_Send
call.
This value is not relevant if the return_code
parameter is set to CM_PROGRAM_PARAMETER_CHECK or
CM_PROGRAM_STATE_CHECK.
return_code Possible values are: