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) in memory. Initialize_Conversation specifies the symbolic destination name (sym_dest_name) associated with the desired 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 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 |