SYNOPSIS

int MGOselsubscription (Subscription **lst, Subscription *sub)

DESCRIPTION

The MGOselsubscription() function selects subscription records. Information is passed through sub and returned through the linked list lst. The selection criteria fields are:

• sub.uwnetid
• sub.subscription_code

sub.uwnetid is the uwnetid name. sub.subscription_code is the subscription reference code. The following fields are set for each selected subscription:

• lst.next
• lst.subscription_name
• lst.subscription_code
• lst.subscription_data
• lst.permit
• lst.permit_by
• lst.permit_source
• lst.permit_exp
• lst.deny
• lst.deny_by
• lst.deny_source
• lst.deny_exp
• lst.notify_code
• lst.notify_date
• lst.status_name
• lst.status_code

RETURN VALUE

Returns the number of records selected 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

rmango

SEE ALSO

MGOdelsubscription(), MGOfreesubscription(), MGOinssubscription(), MGOselrsubscription(), MGOupdsubscription(), MGOzero()