SYNOPSIS

int MGOadduwnetid (Uwnetid *uwn, Validation *val, int opts);

DESCRIPTION

The MGOadduwnetid() function adds a uwnetid and sets up the appropriate affiliations. Validation information is passed through val. The uwnetid and associated information is passed through uwn. The required and optional fields are (the values in brackets indicate which validation tables the field is defined for):

• val.validid (r)
• val.ein (r) [1]
• val.ssn (r)
• val.studentid (r) [1, 2, 7]
• val.account (r) [4]
• val.system_key (r) [2]
• val.clinicianid (r) [3]
• val.advanceid (r) [7]
• val.regid (r)
• val.lname (o)
• val.pac (o)
• val.birthdate (o)
• val.source_code (o)

• uwn.uwnetid (r)
• uwn.uid (o)
• uwn.luid (o)
• uwn.account (o)

val.validid is the validation id. val.ein is the employee number. val.ssn is the social security number. val.studentid is the student number. val.account is the AVF account name. val.system_key is the student system key value. val.clinicianid is the clinician id. val.advanceid is the advance id. val.regid is the registry id. You must specify one (or more) of: validid, ein, ssn, studentid, account, system_key, clinicianid, advanceid, regid. val.lname is the last name. val.pac is the private access code. If specified and the pac is marked as one-time, the pac will expire automatically in two hours. val.birthdate is the birthdate in YYYY-MM-DD form. val.source_code is the validation source reference code. uwn.uwnetid is the uwnetid name. If a "*" is placed at the end of the name, a unique uwnetid consisting of the name (plus the next number in sequence beginning with 1 if the name is already taken) will be generated. If a high uid is wanted, then the uwn.uid field should be set. Specify a positive value, or 0 to have one chosen at random. The same applies for a low uid (uwn.luid). uwn.account is the account name. It typically is set to the encrypted employee number, student number, or some other unique value. opts can be one or more of:

• 0 - Default behavior
• 1 - Do not permanently add uwnetid (same as MGOwantuwnetid())
• 2 - Force completion (overrides MGO_E_VAU error)
• 4 - Test operation only

Note: Upon successful return, the uwn.uwnetid and uwn.uid fields will be set their resultant values.

RETURN VALUE

Returns 1 upon success or -1 if an error occurred (in which case MGOerrno and MGOerrmsg are set appropriately).

ERRORS

• MGO_E_MAR - One or more of the required arguments were missing
• MGO_E_IAR - Invalid or ambiguous argument
• MGO_E_PMD - Permission denied. See access control
• MGO_E_VAL - No such validation source reference code
• MGO_E_VNV - The given validation information is not valid
• MGO_E_VAU - The validation id is already affiliated with another uwnetid
• MGO_E_UIU - Uwnetid is already in use
• MGO_E_ICU - Invalid character found in uwnetid
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

MGOgetvalidations(), MGOselrvalsource(), MGOwantuwnetid(), MGOzero()