Starting a Conversation

The calls in this category are used to start a conversation between two programs.

Accept_Conversation (cmaccp)

Issued by the invoked program to accept the incoming conversation and set certain conversation characteristics. Upon successful execution of this call, CPI-C generates a conversation identifier.

Allocate (cmallc)

Issued by the invoking program to allocate a conversation with the partner program, using the current conversation characteristics. CPI-C can also start a session between the local LU and partner LU if one does not already exist. The type of conversation allocated depends on the conversation type characteristic—mapped or basic.

Initialize_Conversation (cminit)

Issued by the invoking program to obtain a conversation identifier and to set the initial values for the conversation's characteristics. The initial values are derived from side information associated with the symbolic destination name or are CPI-C defaults.

After issuing Initialize_Conversation, the invoking program can issue any of the following Set_ calls to change the initial conversation characteristics. These calls cannot be issued after Allocate has been issued.

Call	Sets
Set_Conversation_Security_Password (cmscsp)	Security password
Set_Conversation_Security_Type (cmscst)	Conversation security type
Set_Conversation_Security_User_ID (cmscsu)	Security user identifier
Set_Conversation_Type (cmsct)	Conversation type
Set_Mode_Name (cmsmn)	Mode name
Set_Partner_LU_Name (cmspln)	Partner LU name
Set_Return_Control (cmsrc)	Return control
Set_Sync_Level (cmssl)	Synchronization level
Set_TP_Name (cmstpn)	Program name