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

CPI-C Calls
Receive (cmrcv)
Chapter 3202
received data was truncated, the
length of the data will be less than
requested_length .)
Upon receiving this value, the local
program normally reissues the
Receive call to receive the next partof
the record.
CM_NO_DATA_RECEIVED The program did not receive
data.
NOTE If the return_code parameter is set to CM_OK, status
information may be available through the
status_received parameter.
received_length This indicates the number of bytes of data the local
program received on this Receive call. If the
return_code or data_received parameter indicates
that the program received no data, this value is not
relevant.
status_received This parameter indicates changes in the status of the
conversation. These codes are not relevant unless
return_code is set to CM_OK. Possible values are:
CM_NO_STATUS_RECEIVED No conversation status
change was received on this call.
CM_SEND_RECEIVED For the partner program, the
conversation has entered Receive
state. For the local program, the
conversation is now in Send state if
no data was received on this call, or
Send-Pending state if data was
received on this call.
Upon receiving this value, the local
program normally uses the
Send_Data call to begin sending data.