CCME How To - Dial-peer digit manipulation using Translation Profiles

To learn more about this tutorial contact us info_ipmax@ipmax.it
or visit our site www.ipmax.it/support WWW.IPMAX.IT
Dial Peers
Digit manipulation
using
Translation Profiles
CISCO
Call Manager Express 8.6

1. Application enviroment
Here are some of the most common reasons for which it is required the digits manipulation:
• To translate a full PSTN number (eg an10 digits E.164 number) to an extension shorter so that the internal and external calls can be
made to a single extension.
• To ensure that users dial an access code for PSTN calls (the classic 0). Then this access code must be removed before forwarding
the call over the PSTN.
• Block calls to specific numbers.
• To redirect calls to specific numbers.
The CCME has several methods to manipulate digits. The next section will cover the digit manipulation by the command:
translation-profile.
Dial-Peer digit manipulation using Translation Profiles
Cisco Call manager Express 8.6
CCME
01

Translation profiles work similarly to the access control lists (ACLs) on a router.
• Your first task is to create the voice-translation rule with a unique tag for identification.
• Every voice translation-rule can contain up to 15 rules.
• The next step is to create a voice-translation profile and set the rules to be used for the numbers called or callers.
• Finally, the voice translation-profile is applied to the dial-peer PSTN or VoIP. If desired, it can also be set globally on the voice
gateway. This profile can be applied to incoming or outgoing on the dial-peer.
CCME
02
1. Application enviroment

• Translation profiles are extremely flexible.
• They can be used to provide more granular control of scenarios change compared to other tools of manipulation of figures.
03
2. Implementation
The following example creates the translation rule 1:
CME#
CME#configure terminal
Enter configuration commands, one per line. End with CNTL/Z
CME(config)#voice translation-rule 1
CME(cfg-translation-rule)#
At this point you are in cfg-translation-rule mod

I make a premise
We subscribed with our telephone operator, DID (Direc Inward Dial) for the numbers:
02.92.90.91-00 02.92.90.91-99
Here in Italy are permitted numbers with variable length.
I.e. the numbers: 2.92.90.91.7 & 2.92.90.91.07 are identical. All indicate the extension 07.
The correct syntax of a translation rule is:
rule <1-15> / numeric string to be checked / / numeric string to replace /
The following rules allow you to convert penultimate and / or the last digit of a call from PSTN, in a new three digit number, in the range
1xx.
04
CME(cfg-translation-rule)# rule 5 /^2929091([0-9])$/ /101/
CME(cfg-translation-rule)# rule 10 /^2929091(.*)$/ /11/
CME(cfg-translation-rule)# exit
CME(config)# exit
CME#
2. Implementation

To be clear, we test the voice translation-rule 1 with the command:
test voice translation-rule <1-15> <number to be tested>
05
CME#test voice translation-rule 1 29290911
Matched with rule 5
Original number: 29290911 Translated number: 101
Original number type: none Translated number type: none
Original number plan: none Translated number plan: none
Matched with rule 10
Matched with rule 10
Depending on the length of the called number the voice translation-rule 1 will pass the rule between 5 and 10, while maintaining the
conversion to three digits for internal numbering.
2. Implementation

To complete the configuration, the voice translation-rule 1 must be activated within a translation-profile as follows:
06
CME(config)# voice translation-profile PSTN-IN
CME(cfg-translation-profile)# translate called 1
CME(cfg-translation-profile)# exit
CME(config)# exit
CME#
Above the translation rule 1 is activated for incoming calls (parameter "called") in the translation-profile tagged PSTN-IN.
CME(config)# dial-peer voice 10 pots
CME(config-dial-peer)# translation-profile incoming PSTN-IN
CME(config-dial-peer)# incoming called-number 292909T
CME(config-dial-peer)# direct-inward-dial
CME(config-dial-peer)# exit
CME(config)# exit
CME#
The dial-peer 10 will activate whenever the CCME receive an incoming call ("incoming") containing the numbers 292909nnx.
Finally we are able to receive calls on our CCME and then deliver the call properly inward desired!
Now the translation profile must be associated with a POTS dial-peer. Here 10.
2. Implementation

The following commands are used to start the debug and verify the correct procedures:
CME#
CME#debug isdn q931
debug isdn q931 is ON.
CME#
CME#debug voice translation
VoIP Translation Rule debugging is enabled
CME#
07
3. Verify

02
We make a call from PSTN to our CCME.
3218774532 is calling our CCME number 292909123
CME#
Sep 22 18:43:07.171: ISDN BR1/1/0 Q931: RX <- SETUP pd = 8 callref = 0x04
Bearer Capability i = 0x8090A3
Standard = CCITT
Transfer Capability = Speech
Transfer Mode = Circuit
Transfer Rate = 64 kbit/s
Channel ID i = 0x81
Preferred, B1
Calling Party Number i = 0x0183, '3218774532'
Plan:ISDN, Type:Unknown
Called Party Number i = 0xA1, '292909123'
Plan:ISDN, Type:National
Sending Complete
08
3. Verify

02
At this point the CCME identifies the correct rule for converting the called number from the PSTN.
The CCME thus identifies the rule 10 for proper conversion, while the rule 5 does not pass verification
Then replacement operations are made as specified in rule 10
CME#
Sep 22 …: //-1/x…x/RXRULE/regxrule_profile_match_internal: Matched with rule 10 in ruleset 1
Sep 22 …: //-1/x…x/RXRULE/regxrule_match: No match; number=292909123 rule precedence=5
Sep 22 …: //-1/x…x/RXRULE/sed_subst: Successful substitution; pattern=292909123 matchPattern=^2929091(.*)$
replacePattern=11 replaced pattern=123
Sep 22 …: //-1/x…x/RXRULE/regxrule_subst_num_type: Match Type = none, Replace Type = none Input Type = national
Sep 22 …: //-1/x…x/RXRULE/regxrule_subst_num_plan: Match Plan = none, Replace Plan = none Input Plan = isdn
CME#
09
3. Verify

02
Here's the sequence of call progress: in progress, ringing, off-hook, and finally, the phone conversation with extension123!
CME#
Sep 22 18:43:07.235: ISDN BR1/1/0 Q931: TX -> CALL_PROC pd = 8 callref = 0x84
Channel ID i = 0x89
Exclusive, B1
Sep 22 18:43:07.335: ISDN BR1/1/0 Q931: TX -> ALERTING pd = 8 callref = 0x84
Facility i = 0x9FAA068001018201018B0100A109020204B30201018000
Protocol Profile = Networking Extensions
CME#
CME#Sep 22 18:43:37.427: ISDN BR1/1/0 Q931: TX -> CONNECT pd = 8 callref = 0x84
Channel ID i = 0x89
Exclusive, B1
Sep 22 18:43:37.515: ISDN BR1/1/0 Q931: RX <- CONNECT_ACK pd = 8 callref = 0x04
CME#
Sep 22 18:43:37.515: %ISDN-6-CONNECT: Interface BRI1/1/0:1 is now connected to 123 N/A
CME#s
10
3. Verify

More Needs?
Services and
Solutions
Products
Remote
IpService
Security
Via Ponchielli, 4
20063 Cernusco sul Naviglio (MI) –
Italy
+39 02 9290 9171
info_ipmax@ipmax.it
About us
IPMAX is the ideal partner for companies
seeking quality in products and services.
IPMAX guarantees method and professionalism
to support its customers in selecting technologies
with the best quality / price ratio, in the design,
installation, commissioning and operation

CCME How To - Dial-peer digit manipulation using Translation Profiles

Recommended

Recommended

More Related Content

Viewers also liked

Viewers also liked (13)

More from IPMAX s.r.l.

More from IPMAX s.r.l. (9)

Recently uploaded

Recently uploaded (20)

CCME How To - Dial-peer digit manipulation using Translation Profiles