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

CPI-C Calls
Allocate (cmallc)
Chapter 3 127
Supplied Parameters
The supplied parameter is:
conversation_ID This is the conversation identifier. The value of this
parameter is returned by the Initialize_Conversation
call.
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_PARAMETER_ERROR One of the following has
occurred:
• The mode name derived from the
side information or set by
Set_Mode_Name is not valid.
• The mode name is one of the
names reserved for SNA internal
use (such as SNASVCMG); an
application cannot use it.
CM_PROGRAM_PARAMETER_CHECK The value specified by
conversation_ID is not valid.
CM_PROGRAM_STATE_CHECK The conversation is not in
Initialize state.
CM_UNSUCCESSFUL The conversation's return-control
characteristicis setto CM_IMMEDIATE,
and the local LU does not have an
available contention winner session.
For an explanation of the following return codes, see
Appendix A, “Common Return Codes.”
CM_ALLOCATE_FAILURE_NO_RETRY
CM_ALLOCATE_FAILURE_RETRY
CM_OPERATION_INCOMPLETE
CM_OPERATION_NOT_ACCEPTED