The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
In Cisco CME 3.2.3 and later versions, a Tcl script is available to provide digit translation for Direct Inward Dial (DID) calls when the DID digits provided by the PSTN Central Office (CO) do not match the digits in the range of Cisco Unified CME extension numbers in the internal dial plan. For example, this script is useful when the CO provides DID digits such as 75 that should map to extension 460.
The Direct Inward Dial Digit Translation Service is described in the following sections:
Note For more information about Cisco IOS voice features, see the entire Cisco IOS Voice Configuration Library—including library preface and glossary, feature documents, and troubleshooting information—at http://www.cisco.com/en/US/docs/ios/12_3/vvf_c/cisco_ios_voice_configuration_library_glossary/vcl.htm.
The Direct Inward Dial Digit Translation Service accepts PSTN DID numbers of any length and maps them to the internal extension numbers that have been assigned by a system administrator. The service also appends a user-specified prefix to the DID digits to complete a valid extension number. The service uses the parameters that you input to determine the valid range of digits to be accepted from the CO, the valid range of digits in the local dial plan, and the prefix to append. The service also handles any DID calls that map to invalid extension numbers by playing a prompt and disconnecting the calls.
When a new DID call is received by the Cisco Unified CME system, the following events occur:
– The service measures the offset of the actual digits received, 62, from the lower limit of the specified CO range, which is 55. The result is the offset from the lower limit, 07.
– This result is then added to the lower limit of the site extension number range, which is 00. The result is the digit string to be used in the extension number, 07.
– The service finally appends the specified prefix, which is 5. The resulting extension number for this call is 507.
Note Do not change the filename of the en_disconnect.au file because the script will be looking for a file with that name.
The purpose of this procedure is to enable the DID Digit Translation Service to automatically transform digits sent from a PSTN CO into the correct digits to form valid extension numbers in your Cisco Unified CME system.
– CO range is 00 to 39, and Cisco Unified CME extension number range is 40 to 79 (both ranges contain 40 numbers and are 2 digits in length)
– CO range is 150 to 199, and Cisco Unified CME extension number range is 245 to 294 (both ranges contain 50 numbers and are 3 digits in length)
4. service [ alternate | default ] did-application-name location
5. paramspace language-package location url
6. paramspace language-package index number
7. paramspace language-package language language-code
9. param secondary-prefix digits
10. param co-did-min min-co-value
11. param co-did-max max-co-value
12. param store-did-min min-site-value
13. param store-did-max max-site-value
16. dial-peer voice tag pots
or
dial-peer voice tag voip
18. Repeat Step 16 through Step 17 for each additional dial peer that will receive incoming calls from the CO.
|
|
|
---|---|---|
|
||
|
||
|
Enters application configuration mode to configure packages and services. |
|
service [ alternate | default ] did-application-name location Router(config-app)# service didapp tftp://192.168.254.254/scripts/did/app-cme-did-2.0.0.0.tcl |
Enters service parameter configuration mode to configure parameters for the digit-translation service.
|
|
paramspace language-package location url Router(config-app-param)# paramspace english location flash: |
Defines the location of audio files that are used for dynamic prompts by an IVR application. |
|
paramspace language-package index number |
Defines the category of audio files that are used for dynamic prompts by an IVR application.
|
|
paramspace language-package language language-code |
Specifies the language for dynamic prompts used by the DID application.
Note This language code must match the two-character language prefix used in the names of your audio prompt files, regardless of the language that is actually used in the files. For more information, see the “Welcome Prompt and Other Audio Files” section in the “Cisco Unified CME Basic Automatic Call Distribution and Auto-Attendant Service” chapter. |
|
|
Sets a prefix to add to the DID digits that are forwarded by the PSTN to create an extension number on the primary Cisco Unified CME router. |
|
param secondary-prefix secondary-prefix |
(Optional) Sets a prefix to add to the DID digits that are forwarded by the PSTN for use with a secondary Cisco Unified CME router. This prefix is used to route calls to the primary Cisco Unified CME router. When there are insufficient DID ports on a Cisco Unified CME router, a secondary Cisco Unified CME router or Cisco IOS gateway can be established to receive DID calls. Incoming DID calls to the secondary router are routed across H.323 to the primary router. The DID Digit Translation Service appends the DID prefix that was set in Step 6 to the incoming DID digits, and then appends a secondary prefix to route the call to the primary Cisco Unified CME router. For example, an incoming DID call is for extension 325. The incoming DID digits from the CO are 25, the DID prefix is 3, and the secondary prefix is 7. The number as transformed by the service is 7325. The transformed number matches a VoIP dial peer that routes the call to the primary router. A translation rule is used to send only the relevant digits, 325, to the primary Cisco Unified CME router for further routing to the extension. |
|
|
Sets the lower boundary of the valid range of digits coming from the PSTN CO. |
|
|
Sets the upper boundary of the valid range of digits coming from the PSTN CO. |
|
param store-did-min min-store-value |
Sets the lower boundary of the range of digits that are valid in the Cisco Unified CME numbering plan. |
|
param store-did-max max-store-value |
Sets the upper boundary of the range of digits that are valid in the Cisco Unified CME numbering plan.
|
|
|
||
|
||
Router(config)# dial-peer voice 234 pots |
||
|
Associates this dial peer with the DID Digit Translation application.
|
|
Repeat Step 16 through Step 17 for each additional dial peer that will receive incoming calls from the CO. |
The following examples are included in this section:
Example: DID Numbers in the Same Range as Extension Numbers
In the following example, the application is named did. A range of DID numbers from 00 to 39 is assigned by the PSTN CO. The range of extensions is from 300 to 339. A prefix of 3 is added to the CO digits, which are forwarded without being changed.
service did tftp://192.168.254.254/scripts/did/app-cme-did-2.0.0.0.tcl
paramspace english language en
paramspace english location tftp://192.168.254.254/apps/dir25/
Example: DID Numbers Not in the Same Range as Extension Numbers
In the following example, the application is named didapp. The range of DID numbers that is sent from the CO is not identical to the range of extension numbers used at the Cisco Unified CME site, so they must be converted by the application. The quantity of numbers in the CO range that you input to the application using the co parameters must equal the quantity of extension numbers in the local site plan, which you also input to the application using the store parameters. The following formula is used to ensure this equality:
co-did-max - co-did-min = store-did-max - store-did-min
In this example, the digits that are provided by the CO fall in the range from 55 to 74. The local site uses extensions in the range from 400 to 419. The formula verifies that these are valid ranges for the script: (74-55) = 19 = (419-400). Note that this formula is used only to verify equality. The actual number of extensions is 20.
To implement the plan in this example, the DID application is given a prefix digit of 4 and the range parameters shown in the following example. Note that the number of digits in the minimum-maximum digit strings is the same (2) for the CO and for the site commands.
In the following example, the application is called didapp. Calls are received by a secondary Cisco Unified CME router and are sent to the primary Cisco Unified CME router, which is identified in the session target command under dial peer 1000. The prefix 5 is appended to two incoming digits from the CO to create an extension number. The secondary prefix 4 is then appended to the resulting extension number to route the call to the H.323 VoIP dial peer. The dial peer uses a translation rule to forward only the three relevant digits, (the extension number) to the primary router. For more information about translation rules, see the “ Voice Translation Rules ” technical note at http://www.cisco.com/en/US/tech/tk652/tk90/technologies_tech_note09186a0080325e8e.shtml.
service didapp tftp://192.168.254.254/scripts/did/app-cme-did-2.0.0.0.tcl
paramspace english language en
paramspace english location tftp://192.168.254.254/apps/dir25/
voice translation-profile drop-secondary-prefix
translation-profile outgoing drop-secondary-prefix