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

CPI-C Calls
Set_Conversation_Security_Password (cmscsp)
Chapter 3 233
security_password This specifies the password required to access the
partner program. This parameter is a character string
of 1–10 characters(HP-UX systems), or 1–8 characters
(Windows systems), and is case-sensitive. It must
match the password for the user ID configured for the
partner program.
The following characters are allowed:
• Uppercase and lowercase letters
• Numerals 0–9
• Special characters $, #, @, and . (period)
security_password_length This specifies the length of
security_password .
The range for this value is 1–10 characters (HP-UX
systems), or 1–8 characters (Windows systems). If the
security_password_length is set to 0 (zero), the
security_password parameter is ignored; this is
equivalent to setting security_password 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_password_length is
out of range
CM_PROGRAM_STATE_CHECK One of the following has
occurred:
• The conversation is not in
Initialize state