cc_SetBilling( )

Description | Termination Events | Cautions | Example | Errors | See Also

Name:	int cc_SetBilling(crn, rate_type, ratep, mode)
Inputs:	CRN crn	call reference number
	int rate_type	type of billing data
	CC_RATE_U *ratep	pointer to call charge rate
	unsigned long mode	asynchronous or synchronous
Returns:	0 on success < 0 on failure
Includes:	cclib.h
Category:	Optional call handling
Mode:	asynchronous or synchronous
Technology:	PRI (4ESS only)

Description

The cc_SetBilling( ) function sets the billing rate for AT&T Vari-A-Bill services associated with the particular call reference number, using cents as the unit. In asynchronous mode, the cc_SetBilling( ) function must be used after either CCEV_CONNECTED or CCEV_ANSWERED is received (in call state Connected). In synchronous mode, cc_SetBilling( ) must be used after successful completion of either cc_MakeCall( ) or cc_AnswerCall( ).

NOTE:

This function is specific to users of the AT&T Network's Vari-A-Bill service the AT&T network. Check with the service provider to see if this service can be used.

Parameter	Description
crn:	The call reference number. Each call needs a CRN.
rate_type:	The type of billing data. Possible values are:   ISDN_NEW_RATE - change to different per-minute rate   ISDN_FLAT_RATE - change to flat charge   ISDN_PREM_CHANGE - add additional charge to the call   ISDN_PREM_CREDIT - subtract charge from the call
ratep:	Pointer to the billing rate of the current call. The billing rate information is contained in the CC_RATE_U data structure. For a description of this structure, see Section 6.1. CC_RATE_U.
mode:	Specifies asynchronous (EV_ASYNC) or synchronous (EV_SYNC) mode.

Termination Events

• CCEV_SETBILLING - indicates that the billing information for the call has been acknowledged by the network. This event is returned only when the AT&T Vari-A-Bill feature is used.
• CCEV_TASKFAIL - indicates that a request/message was rejected by the firmware. Typically, this event is triggered by an incorrect function call during the call.

Cautions

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

Example

#include <windows.h>   /* For Windows applications only */  
#include <stdio.h>  
#include <errno.h>  
#include "srllib.h"  
#include "dtilib.h"  
#include "cclib.h"  
void main()  
{  
   LINEDEV   devhdl    = 0;  
   CRN       crn = 0;  
   char     *devname = "dtiB1T1";  
   char      dnis_buf[CC_ADDRSIZE];  
   CC_RATE_U rate;  
   if ( cc_Open(&devhdl, devname, 0) < 0 )   
   {  
        printf("Error opening device: errno = %d\n", errno);  
        exit(1);  
   }  
   printf("Waiting for call\n");  
   if (cc_WaitCall(devhdl, &crn, NULL, -1, EV_SYNC) < 0 )  
        procdevfail(devhdl);  
   if ( cc_GetDNIS(crn, dnis_buf) < 0 )  
        callfail(crn);  
   if ( cc_AnswerCall(crn, 0, EV_SYNC) < 0 )  
        callfail(crn);  
        /*   
         * using cc_SetBilling( ) to set the rate of the current call.   
         * This function is used in conjunction with AT&T Vari-A-Bill   
         * service only.    
         * Do not use it in other protocol applications  
         */   
    rate.ATT.cents = 99;  
    if ( cc_SetBilling(crn, ISDN_FLAT_RATE, &rate, EV_SYNC) < 0 )  
        callfail(crn);  
        .  
        .  
        .  
        .  
        .  
   if ( cc_DropCall(crn, NORMAL_CLEARING, EV_SYNC) < 0 )  
        callfail(crn);  
   if ( cc_ReleaseCall(crn) < 0 )  
        callfail(crn);  
   if ( cc_Close(devhdl) < 0 )   
      printf("Error closing device, errno = %d\n", errno);  
}  
    
int callfail(CRN crn)  
{                 
        LINEDEV ld;  
         cc_CRN2LineDev(crn,&ld);  
         procdevfail(ld);  
}  
int procdevfail(LINEDEV handle)  
{  
        int reason;  
        char *msg;  
        reason = cc_CauseValue(handle);  
        cc_ResultMsg(handle, reason, &msg);  
        printf("reason = %x - %s\n",reason,msg);  
}

Errors

If the function returns < 0 to indicate failure, use the cc_CauseValue( ) function to retrieve the reason code for the failure. The cc_ResultMsg( ) function can be used to interpret the reason code. Error codes are defined in the files ccerr.h, isdnerr.h, and isdncmd.h.

Possible error codes from the cc_SetBilling( ) function include the following:

Error Code	Description
ERR_ISDN_LIB | E_ISBADTS	Bad time slot
ERR_ISDN_LIB | E_FB_UNAVAIL	Flex billing unavailable
ERR_ISDN_LIB | E_ISBADIF	Bad interface number
ERR_ISDN_LIB | E_ISBADCALLID	Bad call identifier
ERR_ISDN_LIB | E_ISBADPAR	Bad input parameter

NOTE:

See Section 7.2.1. Cause/Error Codes from the ISDN Firmware for information on firmware return codes that are specific to the cc_SetBilling( ) function.

See Also

• cc_SetParm( )

Click here to contact Dialogic Customer Engineering