HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_USERID_PASSWORD
3.48.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.49 DEFINE_USERID_PASSWORD
DEFINE_USERID_PASSWORD defines a user ID / password pair for use with APPC and CPI-C conversation
security, or adds profiles for a defined user ID and password.
3.49.1 VCB Structure
typedef struct define_userid_password
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
AP_UINT16 define_type; /* what the define type is */
unsigned char user_id[10]; /* user id */
unsigned char reserv3[8]; /* reserved */
USERID_PASSWORD_CHARS password_chars; /* password characteristics */
} DEFINE_USERID_PASSWORD;
typedef struct userid_password_chars
{
unsigned char description[32]; /* resource description */
unsigned char reserv2[16]; /* reserved */
AP_UINT16 profile_count; /* number of profiles */
AP_UINT16 reserv1; /* reserved */
unsigned char password[10]; /* password */
unsigned char profiles[10][10]; /* profiles */
} USERID_PASSWORD_CHARS;
3.49.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_USERID_PASSWORD
define_type
Specifies how this verb is being used. Possible values are:
AP_ADD_USER
Add a new user, or change the password for an existing user.
AP_ADD_PROFILES
Add to the profiles for an existing user.
user_id
User identifier. This is a 10-byte type-AE EBCDIC character string, padded on the right with EBCDIC spaces.
269