UserProgramDialPlan

Description

This feature is for special cases only. For most situations, setting the DialPlanCountry value is sufficient to establish Dial Plan settings. The UserProgramDialPlan is activated when DialPlanCountry is set to Custom (99).

The User Program Dial Plan (UPDP) feature lets you customize the way the Tenor reads and sends the sequence of digits that you enter to make a call. Once you have exposed the parameter by selecting a Custom Dial Plan, you may start adding dialing patterns so that the Tenor can identify specific sequences of digits, and treat them according to your specification. In general, the dial plan defines which sequences of digits will be recognized by the Tenor as valid dial strings, suitable to send through the network (e.g., 555-1212, 1-408-555-1212, 011 46 8 1234 1234).

When you enable the UPDP and do a show command in the CLI, you see the following table. Click on the links in the table to jump to a definition of that parameter.

   UserProgramDialPlanENtry Table

   index Pattern        Type MINDigit MAXDigit PrefixLen AddPrefix

   ----- -------------- ---- -------- -------- --------- ---------

   1     0112~9         1    10       18       1

   2     2~9            2    7        11       0

   3     0~9            3    3        13       1

   4     1~9            7    3        4        0

Guidelines

Once you enable the UPDP feature, all Dial Plan information is controlled by the UPDP feature only; the other Dial Plan settings are ignored. However, the Country Code and Area Code still participate in constructing the E.164 Normalized number.

Specifically, the following parameters are ignored: MINDNlength, MAXDNlength, CarrierPrefixPattern, IPRoutePrefix, PSTNRoutePrefix, MultipathPrefix, IntercomPrefix, CentrexPrefix.

The parameters LongDistanceprefix and INTernationaLPrefix are still used in case of number normalization or an autoswitch number.

A dialing plan consists of the following elements:

• Number Pattern - Used to define a dial plan format, such as E.164 prefix (long distance, local, international, etc.), PBX extension number, special code, etc. Maximum of 15 digits. Valid entry is 0-9, and '~' (indicates a range, for example, 192~9 means, 192, 193, 194, 195, 196, 197, 198, 199). For Type 6 and 8, the number entered must have a # or * before the digits AND a # or * after the digits (example #31*). For all the other types, only a # or * before the pattern entered works. An error results if a # or * is entered after the pattern for the other types.

• Type of Number - A digit from 1-8 and 14 may be used as a value. The different types of DN sequences are:
  
  0 - Unknown - In this case, the number will be analyzed by the full DialPlan, just as it if were entered manually. This is the most common.
  
  1 - International - Designates an international dial plan.
  
  2 - Long Distance (National) - Designates that this pattern is supported within the domestic long distance calling area, but not internationally.
  
  3 - Carrier Selection Prefixes - Designates a carrier (e.g., Verizon); used mostly for connecting to an LD service provider.
  
  4 - Local - Designates that the dial plan is supported within the local calling area.
  
  5 - Special Service - Designates a Special Service, other than international, long distance, local, carrier selection.
  
  6 - Supplementary Service 1 - Designates Supplementary services, such as call waiting, call forwarding, call transfer, call forwarding, 3 way call, conference call etc. All supplementary services have individual "codes" provided by the Central Office. You can start any of these services by entering type 6 followed by the activation or termination code. An activation code will turn on the service. For example, type *xx# or #xx# where xx indicates the number that corresponds to the service. For example, to turn on call waiting, type 6 *31#.
  
  7 - Private -  If UPDP is selected and a private number is activated, UPDP becomes the dial plan used for the Tenor. To activate a private number using UPDP, ensure the private option is enabled (1), and the private DN is defined.
  
  8 - Supplementary Service 2 - The difference between Supplementary service 1 and 2 types is that in the case of type 1 the digits will be sent immediately, but type 2 service waits for the next digit to be entered. The next DP should be registered in the same dial plan.
  
  14 - Local Prefix - When this type is specified, it means that the local area codes are known. The 3-digit area code can be used as a prefix for the UPDP to indicate they will be followed by 7 digits to form a 10-digit number. If the first 3 digits can be taken as a whole in determining the matching criteria, then there should be no confusion or overlap between 7- and 10-digit calls, provided the 7-digit calls never have the same first 3 digits as the area code(s). The maximum Pattern Length for this type is 5. Type 14 accepts Pattern, Type, MinD, and MaxD. MinD and MaxD should be an exact length of the Pattern, or the default of 0. Otherwise, it is rejected. PrefixLength and AddPrefix are not allowed.
  
  100 - This is a non-Nortel type, allowing the use of the AddPrefix function for non-Nortel (or perhaps Nortel SIP) applications that might need this functionality.
  
  101-120 - These types match Nortel TONs 1-20.

• Minimum Digit - Defines a minimum number of digits to receive; once this limit is met, the string can be sent. This setting is optional. If you enter less than the minimum and the interdigit timer expires, a fast busy tone will be heard. If pattern length is same as min_digit, this field is not required. Min_digit must be equal to or greater than pattern length.

• Maximum Digit - Defines a maximum number of digits to receive. This setting is optional. If max_digit is same as min_digit, this field is not required. Max_digit must be larger than min_digit. Once this number of digits is met, the Tenor will stop receiving characters immediately and send the string.

• Prefix Length - Defines a number of prefix digits to delete. If this field is not set, it is set to the default value as follows:

• • pattern length (international)

  • 1 (long distance)

  • 0 (local)

  • 0 (special service)

  • pattern length (carrier selection)

The default value will cover most cases except for some international dial plans. For example, in China, the international dial plan is 001-009. If the PSTN requests the last digit (1-9) to select a service provider, the prefix number is 2. Otherwise, prefix number is 3, which means three digits will be deleted.

• Add Prefix - Allows for a prefix to be added to the number, after other number manipulation is performed, and after stripping the dialed prefix. This field takes a digit, * or #, has a maximum of 16 characters, and the default is blank. This is required for compatibility with some Nortel networks.

Related Topics

DialPlanCountry

ProgressToneCountry

MINDNlength

MAXDNlength

CarrierPrefixPattern

IPRoutePrefix

PSTNRoutePrefix

MultipathPrefix

IntercomPrefix

CentrexPrefix

LongDistancePrefix

INTnternationaLPrefix

Location

Systemwide Configuration > Dial Plan > Dial Plan Country [Set to Custom] > UPDP tab > Add button

Options

Click Add over the table to display the Add User Programmable Dial Plan Entry dialog box. You can specify the following modifiers:

• Number Pattern

• Type of Number

• Minimum Digit

• Maximum Digit

• Prefix Length

• Add Prefix

Click OK to accept the definition.

Once you have added a dial plan, you can select it and click Edit to modify or Delete to remove it from the table.

Cmd Type

Command

Prompt Level

config-DialPlan-1# set country 99

config-DialPlan-1* updp

config UserProgramDialPlan-1*

Syntax

add {Pattern} t {Type} [mind {MINDigit} maxd {MAXDigit} pl {PrefixLength}]

Arguments

Pattern

Required parameter. Maximum of 15 digits. Valid entry is 0-9, and '~' (indicates a range, for example, 192~9 means, 192, 193, 194, 195, 196, 197, 198, 199). For Type 6 and 8, the number entered must have a # or * before the digits AND a # or * after the digits (example #31*).  For all the other types, only a # or * before the pattern entered works.  An error results if a # or * is entered after the pattern for the other types

Type

Required parameter. A single digit from 1-8 may be used as a value. Values are defined as follows:

0   Unknown

1   International

Example: for 011862145643908 (China) -> use  0112~9

2   National

Example: 17324609000 (US)

3   Carrier Selection

Example: 1010321

4   Local

Example: 4609000

5   Special Service

Example: 911

6   Supplementary service 1

Example: *31# or #31#

7   Private

Example: 13202

8   Supplementary service 2

Example: *31* + other DP

14  Local Prefix

Example: 847

100   Allows use of AddPrefix for non-Nortel applcations.

101-120   Matches Nortel TONs 1-20.

MINDigit

Optional parameter. If you enter less than the minimum and the interdigit timer expires, a fast busy tone will be heard. If pattern length is same as min_digit, this field is not required. Min_digit must be equal to or greater than pattern length.

MAXDigit

Optional parameter. If max_digit is same as min_digit, this field is not required. Max_digit must be larger than min_digit. Once this number of digits is met, the Tenor will stop receiving characters immediately and send the string.

PrefixLength

Defines a number of prefix digits to delete. If this field is not set, it is set to the default value as follows:

• pattern length (international)

• 1 (long distance)

• 0 (local)

• 0 (special service)

• pattern length (carrier selection)

The default value will cover most cases except for some international dial plans. For example, in China, the international dial plan is 001-009. If the PSTN requests the last digit (1-9) to select a service provider, the prefix number is 2. Otherwise, prefix number is 3, which means three digits will be deleted.

AddPrefix

Allows for a prefix to be added to the number, after other number manipulation is performed, and after stripping the dialed prefix. This is required for compatibility with some Nortel networks.

Examples

config-UserProgamDialPlan-1* add 2~9 t 4 mind 7

Local number, 2-9 dial plan format, 7 digit minimum number. This means that all local numbers will be 7 digits maximum and will begin with any digit 2-9.

config-UserProgamDialPlan-1*add 12~9 2 p mind 11 maxd 11

Long distance number, 12-9 dial plan format, 11 digits minimum & maximum. This means that all long distance numbers will be 11 digits long, and must begin with the digit 1, followed by any digit 2 through 9 as the second digit.

config-UserProgamDialPlan-1* add 0112~9 1 p mind 10 maxd 18 pl 3

International Number, 0112-9 dial plan format, 10 digit minimum number, 18 digit maximum number, 3 prefix digits will be deleted. This means that all international numbers will be no less than 10 digits and no more than 18, must always begin with 011, followed by a digit 2-9 as the 4th digit and the first 3 digits (011) are to be deleted to meet the E.164 format.