Starting a Conversation
The calls in this category are used to start a conversation between two programs.
Note
The names of the calls are pseudonyms. The actual C function names appear in parentheses after the pseudonyms. For example, Accept_Conversation is the pseudonym for a call. The actual function name is cmaccp.
Accept_Conversation( cmaccp)
Issued by the invoked program to accept the incoming conversation and set certain conversation characteristics. Upon successful execution of this call, Common Programming Interface for Communications (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 logical unit (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 |