1.6. Responding to ISDN Events

1.6. Responding to ISDN Events

The receipt of an ISDN message or event may require taking the action described in Table2 to retrieve information or to set up the channel for the next call. The following descriptions supplement the event descriptions listed in the GlobalCall API Software Reference manual.

Table 2. Responding to ISDN Events
Event Description/Action

GCEV_CALLINFO Unsolicited ISDN event (not maskable) generated when an incoming Information message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION (ext_id = GCIS_EXEV_CONGESTION) Unsolicited ISDN event (not maskable) generated when an incoming Congestion message is received indicating that the remote end is not ready to accept inbound user information.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_D_CHAN_STATUS Unsolicited ISDN even (not maskable) generated when the status of the D channel changes as a result of an event on the D channel.

Use gc_GetLineDevState( ) function to retrieve D channel status.
Use gc_ResultInfo( ) function to retrieve a cause code and a description of the cause.

GCEV_EXTENSION (ext_id = GCIS_EXEV_DIVERTED) Unsolicited ISDN event generated when a NAM with divert information is received. Indicates that an outbound call was successfully diverted to another station (DPNSS and Q.SIG protocols only).

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION (ext_id = GCIS_EXEV_FACILITY Unsolicited ISDN event (not maskable) generated when an incoming Facility Request message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION (ext_id = GCIS_EXEV_FACILITY_ACK Unsolicited ISDN event (not maskable) generated when an incoming FACILITY_ACKNOWLEDGEMENT message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION (ext_id = GCIS_EXEV_FACILITY_REJ Unsolicited ISDN event (not maskable) generated when an incoming FACILITY_REJECT message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_HOLDACK Termination event for ISDN gc_HoldAck( ) function generated when a Hold Call request is acknowledged successfully.

No action required.

GCEV_HOLDCALL Termination ISDN event (not maskable) generated when the Hold Call request was acknowledged by the remote end and that the call is in the Hold state (DPNSS and Q.SIG protocols only).

Respond with a gc_HoldAck( ) or gc_HoldRej( ) function.

GCEV_HOLDREJ Termination event for ISDN gc_HoldRej( ) function generated when a Hold Call request is rejected successfully.

No action required.

GCEV_EXTENSION (ext_id = GCIS_EXEV_L2FRAME Termination ISDN event (not maskable) generated when an incoming data link layer 2 access message is received.

Use gc_GetFrame( ) function to retrieve the received frame.

GCEV_EXTENSION (ext_id = GCIS_EXEV_L2NOBFFR Termination ISDN event (not maskable) generated when no free space (buffer) is available for an incoming layer 2 access message.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION (ext_id = GCIS_EXEV_NOTIFY Termination ISDN event (not maskable) generated when an incoming Notify message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION (ext_id = GCIS_EXEV_NOUSRINFOBUF Termination ISDN event (not maskable) indicates that the incoming user-to-user information element (UUI) is discarded. An incoming UUI is not accepted until the existing UUI is read by the application.

No action required.

GCEV_NSI Termination ISDN event (not maskable) generated when a Network Specific Information (NSI) message is received (DPNSS and Q.SIG protocols only).

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_PROCEEDING Termination ISDN event (enabled by default) generated when an incoming Proceeding message is received.

Use gc_SetEvtMsk( ) function to clear the mask so that the application is notified when the event occurs.

GCEV_PROGRESSING Termination ISDN event (enabled by default) generated when an incoming Progress message is received.

Use gc_SetEvtMsk( ) function to mask event.

GCEV_REQANI Termination event for ISDN gc_ReqANI( ) function generated when ANI information is received from network. (Applies to AT&T ANI-on-demand feature only.)

No action required.

GCEV_RESETLINEDEV Termination event for the asynchronous mode gc_ResetLineDev( ) function.

Application must issue a new gc_WaitCall( ) function to receive the next incoming call on the channel.

GCEV_RESTARTFAIL Termination event for ISDN indicating that the gc_ResetLineDev( ) function failed.

Use the gc_ResultValue( ) function to retrieve the reason for failure.

GCEV_RETRIEVEACK Termination event for ISDN gc_RetrieveAck( ) function generated when a Retrieve Call request is acknowledged successfully.

No action required.

GCEV_RETRIEVECALL Termination ISDN event (not maskable), generated when the call is retrieved successfully from the HOLD state (DPNSS and Q.SIG protocols only).

Use the gc_RetrieveAck( ) or the gc_RetrieveRej( ) function to respond.

GCEV_RETRIEVEREJ Termination event for ISDN gc_RetrieveRej( ) function generated when a Retrieve Call request is rejected successfully (DPNSS and Q.SIG protocols only).

No action required.

GCEV_SETBILLING Termination event for ISDN gc_SetBilling( ); generated when billing information for the call is acknowledged by the network. (Applies to AT&T ANI-on-demand feature only.)

No action required.

GCEV_SETCHANSTATE Termination event for the asynchronous mode gc_SetChanState( ) function. Unsolicited event (not maskable) generated when the status of the B channel changes or a Maintenance message is received from the network.

Use gc_GetLineDevState( ) to retrieve B channel status.
Use gc_ResultValue( ) and gc_ResultMsg( ) to retrieve a cause code and a description of the cause.

GCEV_SETUP_ACK Termination ISDN event (enabled by default) generated when an incoming setup ACK (acknowledge) message is received.

No action required.

GCEV_TRANSFERACK Termination ISDN event (enabled by default) generated when a Transfer acknowledge message is received from the network (DPNSS and Q.SIG protocols only). Indicates that the network accepted a request to transfer a call.

No action required.

GCEV_TRANSFERREJ Termination ISDN event (enabled by default) generated when a Transfer Reject message is received from the network (DPNSS and Q.SIG protocols only). Indicates that the network rejected a request to transfer a call.

No action required.

GCEV_TRANSIT Termination ISDN event (enabled by default) generated when messages are sent via a call transferring party to the destination party after a transfer call connection is completed (DPNSS and Q.SIG protocols only).

No action required.

GCEV_USRINFO Termination ISDN event (not maskable) generated when an incoming User Information message is received; for example in, response to a gc_SndMsg( ) function call in which the msg_type specified is SndMsg_UsrInformation. Indicates that a User-to-User Information (UUI) event is coming.

Use gc_GetCallInfo( ) function to retrieve call information.

**Table 2. Responding to ISDN Events**
Event	Description/Action
GCEV_CALLINFO	Unsolicited ISDN event (not maskable) generated when an incoming Information message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION (ext_id = GCIS_EXEV_CONGESTION)	Unsolicited ISDN event (not maskable) generated when an incoming Congestion message is received indicating that the remote end is not ready to accept inbound user information. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_D_CHAN_STATUS	Unsolicited ISDN even (not maskable) generated when the status of the D channel changes as a result of an event on the D channel. Use gc_GetLineDevState( ) function to retrieve D channel status. Use gc_ResultInfo( ) function to retrieve a cause code and a description of the cause.
GCEV_EXTENSION (ext_id = GCIS_EXEV_DIVERTED)	Unsolicited ISDN event generated when a NAM with divert information is received. Indicates that an outbound call was successfully diverted to another station (DPNSS and Q.SIG protocols only). Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION (ext_id = GCIS_EXEV_FACILITY	Unsolicited ISDN event (not maskable) generated when an incoming Facility Request message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION (ext_id = GCIS_EXEV_FACILITY_ACK	Unsolicited ISDN event (not maskable) generated when an incoming FACILITY_ACKNOWLEDGEMENT message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION (ext_id = GCIS_EXEV_FACILITY_REJ	Unsolicited ISDN event (not maskable) generated when an incoming FACILITY_REJECT message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_HOLDACK	Termination event for ISDN gc_HoldAck( ) function generated when a Hold Call request is acknowledged successfully. No action required.
GCEV_HOLDCALL	Termination ISDN event (not maskable) generated when the Hold Call request was acknowledged by the remote end and that the call is in the Hold state (DPNSS and Q.SIG protocols only). Respond with a gc_HoldAck( ) or gc_HoldRej( ) function.
GCEV_HOLDREJ	Termination event for ISDN gc_HoldRej( ) function generated when a Hold Call request is rejected successfully. No action required.
GCEV_EXTENSION (ext_id = GCIS_EXEV_L2FRAME	Termination ISDN event (not maskable) generated when an incoming data link layer 2 access message is received. Use gc_GetFrame( ) function to retrieve the received frame.
GCEV_EXTENSION (ext_id = GCIS_EXEV_L2NOBFFR	Termination ISDN event (not maskable) generated when no free space (buffer) is available for an incoming layer 2 access message. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION (ext_id = GCIS_EXEV_NOTIFY	Termination ISDN event (not maskable) generated when an incoming Notify message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION (ext_id = GCIS_EXEV_NOUSRINFOBUF	Termination ISDN event (not maskable) indicates that the incoming user-to-user information element (UUI) is discarded. An incoming UUI is not accepted until the existing UUI is read by the application. No action required.
GCEV_NSI	Termination ISDN event (not maskable) generated when a Network Specific Information (NSI) message is received (DPNSS and Q.SIG protocols only). Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_PROCEEDING	Termination ISDN event (enabled by default) generated when an incoming Proceeding message is received. Use gc_SetEvtMsk( ) function to clear the mask so that the application is notified when the event occurs.
GCEV_PROGRESSING	Termination ISDN event (enabled by default) generated when an incoming Progress message is received. Use gc_SetEvtMsk( ) function to mask event.
GCEV_REQANI	Termination event for ISDN gc_ReqANI( ) function generated when ANI information is received from network. (Applies to AT&T ANI-on-demand feature only.) No action required.
GCEV_RESETLINEDEV	Termination event for the asynchronous mode gc_ResetLineDev( ) function. Application must issue a new gc_WaitCall( ) function to receive the next incoming call on the channel.
GCEV_RESTARTFAIL	Termination event for ISDN indicating that the gc_ResetLineDev( ) function failed. Use the gc_ResultValue( ) function to retrieve the reason for failure.
GCEV_RETRIEVEACK	Termination event for ISDN gc_RetrieveAck( ) function generated when a Retrieve Call request is acknowledged successfully. No action required.
GCEV_RETRIEVECALL	Termination ISDN event (not maskable), generated when the call is retrieved successfully from the HOLD state (DPNSS and Q.SIG protocols only). Use the gc_RetrieveAck( ) or the gc_RetrieveRej( ) function to respond.
GCEV_RETRIEVEREJ	Termination event for ISDN gc_RetrieveRej( ) function generated when a Retrieve Call request is rejected successfully (DPNSS and Q.SIG protocols only). No action required.
GCEV_SETBILLING	Termination event for ISDN gc_SetBilling( ); generated when billing information for the call is acknowledged by the network. (Applies to AT&T ANI-on-demand feature only.) No action required.
GCEV_SETCHANSTATE	Termination event for the asynchronous mode gc_SetChanState( ) function. Unsolicited event (not maskable) generated when the status of the B channel changes or a Maintenance message is received from the network. Use gc_GetLineDevState( ) to retrieve B channel status. Use gc_ResultValue( ) and gc_ResultMsg( ) to retrieve a cause code and a description of the cause.
GCEV_SETUP_ACK	Termination ISDN event (enabled by default) generated when an incoming setup ACK (acknowledge) message is received. No action required.
GCEV_TRANSFERACK	Termination ISDN event (enabled by default) generated when a Transfer acknowledge message is received from the network (DPNSS and Q.SIG protocols only). Indicates that the network accepted a request to transfer a call. No action required.
GCEV_TRANSFERREJ	Termination ISDN event (enabled by default) generated when a Transfer Reject message is received from the network (DPNSS and Q.SIG protocols only). Indicates that the network rejected a request to transfer a call. No action required.
GCEV_TRANSIT	Termination ISDN event (enabled by default) generated when messages are sent via a call transferring party to the destination party after a transfer call connection is completed (DPNSS and Q.SIG protocols only). No action required.
GCEV_USRINFO	Termination ISDN event (not maskable) generated when an incoming User Information message is received; for example in, response to a gc_SndMsg( ) function call in which the msg_type specified is SndMsg_UsrInformation. Indicates that a User-to-User Information (UUI) event is coming. Use gc_GetCallInfo( ) function to retrieve call information.

Click here to contact Dialogic Customer Engineering