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

CPI-C Calls
Set_Conversation_Security_User_ID (cmscsu)
Chapter 3 241
The following characters are allowed:
Uppercase and lowercase letters
Numerals 09
Special characters $, #, @, and . (period)
security_user_ID_length
This specifies the length of
security_user_ID
. This range for this value is 1–10
characters (HP-UX systems), or 1–8 characters
(Windows systems). If the length is 0 (zero), the
security_user_ID
parameter is ignored; this is
equivalent to setting
security_user_ID
to a null
string.
Returned Parameters
After the verb executes, SNAplus2 returns the following parameters:
return_code
Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK One of the following
has occurred:
The value specified by
conversation_ID
is not valid.
The value specified by
security_user_ID_length
is
out of range.
CM_PROGRAM_STATE_CHECK One of the following has
occurred:
The conversation is not in
Initialize state.
The conversation's security type
is set to CM_SECURITY_NONE.
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.