SYNOPSIS
int MGOshowsubscription (char **out, char *uwn, int sub, char *dat)
DESCRIPTION
The MGOshowsubscription() function shows the status of the
given uwnetid uwn and subscription reference code sub.
A particular subscription may require a helper process, which is invoked as
required. All text from the helper process is returned through out.
If the helper process needs additional information, pass it through dat,
using the following format:
MGO_DAT_xxx1=(yyy1) [MGO_DAT_xxx2=(yyy2) ...]
These will be set as environmental values for the helper process.
Note: The "MGO_DAT_" prefix is required syntax. The following values
are passed to the helper process by default:
- MGO_ACTION=0 - The action code value
- MGO_ADMINISTRATOR=[1 or 0] - Whether the client is an administrator-type
- MGO_SUBSCRIPTION=sub - The subscription code value
- MGO_UWNETID=uwn - The uwnetid to act upon
RETURN VALUE
Returns the subscription status reference code 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_NOS - Not subscribed to subscription
- MGO_E_SNP - Subscription is not permitted for uwnetid
- MGO_E_ISE - Internal server error
- MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details
AUTHENTICATION LEVEL
rmango
SEE ALSO
MGOfreechar(),
MGOselrsubscription(),
MGOselrsubstatus(),
MGOsetsubscription(),
MGOzero()