VOS3000 how-to

VOS3000 rewrite rules and dial plans

Change the numbers your switch sends and receives, and control which numbers a gateway accepts.

Updated · By the VOS3000 Web team

Quick answer: A VOS3000 rewrite rule (dial plan) is a comma-separated list of initial:destination pairs: when a number starts with the initial prefix, VOS3000 replaces it with the destination prefix. For example 00: removes a leading 00 and 0:44 turns a leading 0 into 44. Set them in a gateway's Additional Settings, on the Mapping prefix or Routing prefix tab.

Format
initial:destination, separated by commas
Where
Additional Settings, Mapping or Routing prefix tab
Prefix lists
Allow or Forbidden, comma-separated
Number length
Others tab, Number limit

Where they are

Open a gateway's Additional Settings (the sliders icon in the gateway list in VOS3000 Web, or the Additional settings column in the desktop client).

  • Mapping gateway, Mapping prefix tab: Mapping caller prefix, Mapping callee prefix, Caller Rewrite Rule/Dial plan and Callee Rewrite Rule/Dial plan.
  • Routing gateway, Routing prefix tab: Routing caller prefix, Routing callee prefix, Forwarding prefix, Call restriction on caller, and Caller and Callee Rewrite Rule/Dial plan.

The rewrite rule format

A rewrite rule (dial plan) is a list of pairs: an initial prefix and a destination prefix, written initial:destination. Pairs are separated by commas. When a number starts with the initial prefix, that prefix is replaced by the destination prefix.

RuleEffect
00:Removes a leading 00: 0044207… becomes 44207…
:44Adds 44 in front of every number.
0:44Replaces a leading 0 with 44: 0207… becomes 44207…
00:,1:001Two rules: removes a leading 00, and replaces a leading 1 with 001.

In VOS3000 Web, click the … button next to the field to edit the rules as a table with Initial prefix and Destination prefix columns, and Add, Delete, Copy and Paste buttons. The panel writes the comma-separated text for you.

Use caller rules to change the calling number (CLI), for example to add a country code, and callee rules to change the called number, for example to strip a carrier's technical prefix.

Prefix lists: Allow or Forbidden

Each prefix list (Mapping caller prefix, Mapping callee prefix, Routing caller prefix, Routing callee prefix, Forwarding prefix) is a comma-separated list of number prefixes with an Allow or Forbidden switch. Allow means only numbers starting with one of the prefixes pass; Forbidden means those numbers are refused. In the editor each prefix is one row.

Call restriction on caller

On a routing gateway, Call restriction on caller takes pairs of caller and callee prefixes, written caller:callee and separated by commas, with an Allow or Forbidden switch. For example 025:010,021:023.

Number length limits

On the Others tab, Number limit sets the caller and callee number lengths a gateway accepts. Leave it empty for any length, enter lengths like 11,12, or a range like 10-13. Lengths from 1 to 31 are possible. Calls with other lengths are refused, usually with NumberLengthRestricted (-35).

Test your rules

After saving, make a test call and open it in Recent CDR: the Caller and Callee columns show the numbers as VOS3000 handled them. Calls refused by a prefix list end with reasons like CallerPrefixRestricted (-32) or CalleePrefixRestricted (-29); see termination reasons.

Questions about this topic

How do I remove a prefix in VOS3000?

Add a rewrite rule with the prefix as the initial part and nothing as the destination, for example 00: to remove a leading 00.

How do I add a prefix to every number?

Use a rule with an empty initial part, for example :44 adds 44 in front of every number.

What is the difference between Allow and Forbidden?

Allow lets only numbers that start with a listed prefix through. Forbidden refuses numbers that start with a listed prefix.

Try every step in the live demo

Each screen in this guide is in the VOS3000 Web demo, with made-up data. Sign in with demo / demo.