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

Writing CPI-C Applications
CPI-C Call Summary
Chapter 268
If the send type (specified by the Set_Send_Type call) includes the
function of the Flush, Confirm, Prepare_To_Receive, or Deallocate call,
the data is transmitted to the partner LU (and partner program)
immediately. Otherwise, the data accumulates in the local LU's send
buffer, and is sent when one of the following occurs:
• The send buffer fills up
• The local program issues one of the following calls, which flush the
LU's send buffer:
— Flush
— Confirm
— Deallocate
— Prepare_To_Receive
— Receive (with the receive type set to CM_RECEIVE_AND_WAIT)
Flush (cmflus)
This call sends the contents of the local LU's send buffer to the partner
LU (and program). If the send buffer is empty, no action takes place.
Confirm (cmcfm)
This call sends the contents of the local LU's send buffer and a
confirmation request to the partner program and waits for confirmation.
Request_To_Send (cmrts)
This call notifies the partner program that the local program wants to
send data. The partner program can respond to this request by changing
to Receive state so that the local program changes to Send state, or can
ignore the request.
Receiving Data
The following calls enable a program to receive data from its partner
program.