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

CPI-C Calls
Set_Mode_Name (cmsmn)
Chapter 3 269
• Numerals 0–9
The value of mode_name must match the name of a
mode associated with the partner LU during
configuration.
For a mapped conversation, the mode name
SNASVCMG is reserved for SNA internal use; the
Allocate call will fail if you use this name. You are
recommended not to use SNASVCMG in a basic
conversation, or CPSVCMG (another SNA reserved
name) in either type of conversation.
mode_name_length This parameter specifies the length of the mode
name.
The range for this value is 0–8 bytes.
If mode_name_length is set to 0 (zero), the
Set_Mode_Name call is ignored.
Returned Parameters
After the verb executes, SNAplus2 returns the following parameters:
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 is not valid
• The value specified by
mode_name_length is out of
range (greater than 8 or less than
0).
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.”