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

Writing CPI-C Applications

CPI-C Call Summary

Chapter 274

Test_Request_to_Send_Received (cmtrts)

This call determines whether a request-to-send notiﬁcation has been

received from the partner program.

Ending a Conversation

The following calls end a conversation.

Set_Deallocate_Type (cmsdt)

This call speciﬁes how the conversation is to be deallocated. The

deallocation instructions speciﬁed by this call take effect when the

Deallocate call is issued or when the send type is set to

CM_SEND_AND_DEALLOCATE and the Send_Data call is issued.

Deallocate (cmdeal)

This call deallocates a conversation between two programs. Before

deallocating the conversation, this call performs the equivalent of the

Flush or Conﬁrm call, depending on the current conversation

synchronization level and deallocate type.

Cancel_Conversation (cmcanc)

This call cancels any incomplete call on a conversation, and deallocates

the conversation. (An incomplete call is one that was issued in

nonblocking mode and returned CM_OPERATION_INCOMPLETE.)

In Java CPI-C, nonblocking calls are not supported and so there cannot

be an incomplete call outstanding. Cancel_Conversation is equivalent to

Deallocate except that it does not write log data to the local error log.

Extract_Mode_Name (cmemn) Mode name

Extract_Partner_LU_Name (cmepln) Partner LU name

Extract_TP_Name (cmetpn) TP name that was speciﬁed on the

incoming Allocate request

Extract_Sync_Level (cmesl) Synchronization level

Table 2-2 Extract_* Calls and Actions (Continued)

Call Retrieves