SYNOPSIS

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

DESCRIPTION

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

• sub.source_code
• sub.subscription_code
• sub.category_code
• sub.status_code

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. Any of the fields can be specified alone or in any combination to select multiple records. The following fields are set for each selected default subscription:

• lst.next
• lst.source_name
• lst.source_code
• lst.subscription_name
• lst.subscription_code
• lst.category_code
• lst.status_code
• lst.permit
• lst.deny
• lst.subscription_data

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

none

SEE ALSO

MGOdeldsubscription(), MGOfreesubscription(), MGOinsdsubscription(), MGOselrcategory(), MGOselrsubscription(), MGOselrvalsource(), MGOselrvalstatus(), MGOupddsubscription(), MGOzero()