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

CPI-C Calls
Initialize_Conversation (cminit)
Chapter 3190
The parameter is an 8-byte ASCII character string and
can contain anydisplayablecharacters.Thisparameter
can also be set to eight spaces. In this case, the
invoking program must issue the following calls before
issuing the Allocate call:
• Set_Mode_Name
• Set_Partner_LU_Name
• Set_TP_Name
For more details about the side information entry, see
Appendix A, “Common Return Codes.”
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.
conversation_ID This is the identifier for the conversation. It is used by
subsequent CPI-C calls.
return_code Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK One of the following
occurred:
• The value specified by
sym_dest_name does not match a
symbolic destination name
defined in the configuration fileor
one specified by the program
using
Set_CPIC_Side_Information.
• The conversation_ID parameter
is not valid.
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.”