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

CPI-C Calls
Receive (cmrcv)
Chapter 3200
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.
requested_length This indicates the maximum number of bytes of data
the local program is to receive.
The range for this value is 0–32,767.
buffer This is the address of the buffer to contain the data
received by the local program.
Returned Parameters
After the verb executes, SNAplus2 returns the following parameters:
buffer The application's data buffer contains data if the
following conditions are true:
• The data_received parameter is set to a value
other than CM_NO_DATA_RECEIVED
• The return_code parameter is set to CM_OK or to
CM_DEALLOCATED_NORMAL
data_received This parameter indicates whether the program
received data. The following are possible values. These
codes are not relevant unless return_code is set to
CM_OK or CM_DEALLOCATED_NORMAL.
CM_DATA_RECEIVED can be returned if the
conversation's fill characteristic is set to
CM_FILL_BUFFER, indicating that the program is
receiving data independent of its logical format. The
local program received data until requested_length
or end of data was reached.
The end of the data is indicated by either of the
following: