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

CPI-C Calls
Send_Error (cmserr)
Chapter 3222
Send_Error (cmserr)
The Send_Error call notifies the partner program that the local program
has encountered an application-level error. The local program can use
the Send_Error for such purposes as informing the partner program of
an error encountered in received data, rejecting a confirmation request,
or truncating an incomplete logical record it is sending.
The Send_Error call flushes the local LU's send buffer and sends the
partner program the contents of the send buffer followed by the error
notification.
The error notification is sent to the partner as one of the following
return_code values:
• CM_PROGRAM_ERROR_TRUNC
• CM_PROGRAM_ERROR_NO_TRUNC
• CM_PROGRAM_ERROR_PURGING
Upon successful execution of this call, the conversation is in Send state
for the local program and in Receive state for the partner program.
Function Call
void cmserr (
unsigned char CM_PTR conversation_ID,
CM_Request_to_Send_Received CM_PTR request_to_send_received,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmserr (
byte[] conversation_ID,
CPICControlInformationReceived request_to_send_received,
CPICReturnCode return_code
);
Supplied Parameters
The supplied parameter is: