To specify a digit string that can be matched by an incoming call to
associate the call with a dial peer, use the
incoming called -number command in dial-peer configuration mode. To reset to the
default, use the
no form of this command.
incoming called-number { [+]} string { [T]}
no incoming called-number { [+]} string { [T]}
Syntax Description
|
+
|
(Optional) Character that indicates an E.164 standard
number.
|
|
string
|
Series of digits that specify a pattern for the E.164 or
private dialing plan telephone number. Valid entries are the digits 0 through
9, the letters A through D, and the following special characters:
-
The asterisk
(*) and pound sign (#) that appear on standard touch-tone dial pads.
-
Comma (,),
which inserts a pause between digits.
-
Period (.),
which matches any entered digit (this character is used as a wildcard).
-
Percent sign
(%), which indicates that the preceding digit occurred zero or more times;
similar to the wildcard usage.
-
Plus sign (+),
which indicates that the preceding digit occurred one or more times.
|
Note
|
The plus sign used as part of a digit string is
different from the plus sign that can be used in front of a digit string to
indicate that the string is an E.164 standard number.
|
-
Circumflex (^),
which indicates a match to the beginning of the string.
-
Dollar sign
($), which matches the null string at the end of the input string.
-
Backslash
symbol (\), which is followed by a single character, and matches that
character. Can be used with a single character with no other significance
(matching that character).
-
Question mark
(?), which indicates that the preceding digit occurred zero or one time.
-
Brackets ( [ ]
), which indicate a range. A range is a sequence of characters enclosed in the
brackets; only numeric characters from 0 to 9 are allowed in the range.
-
Parentheses ( (
) ), which indicate a pattern and are the same as the regular expression rule.
|
|
T
|
(Optional) Control character that indicates that the
destination-pattern value is a
variable-length dial string. Using this control character enables the router to
wait until all digits are received before routing the call.
|
Command Default
No incoming called number is defined
Command Modes
Dial peer configuration (config-dial-peer)
Command History
|
Release
|
Modification
|
|
11.3(1)T
|
This command was introduced on the Cisco 3600 series.
|
|
11.3NA
|
This command was implemented on the Cisco AS5800.
|
|
12.0(4)XJ
|
This command was modified for store-and-forward fax.
|
|
12.0(4)T
|
This command was integrated into Cisco IOS Release
12.0(4)T.
|
|
12.0(7)XK
|
This command was implemented on the Cisco MC3810.
|
|
12.1(2)T
|
This command was integrated into Cisco IOS Release
12.1(2)T.
|
|
12.1(5)T
|
This command was integrated into Cisco IOS Release
12.1(5)T.
|
|
12.2(4)T
|
This command was implemented on the Cisco 1750.
|
|
12.2(8)T
|
This command was implemented on the following platforms:
Cisco 1751, Cisco 2600 series, Cisco 3600 series, Cisco 3725, and Cisco 3745.
|
|
Cisco IOS XE Release 3.3S
|
This command was integrated into Cisco IOS XE Release 3.3S.
|
| Cisco IOS XE Amsterdam 17.2.1r |
Introduced support for YANG models.
|
Usage Guidelines
When a Cisco device is handling both modem and voice calls, it needs
to be able to identify the service type of the call--meaning whether the
incoming call to the server is a modem or a voice call. When the access server
handles only modem calls, the service type identification is handled through
modem pools. Modem pools associate calls with modem resources based on the
dialed number identification service (DNIS). In a mixed environment, in which
the server receives both modem and voice calls, you need to identify the
service type of a call by using this command.
If you do not use this command, the server attempts to resolve
whether an incoming call is a modem or voice call on the basis of the interface
over which the call arrives. If the call comes in over an interface associated
with a modem pool, the call is assumed to be a modem call; if a call comes in
over a voice port associated with a dial peer, the call is assumed to be a
voice call.
By default, there is no called number associated with the dial peer,
which means that incoming calls are associated with dial peers by matching
calling number with answer address, call number with destination pattern, or
calling interface with configured interface.
Use this command to define the destination telephone number for a
particular dial peer. For the on-ramp POTS dial peer, this telephone number is
the DNIS number of the incoming fax call. For the off-ramp MMoIP dial peer,
this telephone number is the telephone number of the destination fax machine.
This command applies to both VoIP and POTS dial peers and to on-ramp
and off-ramp store-and-forward fax functions.
This command is also used to provide a matching VoIP dial peer on the
basis of called number when fax or modem pass-through with named signaling
events (NSEs) is defined globally on a terminating gateway.
You can ensure that all calls will match at least one dial peer by
using the following commands:
Router(config)# dial-peer voice tag voip
Router(config-dial-peer)# incoming called-number.
Examples
The following example configures calls that come into the router with
a called number of 555-0163 as being voice calls:
dial peer voice 10 pots
incoming called-number 5550163
The following example sets the number (310) 555-0142 as the incoming
called number for MMoIP dial peer 10:
dial-peer voice 10 mmoip
incoming called-number 3105550142
Feedback