SYNOPSIS

int MGOjoinvalidation (Validation *val1, Validation *val2)

DESCRIPTION

The MGOjoinvalidation() function joins two existing validation records from different (or the same) validation sources. The joined validations will be treated as the same "person" for any subsequent relationships. Information is passed through val1 and val2. The required fields are:

• val1.validid
• val1.source_code
• val2.validid
• val2.source_code

val1.validid is the "from" validation id. val1.source_code is the "from" validation source reference code. val2.validid is the "to" validation id. val2.source_code is the "to" validation source reference code. val1 will be joined to val2.

Note: In the case of same-source joins, the "from" record will replace the "to" record. The "to" record will be dropped from the database.

RETURN VALUE

Returns 1 if the join succeeded 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_VAJ - Validation records are already joined
• MGO_E_MAT - No matches found
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

MGOdelvalidation(), MGOinsvalidation(), MGOselvalidation(), MGOselrvalsource(), MGOunjoinvalidation(), MGOupdvalidation(), MGOzero()