Initial Conversation Characteristics

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