5. Error Codes

This chapter describes the error codes used by the Global Call software.

The Global Call software uses two types of error codes as follows:

Error codes (prefixed by EGC_)

Codes that are generated when a Global Call API function returns a value less than 0. The gc_ErrorInfo( ) function can be used to retrieve the error information.

Result values (prefixed by GCRV_)

Values that are generated when a GCEV_TASKFAIL event is received by the application. The gc_ResultInfo( ) function can be used to retrieve the error information.

Common error codes and result values are defined in the gcerr.h header file.

Note: When a Global Call API function fails, the underlying call control library may also generate an error code that contains more detail about the error. The gc_ErrorInfo( ) function also provides access to this error information. The error codes for underlying call control libraries are defined in separate technology-specific header files.

Error codes (prefixed by EGC_) and result values (prefixed by GCRV_) are listed alphabetically and described below. The error codes include the Real Time Configuration Management (RTCM) error codes. See the Global Call API Programming Guide for more information about error handling.

EGC_AGGETXMITSLOT

ag_getxmitslot( ) function failed

EGC_AGLISTEN

Analog device listen failed

EGC_AGUNLISTEN

Analog device unlisten failed

EGC_ALARM

Function interrupted by alarm

EGC_ALARMDBINIT

Alarm database failed to initialize

EGC_ATTACHED

Specified resource already attached

EGC_BUSY

Line is busy

EGC_CCLIBSPECIFIC

Error specific to call control library

EGC_CCLIBSTART

At least one call control library failed to start

EGC_CEPT

Operator intercept detected

EGC_COMPATIBILITY

Incompatible components

EGC_CONGESTION

Congestion on the line

EGC_CPERROR

Special Information Tone (SIT) detection error

EGC_DEVICE

Invalid device handle

EGC_DIALTONE

No dial tone detected

EGC_DRIVER

Driver error

EGC_DTGETXMITSLOT

dt_getxmitslot( ) function failed

EGC_DTLISTEN

Network interface (dti) device listen failed

EGC_DTOPEN

dt_open( ) function failed

EGC_DTUNLISTEN

Network interface (dti) device unlisten failed

EGC_DUPENTRY

Duplicate entry inserted into Global Call database

EGC_DXGETXMITSLOT

dx_getxmitslot( ) function failed

EGC_DXLISTEN

Voice device listen failed

EGC_DXOPEN

dx_open( ) function failed

EGC_DXUNLISTEN

Voice device unlisten failed

EGC_FATALERROR_ACTIVE

Recovery from a fatal error is in progress

EGC_FATALERROR_ OCCURRED

Fatal error occurred

EGC_FILEOPEN

Error opening file

EGC_FILEREAD

Error reading file

EGC_FILEWRITE

Error writing file

EGC_FUNC_NOT_DEFINED

Protocol function not defined

EGC_GC_STARTED

Global Call library is already started

EGC_GCDBERR

Global Call database error

EGC_GCNOTSTARTED

Global Call not started

EGC_GETXMITSLOT

gc_GetXmitSlot( ) function failed

EGC_GLARE

gc_MakeCall( ) function failed due to a glare condition

EGC_ILLSTATE

Function not supported in the current state

EGC_INTERR

Internal Global Call error

EGC_INVCRN

Invalid call reference number

EGC_INVDATABUFFSIZE

(RTCM) Invalid parm data buffer size

EGC_INVDEVNAME

Invalid device name

EGC_INVLINEDEV

Invalid line device passed

EGC_INVMETAEVENT

Invalid metaevent

EGC_INVPARM

Invalid parameter (argument)

EGC_INVPARM_CCLIB

(RTCM) Invalid parm to CCLib

EGC_INVPARM_FIRMWARE

(RTCM) Invalid parm to firmware

EGC_INVPARM_GCLIB

(RTCM) Invalid parm to GCLib

EGC_INVPARM_PROTOCOL

(RTCM) Invalid parm to protocol

EGC_INVPARM_TARGET

(RTCM) Invalid parm to target object

EGC_INVPARMBLK

(RTCM) Invalid GC_PARM_BLK

EGC_INVPARMID

(RTCM) Invalid parm ID

EGC_INVPROTOCOL

Invalid protocol name

EGC_INVQUERYID

(RTCM) Invalid query ID

EGC_INVSETID

(RTCM) Invalid set ID

EGC_INVSTATE

Invalid state

EGC_INVTARGETID

(RTCM) Invalid target object ID

EGC_INVTARGETTYPE

(RTCM) Invalid target object type

EGC_INVUPDATEFLAG

(RTCM) Invalid update condition flag

EGC_LINERELATED

Error is related to line device

EGC_LISTEN

gc_Listen( ) function failed

EGC_MAXDEVICES

Exceeded maximum devices limit

EGC_NAMENOTFOUND

Trunk device name not found

EGC_NDEVICE

Too many devices opened

EGC_NEXT_PARM_ERR

(RTCM) Can not get next parm data

EGC_NO_MORE_AVL

No more information available

EGC_NOANSWER

Rang called party, called party did not answer

EGC_NOCALL

No call was made or transferred

EGC_NOERR

No error

EGC_NOMEM

Out of memory

EGC_NON_RECOVERABLE_ FATALERROR

A non-recoverable fatal error occurred. The application must be shut down and restarted.

EGC_NORB

No ringback detected

EGC_NOT_INSERVICE

Called number is not in-service

EGC_NOVOICE

Call needs voice resource, use gc_AttachResource( ) function

EGC_NPROTOCOL

Too many protocols opened

EGC_OPENH

(same as EGC_DXOPEN)

EGC_PARM_DATATYPE_ERR

(RTCM) Parm data type error

EGC_PARM_UPDATEPERM_ERR

(RTCM) Parm update not allowed

EGC_PARM_VALUE_ERR

(RTCM) Parm value error

EGC_PARM_VALUESIZE_ERR

(RTCM) Parm value buffer size error

EGC_PFILE

Error opening parameter file

EGC_PROTOCOL

Protocol error

EGC_PUTEVT

Error queuing event

EGC_QUERYEDATA_ERR

(RTCM) Query source data error

EGC_RECOVERABLE_ FATALERROR

Recoverable fatal error occurred. Channel must be closed and then reopened.

EGC_REJECT

Call is rejected

EGC_RESETABLE_ FATALERROR

Resetable fatal error occurred. Line device was automatically reset.

EGC_ROUTEFAIL

Routing failed

EGC_SETALRM

Set alarm mode failed

EGC_SRL

SRL failure

EGC_STOPD

Call progress stopped

EGC_SYNC

Set mode flag to EV_ASYNC instead of EV_SYNC

EGC_SYSTEM

System error

EGC_TASKABORTED

Task aborted

EGC_TIMEOUT

Function time-out

EGC_TIMER

Error starting timer

EGC_UNALLOCATED

Number is unallocated

EGC_UNLISTEN

gc_UnListen( ) function failed

EGC_UNSUPPORTED

Function not supported by this technology

EGC_USER

Function interrupted by user

EGC_USRATTRNOTSET

User attribute for this line device not set

EGC_VOICE

No voice resource attached

EGC_VOXERR

Error from voice software

EGC_XMITALRM

Send alarm failed

GCRV_ALARM

Event caused by alarm

GCRV_B8ZSD

Bipolar eight zero substitution detected

GCRV_B8ZSDOK

Bipolar eight zero substitution detected recovered

GCRV_BPVS

Bipolar violation count saturation

GCRV_BPVSOK

Bipolar violation count saturation recovered

GCRV_BUSY

Line is busy

GCRV_CCLIBSPECIFIC

Event caused by specific call control library failure

GCRV_CECS

CRC4 error count saturation

GCRV_CECSOK

CRC4 error count saturation recovered

GCRV_CEPT

Operator intercept detected

GCRV_CONGESTION

Congestion

GCRV_CPERROR

Special Information Tone (SIT) detection error

GCRV_DIALTONE

No dial tone detected

GCRV_DPM

Driver performance monitor failure

GCRV_DPMOK

Driver performance monitor failure recovered

GCRV_ECS

Error count saturation

GCRV_ECSOK

Error count saturation recovered

GCRV_FATALERROR_ ACTIVE

Recovery from fatal error in progress

GCRV_FATALERROR_ OCCURRED

Fatal error occurred

GCRV_FERR

Frame bit error

GCRV_FERROK

Frame bit error recovered

GCRV_FSERR

Frame sync error

GCRV_FSERROK

Frame sync error recovered

GCRV_GLARE

Glare condition occurred

GCRV_INTERNAL

Event caused internal failure

GCRV_LOS

Initial loss of signal detection

GCRV_LOSOK

Initial loss of signal detection recovered

GCRV_MFSERR

Received multi frame sync error

GCRV_MFSERROK

Received multi frame sync error recovered

GCRV_NOANSWER

Event caused by no answer

GCRV_NODYNMEM

Fatal error occurred due to no dynamic memory

GCRV_NONRECOVERABLE_ FATALERROR

Non-recoverable fatal error occurred; application must be shut down and restarted

GCRV_NORB

No ringback detected

GCRV_NORMAL

Normal completion

GCRV_NOT_INSERVICE

Called number is not in-service

GCRV_NOVOICE

Call needs voice resource, use gc_AttachResource( ) function

GCRV_OOF

Out of frame error, count saturation

GCRV_OOFOK

Out of frame error, count saturation recovered

GCRV_PROTOCOL

Event caused by protocol error

GCRV_RBL

Received blue alarm

GCRV_RBLOK

Received blue alarm recovered

GCRV_RCL

Received carrier loss

GCRV_RCLOK

Received carrier loss recovered

GCRV_RDMA

Received distant multi-frame alarm

GCRV_RDMAOK

Received distant multi-frame alarm recovered

GCRV_RECOVERABLE_ FATALERROR

Recoverable fatal error occurred

GCRV_RED

Received a red alarm condition

GCRV_REDOK

Received a red alarm condition recovered

GCRV_REJECT

Call rejected

GCRV_RESETABLE_ FATALERROR

Resetable fatal error occurred. The protocol was automatically reset.

GCRV_RLOS

Received loss of sync

GCRV_RLOSOK

Received loss of sync recovered

GCRV_RRA

Remote alarm

GCRV_RRAOK

Remote alarm recovered

GCRV_RSA1

Received signaling all 1s

GCRV_RSA1OK

Received signaling all 1s recovered

GCRV_RUA1

Received unframed all 1s

GCRV_RUA1OK

Received unframed all 1s recovered

GCRV_RYEL

Received yellow alarm

GCRV_RYELOK

Received yellow alarm recovered

GCRV_SIGNALLING

Signaling change

GCRV_STOPD

Call progress stopped

GCRV_TIMEOUT

Event caused by time-out

GCRV_UNALLOCATED

Number not allocated

Click here to contact Telecom Support Resources