SYNOPSIS

int MGOupddsubscription (Subscription *sub)

DESCRIPTION

The MGOupddsubscription() function updates an existing default subscription record. Information is passed through sub. The required fields are:

• sub.source_code
• sub.subscription_code
• sub.category_code
• sub.status_code
• sub.permit
• sub.deny
• sub.subscription_data

sub.source_code is the validation source reference code. sub.subscription_code is the subscription reference code. sub.category_code is the category reference code. sub.status_code is the validation status reference code. sub.permit is a boolean indicating whether the subscription is permitted by default. sub.deny is a boolean indicating whether the subscription is denied by default. A deny overrides a permit. You should specify one of these two. sub.subscription_data is the subscription data. You can only change the permit, deny and subscription_data fields. To change the other fields, you have to 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_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

MGOdeldsubscription(), MGOinsdsubscription(), MGOseldsubscription(), MGOselrcategory(), MGOselrsubscription(), MGOselrvalsource(), MGOselrvalstatus(), MGOzero()