VOS3000 how-to

VOS3000 routing order and LCR

When several carriers can take a call, this is how VOS3000 decides which one to try first, and when it moves on to the next.

Updated · By the VOS3000 Web team

Quick answer: VOS3000 picks a routing gateway by the longest matching prefix, then prefix priority, then gateway priority (smaller is first), then line usage, then calls made today, then gateway ID. Real-time ASR and lowest rate per second can be added to that order. If a gateway fails, VOS3000 tries the next one, unless the callee was busy or audio had already started.

First rule
Longest matching prefix
Priority
Smaller number is tried first
Optional sorting
Real-time ASR, lowest rate per second
Failover stops on
Busy callee, RTP started, SDP received

The default order

For each call, VOS3000 builds a list of routing gateways whose prefix matches the called number, then sorts it. From the VOS3000 2.1.9.07 manual:

  1. Routing strategy: if the mapping gateway or the calling phone has a First routing strategy or Second routing strategy (ASR or Lowest rate per second), that comes first.
  2. Longest prefix: a gateway with prefix 4420 beats one with 44.
  3. Prefix priority of the routing gateway.
  4. Gateway priority: the smaller number is tried first.
  5. Line usage: the less busy gateway first.
  6. Calls today: the gateway with fewer calls so far today.
  7. Gateway ID.

So for simple failover, give your main carrier priority 1 and the backup priority 2 with the same prefix.

Sorting by quality (ASR)

Turn on Calculate routing quality in real time on a routing gateway, in VOS3000 Web or the desktop client, and VOS3000 tracks its ASR over a sliding window. By default the window is 600 seconds in 10 slices (SS_GATEWAY_ASR_RESERVE_TIME and SS_GATEWAY_ASR_RESERVE_SEPARATE), so each slice is 60 seconds and the ASR is the average of the last 10. SS_GATEWAY_ASR_ROUTE_SORT_CONFIG decides where ASR is placed in the order: before line usage (the default), or later, before gateway ID. Check your numbers with the ASR and ACD calculator.

Least cost routing (LCR)

Sort by lowest rate per second on a routing gateway sorts by what that carrier costs for the number. SS_GATEWAY_FEE_RATE_ROUTE_SORT_CONFIG places it in the order, and SS_GATEWAY_FEE_RATE_ROUTE_BEFORE_ASR decides whether rate beats ASR when both are on. For LCR to be right, every routing gateway needs an up-to-date vendor rate; see VOS3000 rates.

Two more routing gateway options protect your margin: Check rate only tries the gateway if the call has a clearing rate, and Lowest profit rate limit locks the gateway when the profit on a call would fall below your limit.

Protect routes

A routing gateway marked Set to protect route is kept out of the normal sorting. VOS3000 uses it only when the normal gateways fail to connect, or when a call is still not connected after the Protect route enable time (seconds). Use it for an expensive but reliable backup carrier.

When VOS3000 tries the next gateway

If a gateway rejects a call or does not answer in time, VOS3000 tries the next in the list, with these exceptions, all on by default:

  • Callee busy stop switch (SS_GATEWAY_SWITCH_STOP_AFTER_USER_BUSY): a busy callee stops the search.
  • Stop switch gateway when RTP start: once audio has started from a carrier (with media proxy on), VOS3000 does not move on.
  • SS_SIP_STOP_SWITCH_AFTER_SDP: once a SIP carrier has sent SDP (for example in 183 Session Progress), VOS3000 does not move on.

Switch gateway until connect (off by default) keeps trying until a 200 OK, except after busy or RTP start. SS_GATEWAY_SWITCH_LIMIT caps how many gateways one call may try. If no gateway is left, the call ends with a reason such as NoAvailableRouter; look it up in the termination reason lookup.

Questions about this topic

How does VOS3000 choose a routing gateway?

Longest matching prefix first, then prefix priority, then gateway priority, then line usage, then calls made today, then gateway ID. Real-time ASR and lowest rate can be added to the order.

Is a lower or higher priority number tried first?

A lower number. Priority 1 is tried before priority 2.

How do I set up least cost routing (LCR) in VOS3000?

Give each routing gateway its vendor rate and turn on Sort by lowest rate per second, or set the mapping gateway's routing strategy to Lowest rate per second.

Why does VOS3000 not try the next gateway after a busy signal?

Callee busy stop switch is on by default: a busy callee is busy on every route, so VOS3000 stops there.

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.