SYNOPSIS

int MGOselextcategory (Validation **lst, Validation *cat)

DESCRIPTION

The MGOselextcategory() function selects extended category records. Information is passed through cat and returned through the linked list lst. The selection criteria fields are:

• cat.validid
• cat.category_code
• cat.source_code
• cat.status_code

cat.validid is the validation id. cat.category_code is the category reference code. cat.source_code is the validation source reference code. val.status_code is the validation status reference code. If category_code is omitted, all extended category code records are returned. The following fields are set for each selected validation:

• lst.next
• lst.source_name
• lst.source_code
• lst.category_name
• lst.category_code
• lst.status_code
• lst.expiration

RETURN VALUE

Returns the number of records inserted 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_VNV - The given validation information is not valid
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

rmango

SEE ALSO

MGOdelextcategory(), MGOfreevalidation(), MGOinsextcategory(), MGOselrvalstatus(), MGOzero()