SYNOPSIS

int MGOinsdsubscription (Subscription *sub)

DESCRIPTION

The MGOinsdsubscription() function inserts a new default subscription record. Information is passed through sub. The required and optional fields are:

• sub.source_code (r)
• sub.subscription_code (r)
• sub.category_code (r)
• sub.status_code (o)
• sub.permit (o)
• sub.deny (o)
• sub.subscription_data (o)

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.

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_EXI - Record already exists
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

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