Route

Routes define what Trunk Group to use when a certain Pattern is dialed.

Adding a Route

1) Enter the CLI's configuration mode

2) Enter a name for the new Route. You will then be prompted the minimums needed to create the new route.

vbox-nathan(config)# route      ### use tab to get an available list of routes if you are unsure
ld11_reg local    ld10     ld11     intl     ld10_reg emerg
vbox-nathan(config)# route A_Route
!! Notice: Editing new item: A_Route
!! Notice: Minimum requirements needed for insert:
!!   pattern                    ### see next step
!!   trunk_group
!!   desc
vbox-nathan(config-route A_Route)# desc "Local and Long Distance Numbers +9"
vbox-nathan(config-route A_Route)# trunk_group  ### use tab to get a list of the trunks you have made 
pbx-sip-t1 default
vbox-nathan(config-route A_Route)# trunk_group pbx-sip-t1

3) Next enter a Pattern for the route. The Pattern represents the combination of numbers that the Trunk Group will use when making a call. In many cases there will be multiple routes to define multiple types of patterns. Below is an example of what default Routes look like on a freshly installed system.

--------------------------------------------------------------------------------------------------------------------------------------
|  Route     |  Desc.                               |  Trunk Group  |  Pattern       |  Replace  |  Remove  |  Prepend  |  Postpend  |
--------------------------------------------------------------------------------------------------------------------------------------
|  ld11_reg  |  Long Distance 11 Digit without a 9  |  pbx-sip-t1   |  1XXXXXXXXXX   |           |          |           |            |
|  intl      |  International                       |  pbx-sip-t1   |  9011X.        |           |  +1      |           |            |
|  ld11      |  Long Distance 11 Digit              |  pbx-sip-t1   |  91NXXXXXXXXX  |           |  +1      |           |            |
|  emerg     |  Emergency                           |  pbx-sip-t1   |  9911          |           |  +1      |           |            |
|  ld10      |  Long Distance 10 Digit              |  pbx-sip-t1   | 9NXXXXXXXXX    |           |  +1      |  1        |            |
|  local     |  Local 7 Digit                       |  pbx-sip-t1   |  9XXXXXXX      |           |  +1      |           |            |
|  ld10_reg  |  Long Distance 11 Digit without a 9  |  pbx-sip-t1   |  XXXXXXXXXX    |           |          |  1        |            |
--------------------------------------------------------------------------------------------------------------------------------------

Pattern

As you can see above patterns are not limited to just numbers only, but rather can include specific characters to broaden or narrow down the range of types of calls that the routes will take. You are able to use the following characters to help further define a route that is to be taken:

X matches any digit from 0-9
Z matches any digit from 1-9
N matches any digit from 2-9
[1237-9] matches any digit or letter in the brackets (in this example, 1,2,3,7,8,9)
. wildcard, matches one or more characters
! wildcard, matches zero or more characters immediately
[a-z] matches any lower case letter (not frequently used/recommended)
[A-Z] matches any UPPER case letter (not frequently used/recommended)

Replace (processed first)

The replace function will replace a pattern of numbers completely with the defined number included in the replace function.

Example: A number of 518-268-3769 matches the pattern of a route with a replace function set to 5000. Instead of using the 518 number it uses the 5000 number instead plus any of the other functions listed thereafter (such as remove, prepend or postpend)

Remove (processed second)

The remove function will remove numbers from the beginning or end of a pattern dependent on how it is configured. For example a +1, will remove the first digit from a number pattern, whereas -3 would remove the last 3 from a pattern.

Example 1: A number of 518-268-3769 matches the pattern of a Route with a remove of +1, it will will remove the first number of 5, leaving 18-268-3769 (just an example, obviously this is an invalid number, unless it were internal extension)
Example 2: The same number as above matches the Pattern of a Route with a remove of -3. It will remove the last numbers in the sequence leaving a number 5182683 to be dialed (again just an example)

Prepend (processed third)

Prepend will add a specific string of numbers depending on what numbers are defined. In the default routes above many of the numbers are prepended with a 1 to make them valid long distance phone numbers that can be used on the PSTN (public switched telephone network)

Example 1: A number of 518-268-3769 matches a route with a prepend of 1, so it will add the number 1 in front of the string of number so the actual number being used by the trunk handler would be 1-518-268-3769.
Example 2: A number of 268-3769 matches a route with a prepend of 518, so it will add the numbers of 518 in front of the string of numbers so the actual number being used by the trunk handler would be 518-268-3769

Postpend (processed last)

Postpend function the exact opposite of prepend, instead of adding numbers to the beginning of a pattern, it will add numbers to an end of a pattern.

Example: A number of 518-268 matches a route with a postpend of 3769, it will add the numbers of 3769 to the end of the number making the actual numbered dialed out to the trunk handler of 518-268-3769

By using a mix of the above settings you are able to dial in highly specific routes meant to send specific calls to certain places. In the example below we are going to use this route as a means of calling a long distance number when someone is using a 9 dial out number.

vbox-nathan(config-route A_Route)# pattern 9NXXXXXXXXX
vbox-nathan(config-route A_Route)# mangle_remove +1
vbox-nathan(config-route A_Route)# mangle_prepend 1

4) Lastly use the show command to ensure your settings have been saved.

vbox-nathan(config-route A_Route)# show
! Generating running-config
!!
 
! -------------- Routes ----------------
route A_Route
  callerid passthrough
  desc "Local and Long Distance Numbers +9"
  mangle_prepend 1
  mangle_remove +1
  pattern 9NXXXXXXXXX
  record inherit
  trunk_group pbx-sip-t1
  exit
 
exit

Route Settings Description

!	Comments
callerid	Callerid option for when this route is utilized.
desc	(*) Non-functional description of this route.
do	To run exec commands in config mode
exit	Exit from this level (with notification of incomplete config)
mangle_postpend	Number Mangle: Add digits to the end of the dialed destination. This option is processed third.
mangle_prepend	Number Mangle: Add digits to the beginning of the dialed destination. This option is processed second.
mangle_remove	Number Mangle: Remove digits from the dialed destination. This option is processed first.
mange_replace	Number Mangle: Replace the dialed destination with this. (Enabling this option will override all other number mangling options)
no	Clear settings
override_callerid_name	Callerid name to force, if this route is utilized.
override_callerid_number	Callerid number to force, if this route is utilized.
pattern	(*) Pattern to match dialed destination against that will activate this route.
record	Call recording option for when this route is utilized.
show	Show the running-config for the current item
trunk_group	(*) The trunk group that this route will use to dial out.