2.26. gc_SetBilling( )

When using DM3 boards, the gc_SetBilling( ) function is not supported.

When using Springware boards, the gc_SetBilling( ) function sets different billing rates for "900" number calls on a per call basis for networks providing the AT&T Vari-A-Bill service. In synchronous mode, this function must be used after the successful completion of either a gc_MakeCall( ) or gc_AnswerCall( ) function.

Note: The gc_SetBilling( ) function is used exclusively for the AT&T Vari-A-Bill service.

For ISDN applications, the rate_type parameter for the gc_SetBilling( ) function can have the following values:

• ISDN_NEW_RATE - change to a different per-minute rate
• ISDN_FLAT_RATE - change to flat charge
• ISDN_FREE_CALL - no charges call
• ISDN_PREM_CHAR - add additional charge to call
• ISDN_PREM_CREDIT - subtract charge from call

The current data structure for the ratep block (GC_RATE_U) is defined for AT&T only. For a description of the data structure, see the Global Call API Software Reference.

Both asynchronous (including extended asynchronous mode for Windows applications) and synchronous modes are supported. If the mode parameter is set to EV_ASYNC, completion of the function is indicated by the GCEV_SETBILLING termination event.

ISDN cause values for the gc_SetBilling( ) function are listed in Table 12. These cause values apply only to AT&T's Vari-A-Bill service.

Table 12. Cause Values, gc_SetBilling Function

Cause	Description
ISDN_FB_UNAVAIL	Flexible billing feature is not available.
ISDN_FB_BAD_OPER	Invalid operation.
ISDN_FB_BAD_ARG	Invalid argument.
ISDN_FB_RET_ERR	Return error component value.
ISDN_FB_IE_ERR	Invalid information element.
ISDN_NO_FB_INF	No flexible billing information.

Cautions

• This function is available only on the AT&T network and only for the PRI 4ESS protocol.
• The gc_SetBilling( ) function may not function in all service-provider environments. Check whether retrieving billing information is an option with your service provider.

Click here to contact Telecom Support Resources