Cisco IOS Voice Commands:
N


This chapter contains commands to configure and maintain Cisco IOS voice applications. The commands are presented in alphabetical order. Some commands required for configuring voice may be found in other Cisco IOS command references. Use the command reference master index or search online to find these commands.

For detailed information on how to configure these applications and features, refer to the Cisco IOS Voice Configuration Guide.

name (dial peer cor custom)

To specify the name for a custom class of restrictions (COR), use the name command in dial peer COR custom configuration mode. To remove a specified COR, use the no form of this command.

name class-name

no name class-name

Syntax Description

class-name

Name that describes the specific COR.


Command Default

No default behavior or values.

Command Modes

Dial peer COR custom configuration

Command History

Release
Modification

12.1(3)T

This command was introduced.


Usage Guidelines

The dial-peer cor custom and name commands define the names of capabilities on which to apply COR operation. Examples of names might include any of the following: call1900, call527, call9, or call 911. You must define the capabilities before you specify the COR rules.

You can define a maximum of 64 COR names.

Examples

The following example defines three COR names:

dial-peer cor custom
 name 900_call
 name 800_call
 name catchall

Related Commands

Command
Description

dial-peer cor custom

Specifies that named CORs apply to dial peers.


nat symmetric check-media-src

To enable the gateway, to check the media source of incoming Real-time Transport Protocol (RTP) packets in symmetric Network Address Translation (NAT) environments, use the nat symmetric check-media-src command in SIP user agent configuration mode. To disable media source checking, use the no form of this command.

nat symmetric check-media-src

no nat symmetric check-media-src

Syntax Description

This command has no arguments or keywords.

Command Default

Media source checking is disabled.

Command Modes

SIP user agent configuration (sip-ua)

Command History

Release
Modification

12.2(13)T

This command was introduced.


Usage Guidelines

This command provides the ability to enable or disable symmetric NAT settings for the Session Initiation Protocol (SIP) user agent. Use the nat symmetric check-media-src command to configure the gateway to check the media source address and port of the first incoming RTP packet. Checking for media packets is automatically enabled if the gateway receives the direction role "active or both".

Examples

The following example enables checking the media source:

Router(config)# sip-ua
Router(config-sip-ua)# nat symmetric check-media-src

Related Commands

Command
Description

nat symmetric role

Defines endpoint settings to initiate or accept a connection for symmetric.


nat symmetric role

To define endpoint settings to initiate or accept a connection for symmetric Network Address Translation (NAT) configuration, use the nat symmetric role command in SIP user agent configuration mode. To disable the nat symmetric role configuration, use the no form of this command.

nat symmetric role {active | passive}

no nat symmetric role {active | passive}

Syntax Description

active

Sets the symmetric NAT endpoint role to active, originating an outgoing connection.

passive

Sets the symmetric NAT endpoint role to passive, accepting an incoming connection to the port number on the m=line of the Session Description Protocol (SDP) body sent from the SDP body to the other endpoint.


Command Default

The endpoint settings to initiate or accept connections for NAT configuration are not defined..

Command Modes

SIP user agent configuration (sip-ua)

Command History

Release
Modification

12.2(13)T

This command was introduced.


Usage Guidelines

This command provides the ability to specify symmetric NAT endpoint settings for the SIP user agent. If the gateway does not receive the direction role, use the nat symmetric role command to define endpoint settings to initiate or accept a connection for symmetric NAT configuration. This is achieved by setting the symmetric NAT endpoint role to active or passive, respectively. Cisco recommends that you use the nat symmetric role command under the following conditions:

Endpoints are aware of their presence inside or outside of NAT

Endpoints parse and process direction:<role> in SDP

If the endpoints conditions are not satisfied, you may not achieve the desired results when you configure the nat symmetric role command.

Examples

The following example shows how to set the endpoint role in connection setup to active:

Router(config)# sip-ua
Router(config-sip-ua)# nat symmetric role active

Related Commands

Command
Description

nat symmetric check-media-src

Enables source media checking for symmetric NAT.


neighbor (annex g)

To configure the neighboring border elements (BEs) that interact with the local BE for the purpose of obtaining addressing information and aiding in address resolution, enter the neighbor command in Annex G configuration mode. To reset the default value, use the no form of this command.

neighbor ip-address

no neighbor

Syntax Description

ip-address

IP address of the neighbor that is used for exchanging Annex G messages.


Command Default

No default behavior or values

Command Modes

Annex G configuration

Command History

Release
Modification

12.2(2)XA

This command was introduced.

12.2(4)T

This command was integrated into Cisco IOS Release 12.2(4)T. Support for the Cisco AS5300, Cisco AS5350, and Cisco AS5400 is not included in this release.

12.2(2)XB1

This command was implemented on the Cisco AS5850.

12.2(11)T

This command was integrated into Cisco IOS Release 12.2(11)T. This command is supported on the Cisco AS5300, Cisco AS5350, Cisco AS5400, and Cisco AS5850 in this release.


Examples

The following example configures a neighboring BE that has an IP address and border element ID:

Router(config)# call-router h323-annexg be20
Router(config-annexg)# neighbor 121.90.10.42
Router(config-annexg-neigh)# id be30
Router(config-annexg-neigh)# exit

Related Commands

Command
Description

advertise

Controls the types of descriptors that the BE advertises to its neighbors.

call-router

Enables the Annex G border element configuration commands.

id

Configures the local ID for the neighboring BE.

port

Configures the port number of the neighbor that is used for exchanging Annex G messages.

query-interval

Configures the interval at which the local BE will query the neighboring BE.


neighbor (tgrep)

To create a TGREP session with another device, use the neighbor command in TGREP configuration mode. To disable a TRIP connection, use the no form of this command.

neighbor ip_address

no neighbor ip_address

Syntax Description

ip_address

IP address of a peer device with which TGREP information will be exchanged.


Command Default

No neighboring devices are defined

Command Modes

TGREP configuration

Command History

Release
Modification

12.3(1)

This command was introduced.


Examples

The following example shows that the gateway with the IP address 192.116.56.10 is defined as a neighbor for ITAD 1234:

Router(config)# tgrep local-itad 1234
Router(config-tgrep)# neighbor 192.116.56.10

Related Commands

Command
Description

tgrep local-itad

Enters TGREP configuration mode and defines an ITAD.


network-clock base-rate

To configure the network clock base rate for universal I/O serial ports 0 and 1, use the network-clock base-rate command in global configuration mode. To disable the current network clock base rate, use the no form of this command.

network-clock base-rate {56k | 64k}

no network-clock base-rate {56k | 64k}

Syntax Description

56k

Sets the network clock base rate to 56 kbps.

64k

Sets the network clock base rate to 64 kbps.


Command Default

56 kbps

Command Modes

Global configuration

Command History

Release
Modification

11.3(1)MA

This command was introduced on the Cisco MC3810.


Usage Guidelines

This command applies to Voice over Frame Relay and Voice over ATM.

Examples

The following example sets the network clock base rate to 64 kbps:

network-clock base-rate 64k

Related Commands

Command
Description

network-clock-select

Uses the network clock source to provide timing to the system backplane PCM bus.

network-clock-switch

Configures the switch delay time to the next priority network clock source when the current network clock source fails.


network-clock-participate

To allow the ports on a specified network module or voice/WAN interface card (VWIC) to use the network clock for timing, use the network-clock-participate command in global configuration mode. To restrict the device to use only its own clock signals, use the no form of this command.

network-clock-participate [slot slot-number | wic wic-slot | aim aim-slot-number]

no network-clock-participate [nm slot | wic wic-slot]

Syntax Description

slot slot-number

(Optional) Network module slot number on the router chassis. Valid values are from 1 to 6.

wic wic-slot

Configures the WAN interface card (WIC) slot number on the router chassis. Valid values are 0 or 1.

aim aim-slot-number

Configures the Advanced Integration Module (AIM) in the specified slot. The aim-slot-number values are 0 or 1 for the Cisco 3660 and 0 or 1 for the Cisco 3725, and Cisco 3745.


Command Default

No network clocking is enabled, and interfaces are restricted to using the clocking generated on their own modules.

Command Modes

Global configuration

Command History

Release
Modification

12.1(5)XM

This command was introduced on the Cisco 3660.

12.2(4)T

This command was integrated into Cisco IOS Release 12.2(4)T.

12.2(2)XB

The slot keyword was replaced by the nm keyword and the wic keyword and the wic-slot argument were added.

12.2(8)T

This command was integrated into Cisco IOS Release 12.2(8)T.

12.2(15)T

This command was integrated into Cisco IOS Release 12.2(15)T with support for the Cisco 3660, Cisco 3725, and Cisco 3745. Clocks can be synchronized on two ports. The aim keyword was added. The nm keyword was replaced by the slot keyword.

12.4(15)T9

This command was integrated into Cisco IOS Release 12.4(15)T9, and support was added for the NM-CEM-4SER modules.


Usage Guidelines

This command is used for ATM segmentation and reassembly or digital signal processing and Cisco 3660, Cisco 3725, and Cisco 3745 routers.

This command applies to any network module with T1/E1 controllers to provide clocks from a central source (MIX module for the Cisco 3660) to the network module and to the port on the network module. Then that port can be selected as the clock source with the network-clock-select command to supply clock to other ports or network modules that choose to participate in network clocking with the network-clock-participate command. This command synchronizes the clocks for two ports.

On the Cisco 3700 series, you must use the network-clock-participate command and either the wic wic-slot keyword and argument or the slot slot-number keyword and argument.


Note If the AIM takes its clock signals from a T1 or E1 controller, it is mandatory to use the network-clock-select and network-clock-participate commands for ATM. The clocks for the ATM and voice interfaces do not need to be synchronous, but improved voice quality may result if they are.



Note The only VWICs that can participate in network clocking are digital T1/E1 packet voice trunk network modules (NM-HDV), and Fast Ethernet network modules (NM-2W, NM-1FE. and NM-2FE).



Note Beginning with Cisco IOS Release 12.4(15)T9, the network-clock-participate command can also be used for the NM-CEM-4SER modules. When the network-clock-participate command is configured, the clock is derived from the backplane. When the no network-clock-participate command is configured, the local oscillator clock is used.


Examples

The following example configures the network module in slot 5 to participate in network clocking on a Cisco 3660 with a MIX module:

network-clock-participate slot 5
network-clock-select 1 e1 

The following example on a Cisco 3700 series router specifies that the AIM participates in network clocking and selects port E1 0/1 to provide the clock signals.

Router(config)# network-clock-participate wic 0
Router(config)# network-clock-participate aim 0
Router(config)# network-clock-select 2 E1 0/1

The following example on a Cisco 3660 specifies the slot number that participates in network clocking and selects port E1 5/0:

Router(config)# network-clock-participate slot 5
Router(config)# network-clock-select 1 E1 5/0

Related Commands

Command
Description

network-clock-select

Specifies selection priority for the clock sources.

network-clock-source

Selects the port to be the clock source to supply clock resources to other ports or network modules.


network-clock-select

To name a source to provide timing for the network clock and to specify the selection priority for this clock source, use the network-clock-select command in global configuration mode. To cancel the network clock selection, use the no form of this command.

network-clock-select priority {bri | atm | t1 | e1} slot/port

no network-clock-select priority {bri | atm | t1 | e1} slot/port

Syntax Description

priority

Selection priority for the clock source (1 is the highest priority). The clock with the highest priority is selected to drive the system time-division-multiplexing (TDM) clocks. When the higher-priority clock source fails, the next-higher-priority clock source is selected. Ranges are as follows:

Cisco 2600 series: 1 to 4

Cisco 3660: 1 to 8

Cisco 2800 series: 1 to 8

bri

Specifies that the slot is configured as BRI.

atm

Specifies that the slot is configured as ATM.

t1

Specifies that the slot is configured as T1.

e1

Specifies that the slot is configured as E1.

slot

Slot number identifying the controller that is the clock source.

Cisco 2600 series or Cisco 2600XM—0 (built-in WIC slot) or 1 (network module slot).

Cisco 3660, Cisco 3725, and Cisco 3745—1 to 6.

Cisco 2800 series—0, 1, or 2.

port

Port number identifying the controller that is the clock source. The range is from 0 to 3. For the Cisco 2800 series, the range is 0 to 7 (for example, BRI interface can be 2/0 to 2/7).

serial 0

(Optional) Specifies serial interface 0 as the clock source. This option is not available on the Cisco 2800 series or Cisco 3800 series.

system

(Optional) Specifies the system clock as the clock source. This option is not available on the Cisco 2800 series or Cisco 3800 series.

bvm

Clocking priority for the BRI voice module (BVM). This option is not available on the Cisco 2800 series or Cisco 3800 series.

controller

(Optional) Specifies which controller is the clock source. You can specify either the trunk controller (T1/E1 0) or the digital voice module (T1/E1 1). This option is not available on the Cisco 2800 series or Cisco 3800 series.


Command Default

Cisco 2600 series and Cisco 2600XM

The network clock source is the Advanced Integration Module (AIM) phase-locked loop (PLL) with priority 5, which indicates that the network clock is in free running mode.

Cisco 3660, Cisco 3725, and Cisco 3745

The network clock source is the backplane PLL with priority 9, which indicates that the network clock is in free running mode.


Note Default clock values can fall outside the configurable range because they are derived from an external source.


Command Modes

Global configuration

Command History

Release
Modification

11.3 MA

This command was introduced on the Cisco MC3810.

12.0(3)XG

The BVM as a possible network clock source was added.

12.1(5)XM

This command was implemented on the Cisco 3660. The keywords t1 and e1 were introduced.

12.2(4)T

This command was integrated into Cisco IOS Release 12.2(4)T.

12.2(2)XB

This command was implemented on the Cisco 2600 series and Cisco 3660 with AIMs installed.

12.2(8)T

This command was integrated into Cisco IOS Release 12.2(8)T.

12.2(15)T

This command was implemented on the Cisco 2600XM, Cisco 2691, Cisco 3725, and Cisco 3745.

12.3(8)T4

This command was integrated into Cisco IOS Release 12.3(8)T4 and the bri keyword was added. Support was also added for the Cisco 2800 series.

12.3(11)T

This command was integrated into Cisco IOS Release 12.3(11)T and the atm keyword was added. Support was also added for the Cisco 3800 series.


Usage Guidelines

When an active clock source fails, the system chooses the next lower priority clock source specified by this command. When a higher-priority clock becomes available, the system automatically reselects the higher-priority clock source.

Cisco 2600 series and Cisco 3660

This command is used on Cisco 2600 series and Cisco 2600XM with AIMs installed or on the Cisco 3660 with Multiservice Interchange (MIX) modules installed. This command names a controller to provide clocking signals to the backplane, which then provides the names to all the network modules that are participating in network clocking.

Examples

The following example shows how to select the controller in slot 5, port 1, to provide the clock at priority 3:

network-clock-select 3 t1 5/1

Related Commands

Command
Description

network-clock-participate

Configures a network module to participate in network clocking.

network-clock-switch

Configures the switch delay time to the next priority network clock source when the current network clock source fails or a higher priority clock source is up and available.

show network-clocks

Displays the network clock configuration and current primary clock source.


network-clock-switch

To configure the switch delay time to the next priority network clock source when the current network clock source fails, use the network-clock-switch command in global configuration mode. To cancel the network clock delay time selection, use the no form of this command.

network-clock-switch [switch-delay | never] [restore-delay | never]

no network-clock-switch

Syntax Description

switch-delay

(Optional) Delay time, in seconds, before the next-priority network clock source is used when the current network clock source fails. Range is from 0 to 99. Default is 10.

never

(Optional) No delay time before the current network clock source recovers.

restore-delay

(Optional) Delay time, in seconds, before the current network clock source recovers. Range is from 0 to 99.

never

(Optional) No delay time before the next-priority network clock source is used when the current network clock source fails.


Command Default

10 seconds

Command Modes

Global configuration

Command History

Release
Modification

11.3(1)MA

This command was introduced on the Cisco MC3810.


Usage Guidelines

This command applies to Voice over Frame Relay and Voice over ATM.

Examples

The following example switches the network clock source after 20 seconds and sets the delay time before the current network clock source recovers to 20 seconds:

network-clock-switch 20 20

Related Commands

Command
Description

network-clock-select

Uses the network clock source to provide timing to the system backplane PCM bus.


non-linear

To enable nonlinear processing (NLP) in the echo canceller and set its threshold or comfort-noise attenuation, use the non-linear command in voice-port configuration mode. To disable nonlinear processing, use the no form of this command.

non-linear [comfort-noise attenuation {0db | 3db | 6db | 9db} | threshold dB]

no non-linear [comfort-noise attenuation | threshold]

Syntax Description

0db | 3db | 6db | 9db

(Optional) Attenuation level of the comfort noise in dB. Default is 0db, which means that comfort noise is not attenuated.

threshold dB

(Optional) Sets the threshold in dB. Range is -15 to -45. Default is -21.

Note This keyword is not supported when using the extended G.168 echo canceller.


Command Default

NLP is enabled; comfort-noise attenuation is disabled; threshold is -21 dB.

Command Modes

Voice-port configuration

Command History

Release
Modification

11.3(1)T

This command was introduced.

12.2(11)T

The threshold keyword was added.

12.2(13)T

This command was implemented on routers that support the extended G.168 echo canceller.

12.3(6)

The comfort-noise keyword was added.


Usage Guidelines

This command enables functionality that is also generally known as residual echo suppression. Use this command to shut off any signal if no near-end speech is detected. Enabling this command normally improves performance, although some users might perceive truncation of consonants at the end of sentences when this command is enabled.

Use the comfort-noise keyword if the comfort noise generated by the NLP sounds like hissing. Using this keyword makes the hissing sound less audible.


Note The echo-cancel enable command must be enabled for this command to take effect.


Examples

The following example enables nonlinear call processing on a Cisco 3600 series router:

voice-port 1/0/0
 non-linear

The following example sets the attenuation level to 9 dB on a Cisco 3600 series router:

voice-port 1/0/0
 non-linear comfort-noise attenuation 9db

Related Commands

Command
Description

echo-cancel enable

Enables echo cancellation for voice that is sent and received on the same interface.


notify (MGCP profile)

To specify the order in which automatic number identification (ANI) and dialed number identification service (DNIS) digits are reported to the Media Gateway Control Protocol (MGCP) call agent, use the notify command in MGCP profile configuration mode. To revert to the default, use the no form of this command.

notify {ani-dnis | dnis-ani}

no notify {ani-dnis | dnis-ani}

Syntax Description

ani-dnis

ANI digits are sent in the first notify message, followed by DNIS. This is the default.

dnis-ani

DNIS digits are sent in the first notify message, followed by ANI.


Command Default

The default order is ANI first and DNIS second.

Command Modes

MGCP profile configuration

Command History

Release
Modification

12.4(4)T

This command was introduced.


Usage Guidelines

This command controls the order of ANI and DNIS when using the Feature Group D (FGD) Exchange Access North American (EANA) protocol on a T1 interface. Selecting the ani-dnis keyword causes the ANI digits to be sent in the first NTFY message to the MGCP call agent and the DNIS digits to be sent in a second NTFY message. Selecting the dnis-ani keyword causes the DNIS digits to be sent in the first NTFY message to the MGCP call agent and the ANI digits to be sent in a second NTFY message.

Examples

The following example sets the digit order to DNIS first and ANI second for the default MGCP profile:

Router(config)# mgcp profile default
Router(config-mgcp-profile)# notify dnis-ani

Related Commands

Command
Description

mgcp package-capability

Specifies an MGCP package capability type for a media gateway.

mgcp profile

Defines an MGCP profile to be associated with one or more MGCP endpoints

show mgcp

Displays MGCP configuration information.

show mgcp profile

Displays information for MGCP profiles.


notify redirect

To enable application handling of redirect requests for all VoIP dial peers on a Cisco IOS voice gateway, use the notify redirect command in voice service VoIP configuration mode. To disable application handling of redirect requests on the gateway, use the no form of this command. To return the gateway to the default notify redirect command settings, use the default form of this command.

notify redirect {ip2ip | ip2pots}

no notify redirect {ip2ip | ip2pots}

default notify redirect {ip2ip | ip2pots}

Syntax Description

ip2ip

Enables notify redirection for IP-to-IP calls.

ip2pots

Enables notify redirection for IP-to-IP calls for IP-to-POTS calls.


Command Default

Notify redirection for IP-to-IP calls is enabled.

Notify redirection for IP-to-POTS calls is disabled.

Notify redirection for Session Initiation Protocol (SIP) phones registered to Cisco Unified Communications Manager Express (Cisco Unified CME) is enabled.

Command Modes

Voice service VoIP configuration (conf-voi-serv)

Command History

Release
Modification

12.4(4)T

This command was introduced.

15.1(1)T

This command was integrated into Cisco IOS Release 15.1(1)T.


Usage Guidelines

Use this command to enable notify redirection globally on a gateway. Use the notify redirect command in dial peer voice configuration mode to configure notify redirection settings for IP-to-IPand IP-to-POTS calls on a specific inbound dial peer on a gateway.


Note This command is supported on Cisco Unified Communications Manager Express (Cisco Unified CME), release 3.4 and later releases and on Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST) release 3.4 and later releases. However, to use the notify redirect command in voice service VoIP configuration mode on compatible Cisco Unified SIP SRST devices, you must first use the allow-connections command to enable the corresponding call flows on the SRST gateway.


Examples

The following is partial sample output from the show running-config command showing that notify redirection has been set up globally for both IP-to-IP and IP-to-POTS calling (because support of IP-to-IP calls is enabled by default, the ip2ip setting does not appear in the output).

voice service voip

 notify redirect ip2pots 
 allow-connections h323 to h323 
 allow-connections h323 to sip 
 allow-connections sip to sip 
 no supplementary-service h450.2 
 no supplementary-service h450.3 
 sip 
 registrar server expires max 600 min 60

Related Commands

Command
Description

allow-connections

Allows connections between specific endpoint types in a VoIP network.

notify redirect (dial peer)

Enables application handling of redirect requests on a specific VoIP dial peer on a Cisco IOS voice gateway.


notify redirect (dial peer)

To enable application handling of redirect requests on a specific VoIP dial peer on a Cisco IOS voice gateway, use the notify redirect command in dial peer voice configuration mode. To disable notify redirection on the gateway, use the no form of this command. To return the gateway to the default notify redirection settings, use the default form of this command.

notify redirect {ip2ip | ip2pots}

no notify redirect {ip2ip | ip2pots}

default notify redirect {ip2ip | ip2pots}

Syntax Description

ip2ip

Enables notify redirect for IP-to-IP calls.

ip2pots

Enables notify redirect for IP-to-POTS calls.


Command Default

Notify redirection for IP-to-IP is enabled.
Notify redirection for IP-to-POTS is disabled.

Notify redirection for Session Initiation Protocol (SIP) phones registered to Cisco Unified Communications Manager Express (Cisco Unified CME) is enabled.

Command Modes

Dial peer voice configuration (config-dial-peer)

Command History

Release
Modification

12.4(4)T

This command was introduced.

15.1(1)T

This command was integrated into Cisco IOS Release 15.1(1)T.


Usage Guidelines

Use this command in dial peer configuration mode to configure IP-to-IP and IP-to-POTS calls on an inbound dial peer on a Cisco IOS voice gateway. This command configures notify redirection settings on a per-dial-peer basis.

When notify redirect is enabled in dial peer voice configuration mode, the configuration for the specific dial peer is activated only if the dial peer is an inbound dial peer. To enable notify redirect globally on a Cisco IOS voice gateway, use the notify redirect command in voice service VoIP configuration mode.


Note This command is supported on Cisco Unified Communications Manager Express (Cisco Unified CME), release 3.4 and later releases and Cisco Unified Session Initiation Protocol (SIP) Survivable Remote Site Telephony (SRST) release 3.4 and later releases. However, to use the notify redirect command in voice service VoIP configuration mode on compatible Cisco Unified SIP SRST devices, you must first use the allow-connections command to enable the corresponding call flows on the SRST gateway.


Examples

The following is partial sample output from the show running-config command showing that notify redirection is enabled for both IP-to-IP and IP-to-POTS calls on VoIP dial peer 8000 (because support of IP-to-IP calls is enabled by default, the ip2ip setting does not appear in the output):

dial-peer voice 8000 voip
 destination-pattern 80..
 notify redirect ip2pots
 session protocol sipv2
 session target ipv4:209.165.201.15
 dtmf-relay rtp-nte
 codec g711ulaw
!

 

Related Commands

Command
Description

allow-connections

Allows connections between specific endpoint types in a VoIP network.

notify redirect

Enables application handling of redirect requests for all VoIP dial peers on a Cisco IOS voice gateway.


notify telephone-event

To configure the maximum interval between two consecutive NOTIFY messages for a particular telephone event, use the notify telephone-event command in SIP UA configuration mode. To reset the interval to the default value, use the no form of this command.

notify telephone-event max-duration milliseconds

no notify telephone-event

Syntax Description

max-duration milliseconds

Time interval between consecutive NOTIFY messages for a single DTMF event, in milliseconds. Range is from 40 to 3000. Default is 2000.


Command Default

2000 milliseconds

Command Modes

SIP UA configuration (config-sip-ua)

Command History

Release
Modification

12.2(15)ZJ

This command was introduced.

12.3(4)T

This command was integrated into Cisco IOS Release 12.3(4)T.

15.0(1)M

This command was modified. The acceptable value range for the milliseconds argument was expanded (the lower end of the range was changed from 500 to 40).

12.4(24)T3

This command was modified. The acceptable value range for the milliseconds argument was expanded (the lower end of the range was changed from 500 to 40).


Usage Guidelines

The notify telephone-event command works with the dtmf-relay sip-notify command. The dtmf-relay sip-notify command forwards out-of-band DTMF tones by using SIP NOTIFY messages. The notify telephone-event command sets the maximum time interval between consecutive NOTIFY messages for a single DTMF event. The maximum time is negotiated between two SIP endpoints and the lowest duration value is the one selected. This duration is negotiated during call establishment as part of negotiating the SIP-NOTIFY DTMF relay.

The originating gateway sends an indication of DTMF relay in an Invite message using the SIP Call-Info header. The terminating gateway acknowledges the message with an 18x/200 Response message, also using the Call-Info header. The set duration appears in the Call-Info header in the following way:

Call-Info: <sip: address>; method="Notify;Event=telephone-event;Duration=msec" 

For example, if the maximum duration of gateway A is set to 1000 ms, and gateway B is set to 700 ms, the resulting negotiated duration would be 700 ms. Both A and B would use the value 700 in all of their NOTIFY messages for DTMF events.

Examples

The following example sets the maximum duration for a DTMF event to 40 ms.

Router(config)# sip-ua
Router(config-sip-ua)# notify telephone-event max-duration 40

Related Commands

Command
Description

dtmf-relay sip-notify

Forwards DTMF tones using SIP NOTIFY messages.


nsap

To specify the network service access point (NSAP) address for a local video dial peer, use the nsap command in dial peer configuration mode. To remove any configured NSAP address from the dial peer, use the no form of this command.

nsap nsap-address

no nsap

Syntax Description

nsap-address

A 40-digit hexadecimal number; the number must be unique on the device.


Command Default

No NSAP address for a video dial peer is configured

Command Modes

Dial peer configuration

Command History

Release
Modification

12.0(5)XK

This command was introduced for ATM video dial peer configuration on the Cisco MC3810.

12.0(7)T

This command was integrated into Cisco IOS Release 12.0(9)T.


Usage Guidelines

The address must be unique on the router.

Examples

The following example sets up an NSAP address for the local video dial peer designated as 10:

dial-peer video 10 videocodec
 nsap 47.0091810000000002F26D4901.333333333332.02

Related Commands

Command
Description

dial-peer video

Defines a video ATM dial peer for a local or remote video codec, specifies video-related encapsulation, and enters dial peer configuration mode.

show dial-peer video

Displays dial peer configuration.


null-called-number

To substitute a user-defined number as the called number IE when an incoming H.323 setup message does not contain a called number IE, use the null-called-number command in voice service H.323 configuration mode. To disable the addition of the number used as the called number IE, use the no form of this command.

null-called-number override string

no null-called-number

Syntax Description

override string

Specifies the user-defined series of digits for the E.164 or private dialing plan telephone number when the called number IE is missing from the H.323 setup message. Valid entries are the digits 0 through 9.


Command Default

The command behavior is disabled. H.323 setup messages missing the called number IE are disconnected.

Command Modes

Voice service h323 configuration (conf-serv-h323)

Command History

Release
Modification

12.4(22)YB

This command was introduced.

15.0(1)M

This command was integrated into Cisco IOS Release 15.0(1)M.


Usage Guidelines

For a call connection to be completed the incoming H.323 setup messages must include the called number IE and the E.164 destination address. Calls lacking called number IE are disconnected. The null-called-number is a user-defined number used when the called number IE is missing to complete the call.

Examples

The following example shows the number 4567 configured as the user-defined number used to complete a call when the H.323 setup message is missing the called number IE:

Router(conf-serv-h323)# null-called-number override 4567

numbering-type

To match on a number type for a dial-peer call leg, use the numbering-type command in dial peer configuration mode. To remove the numbering type for a dial-peer call leg, use the no form of this command.

numbering-type {international | abbreviated | national | network | reserved | subscriber | unknown}

no numbering-type {international | abbreviated | national | network | reserved | subscriber | unknown}

Syntax Description

international

International numbering type.

abbreviated

Abbreviated numbering type.

national

National numbering type.

network

Network numbering type.

reserved

Reserved numbering type.

subscriber

Subscriber numbering type.

unknown

Numbering type unknown.


Command Default

No default behaviors or values

Command Modes

Dial peer configuration

Command History

Release
Modification

12.0(7)XR1

This command was introduced on the Cisco AS5300.

12.0(7)XK

This command was implemented as follows:

VoIP: Cisco 2600 series, Cisco 3600 series, Cisco MC3810

VoFR: Cisco 2600 series, Cisco 3600 series, Cisco MC3810

VoATM: Cisco 3600 series, Cisco MC3810

12.1(1)T

This command was integrated into Cisco IOS Release 12.1(1)T and implemented as follows:

VoIP: Cisco 1750, Cisco 2600 series, Cisco 3600 series, Cisco AS5300, Cisco 7200 series, Cisco 7500 series

12.1(2)T

This command was implemented as follows:

VoIP: Cisco MC3810

VoFR: Cisco 2600 series, Cisco 3600 series, Cisco MC3810

VoATM: Cisco 3600 series, Cisco MC3810

12.2(2)XB1

This command was implemented on the Cisco AS5850.

12.2(11)T

This command was integrated into Cisco IOS Release 12.2(11)T.


Usage Guidelines

This command is supported for POTS, VoIP, VoFR, and VoATM dial peers. The numbering type options are implemented as defined by the ITU Q.931 specification.

Examples

The following example shows how to configure a POTS dial peer for network usage:

dial-peer voice 100 pots
 numbering-type network

The following example shows how to configure a VoIP dial peer for subscriber usage:

dial-peer voice 200 voip
 numbering-type subscriber

Related Commands

Command
Description

rule

Applies a translation rule to a calling party number or a called party number for both incoming and outgoing calls.

show translation-rule

Displays the contents of all the rules that have been configured for a specific translation name.

test translation-rule

Tests the execution of the translation rules on a specific name-tag.

translate

Applies a translation rule to a calling party number or a called party number for incoming calls.

translate-outgoing

Applies a translation rule to a calling party number or a called party number for outgoing calls.

translation-rule

Creates a translation name and enters translation-rule configuration mode.

voip-incoming translation-rule

Captures calls that originate from H.323-compatible clients.


num-exp

To define how to expand a telephone extension number into a particular destination pattern, use the num-exp command in global configuration mode. To remove the configured number expansion, use the no form of this command.

num-exp extension-number expanded-number

no num-exp extension-number

Syntax Description

extension-number

One or more digits that define an extension number for a particular dial peer.

expanded-number

One or more digits that define the expanded telephone number or destination pattern for the extension number listed.


Command Default

No number expansion is defined.

Command Modes

Global configuration

Command History

Release
Modification

11.3(1)T

This command was introduced on the Cisco 3600 series.

12.0(3)T

This command was implemented on the Cisco AS5300.

12.0(4)XL

This command was implemented on the Cisco AS5800.

12.0(7)T

This command was integrated into Cisco IOS Release 12.0(7)T.

12.0(7)XK

This command was implemented on the Cisco MC3810.

12.1(2)T

This command was modified. It was integraged into Cisco IOS Release 12.1(2)T.


Usage Guidelines

Use this command to define how to expand a particular set of numbers (for example, a telephone extension number) into a particular destination pattern. With this command, you can bind specific extensions and expanded numbers together by explicitly defining each number, or you can define extensions and expanded numbers using variables. You can also use this command to convert seven-digit numbers to numbers containing fewer than seven digits.

You can configure a maximum of 250 number extensions before the router sends an error message stating that the limit has been reached.

Use a period (.) as a variable or wildcard, representing a single number. Use a separate period for each number that you want to represent with a wildcard—for example, if you want to replace four numbers in an extension with wildcards, type in four periods.

Examples

The following example expands the extension number 50145 to the number 14085550145:

num-exp 50145 14085550145

The following example expands all five-digit extensions beginning with 5 such that the 5 is replaced with the digits 1408555 at the beginning of the extension number:

num-exp 5.... 1408555....

Related Commands

Command
Description

dial-peer terminator

Designates a special character to be used as a terminator for variable length dialed numbers.

forward-digits

Specifies which digits to forward for voice calls.

prefix

Specifies a prefix for a dial peer.