HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
Set_Conversation_Type (cmsct)
Chapter 3 245
Returned Parameters
After the verb executes, SNAplus2 returns parameters to indicate
whether the execution was successful and, if not, to indicate the reason
the execution was unsuccessful.
return_code Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_STATE_CHECK The conversation is not in
Initialize state.
CM_PROGRAM_PARAMETER_CHECK One of the following
has occurred:
• The value specified by
conversation_ID or
conversation_type is not valid.
• 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 For an explanation of
this return code, see Appendix A,
“Common Return Codes.”
State When Issued
The conversation must be in Initialize state.