2.5. gc_DropCall( )

The gc_DropCall( ) function used in an ISDN environment supports all of the cause values listed in the Global Call API Library Reference except for GC_SEND_SIT. In addition, the cause values listed in Table 10 may be used in an ISDN environment.

Table 10. Cause Values, gc_DropCall( ) Function 

Cause	Description
ACCESS_INFO_DISCARDED	Access information discarded
BAD_INFO_ELEM	Information element nonexistent or not implemented
BEAR_CAP_NOT_AVAIL	Bearer channel capability not available
CAP_NOT_IMPLEMENTED	Bearer channel capability not implemented
CHAN_DOES_NOT_EXIST	Channel does not exist
CHAN_NOT_IMPLEMENTED	Channel type not implemented
FACILITY_NOT_IMPLEMENT	Requested facility not implemented
FACILITY_NOT_SUBSCRIBED	Facility not subscribed
FACILITY_REJECTED	Facility rejected
GC_USER_BUSY	End user is busy
INCOMING_CALL_BARRED	Incoming call barred
INCOMPATIBLE_DEST	Incompatible destination
INTERWORKING_UNSPEC	Interworking unspecified
INVALID_CALL_REF	Invalid call reference
INVALID_ELEM_CONTENTS	Invalid information element
INVALID_MSG_UNSPEC	Invalid message, unspecified
INVALID_NUMBER_FORMAT	Invalid number format
MANDATORY_IE_LEN_ERR	Message received with mandatory information element of incorrect length
MANDATORY_IE_MISSING	Mandatory information element missing
NETWORK_OUT_OF_ORDER	Network out of order
NO_CIRCUIT_AVAILABLE	No circuit available
NO_ROUTE	No route. Network has no route to the specified transient network or to the destination.
NO_USER_RESPONDING	No user responding
NONEXISTENT_MSG	Message type nonexistent or not implemented
NUMBER_CHANGED	Number changed
OUTGOING_CALL_BARRED	Outgoing call barred
PRE_EMPTED	Call preempted
PROTOCOL_ERROR	Protocol error, unspecified
RESP_TO_STAT_ENQ	Response to status inquiry
SERVICE_NOT_AVAIL	Service not available
TEMPORARY_FAILURE	Temporary failure
TIMER_EXPIRY	Recovery on timer expired
UNSPECIFIED_CAUSE	Unspecified cause
WRONG_MESSAGE	Message type invalid in call state or not implemented
WRONG_MSG_FOR_STATE	Message type not compatible with call state

The gc_DropCall( ) function sends a Disconnect message to the network to indicate that the call was terminated.

Note: A GCEV_OFFERED event may be generated after gc_DropCall( ) is issued and before the call is released. The event would be generated on a different CRN. The application must allow for this possibility and be able to handle the event.

Click here to contact Telecom Support Resources