SYNOPSIS

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

DESCRIPTION

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

• sub.subscription_code
• sub.attribute_code

sub.subscription is the subscription reference code. sub.attribute is the subscription attribute reference code. Either field may be selected or both. The following fields are set for each selected subscription attribute:

• lst.next
• lst.subscription_code
• lst.subscription_name
• lst.attribute_code
• lst.attribute_name
• lst.attribute_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

MGOdelrsubattrval(), MGOfreecode(), MGOinsrsubattrval(), MGOselrsubattr(), MGOselrsubscription(), MGOupdrsubattrval(), MGOzero()