SYNOPSIS

int MGOupdvalidation (Validation *val)

DESCRIPTION

The MGOupdvalidation() function updates an existing validation record. Information is passed through val. The basic required fields are:

• val.validid
• val.source_code

val.validid is the validation id. val.source_code is the validation source reference code. The extended required fields depend on val.source_code. The values in brackets indicate a required field for the indicated validation source.

• val.new_validid
• val.prior_ein [1]
• val.ssn
• val.studentid [1, 2, 7]
• val.lname
• val.fname
• val.sec_lname [7]
• val.sec_fname [7]
• val.pac
• val.birthdate
• val.college [1, 2, 4]
• val.department [1, 2, 4]
• val.unit [1]
• val.hepps_type [1]
• val.budget [1]
• val.faccode [1]
• val.mailstop [1]
• val.sdb_class [2]
• val.branch [2]
• val.techfee [2]
• val.expiration [4]
• val.sdb_status [2]
• val.employee_status [2]
• val.comment_code [4]
• val.alumni_member [7]
• val.alumni_type [7]
• val.category_code
• val.verify1 [4]
• val.verify1_code [4]
• val.verify2 [4]
• val.verify2_code [4]
• val.notify_code
• val.notify_date
• val.status_code

val.prior_ein is the prior employee number. val.ssn is the social security number. val.studentid is the student number. val.system_key is the student system key value. val.lname and val.fname are the last and first (plus middle) names respectively. val.sec_lname and val.sec_fname are the secondary last and first (plus middle) names respectively. val.pac is the private access code. If specified as "*", a 6-digit pac will be automatically generated. val.birthdate is the birthdate in YYYY-MM-DD form. val.college is the college code. val.department is the department code. val.unit is the HEPPS unit code. val.hepps_type is the HEPPS type code. val.budget is the HEPPS budget code. val.faccode is the HEPPS faculty code. val.mailstop is the HEPPS mailstop code. val.sdb_class is the ASUW class code. val.branch is the ASUW branch code. val.techfee flags whether the tech fee has been paid. val.expiration is the AVF expiration date in YYYY-MM-DD form. val.sdb_status is the ASUW status code. val.employee_status is the HEPPS employee status code. val.comment_code is the comment reference code. val.alumni_member is the alumni member indicator code. val.alumni_type is the alumni type code. val.category_code is the category reference code. val.verify1 is the first verification field. val.verify1_code is the first verification reference code. val.verify2 is the second verification field. val.verify2_code is the second verification reference code. val.notify_code indicates whether the validid has been notified that the validation is to expire. val.notify_date is the date of expiration. val.status_code is the validation status reference code. You can only change the extended fields. To change either basic field, you must insert a new record.

RETURN VALUE

Returns the number of records updated 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_MAT - No matches found
• MGO_E_VAL - No such validation source reference code
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

MGOdelvalidation(), MGOinsvalidation(), MGOselvalidation(), MGOselrcategory(), MGOselrcomment(), MGOselrvalsource(), MGOselrvalstatus(), MGOselrverify(), MGOzero()