Route Call to a Cause Code

Routing to a Cause Code allows the IMG 2020 to receive an incoming call and reject it with a cause code specified by the user. For example, a call comes into the IMG 2020 on Channel Group A. Channel Group A would route the call to a Route Table and then Route Table Entry. If Route Table entry is configured for this feature the IMG 2020 would reject the call and send the rejected call with the cause code out the same channel group the call came in on. 

Call Flow Diagram

Below is Call Flow diagram of the Route Call to a Cause Code feature. The procedure below will configure the IMG 2020 to follow this Call Flow diagram.

 

Configuration

The configuration section below displays the steps needed to configure the Route To a Cause Code feature. It is assumed that the initial configurations such as DS-1's/DS-0's, interfaces, IP Spans/Channels, and SS7 Signaling have already been achieved. Refer to the Basic Configurations and Configure SS7 topics for information on configuring the initial objects. The procedure below will start with configuring from the Routing Configuration object. The following example will demonstrate the configuration needed to allow a call to come into the IMG 2020 and then have it rejected with Cause Code 003 - No Route To Destination.

Create Incoming Channel Group

The first step would be to create an incoming Channel Group. The incoming Channel group, configured for SS7, would receive the incoming call and route the call to a Route Table which would then send call to Route Table Entry.

  • Right click on the Dialogic object and select New Routing Configuration. A Routing Configuration Pane will appear. Refer to the IMG 1010 - Configuring Routing topic for more information on this object.

  • Right click on Routing Configuration and select New Channel Groups. The Channel Groups object is a parent or container object and no configuration is needed here. Refer to the Channel Groups topic for more information on this object.

  • Right click on Channel Groups Object and select New Channel Group. A Channel Group object will appear. In the Name field either accept the default name entry or enter a different name that identifies the channel group. The Incoming Channel Group in this example will be an SS7 Channel Group and be named ChGrp_SS7. Refer to the Channel Group topic for more information on configuring the individual fields within the SIP channel group object. 

Create Route Tables and then Route Table Entries

The routing for this feature will now be configured. The next few steps will configure the objects needed to reject the call.

  • Right click on Routing Configuration object and select New Routing Tables. The Routing Tables object created is a container object which will allow multiple individual Routing Tables to be created beneath it. Refer to the Routing Tables topic for more information.

  • Right click on Routing Tables object and select New Route Table. A Route Table object gets created. In the Name field either accept the default name or enter a name that identifies this Route Table. In this example the name will be RT1 for Route Table 1. Refer to the Route Table topic for more information on configuring the Route Table object.

  • Create a Route Entry under the Route Table by right clicking on Route Table and select New Route Element. A Route Element screen will appear. Click in the Route Action Type field and a drop down menu appears. Select Cause Code from the list.

  • Once Cause Code is selected from the Route Action Type field, the last field which was labeled Outgoing Channel Group will automatically modify itself so the field now reads Reject Cause Code. Select from drop down menu of the Reject Cause Code field which cause code to send when the call is rejected. In this example No Route to Destination was chosen.

  • Enter the Router String to match into the Router String field. In this example, the dialed number 5085551212 will be matched. See Route Table Element for more information on configuring this pane.

Refer to the Cause Code Values topic for a list of the Cause Codes.

Configure Channel Group to access Route Table configured

Once the Route Table and Route Entry are configured, go back to the Channel Group created. Select from drop down menu the Route Table just configured. By selecting the Route Table, the rejected call with the Cause Code configured will be sent out this Channel Group. See Below.


 

  • Once the Channel Group configuration has been achieved, click back onto the Channel Groups object. This object will now display an exclamation point in the icon indicating the configuration has not been sent to the IMG 2020. Click on the Download Resource Table button and the configuration will be sent to the IMG 2020.

  • The same exclamation point icon will also be visible in the Route Table object. Click on the Route Table object and then click on the Download Routing Table button to send the routing configuration to the IMG 2020.

Flow of above Configuration

After configuring the Route Call to a Cause Code feature above the following bulleted list explains what happens once a call comes into the IMG 2020 and it rejects call with Cause Code configured.

  • Call comes into SS7 Channel Group labeled ChGrp_SS7. Within this Channel Group the Route Table field is set to RT1 - ID:5. This will send the call to Route Table RT1.

  • Route Table RT1 has one entry in it. The call then references this entry and sees that if the Router String 5088881212 is matched, reject this call with the cause code configured and send rejected message out Channel Group labeled ChGrp_SS7. 

Web GUI Tree for above configuration

Additional Information

The IMG 2020 will map the configured reject cause code in the release message so that the message corresponds to the protocol used for the incoming call. For Example: User configures a SIP cause code in the routing table but the incoming channel group is SS7, the IMG 2020 will map the SIP cause code to the SS7 cause code when rejecting the call.

Return to Documentation Home I Return to Sangoma Support