Filter
Top Products
retrieves the error/cause code of a failure cc_CauseValue( )
67
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.