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

CPI-C Calls
Send_Error (cmserr)
Chapter 3 227
Usage Notes
The following sections describe additional usage information for the
Send_Error call.
Sending Log Data
In basic conversations, the local program can use the Set_Log_Data call
to specify error log data to be sent to the partner LU. If the basic
conversation's log data length characteristic is greater than 0 (zero), the
LU formats the data and stores it in the send buffer.
After the Send_Error call is completed, the log data length is set to 0
(zero) and the log data to null.
Purged Data
If the conversation is in Receive state or Pending-Post state when the
program issues the Send_Error call, incoming data is purged by CPI-C.
This data includes the following:
• Data sent by the Send_Data call
• Confirmation requests
• Deallocation requests if the conversation's deallocate type is set to
CM_DEALLOCATE_CONFIRM or to
CM_DEALLOCATE_SYNC_LEVEL with the synchronization level
set to CM_CONFIRM
CPI-C does not purge an incoming request-to-send indicator.
CM_PROGRAM_ERROR_PURGING
CM_SVC_ERROR_PURGING
Receive
All others No change
Table 3-13 State Changes for the Send_Error Call (Continued)
return_code New state