Usage Guidelines
This command creates a pattern for expanding individual abbreviated
extension numbers of calling numbers into fully qualified E.164 numbers.
Use this command when configuring a network with multiple Cisco
Unified CMEs to ensure that the appropriate calling number, extension or E.164
number, is provided to the target Cisco Unified CME, and appears on the phone
display of the called phone. In networks that have a single Cisco Unified CME,
this command is not needed.
If multiple dial-plan patterns are defined, the system matches
extension numbers against the patterns in sequential order, starting with with
the lowest numbered dial-plan pattern tag first. Once a pattern matches an
extension number, the pattern is used to generate an expanded number. If
additional patterns subsequently match the extension number, they are not used.
The
dialplan-pattern command builds additional
dial peers for the expanded numbers it creates. For example, when the ephone-dn
with the number 1001 was defined, the following POTS dial peer was
automatically created for it:
dial-peer voice 20001 pots
destination-pattern 1001
voice-port 50/0/2
When you define a dial-plan pattern that 1001 will match, such as
40855510.., a second dial peer is created so that calls to both the 1001 and
4085551001 numbers will be completed. In our example, the additional dial peer
that is automatically created looks like the following:
dial-peer voice 20002 pots
destination-pattern 4085551001
voice-port 50/0/2
Both numbers are recognized by Cisco Unified CME as being associated
with a SCCP phone.
Both dial peers can be seen with the
show
telephony-service
dial-peer command.
In networks with multiple routers, you may need to use the
dialplan-pattern command to expand extensions
to E.164 numbers because local extension numbering schemes can overlap each
other. Networks with multiple routers have authorities such as gatekeepers that
route calls through the network. These authorities require E.164 numbers so
that all numbers in the network will be unique. Use the
dialplan-pattern command to expand extension
numbers into unique E.164 numbers for registering with a gatekeeper.
Ephone-dn numbers for the Cisco IP phones must match the number in
the
extension-length argument; otherwise, the
extension number cannot be expanded. For example, the following command maps
all 3-digit extension numbers to the telephone number 40855501xx, so that
extension 111 is expanded but the 4-digit extension 1011 is not.
dialplan-pattern 1 40855501.. extension-length 3
Using the
dialplan-pattern command to expand extension
numbers can sometimes result in the improper matching of numbers with dial
peers. For example, the expanded E.164 number 2035550134 can match dial-peer
destination-pattern 203, not 134, which would be the correct destination
pattern for the desired extension. If it is necessary for you to use the
dialplan-pattern command and you know that
the expanded numbers might match destination patterns for other dial peers, you
can manually configure the E.164 expanded number for an extension as its
secondary number using the
number command, as shown in the following
example:
ephone-dn 23
number 134 secondary 2035550134
The pattern created by the
dialplan-pattern command is also used to
enable distinctive ringing for inbound calls. If a calling-party number matches
a dial-plan pattern, the call is considered an internal call and has a
distinctive ring that identifies the call as internal. Any call with a
calling-party number that does not match a dial-plan pattern is considered an
external call and has a distinctive ring that is different from the internal
ringing.
When the
extension-pattern keyword and
extension-pattern
argument are used, the leading digits of an extension pattern
are stripped and replaced with the corresponding leading digits of the dial
plan. For example, the following command maps all 4xx extension numbers to the
E.164 number 40855501xx, so that extension 412 corresponds to 4085550112.
dialplan-pattern 1 4085550100 extension-length 3 extension-pattern 4..
When the demote keyword is used, the dialplan-pattern command tries
to demote the registered phone if it matches the pattern, extension-length, and
extension-pattern.
Examples
The following example shows how to create dial-plan pattern 1 for
extension numbers 5000 to 5099 with a prefix of 408555. If an inbound calling
party number (4085555044) matches dial-plan pattern 1, the recipient phone will
display an extension (5044) as the caller ID and use an internal ringing tone.
If an outbound calling party extension number (5044) matches the same dial-plan
pattern 1, the calling-party extension will be converted to an E.164 number
(4085555044). The E.164 calling-party number will appear as the caller ID.
Router(config)# telephony-service
Router(config-telephony)# dialplan-pattern 1 40855550.. extension-length 4 extension-pattern 50..
In the following example, the
dialplan-pattern command creates dial-plan
pattern 1 for extensions 800 to 899 with the telephone prefix starting with
4085559. As each number in the extension pattern is declared with the
number command, two POTS dial peers are
created. In the example, they are 801 (an internal office number) and
4085579001 (an external number).
Router(config)# telephony-service
Router(config-telephony)# dialplan-pattern 1 40855590.. extension-length 3 extension-pattern 8..
The following example shows a configuration for two Cisco CME
systems. One system uses 50.. and the other uses 60.. for extension numbers.
Each is configured with the same two
dialplan-pattern commands. Calls from the
“50..” system to the “60..” system, and vice versa, are treated as internal
calls. Calls that go across a H.323 network and calls that go to a PSTN through
an ISDN interface on one of the configured Cisco CME routers are represented as
E.164.
Router(config)# telephony-service
Router(config-telephony)# dialplan-pattern 1 40855550.. extension-length 4 extension-pattern 50..
Router(config-telephony)# dialplan-pattern 2 51055560.. extension-length 4 extension-pattern 60..