3.5.4 Handling Unsolicited Events

The application must handle unsolicited events in the synchronous mode, unless these events are masked or disabled. The gc_SetConfigData( ) function specifies the events that are enabled or disabled for a specified line device. This function sets the event mask associated with the specified line device. If an event bit in the mask is cleared, the event is disabled and not sent to the application.

The unsolicited events listed in Table 12 require a signal handler if they are enabled. Unsolicited events that cannot be masked must use a signal handler. All technology-specific unsolicited events also require a signal handler (see the appropriate Global Call Technology User's Guide for details). If any of these unsolicited events are not masked by the application and signal handlers are not defined, they are queued without being retrievable and memory problems are likely to occur.

Table 12. Unsolicited Events Requiring Signal Handlers

Event	Default Setting	Maskable
GCEV_ALERTING	enabled	yes
GCEV_PROCEEDING	disabled	yes
GCEV_DETECTED	disabled	yes
GCEV_BLOCKED	enabled	yes
GCEV_UNBLOCKED	enabled	yes
GCEV_DISCONNECTED	enabled	no
GCEV_TASKFAIL	enabled	no

Click here to contact Telecom Support Resources