Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |