Dialogic Global Call IP Benutzerhandbuch

132

Dialogic Corporation

Use the cause parameter in the gc_DropCall( ) function to specify a disconnect reason/cause to be 
sent to the remote endpoint. 

When using SIP, reasons are only supported when a call is disconnected while in the Offered state. 

Use the gc_ResultInfo( ) function to get the reason/cause of a GCEV_DISCONNECTED event. 
This reason/cause could be sent from the remote endpoint or it could be the result of an internal 
error. 

IP-specific reason/cause values are specified in the eIP_EC_TYPE enumerator defined in the 
gcip_defs.h header file. 

Both SIP and H.323 define request response codes that can be included in the failure response 
messages that are sent when a local system cannot take additional incoming sessions. Global Call 
allows applications to set SIP and H.323 busy code values on a virtual board level. 

SIP and H.323 busy codes are configured independently, and the configuration of each can be 
changed at any time. The busy codes are configured by calling gc_SetConfigData( ) using the 
following parameter set ID and parameter ID:

for SIP: IPSET_SIP_RESPONSE_CODE and IPPARM_BUSY_REASON; see 

for H.323: IPSET_H323_RESPONSE_CODE and IPPARM_BUSY_CAUSE; see 

For SIP, RFC3261 defines three applicable busy codes:

480 Temporarily Unavailable

The callee’s end system was contacted successfully, but the callee is currently unavailable. For 
example, the callee may be not logged in, may be in a state that precludes communication, or 
may have activated the “do not disturb” feature. This busy code is also returned by a redirect or 
proxy server that recognizes the user identified by the Request-URI but does not currently have 
a valid forwarding location for that user.

486 Busy Here

The callee’s end system was contacted successfully, but the callee is currently not willing or 
able to take additional calls at this end system. This response should be used if the user could 
be available elsewhere. 

600 Busy Everywhere

The callee’s end system was contacted successfully, but the callee is busy and does not wish to 
take the call at this time. This response should be used if the callee knows that no other end 
system will be available to accept this call.