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

Writing CPI-C Applications

CPI-C Call Summary

Chapter 2 71

Set_Log_Data (cmsld)

This call speciﬁes a log message (log data) and its length to be sent to the

partner LU. This call only has an effect in basic conversations. If present,

log data is sent when the Send_Error call is issued or when the

conversation is abnormally deallocated. After the log data is sent CPI-C

resets the log data to null and the log data length to 0 (zero).

Send_Error (cmserr)

This call notiﬁes the partner program that the local program has

encountered an application-level error. The local program can use the

Send_Error call for such purposes as informing the partner program of

an error encountered in received data, rejecting a conﬁrmation request,

or truncating an incomplete logical record it is sending.

Issuing Calls in Nonblocking Mode

This section does not apply to Java CPI-C. Java CPI-C functions always

operate in blocking mode; that is, the function does not return control to

the application until the requested processing has completed. The

functions described in this section are not available in Java CPI-C.

The following calls enable the program to specify that subsequent CPI-C

calls can operate in nonblocking mode, to check whether a previous

nonblocking call has completed, or to wait for a nonblocking call to

complete.

For details on using nonblocking mode, see “HP-UX Considerations”and

“Windows Considerations”. (See also “Cancel_Conversation (cmcanc)”;

this cancels a previous nonblocking call and also deallocates the

conversation.)

Set_Processing_Mode (cmspm)

This call sets the conversation's processing mode to blocking (calls do not

return until processing has completed) or nonblocking (calls can return

immediately even though processing is not yet complete).

Check_For_Completion (cmchck)

For Unix This call checkswhether there is an outstanding nonblocking function on

any of the program's conversations for which processing has completed.

If there is such a function, it returns the conversation ID of the