cc_CauseValue( )

Description | Cautions | Example | Errors | See Also

Name:	int cc_CauseValue(linedev)
Inputs:	LINEDEV linedev	line device handle
Returns:	cause value code
Includes:	cclib.h
Category:	System tools
Mode:	synchronous
Technology:	BRI/2; BRI/SC; PRI (all protocols)

Description

The cc_CauseValue( ) function retrieves the error/cause code of a failure on a given device when a function returns a -1. Use ResultMsg( ) to retrieve the ASCII string and interpret the reason code associated with the cause value.

NOTES:

1. The cc_CauseValue( ) function is equivalent to ATDV_LASTERR( ).

2. To retrieve the cause of an event or the cause information element of ISDN messages, use the cc_ResultValue( ) function.

There are three cause/error locations:

• Firmware (ERR_ISDN_FW) - returned when there is a firmware-related cause/error. Firmware errors are listed in the isdncmd.h file.
• Network (ERR_ISDN_CAUSE) - returned with a disconnect or reject event (for example, CCEV_DISCONNECTED, CCEV_HOLDREJ, or CCEV_RETRIEVEREJ). Network cause values are listed in the isdncmd.h file.
• ISDN Library (ERR_ISDN_LIB) - returned when there is a library-related cause/error. Library errors are listed in the isdnerr.h file.

See Section 7.2. Error Handling for a listing of errors and cause values.

Parameter	Description
linedev:	The specified line device handle.

Cautions

None

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";  
   int state;  
   int reason;  
   char *msg;  
   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_AnswerCall(crn, 0, EV_SYNC) < 0 )  
        callfail(crn);  
      .  
      .  
      .  
      .  
      .  
   /* Drop the call */  
   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

The cc_CauseValue( ) function returns -1 when there is no error/cause code available for the specified line device. Error codes are defined in the files ccerr.h, isdnerr.h, and isdncmd.h.

See Also

• cc_ResultMsg( )

Click here to contact Dialogic Customer Engineering