CIPTV 1 - Dial Plan - Describe digit manipulation

Introduction :

the third component of the dial plan  is digit manipulation , take as simple as you will transform / change / edit endpoint addressing schemes, for the beginning we will only see manipulation of digit in the exact terms cause there more than meets the eye.

before we begin i also want to point that DM is also something that can differ from one platform to another , etc.

Now you are going to think what is the purpose of DM? what i can say to you is that in some cases it is necessary to manipulate digit , really digit manipulation depends on the scenario of the implementation and so one , plus other. so the intake of this part is that DM depends on the design. the purpose is as clear in the name it self to manipulate numbers.

Digit Manipulation Ops:

• Match  : it matches a set of numbers
• Replace : replace the matched numbers with new ones

 Now i will separete this post in two section,

• Section 1 : Cisco OS gateway Digit Manipulation
• Section 1 : CUCM Digit Manipulation

Section 1 : Cisco IOS gateway Digit Manipulation

Symbols for DM:

Commonly used symbols :

"." : one digit from 0-9

"T" : long digit number

"#" : end the inter-digit timeout

"[]" : range of numbers

Less commonly used symbols:

"()" :

"%":

"+":

"?":

Regular expression for DM:

"^X" : start of with X

"X$" : ends with X

Note : by defaut matching numbers are stripped.

following the above , this behavior of digit manipulation is not always accepted, thus if left , a call will not establish by default.

Usefull commands:

• prefix , used to add a prefix 
• forward-digit, used to indicat to forward a number of digit couting from the end.
• num-exp ??

So how we will manipulate digits in our IOS gateway, well they exsist to main compenent:

• translation rules : where the rule is configured and the statement of match/replace take place
• translation profile : this is an additional feature that enable you to set the rule for specifi calling or called number.

BIG CONFUSION BETWEEN CALLING & CALLED ( EINSTEIN)

just to make it simple look at the picture below

so your first line of attack in digit manipulations would be translation rule along side translation profile.

translation rule as already said are base on a match-replace scheme as there method of operation.

syntax :
voice translation rule n°
rule n° /pattern to match/ /pattern to replace/
pattern uses REGX.

translation profile applies the rules on specific direction of the call.
with transaltion profile we can modify called party number or calling party number

syntax:
voice transaltion profile PROFILE_NAME
transalte called XX
translate calling YY


after creating the profile you will have to apply them where right? well there is a few and commong places to do so.

1-voice port
2-dial peer

and the tricky part in applying them is you will apply them according to the direction of the call.

syntax:

dial-per voice XX pots
transaltion-profile XX incoming
transaltion-profile YY outgoing


Reminder : there is a cool feature about transaltion rules which BLOCKING.

a good illustration:

Bonus: you can verify your transaltion rule that you created byt using to set of tools

• VTR.msi ( Voice Transaltion Rule software ) , if you need it please send me a request or lookup the internet
• IOS GATEWAT TEST command, you can use a spécial command embeede in the IOS code to test your digit manilpulation transalation rule ( test voice translation rule number_of_rule pattern)

Section 2 : CUCM Digit Manipulation

this section right here is very important section guys, open you eyes and minds , a lot of labing and real world work will pretty much get down to this section , i'm not saying it's what you will only be doing , but this part is a SOMETHING, you feel me.

As a reminder in my blog i tent to explain stuff but you will come across stuff not fully expalind that because integration the hole thing will be like copying the SRND, no point right.

Digit Manipulation in CUCM uses same old techniques and operation as in CISCO IOS, yet they differ in the tools , the naming of these tools , the level and places where you can apply them, and i can tell you that there is a lot more into CUCM then CISCO IOS.

Here is the list (note this list in not complete) :

Name	Abbr	Description
Transaltion Pattern	TP	translation pattern are a DM tool applied instantly in the Cng/Cd IDs, hence force a second lookup in CUCM call routing
Calling Party Transformation Pattern	CngPTP	these guys here took me lab implementation to fully understand them, its a D  tools that only change the Calling party at the destination, meanning thta this don't affect the call routing of CUCM, its usedfor Globolazation/Localazation purposes
Called Party Transformation Pattern	CdPTP	same as CngPTP this one apply to Called ID
Route Patter Level	RP-L	in the route pattern level , there is a gez DM tool you can check and apply , you can set a Cng MASK for example
Route Group-Level	RG-L	also in the RG level you can set a few Dm tools , DM tool generaly aimes to change Caller ID or/and Calling ID.
Device* Level	D-L
Device pool Level	DP-L	This of course is great place to set some paramere as the applie to all the device included in this device pool a tool called CngPTP_CSS this one works in conjuction with CngPTP as you may noic from the naming conventions.
Line Level	L-L	at the line there is also a DM tool , a famous one for me is the EPNM (the External Phone Numer Mask) nice tools used alot you have to check it
SIP Route pattern level	SIPRP-L	as Route Pattern in SIP you can also set some DM
External Phone Number Mask	EM	Oops already mentioned, with a bit of details , first this tools canged the lince appareance number on the phone using a MASK, and you can lavreage it to be used in other tools ze discussed to be you DM.

there is more to talk about in CUCM i note the following:

• Special characters for REGEX
• Maximum supported DM tools
• design approach when implementing and uses cases scenarios

these are all part of the experience and more studies you have to do to continue on with paths.

Cheers, Oussama