Global Call ISDN Technology User's Guide: 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 Table 2 to retrieve information or to set up the channel for the next call. The following descriptions supplement the event descriptions listed in the Global Call API Library Reference manual.

Table 2. Responding to ISDN Events

Event

Description/Action

GCEV_CALLINFO when using both Springware and DM3 boards Unsolicited ISDN event (not maskable) generated when an incoming Information message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION with ext_id = GCIS_EXEV_CONGESTION when using Springware boards GCEV_CONGESTION event when using DM3 boards 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 when using both Springware and DM3 boards 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 withext_id = GCIS_EXEV_DIVERTED when using Springware boards Note: Not supported when using DM3 boards. 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 withext_id = GCIS_EXEV_FACILITY when using Springware boards GCEV_FACILITY event when using DM3 boards Unsolicited ISDN event (not maskable) generated when an incoming Facility Request message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION withext_id = GCIS_EXEV_FACILITY_ACK when using Springware boards Note: Not supported when using DM3 boards. Unsolicited ISDN event (not maskable) generated when an incoming FACILITY_ACKNOWLEDGEMENT message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION withext_id = GCIS_EXEV_FACILITY_REJ when using Springware boards Note: Not supported when using DM3 boards. Unsolicited ISDN event (not maskable) generated when an incoming FACILITY_REJECT message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_HOLDACK when using Springware boards Note: Not supported when using DM3 boards. Termination event for ISDN gc_HoldAck( ) function generated when a Hold Call request is acknowledged successfully.

No action required.

GCEV_HOLDCALL when using Springware boards Note: Not supported when using DM3 boards. 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 when using Springware boards Note: Not supported when using DM3 boards. Termination event for ISDN gc_HoldRej( ) function generated when a Hold Call request is rejected successfully.

No action required.

GCEV_EXTENSION withext_id = GCIS_EXEV_L2FRAME when using Springware boards GCEV_L2FRAME event when using DM3 boards 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 withext_id = GCIS_EXEV_L2NOBFFR when using Springware boards Note: Not supported when using DM3 boards. 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 withext_id = GCIS_EXEV_NOTIFY when using Springware boards GCEV_NOTIFY event when using DM3 boards Termination ISDN event (not maskable) generated when an incoming Notify message is received.

Use gc_GetCallInfo( ) function to retrieve call information.

GCEV_EXTENSION with ext_id = GCIS_EXEV_NOUSRINFOBUF when using Springware boards Note: Not supported when using DM3 boards. 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 when using Springware boards Note: Not supported when using DM3 boards. 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 when using both Springware and DM3 boards 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 when using both Springware and DM3 boards Termination ISDN event (enabled by default) generated when an incoming Progress message is received.

Use gc_SetEvtMsk( ) function to mask event.

GCEV_REQANI when using Springware boards Note: Not supported when using DM3 boards. 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 when using both Springware and DM3 boards 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 when using both Springware and DM3 boards Termination event for ISDN indicating that the gc_ResetLineDev( ) function failed.

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

GCEV_RETRIEVEACK when using Springware boards Note: Not supported when using DM3 boards. Termination event for ISDN gc_RetrieveAck( ) function generated when a Retrieve Call request is acknowledged successfully.

No action required.

GCEV_RETRIEVECALL when using Springware boards Note: Not supported when using DM3 boards. 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 when using Springware boards Note: Not supported when using DM3 boards. 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 when using Springware boards Note: Not supported when using DM3 boards. 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 when using both Springware and DM3 boards 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 when using both Springware and DM3 boards Termination ISDN event (enabled by default) generated when an incoming setup ACK (acknowledge) message is received.

No action required.

GCEV_TRANSFERACK when using Springware boards Note: Not supported when using DM3 boards. 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 when using Springware boards Note: Not supported when using DM3 boards. 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 when using both Springware and DM3 boards 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 when using both Springware and DM3 boards 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 when using both Springware and DM3 boards	Unsolicited ISDN event (not maskable) generated when an incoming Information message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION with ext_id = GCIS_EXEV_CONGESTION when using Springware boards GCEV_CONGESTION event when using DM3 boards	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 when using both Springware and DM3 boards	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 withext_id = GCIS_EXEV_DIVERTED when using Springware boards Note: Not supported when using DM3 boards.	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 withext_id = GCIS_EXEV_FACILITY when using Springware boards GCEV_FACILITY event when using DM3 boards	Unsolicited ISDN event (not maskable) generated when an incoming Facility Request message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION withext_id = GCIS_EXEV_FACILITY_ACK when using Springware boards Note: Not supported when using DM3 boards.	Unsolicited ISDN event (not maskable) generated when an incoming FACILITY_ACKNOWLEDGEMENT message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION withext_id = GCIS_EXEV_FACILITY_REJ when using Springware boards Note: Not supported when using DM3 boards.	Unsolicited ISDN event (not maskable) generated when an incoming FACILITY_REJECT message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_HOLDACK when using Springware boards Note: Not supported when using DM3 boards.	Termination event for ISDN gc_HoldAck( ) function generated when a Hold Call request is acknowledged successfully. No action required.
GCEV_HOLDCALL when using Springware boards Note: Not supported when using DM3 boards.	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 when using Springware boards Note: Not supported when using DM3 boards.	Termination event for ISDN gc_HoldRej( ) function generated when a Hold Call request is rejected successfully. No action required.
GCEV_EXTENSION withext_id = GCIS_EXEV_L2FRAME when using Springware boards GCEV_L2FRAME event when using DM3 boards	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 withext_id = GCIS_EXEV_L2NOBFFR when using Springware boards Note: Not supported when using DM3 boards.	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 withext_id = GCIS_EXEV_NOTIFY when using Springware boards GCEV_NOTIFY event when using DM3 boards	Termination ISDN event (not maskable) generated when an incoming Notify message is received. Use gc_GetCallInfo( ) function to retrieve call information.
GCEV_EXTENSION with ext_id = GCIS_EXEV_NOUSRINFOBUF when using Springware boards Note: Not supported when using DM3 boards.	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 when using Springware boards Note: Not supported when using DM3 boards.	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 when using both Springware and DM3 boards	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 when using both Springware and DM3 boards	Termination ISDN event (enabled by default) generated when an incoming Progress message is received. Use gc_SetEvtMsk( ) function to mask event.
GCEV_REQANI when using Springware boards Note: Not supported when using DM3 boards.	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 when using both Springware and DM3 boards	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 when using both Springware and DM3 boards	Termination event for ISDN indicating that the gc_ResetLineDev( ) function failed. Use the gc_ResultValue( ) function to retrieve the reason for failure.
GCEV_RETRIEVEACK when using Springware boards Note: Not supported when using DM3 boards.	Termination event for ISDN gc_RetrieveAck( ) function generated when a Retrieve Call request is acknowledged successfully. No action required.
GCEV_RETRIEVECALL when using Springware boards Note: Not supported when using DM3 boards.	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 when using Springware boards Note: Not supported when using DM3 boards.	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 when using Springware boards Note: Not supported when using DM3 boards.	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 when using both Springware and DM3 boards	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 when using both Springware and DM3 boards	Termination ISDN event (enabled by default) generated when an incoming setup ACK (acknowledge) message is received. No action required.
GCEV_TRANSFERACK when using Springware boards Note: Not supported when using DM3 boards.	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 when using Springware boards Note: Not supported when using DM3 boards.	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 when using both Springware and DM3 boards	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 when using both Springware and DM3 boards	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 Telecom Support Resources