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

CPI-C Calls
Receive (cmrcv)
Chapter 3 201
• A change to another conversation state, based on
the return_code , status_received , and
data_received parameters
• An error condition
If the conversation's receive type is set to
CM_RECEIVE_IMMEDIATE, the data received can be
less than requested_length if a smaller amount of
data has arrived from the partner program.
CM_COMPLETE_DATA_RECEIVED In a mapped
conversation, this parameter
indicates that the local program has
received a complete data record or
the last part of a data record.
In a basic conversation with the fill
characteristic set to CM_FILL_LL,
this value indicates that the local
program has received a complete
logical record or the end of a logical
record.
CM_INCOMPLETE_DATA_RECEIVED In a mapped
conversation, this value indicates
that the local program has received
an incomplete data record, the
requested_length parameter
specified a value less than the length
of the data record (or less than the
remainder of the data record if this is
not the first Receive call to read the
record). The amount of data received
is equal to the requested_length
parameter.
In a basic conversation with the fill
characteristic set to CM_FILL_LL,
this value indicates that the local
program has received an incomplete
logical record. The amount of data
received is equal to the
requested_length parameter. (Ifthe