HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_USERID_PASSWORD
Some CPI-C implementations have a maximum user ID length of 8 characters. If you specify a user ID of 9
or 10 characters, CPI-C applications running on other systems may not be able to access applications on the
SNAplus2 system using this user ID and password.
password_chars.description
A null-terminated text string (0–31 characters followed by a null character) describing the user ID and
password. This string is for information only; it is stored in the node’s configuration file and returned on the
QUERY_USERID_PASSWORD verb, but SNAplus2 does not make any other use of it.
password_chars.profile_count
Number of profiles. This parameter is normally set to zero; see
password_chars.profiles below for more
information.
password_chars.password
User’s password. This is a 10-byte type-AE EBCDIC character string, padded on the right with EBCDIC
spaces.
Some CPI-C implementations have a maximum password length of 8 characters. If you specify a password
of 9 or 10 characters, CPI-C applications running on other systems may not be able to access applications on
the SNAplus2 system using this user ID and password.
Whatever value the application supplies for this parameter is immediately replaced by the encrypted version
of the password. Therefore, the value supplied for the password_chars.password parameter is never written
out.
password_chars.profiles
Profile names associated with the user ID and password. Each of these is a 10-byte type-AE EBCDIC
character string, padded on the right with EBCDIC spaces.
If a remote TP uses this user ID and password to contact the local TP, and specifies a profile on the Attach,
this must match one of the profile names defined here. Check with the remote System Administrator to
determine if a profile will be used; for each profile that will be used, specify the profile name as one of the
profiles parameters on this verb. In most cases, profile names are not used, and so there is no need to specify
them on this verb; set password_chars.profile_count to zero and do not specify any profiles.
3.49.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.49.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_PASSWORD
The password parameter contained a character that was not valid.
AP_INVALID_PROFILE
One or more of the specified profiles was not valid.
270