Initial Conversation Characteristics
Common Programming Interface for Communications (CPI-C) maintains a set of internal values called characteristics for each conversation. Some characteristics affect the overall operation of the conversation, such as the conversation type. Others affect the behavior of specific calls, such as the receive type.
Many of these characteristics are initially derived from the side information table (see Side Information for CPI-C Programs) in memory. Initialize_Conversation specifies the symbolic destination name (sym_dest_name) associated with the wanted side information table entry.
The following table lists the initial values of the conversation characteristics and tells which call can change a given value.
| Characteristic | Initial value set by Initialize_Conversation | Initial value set by Accept_Conversation | Can be changed by |
|---|---|---|---|
| Conversation state | CM_INITIALIZE_STATE | CM_RECEIVE_STATE | Depends on call |
| Conversation type | CM_MAPPED_ CONVERSATION | The value specified by the invoking program. | Set_Conversation_Type |
| Deallocate type | CM_DEALLOCATE_ SYNC_LEVEL | CM_DEALLOCATE_ SYNC_LEVEL | Set_Deallocate_Type |
| Error direction | CM_RECEIVE_ERROR | CM_RECEIVE_ ERROR | Set_Error_Direction |
| Fill | CM_FILL_LL | CM_FILL_LL | Set_Fill |
| Log data | Null | Null | Set_Log_Data |
| Log data length | 0 | 0 | Set_Log_Data |
| Mode name | The mode name contained in the side information. If no sym_dest_name is specified, this is a null string. | The mode name for the session on which the conversation startup request arrived. | Set_Mode_Name |
| Mode name length | Length of mode name. If no sym_dest_name is specified, this is zero. | Length of mode name. | Set_Mode_Name |
| Partner LU name | The partner logical unit (LU) name contained in the side information. If no sym_dest_name is specified, this is a single blank. | The partner LU name for the session on which the conversation startup request arrived. | Set_Partner_LU_Name |
| Partner LU name length | Length of partner LU name. If no sym_dest_name is specified, this is 1. | Length of partner LU name. | Set_Partner_LU_Name |
| Partner program name | The program name contained in the side information. If no sym_dest_name is specified, this is a single blank. | Not applicable. | Set_TP_Name |
| Partner program name length | Length of partner program name. If no sym_dest_name is specified, this is 1. | Not applicable. | Set_TP_Name |
| Password | The password contained in the side information. If no sym_dest_name is specified, this is a single blank. | The value specified by the invoking program. | Set_Conversation_Security_Password |
| Password length | Length of password. If no sym_dest_name is specified, this is 1. | Length of password. | Set_Conversation_Security_Password |
| Prepare-to-receive type | CM_PREP_TO_ RECEIVE_SYNC_ LEVEL | CM_PREP_TO_ RECEIVE_SYNC_ LEVEL | Set_Prepare_To_Receive_Type |
| Receive type | CM_RECEIVE_AND_ WAIT | CM_RECEIVE_AND_ WAIT | Set_Receive_Type |
| Return control | CM_WHEN_SESSION_ ALLOCATED | Not applicable. | Set_Return_Control |
| Security type | The security type contained in the side information. | The value specified by the invoking program. | Set_Conversation_Security_Type |
| Send type | CM_BUFFER_DATA | CM_BUFFER_DATA | Set_Send_Type |
| Synchronization level | CM_NONE | The value specified by the invoking program. | Set_Sync_Level |
| User identifier | The user identifier contained in the side information. If no sym_dest_name is specified, this is a single blank. | The value specified by the invoking program. | Set_Conversation_Security_User_ID |
| User identifier length | Length of user identifier. If no sym_dest_name is specified, this is 1. | Length of user identifier. | Set_Conversation_Security_User_ID |