2.2. Error Handling

All the DCB/SC library functions return a value that indicates the success or failure of the function call. DCB/SC library functions return one of the following values:

0	function success
-1	function error

If a function fails, the error can be retrieved using the Standard Runtime Library (SRL) function ATDV_LASTERR( ).

NOTES:

1. The function dcb_open( ) is an exception to the above error-handling rules. A dcb_open( ) function call returns a device handle if the function call is successful. A device handle is a non-zero value. If dcb_open( ) fails, the return code is -1 and the specific error is found in errno defined in errno.h.

NOTES:

2. If the error returned by ATDV_LASTERR( ) is EDT_SYSTEM, a Windows system error has occurred, and you need to check the global variable errno defined in errno.h.

The causes and values of error codes that may be returned to the application by the DCB/SC board are a subset of errors used for the Dialogic Digital Network Interface products or the Dialogic Modular Station Interface (MSI/SC) products. The following tables list possible error codes.

Table 1. Error Types Defined in dtilib.h

Error Returned	Description
EDT_SH_LIBBSY	Switching Handler Library is busy.
EDT_SH_BADINDX	Invalid Switching Handler index number.
EDT_SH_LIBNOTINIT	Switching Handler Library has not been initialized.
EDT_SH_NOCLK	Switching Handler Clock fallback failed.
EDT_SH_MISSING	Switching Handler is not present.
EDT_SH_BADMODE	Invalid bus mode.
EDT_SH_BADLCLTS	Invalid local time slot number.
EDT_SH_BADTYPE	Invalid local time slot type.
EDT_ADDRS	Incorrect address.
EDT_BADBRDERR	Board is missing or defective.
EDT_BADCMDERR	Invalid or undefined command to driver.
EDT_BADCNT	Incorrect count of bytes requested.
EDT_BADDEV	Bad device error.
EDT_BADGLOB	Incorrect global parameter number.
EDT_BADPORT	First byte appeared on reserved port.
EDT_BADVAL	Invalid parameter value passed in value pointer.
EDT_CHKSUM	Incorrect checksum.
EDT_DATTO	Data reception timed out.
EDT_DTTSTMOD	In test mode; cannot set board mode.
EDT_FWERR	Firmware returned an error.
EDT_INVBD	Invalid board.
EDT_INVMSG	Invalid message.
EDT_INVTS	Invalid time slot.
EDT_MBFMT	Wrong number of bytes for multiple byte request.
EDT_MBIMM	Received an immediate termination.
EDT_MBINV	First byte appeared on data port.
EDT_MBOVR	Message was too long.
EDT_MBPORT	Received multiple byte data on port other than 0 or 1.

Table 1. Error Types Defined in dtilib.h (continued)

Error Returned	Description
EDT_MBTERM	Terminating byte other than FEH or FFH.
EDT_MBUND	Under the number of bytes for a multibyte request.
EDT_MSGCNT	Count received did not match actual count.
EDT_NOCLK	No clock source present.
EDT_NOIDLEERR	Time slot is not in idle/closed state.
EDT_NOMEMERR	Cannot map or allocate memory in driver.
EDT_NOTDNLD	Not downloaded.
EDT_PARAMERR	Invalid parameter.
EDT_RANGEERR	Bad/overlapping physical memory range.
EDT_SIGINS	Insertion signaling not enabled.
EDT_SIGTO	Transmit/receive did not update in time.
EDT_SIZEERR	Message too big or too small.
EDT_SKIPRPLYERR	A required reply was skipped.
EDT_STARTED	Cannot start when already started.
EDT_SYSTEM	Windows system error - check the global variable errno for more information .
EDT_TMOERR	Timed out waiting for reply from firmware.
EDT_TSASN	Time slot already assigned.

Table 2. Error Types Defined in msilib.h

Error Returned	Description
E_MS1PTY	Cannot remove party from one party conference.
E_MSBADCHPARM	Invalid channel parameter number.
E_MSBADVAL	Invalid parameter value.
E_MSCHASNCNF	Channel is assigned to conference.
E_MSCNFFUL	Conference system is full.
E_MSCNFLMT	Exceeds conference limit.
E_MSGLOBREAD	Cannot read parameter globally.
E_MSINVCB	Invalid control block ID.
E_MSINVCATTR	Invalid conference attribute.
E_MSINVCNF	Invalid conference number.
E_MSINVDSP	Invalid DSP specified.
E_MSINVMT	Invalid multitasking function.
E_MSINVPATTR	Invalid party attribute.
E_MSINVPTYNUM	Invalid party number.
E_MSINVPTYCNT	Invalid number of parties specified.
E_MSINVPTYTYPE	Invalid conference member type.
E_MSINVVAL	Bad global parameter value.
E_MSINVTS	Invalid time slot number specified.
E_MSMONEXT	Monitor already exists for this conference.
E_MSNOCNF	No conferencing available on device.
E_MSNODSPTS	All time slots going to the DSP are busy.
E_MSNOFEMCH	No DCB/SC daughterboard to support this channel.
E_MSNOMON	No monitor exists for this conference.
E_MSNONCNFCH	Channel is not assigned to specified conference.
E_MSNOTS	No time slot assigned to channel.
E_MSPTYASN	Party already assigned.
E_MSTSASNCNF	Time slot already assigned to a conference.

Click here to contact Dialogic Customer Engineering