HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
DEFINE_USERID_PASSWORD
Chapter 3404
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.
Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following
parameters:
primary_rc AP_OK
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.