3Com Nbx 100 And Ss3 Nbx Administration Guide

							Dial Plan Pretranslators41
Pretranslators for
Incoming CallsFor incoming calls, pretranslation reformats the dialed number before it is 
passed to the Incoming dial plan table (Table ID 2). See “Incoming Dial 
Plan Table” later in this chapter.
Incoming Pretranslator Example 1
If, for an incoming telephone call, the telephone company passes you 
4-digit numbers from 6100 through 6199, the system can use a 
pretranslator to remove the first digit; the remaining 3 digits can then be 
used as internal extension numbers in a 3-digit dial plan. Tell the system 
which pretranslations you want to perform by defining digit manipulation 
operations (append, prepend, replace, stripLead, or stripTrail) within the 
PreTranslator section of the dial plan configuration file.
Incoming Pretranslator Example 2
Assume the telephone company passes 10-digit numbers to the system 
for each incoming telephone call (for example, numbers in the range 
4567-89-3000 to 4567-89-3500). If the system uses 4-digit extensions in 
the range 2000 to 2500, you could pass an incoming 10-digit number 
such as 4567-89-3210 to extension 2210.
This strategy requires two pretranslation operations: The first operation 
performs a stripLead operation to remove the initial 7 digits, leaving 210. 
The second operation prepends the number 2 in front of the remaining 3 
digits. The result is 2210, which matches an extension within the 
extension range. “Sample Solutions Using Dial Plan Configuration File 
Commands” later in this chapter shows how to accomplish this 
pretranslation using the dial plan configuration file.
Each device can specify only one DDI/DID pretranslator and one CLIP 
pretranslator. To create or modify a pretranslator, you either edit a dial 
plan configuration file and import it, or use the NBX NetSet utility and 
modify an existing dial plan configuration file.
The system performs operations in ascending order of operation ID. 
Operations are both sequential and cumulative.
You can also use pretranslators with virtual tie lines to link multiple 
NBX systems. Incoming calls within a defined numeric range arrive at the 
first system, are modified through digit manipulation operations, and are 
then routed to a tie line connected to a second system.
Each sample dial plan that is shipped with the system includes a default 
pretranslator. 
						

							42CHAPTER 2: DIAL PLAN
Pretranslator Example 3
Assume that the telephone company passes 4-digit numbers to the 
system for each incoming telephone call (for example, numbers in the 
range 5200 through 5300). If the system uses 3-digit extensions in the 
range 200 through 300, you could define a single pretranslation 
operation to stripLead (remove) the first digit, for instance, the number 5 
from an incoming number such as 5278, and pass the call to extension 
278. “Sample Solutions Using Dial Plan Configuration File Commands”
 
later in this chapter shows how to accomplish this pretranslation using 
the dial plan configuration file.
Pretranslators for
Certain
Outgoing CallsOn outgoing calls using an ISDN PRI card, pretranslators allow the 
external called party to identify the full number of the internal calling 
party, including the area code. For example, if the person on extension 
101 within a company calls an external number, the caller’s entire number 
is displayed to the called party when Calling Line ID Presentation (CLIP) 
pretranslators are used. Pretranslation reformats the outgoing dialed 
number before it is passed to the Internal dial plan table (Table ID 1) or 
possibly the Least Cost Routing table (Table ID 3). For more information, 
see “Internal Dial Plan Table”
 and “Least Cost Routing Dial Plan Table” 
later in this chapter.
Example: If the DDI/DID telephone numbers range from 508-555-4200 
through 508-555-4299, internally, you dial extensions from 2000 
through 2099 to reach another internal telephone.
When you place a call to an external telephone number, the system can 
use these pretranslator steps to create the full 10-digit number:
1Remove (stripLead) the first two digits (20) from the internal extension 
number of the telephone making the call.
2Add (prepend) the digit sequence 50855542 to the two remaining digits, 
creating the full DDI/DID telephone number. 
3Pass the full number to the telephone company.
Example: To transmit Calling Line ID Presentation (CLIP) information on 
outgoing calls, you can define a pretranslator that transforms internal 
extensions into full telephone numbers (the numbers that someone 
external to the company uses to dial in). Assume that you are using 
telephone extension numbers from 1000 to 1099 and that only the last 
two digits match the DDI/DID (Direct Inward Dial/Direct Dial Inward) 
numbers that are assigned to the company. You can define a  
						

							Managing the Dial Plan Configuration File43
pretranslator to remove (stripLead) the first two digits from the internal 
extension number and add (prepend) the appropriate digit string. This 
pretranslator constructs the full telephone number.
Example: If you use two different long-distance carriers at different times 
of the day to save costs, you can prepend different digit sequences to the 
outgoing dialed number to select which carrier you want. If you prepend 
1010321 between the time the business opens and 3:00 p.m., you select 
one long-distance carrier. If you prepend 1010220 from 3:00 p.m. until 
the next time the business opens (including weekends), you select the 
other carrier and obtain a lower rate.
To tell the system which outgoing pretranslations you want to perform, 
you define digit manipulation operations (append, prepend, replace, 
stripLead, or stripTrail) in the Routes section of the dial plan configuration 
file. You can define these commands for both destination routes and 
timed routes. For more information on configuring pretranslators, see 
“Managing Dial Plan Pretranslators”
 later in this chapter.
Managing 
the Dial Plan 
Configuration FileThis section describes the dial plan configuration file and how to manage 
it. From the Operations tab of the Dial Plan window, you can perform 
these tasks:
■Accessing the Dial Plan
■Creating Dial Plan Configuration Files
■Importing and Exporting Dial Plan Configuration Files
■Importing a User-Defined Dial Plan
■Exporting (Saving) a Dial Plan Configuration File
■Testing a Dial Plan
■Generating a Dial Plan Report
■Modifying a Dial Plan Configuration File 
						

							44CHAPTER 2: DIAL PLAN
Accessing the
Dial PlanTo import a dial plan configuration file and modify it, select NBX NetSet 
> Dial Plan > Operations (Figure 3
). From this tab, you can access 
customer-defined and default dial plans.
Figure 3   Dial Plan Operations Tab
Creating Dial Plan
Configuration FilesThe simplest way to create a new dial plan is to model it after an 
existing one.
1Go to the Operations tab (Figure 3
).
2Browse for a dial plan, or select one from the pull-down list.
3Click Open to open the file in your browser.
4Click Save As and save the dial plan as a new file.
You can now edit the file with an ASCII editor. After you customize the 
new dial plan, Import it to the NBX system. see “Importing and Exporting 
Dial Plan Configuration Files” later in this chapter.
3Com recommends that you enter these commands at the top of every 
dial plan configuration file:
Table Delete *
DestinationRoute Delete *
TimedRoute Delete *
PreTranslator Delete *
When you subsequently import this dial plan, these commands purge any 
traces of the old dial plan and prevent any conflicts that can result from 
importing one dial plan on top of an existing one. 
						

							Managing the Dial Plan Configuration File45
You create new entries in the dial plan configuration file by typing in new 
commands (see “Dial Plan Configuration File Commands” 
later in this 
chapter) or by cutting, pasting and editing existing lines in the file.
When you cut and paste new lines into dial plan tables, be sure to change 
the Entry number in the pasted line. If two or more lines have the same 
Entry number, the NBX system replaces the first one with the second; 
therefore, only the last one takes effect.
Importing and
Exporting Dial Plan
Configuration FilesYou import a dial plan configuration file either to implement changes you 
have made by editing the file, or to reload a previously saved 
configuration.
From the Operations tab of the Dial Plan window, you can:
■Import a North American Dial Plan
■Import an International Dial Plan
This section concludes with a discussion of:
■International Dial Plan Issues
When you export the working dial plan, the NBX system constructs a new 
configuration file from the values in the database and displays it. The new 
file shows the current date and time. You name the file when you save it.
The sample default files include examples of such things as timed routes 
and pretranslators. To preserve the default (sample) dial plan 
configuration included with the system, 3Com advises you to choose a 
unique file name different than any of the default (sample) dial plan 
configuration files so that you do not overwrite the sample default files.
Import a North American Dial Plan 
The default dial plan for the SuperStack 3 NBX system is 
NorthAmerica-4-digit.txt. The default dial plan for the NBX 100 
system is 
NorthAmerica.txt. Some customized dial plans are provided 
for use in other countries.
Always read the system Release Notes (called 
readme.txt) for the most 
up-to-date information on dial plans. 
						

							46CHAPTER 2: DIAL PLAN
To import a default dial plan configuration file:
1In the NBX NetSet – Main Menu window, click Dial Plan. The Dial Plan 
window appears, displaying the Operations tab (Figure 3
).
2Click the 
Default File radio button. From the Default File pull-down list, 
select the default file that you want to use.
3Click 
Import.
4Reboot the system.
CAUTION:When you import a dial plan configuration file, the 
NBX system immediately implements the dial plan. You are always 
warned that the system may become inoperative. The system becomes 
inoperative only if you have manually modified a dial plan and have 
made syntax or content errors. Carefully check any changes that you 
make to the configuration file before you import.
Import an International Dial Plan 
To change the default North American dial plan to a country-specific dial 
plan:
1In the NBX NetSet – Main Menu window, click Dial Plan. The Dial Plan 
window appears, displaying the Operations tab (Figure 3
).
2Click the 
Default File radio button.
3In the list next to the Default File button, select the default file that you 
want to use.
4Click 
Import.
CAUTION:When you import a dial plan configuration file, a message 
warns you that the dial plan may become inoperative. The system 
becomes inoperative only if you have manually modified a dial plan and 
have made syntax or content errors. Carefully check any changes that you 
make to the configuration file before you import.
5Click Ye s. The system imports the new dial plan and produces a report of 
any errors. 
6Reboot the system.
You may see a warning that “destination extension list is empty.” This 
means that a particular type of device is not installed. You may safely 
ignore this type of warning. 
						

							Managing the Dial Plan Configuration File47
International Dial Plan Issues
Several international dial plan issues warrant attention. See these topics:
Customizing an International Dial Plan.If there is no customized 
dial plan for your country, you may need to modify the default dial plan. 
See “Modifying a Dial Plan Configuration File”
 later in this chapter.
If you make changes to the default dial plan, you can test them by 
making a simulated call. See “Testing a Dial Plan”
 later in this chapter.
Autodiscovering Internal Telephones.The default dial plan for the 
NBX 100 allows you to allocate internal telephones to extension numbers 
100 through 449. The default dial plan for the SuperStack 3 NBX system 
allows you to allocate internal telephones to extension numbers 1000 
through 3999. If you are autodiscovering your company’s internal 
telephones, Auto Discovery usually begins at number 100 or 1000. 
However, for some countries, internal telephones begin at a higher 
number to allow you to directly dial numbers of “national importance.” 
Auto Discovery allocates telephone extensions numbers within this range. 
For more information on Auto Discovery, see “Using Auto Discovery for 
Initial System Configuration” in the NBX Installation Guide.
Dialing Outside Lines.To obtain an outside line, dial 9 or 0 as 
appropriate for your country.
WARNING:You must first obtain an outside line before you can dial 
emergency numbers. 
Importing a
User-Defined Dial PlanTo import a customer-defined (user-defined) dial plan configuration file:
1In the NBX NetSet – Main Menu window, click Dial Plan. The Dial Plan 
window appears, displaying the Operations tab (Figure 3
).
2In the field to the right of the User-Defined File radio button, enter the 
path and name of the user-defined configuration file, or click 
Browse to 
find the file that you want.
The NBX system has no predefined location for dial plan configuration 
files. You can specify any directory or path that you want.
3Click 
Import and reboot the system. 
						

							48CHAPTER 2: DIAL PLAN
CAUTION:When you import a dial plan configuration file, the 
NBX system immediately implements the dial plan. You are always 
warned that the system may become inoperative. The system becomes 
inoperative only if you have manually modified a dial plan and have 
made syntax or content errors. Carefully check any changes that you 
make to the configuration file before you import them.
Exporting
(Saving) a Dial Plan
Configuration FileWhen you export (save) the current configuration, the system creates 
a new dial plan configuration file from the current database. You save the 
new text file using a name that you choose.
This example refers to Internet Explorer. If you use another browser, you 
may need to use slightly different procedures.
To export a dial plan configuration file:
1In the NBX NetSet – Main Menu window, click Dial Plan. The Dial Plan 
window appears, displaying the Operations tab (Figure 3
).
2Click 
Export. The system constructs a new configuration file from the 
current values in the database and displays it. Figure 4
 shows a partial 
display. Scroll your browser window to see your complete dial plan.
Figure 4   Dial Plan Configuration File (partial)
3Click the File menu and select Save As. 
						

							Managing the Dial Plan Configuration File49
4From the list box at the top of the Save As window, select the destination 
folder.
5In the File Name text box, replace the default file name with a new name.
The sample default files include examples of such things as timed routes 
and pretranslators. Verify that you rename the new configuration file with 
a unique file name so that you do not overwrite the sample default file.
6Click Save.
Testing a Dial PlanThis section describes how to test the currently loaded dial plan by 
placing a simulated call. 
Even if the NBX system is completely installed and operational, a test 
places a simulated, not an actual call.
Example: If you have an entry in the dial plan for digit sequences starting 
with 91, with MIN and MAX set to 5, and you test the sequence 9123, 
the dial plan test reports an insufficient number of digits. However, in 
actual operation, the NBX system would time out waiting for the fifth 
digit, and then attempt to place the call. Assuming that the outside line 
prefix is 9 (such as in the United States), this situation would obtain an 
outside line (9) and then dial the numbers 123.
You can specify a day of the week and a time by selecting entries from 
the Day/Time list boxes (Figure 5
). This choice instructs the system to act 
as if the day and time you select are the current day and time.
If you have timed routes defined in the dial plan, you use different day 
and time settings to determine whether the timed route works properly.
Example: Assume that you want a timed route to select route 35 during 
open business hours Monday through Friday, but route 36 when business 
is closed on those days and on weekends. After you define the timed 
route commands and import the modified file, you then test using days 
and times within business hours (to verify that the system selects route 35) 
and during closed hours and weekends (to verify that it selects route 36).
You can also use day and time settings to test whether the Class of 
Service settings operate as expected.
Example: You can configure the dial plan to allow toll calls from an 
extension during open business hours, but to disallow such calls when 
the business is closed and on weekends. Test using days and times within  
						

							50CHAPTER 2: DIAL PLAN
business hours (to confirm that you can make toll calls from that 
extension) and during closed hours and weekends (to confirm that the 
system prevents such calls).
To create and run a test using the currently loaded dial plan:
1In the NBX NetSet – Main Menu window, click Dial Plan. The Dial Plan 
window appears, displaying the Operations tab (Figure 3
).
2Click 
Te s t. The Te s t Dial Plan dialog box appears (Figure 5).
Figure 5   Test Dial Plan Dialog Box
3To set up the simulated call, from the Device to dial from list box, select 
the number from which you want to dial.
4In Number to dial, enter the number that you want the system to dial.
5Select the desired date and time in the Day/Time pull-down lists.
For some tests, the day and time settings are irrelevant. You can leave the 
settings at their default values (Sunday, 00, and 00).
6Click Te s t. The test runs and the results appear in the dialog box 
(Figure 6
). If the test results extend beyond the borders of the window, 
move the scroll bars at the bottom and to the right of the window to see 
the additional text.