Set_Conversation_Type

The Set_Conversation_Type call (function name cmsct) is issued by the invoking program to define a conversation as being mapped or basic. This call overrides the default conversation type established by Initialize_Conversation. The default conversation type is CM_MAPPED_CONVERSATION. This call cannot be issued after Allocate has been issued.

CM_ENTRY Set_Conversation_Type(
  unsigned char FAR *conversation_ID,  
  CM_INT32 FAR *conversation_type,  
  CM_INT32 FAR *return_code         
);
 

Parameters

conversation_ID

Supplied parameter. Specifies the identifier for the conversation. The value of this parameter was returned by Initialize_Conversation.

conversation_type

Supplied parameter. Specifies the type of conversation to be allocated by Allocate. Possible values are:

CM_BASIC_CONVERSATION

CM_MAPPED_CONVERSATION

return_code

The code returned from this call. The valid return codes are listed below.

Return Codes

cm_ok

Primary return code; the call executed successfully.

cm_program_state_check

Primary return code; the conversation is not in INITIALIZE state.

cm_program_parameter_check

Primary return code; one of the following occurred:

• The value specified by conversation_ID or conversation_type is invalid.
• The conversation_type parameter specifies a mapped conversation, but the fill characteristic is set to CM_FILL_BUFFER, which is incompatible with mapped conversations. Before changing the conversation type to mapped, you must issue the Set_Fill call to change the fill type to CM_FILL_LL.
• The conversation_type parameter specifies a mapped conversation. However, a previous Set_Log_Data call, allowed only in basic conversations, is still in effect.

cm_product_specific_error

Primary return code; a product-specific error occurred and has been logged in the product's error log.

State Changes

The conversation must be in INITIALIZE state.

There is no state change.