SYNOPSIS

int MGOinssubscription (Subscription *sub)

DESCRIPTION

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

• sub.uwnetid (r)
• sub.subscription_code (r)
• sub.subscription_data (o)
• sub.permit (o)
• sub.permit_by (o)
• sub.permit_source (o)
• sub.permit_exp (o)
• sub.deny (o)
• sub.deny_by (o)
• sub.deny_source (o)
• sub.deny_exp (o)
• sub.notify_code (o)
• sub.notify_date (o)
• sub.status_code (o)

sub.uwnetid is the uwnetid name. sub.subscription_code is the subscription reference code. sub.subscription_data is the subscription data. sub.permit is a boolean indicating whether the subscription is permitted. sub.permit_by is the validation id of the entity who authorized this permission. sub.permit_source is the validation source reference code. If you enable the permit boolean, you must also specify the permit_by and permit_source fields. sub.permit_exp is the expiration date of this subscription in YYYY-MM-DD form. The same applies to the sub.deny* fields. Note that a deny overrides any permits. sub.notify_code indicates whether the uwnetid has been notified that the subscription is to expire. sub.notify_date is the date of expiration. sub.status_code is the subscription status reference code.

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

MGOdelsubscription(), MGOselrsubscription(), MGOselsubscription(), MGOselrsubstatus(), MGOupdsubscription(), MGOzero()