SYNOPSIS

int MGOunjoinvalidation (Validation *val, int opt)

DESCRIPTION

The MGOunjoinvalidation() function unjoins (breaks off) an individual validation record from a joined set. The associated identifiers (uwnetid, regid, etc.) can either follow the unjoined record or stay with the remainder of the joined set. Either the unjoined record or the joined set will be issued a new regid. The unjoined validation will be treated as a different "person" for any subsequent relationships. Information is passed through val. The required fields are:

• val.validid
• val.source_code

val.validid is the unjoin validation id. val.source_code is the unjoin validation source reference code. opt can be one of:

• 0 - Associated identifiers stay with remainder of joined set
• 1 - Associated identifiers follow unjoined record

Note: After completion, it will no longer be possible to query either the unjoined record (opt=0) or the joined set (opt=1) by the set's former regid.

RETURN VALUE

Returns 1 if the unjoin 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_VNJ - Validation record is not joined to any set
• MGO_E_MAT - No matches found
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

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