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

CPI-C Calls
Set_Log_Data (cmsld)
Chapter 3 265
Set_Log_Data (cmsld)
The Set_Log_Data call specifies a log message (log data) and its length to
be sent to the partner LU. This call is allowed only in basic
conversations. It overrides the default log data, which is null, and the
default log data length, which is 0 (zero).
Function Call
void cmsld (
unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR log_data,
CM_INT32 CM_PTR log_data_length,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmsld (
byte[] conversation_ID,
byte[] log_data,
CPICLength log_data_length,
CPICReturnCode return_code
);
Supplied Parameters
The supplied parameters are:
conversation_ID This is the identifier for the conversation. The value of
this parameter is returned by the
Initialize_Conversation, Initialize_For_Incoming, or
Accept_Conversation call.
log_data Address of data buffer containing error information.
This data is sent to the local error log and to the
partner LU.
This parameter is used by the Send_Error call if
log_data_length is greater than 0 (zero).