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

Writing CPI-C Applications
CPI-C Call Summary
Chapter 2 69
Set_Prepare_To_Receive_Type (cmsptr)
This call sets the conversation's prepare-to-receive type, which specifies
whether subsequent Prepare_To_Receive calls will include Flush or
Confirm functionality. The prepare-to-receive type affects all subsequent
Prepare_To_Receive calls. It can be changed by issuing the
Set_Prepare_To_Receive_Type call again.
Prepare_To_Receive (cmptr)
This call changes the state of the conversation for the local program from
Send to Receive, making it possible for the local program to begin
receiving data. Before changing the conversation state, this call performs
the equivalent of the Flush or Confirm call.
Set_Receive_Type (cmsrt)
This call sets the conversation's receive type, which specifies whether a
program issuing a Receive call will wait for data to arrive if data is not
available. The receive type value affects all subsequent Receive calls. It
can be changed by issuing the Set_Receive_Type call again.
Receive (cmrcv)
Issuing this call while the conversation is in Receive state causes the
local program to receive any data that is currently available from the
partner program. If no data is available and the receive type is set to
CM_RECEIVE_AND_WAIT, the local program waits for data to arrive. If
the receive type is set to CM_RECEIVE_IMMEDIATE, the program does
not wait.
Issuing this call while the conversation is in Send or Send-Pending state
is allowed only if the receive type is set to CM_RECEIVE_AND_WAIT.
This flushes the LU's send buffer and changes the conversation state to
Receive. The local program then begins to receive data.
Set_Fill (cmsf)
This call sets the conversation's fill type, which specifies whether
programs will receive data in the form of logical records or as a specified
length of data. It only has an effect in basic conversations. The fill value
affects all subsequent Receive calls. It can be changed by issuing the
Set_Fill call again.