-
Cisco IOS Voice Command Reference
-
About Cisco IOS Software Documentation
-
Using Cisco IOS Software
-
Commands: A
-
Commands: B
-
Commands:cac master through call application stats
-
Commands: call application voice through call-denial
-
Commands: call fallback through called-number (dial-peer)
-
Commands: caller-id (dial peer) through ccm-manager switchover-to-backup
-
Commands: ccs connect (controller) through clear vsp statistics
-
Commands: clid through cptone
-
Commands: default (MGCP profile) through direct-inward-dial
-
Commands: disable-early-media 180 through dualtone
-
Commands: E
-
Commands: F
-
Commands: G
-
Commands: H
-
Commands: icpif through irq global-request
-
Commands: isdn bind-l3 through ixi transport http
-
Commands: K
-
Commands: L
-
Commands: map q850-cause through mgcp package-capability
-
Commands: mgcp persistent through mmoip aaa send-id secondary
-
Commands: mode (ATM/T1/E1 controller) through mwi-server
-
Commands: N
-
Commands: O
-
Commands: package through pattern
-
Commands: permit hostname through proxy h323
-
Commands: Q
-
Commands: R
-
Commands: sccp through service-type call-check
-
Commands: session through sgcp tse payload
-
Commands: show aal2 profile through show call filter match-list
-
Commands: show call history fax through show debug condition
-
Commands: show dial-peer video through show gatekeeper zone status
-
Commands: show gateway through show modem relay statistics
-
Commands: show mrcp client session active through show sgcp statistics
-
Commands: show sip service through show trunk hdlc
-
Commands: show vdev through show voice statistics memory-usage
-
Commands: show voice translation-profile through shutdown (voice-port)
-
Commands: signal through srv version
-
Commands: ss7 mtp2-variant through switchover method
-
Commands: target carrier-id through threshold noise
-
Commands: timeout (auto-config application) through timing clear-wait
-
Commands:timing delay-duration through type (voice)
-
Commands: U
-
Commands: vad (dial peer) through voice class dualtone-detect-params
-
Commands: voice class h323 through vxml tree memory
-
Commands: W
-
Commands: Z
-
Feedback
Table Of Contents
dspfarm confbridge maximum sessions
dspfarm transcoder maximum sessions
dtmf-relay (Voice over Frame Relay)
disable-early-media 180
To specify which call treatment, early media or local ringback, is provided for 180 responses with 180 responses with Session Description Protocol (SDP), use the disable-early-media 180 command in sip-ua configuration mode. To enable early media cut-through for 180 messages with SDP, use the no form of this command.
disable-early-media 180
no disable-early-media 180
Syntax Description
This command has no arguments or keywords.
Command Default
Early media cut-through for 180 responses with SDP is enabled.
Command Modes
SIP-UA configuration
Command History
Usage Guidelines
This command provides the ability to enable or disable early media cut-through on Cisco IOS gateways for Session Initiation Protocol (SIP) 180 responses with SDP. Use the disable-early-media 180 command to configure the gateway to ignore the SDP message and provide local ringback. To restore the default treatment, early media cut-through, use the no disable-early-media 180 command.
Examples
The following example disables early media cut-through for SIP 180 responses with SDP:
Router(config-sip-ua)# disable-early-media 180Related Commands
disc_pi_off
To enable an H.323 gateway to disconnect a call when it receives a disconnect message with a progress indicator (PI) value, use the disc_pi_off command in voice-port configuration mode. To restore the default state, use the no form of this command.
disc_pi_off
no disc_pi_off
Syntax Description
This command has no arguments or keywords.
Command Default
The gateway does not disconnect a call when it receives a disconnect message with a PI value.
Command Modes
Voice-port configuration
Command History
Usage Guidelines
The disc_pi_off voice-port command is valid only if the disconnect with PI is received on the inbound call leg. For example, if this command is enabled on the voice port of the originating gateway, and a disconnect message with PI is received from the terminating switch, the disconnect message is converted to a disconnect message. But if this command is enabled on the voice port of the terminating gateway, and a disconnect message with PI is received from the terminating switch, the disconnect message is not converted to a standard disconnect message because the disconnect message is received on the outbound call leg.
Note
The disc_pi_off voice-port configuration command is valid only for the default session application; it does not work for interactive voice response (IVR) applications.
Examples
The following example handles a disconnect message with a PI value in the same way as a standard disconnect message for voice port 0:23:
voice-port 0:Ddisc_pi_offRelated Commands
disconnect-ack
To configure a Foreign Exchange Station (FXS) voice port to return an acknowledgment upon receipt of a disconnect signal, use the disconnect-ack command in voice-port configuration mode. To disable the acknowledgment, use the no form of this command.
disconnect-ack
no disconnect-ack
Syntax Description
This command has no arguments or keywords.
Command Default
FXS voice ports return an acknowledgment upon receipt of a disconnect signal
Command Modes
Voice-port configuration
Command History
Usage Guidelines
The disconnect-ack command configures an FXS voice port to remove line power if the equipment on an FXS loop-start trunk disconnects first.
Examples
The following example, which begins in global configuration mode, turns off the disconnect acknowledgment signal on voice port 1/1/0:
voice-port 1/0/0no disconnect-ackCommand History
dnis (DNIS group)
To add a dialed number identification service (DNIS) number to a DNIS map, use the dnis command in DNIS-map configuration mode. To delete a DNIS number, use the no form of this command.
dnis number [url url]
no dnis
Syntax Description
Command Default
If no URL is entered, the DNIS number links to the VoiceXML application that is configured in the dial peer with the application command.
Command Modes
DNIS-map configuration
Command History
12.2(2)XB
This command was introduced on the Cisco AS5300, Cisco AS5350, and Cisco AS5400.
12.2(11)T
This command was implemented on the Cisco 3640 and Cisco 3660.
Usage Guidelines
To enter DNIS-map configuration mode for the dnis command, use the voice dnis-map command.
Enter the dnis command once for each telephone number that you want to map to a voice application. A separate entry must be made for each telephone number in a DNIS map. Wildcards are not supported.
URLs in DNIS entries are used only by VoiceXML applications. When an incoming called number matches a DNIS entry, it loads the VoiceXML document that is specified by the URL, provided that a VoiceXML application is configured in the dial peer using the application command.
Non-VoiceXML applications, such as TCL applications, ignore the URLs in DNIS maps and link a call to the TCL application that is configured in the dial peer using the application command.
For a DNIS map to be applied to an outbound dial peer, a VoiceXML application must be configured by using the application command with the out-bound keyword. Otherwise, the call is not handed off to the application that is specified in the URL of the DNIS map.
The number of allowable DNIS entries is limited by the amount of available configuration memory on the gateway. As a guideline, DNIS maps that contain more than several hundred DNIS entries should be maintained in an external text file.
To associate a DNIS map with a dial peer, use the dnis-map command.
Examples
The first line in the following example shows how the voice dnis-map command is used to create a DNIS map named "dmap1". The last two lines show how the dnis command is used to enter DNIS entries.
The first DNIS entry specifies the location of a VoiceXML document. The second DNIS entry does not specify a URL. A DNIS number without a URL is, by default, matched to the URL of the application that is configured in the dial peer by using the application command.
voice dnis-map dmap1dnis 5553305 url tftp://blue/sky/test.vxmldnis 5558888Related Commands
dnis-map
To associate a dialed number identification service (DNIS) map with a dial peer, use the dnis-map command in dial peer configuration mode. To remove a DNIS map from the dial peer, use the no form of this command.
dnis-map map-name
no dnis-map
Syntax Description
Command Default
No default behavior or values
Command Modes
Dial peer configuration
Command History
12.2(2)XB
This command was introduced on the Cisco AS5300, Cisco AS5350, and Cisco AS5400.
12.2(11)T
This command was implemented on the Cisco 3640 and Cisco 3660.
Usage Guidelines
A DNIS map is a table of destination numbers with optional URLs that link to specific VoiceXML documents. When configured in a dial peer, a DNIS map enables you to link multiple called numbers to a single Tool Command Language (TCL) application or to individual VoiceXML documents.
The dnis-map command must be used with the application command.
Only one DNIS map can be configured in each dial peer.
To create a DNIS map, use the voice dnis-map command to enter DNIS-map configuration mode, and then use the dnis command to add entries to the DNIS map. Or you can create an external text file of DNIS entries and link to its URL by using the voice dnis-map command.
To view the configuration information for DNIS maps, use the show voice dnis-map command.
A URL configured for a DNIS number is ignored by a TCL application; the TCL script that is configured for the application is used instead.
Note
Examples
In the following example the DNIS map named "dmap1" is associated with the VoIP dial peer 3. The outbound application "vapptest1" is associated through this dial peer with DNIS map "dmap1".
dial-peer voice 3 voipdnis-map dmap1application vapptest1 outboundRelated Commands
domain-name (annex G)
To set the domain name that is reported in service relationships, use the domain-name command in annex G neighbor configuration mode. To remove the domain name, use the no form of this command.
domain-name id
no domain-name id
Syntax Description
Command Modes
Annex G neighbor configuration mode
Command Default
No default behavior or values
Command History
Usage Guidelines
Use this command to set the domain name reported that is reported in service relationships.
Examples
The following example shows how to set a domain name to "boston1":
Router(config-annexg-neigh)# domain-name boston1Related Commands
ds0 busyout (voice)
To force a DS0 time slot on a controller into the busyout state, use the ds0 busyout command in controller configuration mode. To remove the DS0 time slot from the busyout state, use the no form of this command.
ds0 busyout ds0-time-slot
no ds0 busyout ds0-time-slot
Syntax Description
ds0-time-slot
DS0 time slots to be forced into the busyout state. Range is from 1 to 24 and can include any combination of time slots.
Command Default
DS0 time slots are not in busyout state.
Command Modes
Controller configuration
Command History
12.0(7)XK
This command was introduced on Cisco MC3810 and Cisco 2600 series and Cisco 3600 series.
12.1(2)T
This command was integrated into Cisco IOS Release 12.1(2)T.
Usage Guidelines
The ds0 busyout command affects only DS0 time slots that are configured into a DS0 group and that function as part of a digital voice port. If multiple DS0 groups are configured on a controller, any combination of DS0 time slots can be busied out, provided that each DS0 time slot to be busied out is part of a DS0 group.
If a DS0 time slot is in the busyout state, only the no ds0 busyout command can restore the DS0 time slot to service.
To avoid conflicting command-line interface (CLI) commands, do not use the ds0 busyout command and the busyout forced command on the same controller.
Examples
The following example configures DS0 time slot 6 on controller T1 0 to be forced into the busyout state:
controller t1 0ds0 busyout 6The following example configures DS0 time slots 1, 3, 4, 5, 6, and 24 on controller E1 1 to be forced into the busyout state:
controller e1 1ds0 busyout 1,3-6,24Related Commands
busyout seize
Changes the busyout seize procedure for a voice port.
show running configuration
Determines which DS0 time slots have been forced into the busyout state.
ds0-group (E1)
To specify the DS0 time slots that make up a logical voice port on an E1 controller, specify the signaling type by which the router communicates with the PBX or PSTN, and define E1 channels for compressed voice calls and the channel-associated signaling (CAS) method by which the router connects to the PBX or PSTN, use the ds0-group command in controller configuration mode. To remove the group and signaling setting, use the no form of this command.
Cisco IOS Release 12.2 and Later Releases
Cisco 1750 and Cisco 1751
ds0-group ds0-group-number timeslots timeslot-list {[service service-type] | [type e&m-fgb | e&m-fgd | e&m-immediate-start | fgd-eana | fgd-os | fxs-ground-start | fxs-loop-start | none | r1-itu | r1-modified | r1-turkey]}
no ds0-group ds0-group-number
Cisco IOS Release 12.1 and Earlier Releases
Cisco 1750 and Cisco 1751
ds0-group ds0-group-number timeslots timeslot-list {[service service-type] | [type e&m-fgb | e&m-fgd | e&m-immediate-start | fgd-eana | fgd-os | fxs-ground-start | fxs-loop-start | none | r1-itu | r1-modified | r1-turkey | sas-ground-start | sas-loop-start]}
no ds0-group ds0-group-number
Cisco 2600 Series (Except Cisco 2691), Cisco 3600 Series (Except Cisco 3660)
ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-immediate-start | e&m-melcas-delay | e&m-melcas-immed | e&m-melcas-wink | e&m-wink-start | ext-sig | fgd-eana | fxo-ground-start | fxo-loop-start | fxo-melcas | fxs-ground-start | fxs-loop-start | fxs-melcas | r2-analog | r2-digital | r2-pulse}
no ds0-group ds0-group-number
Cisco 2691, Cisco 2600XM Series, Cisco 2800 Series (Except Cisco 2801), Cisco 3660, Cisco 3700 Series, Cisco 3800 Series
ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-immediate-start | e&m-lmr | e&m-melcas-delay | e&m-melcas-immed | e&m-melcas-wink | e&m-wink-start | ext-sig | fgd-eana | fxo-ground-start | fxo-loop-start | fxo-melcas | fxs-ground-start | fxs-loop-start | fxs-melcas | r2-analog | r2-digital | r2-pulse}
no ds0-group ds0-group-number
Cisco 7200 Series and Cisco 7500 Series Voice Ports
ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-fgd | e&m-immediate-start | e&m-wink-start | fxo-ground-start | fxo-loop-start | fxs-ground-start | fxs-loop-start }
no ds0-group ds0-group-number
Cisco 7700 Series Voice Ports
ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-immediate-start | e&m-wink-start | fxs-ground-start | fxs-loop-start | fxo-ground-start | fxo-loop-start}
no ds0-group ds0-group-number
Cisco AS5300 and the Cisco AS5400
ds0-group ds0-group-number timeslots timeslot-list type {none | p7 | r2-analog | r2-digital | r2-lsv181-digital | r2-pulse}
no ds0-group ds0-group-number
Note
Syntax Description
Command Default
There is no DS0 group. Calls are allowed in both directions.
Command Modes
Controller configuration
Command History
Usage Guidelines
The ds0-group command automatically creates a logical voice port that is numbered as follows:
•
–
Although only one voice port is created for each group, applicable calls are routed to any channel in the group.
Be sure you take the following into account when you are configuring DS0 groups:
•
•
http://www.cisco.com/go/fn•
•
Examples
The following example shows ranges of E1 controller time slots configured for FXS ground-start and FXO loop-start signaling:
E1 1/0framing esflinecode b8zsds0-group 1 timeslots 1-10 type fxs-ground-startds0-group 2 timeslots 11-24 type fxo-loop-startThe following example shows ranges of T1 controller time slots configured for FXS ground-start signaling:
controller E1 1/0ds0-group 1 timeslots 1-4 type fxs-ground-startThe following example illustrates setting the E1 channels for Signaling System 7 (SS7) service on any trunking gateway using the mgcp keyword:
Router(config-controller)# ds0-group 0 timeslots 1-24 type none service mgcpIn the following example, the time slot maximum is 12 and the time slot is 1, so two voice-ports are created successfully.
controller E1 0/0ds0-group 0 timeslots 1-4 type e&m-immediate-startds0-group 1 timeslots 6-12 type e&m-immediate-startIf a third DS0 group is added, the voice-port is rejected even though the total number of voice channels is less than 16.
ds0-group 2 timeslots 17-18 type e&m-immediate-startIn the following example, the signaling type is set to e&m-lmr:
ds0-group 0 timeslots 1-10 type e&m-lmrRelated Commands
ds0-group (T1)
To specify the DS0 time slots that make up a logical voice port on a T1 controller, to specify the signaling type by which the router communicates with the PBX or PSTN, and to define T1 channels for compressed voice calls and the channel-associated signaling (CAS) method by which the router connects to the PBX or PSTN, use the ds0-group command in controller configuration mode. To remove the group and signaling setting, use the no form of this command.
Cisco IOS Release 12.2 and Later Releases
Cisco 1750 and Cisco 1751
ds0-group ds0-group-number timeslots timeslot-list [service service-type] type {e&m-fgb | e&m-fgd | e&m-immediate-start | fgd-eana | fgd-os | fxs-ground-start | fxs-loop-start | none | r1-itu | r1-modified | r1-turkey}
no ds0-group ds0-group-number
Cisco IOS Release 12.1 and Earlier Releases
Cisco 1750 and Cisco 1751
ds0-group ds0-group-number timeslots timeslot-list [service service-type] type {e&m-fgb | e&m-fgd | e&m-immediate-start | fgd-eana | fgd-os | fxs-ground-start | fxs-loop-start | none | r1-itu | r1-modified | r1-turkey | sas-ground-start | sas-loop-start}
no ds0-group ds0-group-number
Cisco 2600 Series (Except Cisco 2691), Cisco 3600 Series (Except Cisco 3660), and Cisco VG 200
ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-fgd | e&m-immediate-start | e&m-wink-start | ext-sig | fgd-eana | fxo-ground-start | fxo-loop-start | fxs-ground-start | fxs-loop-start}
no ds0-group ds0-group-number
Cisco 2691, Cisco 2600XM Series, Cisco 2800 Series (Except Cisco 2801), Cisco 3660, Cisco 3700 Series, Cisco 3800 Series
ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-fgd | e&m-immediate-start | e&m-lmr | e&m-wink-start | ext-sig | fgd-eana | fgd-emf [mf] [ani-pani] [ani] | fxo-ground-start | fxo-loop-start | fxs-ground-start | fxs-loop-start}
no ds0-group ds0-group-number
Cisco 7200 Series and Cisco 7500 Series
ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-fgd | e&m-immediate-start | e&m-wink-start | fxo-ground-start | fxo-loop-start | fxs-ground-start | fxs-loop-start}
no ds0-group ds0-group-number
Cisco 7700 Series Voice Ports
ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-immediate-start | e&m-wink-start | fxo-ground-start | fxo-loop-start | fxs-ground-start | fxs-loop-start}
no ds0-group ds0-group-number
Cisco IOS Release 12.2 and Later Releases
Cisco AS5300, Cisco AS5350, and Cisco AS5400
ds0-group ds0-group-number timeslots timeslot-list [service service-type] [type [e&m-fgb [dtmf | mf] | e&m-fgd [dtmf | mf [dnis | ani-dnis [info-digits-no-strip] | | fgd-emf [ani-pani] [ani] | service service-type] | e&m-immediate-start | fxs-ground-start | fxs-loop-start | fgd-eana [ani-dnis | mf] | fgd-os [dnis-ani | mf]| none]]
no ds0-group ds0-group-number
Cisco AS5850
ds0-group ds0-group-number timeslots timeslot-list [service service-type] [type [e&m-fgb [dtmf | mf] | e&m-fgd [dtmf | mf [dnis | ani-dnis [info-digits-no-strip] | | fgd-emf [ani-pani] [ani] | service service-type] | e&m-immediate-start | fxs-ground-start | fxs-loop-start | fgd-eana [ani-dnis | mf] | fgd-os [dnis-ani | mf] | r1-itu [dnis] | none]]
no ds0-group ds0-group-number
Cisco IOS Release 12.1 and Earlier Releases
Cisco AS5300, Cisco AS5350, and Cisco AS5400
ds0-group ds0-group-number timeslots timeslot-list [service service-type] [type [e&m-fgb [dtmf | mf] | e&m-fgd [dtmf | mf [dnis | ani-dnis [info-digits-no-strip] | | fgd-emf [ani-pani] [ani] | service service-type] | e&m-immediate-start | fxs-ground-start | fxs-loop-start | fgd-eana [ani-dnis | mf] | fgd-os [dnis-ani | mf] | sas-ground-start | sas-loop-start | none]]
no ds0-group ds0-group-number
Cisco AS5850
ds0-group ds0-group-number timeslots timeslot-list [service service-type] [type [e&m-fgb [dtmf | mf] | e&m-fgd [dtmf | mf [dnis | ani-dnis [info-digits-no-strip] | | fgd-emf [ani-pani] [ani] | service service-type] | e&m-immediate-start | fxs-ground-start | fxs-loop-start | fgd-eana [ani-dnis | mf] | fgd-os [dnis-ani | mf] | r1-itu [dnis] | sas-ground-start | sas-loop-start | none]]
no ds0-group ds0-group-number
Syntax Description
ds0-group-number
A value that identifies the DS0 group. Range is from 0 to 23.
timeslots timeslot-list
Lists time slots in the DS0 group. The timeslot-list argument is a single time-slot number, a single range of numbers, or multiple ranges of numbers separated by commas. Range is from 1 to 24. Examples are as follows:
•
•
•
•
•
Specifies the type of signaling for the DS0 group. The signaling method selection for the type keyword depends on the connection that you are making. The ear and mouth (E&M) interface allows connection for PBX trunk lines (tie lines) and telephone equipment. The Foreign Exchange Station (FXS) interface allows connection of basic telephone equipment and PBX. The Foreign Exchange Office (FXO) interface is for connecting the central office (CO) to a standard PBX interface where permitted by local regulations; it is often used for off-premise extensions (OPXs). Types are as follows:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
service service-type
(Optional) Specifies the type of service.
•
•
•
•
•
dtmf
(Optional) Specifies dual tone multifrequency (DTMF) tone signaling.
mf
(Optional) Specifies multifrequency (MF) tone signaling
ani
(Optional) Provisions ANI address information.
ani-dnis
(Optional) Specifies automatic number identification (ANI) and dialed number identification service (DNIS) address information provisioning for FGD OS.
ani-pani
(Optional) Provisions ANI and PANI address information.
dnis-ani
(Optional) Specifies ANI and DNIS address information provisioning for FGD EANA.
dnis
(Optional) Specifies DNIS address information provisioning.
info-digits-no-strip
(Optional) Retains info digits on the Cisco AS5x00 platforms.
1 Used only with the type none keywords on the Cisco AS5x00 platforms.
Command Default
There is no DS0 group. Calls are allowed in both directions.
Command Modes
Controller configuration
Command History
Usage Guidelines
The ds0-group command automatically creates a logical voice port that is numbered as follows:
•
–
•
–
•
–
Although only one voice port is created for each group, applicable calls are routed to any channel in the group.
Be sure that you take the following into account when you are configuring DS0 groups:
•
•
•
Note
Note
Examples
The following example shows ranges of T1 controller time slots configured for FXS ground-start and FXO loop-start signaling:
controller T1 1/0framing esflinecode b8zsds0-group 1 timeslots 1-10 type fxs-ground-startds0-group 2 timeslots 11-24 type fxo-loop-startThe following example shows ranges of T1 controller time slots configured for FXS ground-start signaling:
controller T1 1/0ds0-group 1 timeslots 1-4 type fxs-ground-startThe following example illustrates setting the T1 channels for Signaling System 7 (SS7) service on any trunking gateway using the mgcp keyword:
ds0-group 0 timeslots 1-24 type none service mgcpIn the following example, the time slot maximum is 12 and the time slot is 1, so two voice-ports are created successfully.
controller T1 0/0ds0-group 0 timeslots 1-4 type e&m-immediate-startds0-group 1 timeslots 6-12 type e&m-immediate-startIf a third DS0 group is added, the voice port is rejected even though the total number of voice channels is less than 16.
ds0-group 2 timeslots 17-18 type e&m-immediate-startIn the following example, the signaling type is set to E&M LMR:
ds0-group 0 timeslots 1-10 type e&m-lmrYou have the option to retain info digits when you are configuring E&M Type II Feature Group D with MF signaling and ANI/DNIS for calls being sent over IP. Info digits denote the subscriber type, and the info-digits keyword prepends info digits to the calling number.
On inbound calls from a T1 FGD voice-port with MF ANI-DNIS, when ANI information is obtained, it is passed unaltered to the next matching dial peer, either POTS or VoIP. The addition of the info-digits-no-strip keyword allows you to retain the info digits portion of the ANI information; the modified ANI is then passed to the next matching dial peer. Ordinarily, info digits are not valid for calls going over IP and are, therefore, stripped off. The ability to retain info digits is particularly useful for calls that are not leaving the PSTN network and are just being hairpinned back.
In the following example, the E&M Type II Feature Group D is configured with MF signaling and ANI/DNIS over IP while retaining info digits:
ds0-group 0 timeslots 1-24 type e&m-fgd mf ani-dnis info-digits-no-stripThe following example enables FGD EMF:
ds0-group 11 timeslots 11 type fgd-emf anids0-group 11 timeslots 11 type fgd-emf ani-paniRelated Commands
ds0-num
To add B-channel information in outgoing Session Initiation Protocol (SIP) messages, use the ds0-num command in SIP voice service configuration mode. To return to the default setting, use the no form of this command.
ds0-num
no ds0-num
Syntax Description
This command has no arguments or keywords.
Command Default
B channel information is disabled.
Command Modes
SIP voice service configuration
Command History
Usage Guidelines
This command enables the SIP application to receive B-channel information of incoming ISDN calls. The B-channel information appears in the Via header of an Invite request and information acquired from the Via header can be used during call transfer or to route a call.
Examples
The following example adds B-channel information to outgoing SIP messages:
Router(config)# voice service voipRouter(conf-voi-serv)# sipRouter(conf-serv-sip)# ds0-numRelated Commands
sip
Enables SIP voice service configuration commands.
voice service voip
Specifies the voice encapsulation type as VoIP.
dsn
To specify that a delivery status notice (DSN) be delivered to the sender, use the dsn command in dial peer configuration mode. To cancel a specific DSN option, use the no form of this command.
dsn {delay | failure | success}
no dsn {delay | failure | success}
Syntax Description
Note
Command Default
The default is to send a nondelivery message in the event of a failure
Command Modes
Dial peer configuration
Command History
Usage Guidelines
When the delay keyword is selected, the next-hop mailer sends a message to the FROM address saying that the mail message was delayed. The definition of the delay keyword is made by each mailer and is not controlled by the sender. Each mailer in the path to the recipient that supports the DSN extension receives the same request.
When the failure keyword is selected, the next-hop mailer sends a message to the FROM address that the mail message delivery failed. Each mailer in the path to the recipient that supports the DSN extension receives the same request.
When the success keyword is selected, the next-hop mailer sends a message to the FROM address saying that the mail message was successfully delivered to the recipient. Each mailer in the path to the recipient that supports the DSN extension receives the same request.
This command is applicable to Multimedia Mail over Internet Protocol (MMoIP) dial peers.
DSNs are messages or responses that are automatically generated and sent to the sender or originator of an e-mail message by the Simple Mail Transfer Protocol (SMTP) server, notifying the sender of the status of the e-mail message. Specifications for DSN are described in RFC 1891, RFC 1892, RFC 1893, and RFC 1894.
The on-ramp DSN request is included as part of the fax-mail message sent by the on-ramp gateway when the matching MMoIP dial peer has been configured. The on-ramp DSN response is generated by the SMTP server when the fax-mail message is accepted. The DSN is sent back to the user defined by the mta send mail-from command. The off-ramp DSN is requested by the e-mail client. The DSN response is generated by the SMTP server when it receives a request as part of the fax-mail message.
Note
Because the SMTP server generates the DSNs, you need to configure both mail from: and rcpt to: on the server for the DSN feature to work. For example:
mail from: <user@mail-server.company.com>rcpt to: <fax=555-1212@company.com> NOTIFY=SUCCESS,FAILURE,DELAYThere are three different states that can be reported back to the sender:
•
•
•
Because these delivery states are not mutually exclusive, you can configure store-and-forward fax to generate these messages for all or any combination of these events.
DSN messages notify the sender of the status of a particular e-mail message that contains a fax TIFF image. Use the dsn command to specify which notification messages are sent to the user.
The dsn command allows you to select more than one notification option by reissuing the command and specifying a different notification option each time. To discontinue a specific notification option, use the no form of the command for that specific keyword.
If the failure keyword is not included when DSN is configured, the sender receives no notification of message delivery failure. Because a failure is usually significant, care should be taken to always include the failure keyword as part of the dsn command configuration.
This command applies to on-ramp store-and-forward fax functions.
Examples
The following example specifies that a DSN message be returned to the sender when the e-mail message that contains the fax has been successfully delivered to the recipient or if the message that contains the fax has failed to be delivered:
dial-peer voice 10 mmoipdsn successdsn failureRelated Commands
dsp services dspfarm
To enable digital-signal-processor (DSP) farm services for a particular voice network module, use the dsp services dspfarm command in interface configuration mode. To disable services, use the no form of this command.
dsp services dspfarm
no dsp services dspfarm
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
Voice-card configuration
Command History
Usage Guidelines
The router must be equipped with one or more voice network modules that provide DSP resources. DSP resources are used only if this command is configured under the particular voice card.
The number of voice network modules that must be enabled for DSP-farm services depends on the number of DSPs on the module and on the maximum number of transcoding and conferencing sessions configured for the DSP farm.
Note
Examples
The following example enables DSP-farm services on an NM-HDV2 or NM-HD-1V/2V/2VE:
Router(config)# voice-card 2Router(config-voicecard)# dsp services dspfarmRouter(config-voicecard)# exitRouter(config)# dspfarm profile 20 conferenceRouter(config-dspfarm-profile)# maximum sessions 4Router(config-dspfarm-profile)# associate application sccpRouter(config-dspfarm-profile)# no shutdownThe following example enables DSP-farm services on an NM-HDV or NM-HDV-FARM:
Router(config)# voice-card 2Router(config-voicecard)# dsp services dspfarmRouter(config-voicecard)# exitRouter(config)# dspfarm transcoder maximum sessions 15Router(config)# no dspfarmRouter(config)# dspfarmRelated Commands
dspfarm (DSP farm)
To enable digital-signal-processor (DSP) farm service, use the dspfarm command in global configuration mode. To disable the service, use the no form of this command.
dspfarm
no dspfarm
Syntax Description
This command has no arguments or keywords.
Command Default
DSP-farm service is disabled.
Command Modes
Global configuration
Command History
Usage Guidelines
The router on which this command is used must be equipped with one or more digital T1/E1 packet voice trunk network modules (NM-HDVs) or high-density voice (HDV) transcoding/conferencing DSP farms (NM-HDV-FARMs) to provide DSP resources.
Before enabling DSP-farm services, you must configure the NM-HDV or NM-HDV-FARM on which DSP-farm services are to be enabled using the dsp service dspfarm command. You must also specify the maximum number of transcoding sessions to be supported by the DSP farm using the dspfarm transcoder maximum sessions command.
This command causes the system to download new firmware into the DSPs, start up the required subsystems, and wait for a service request from the transcoding and conferencing applications.
Examples
The following example configures an NM-HDV or NM-HDV-FARM, specifies the maximum number of transcoding sessions, and enables DSP-farm services:
Router# configure terminalRouter(config)# no dspfarmRouter(config)# voice-card 2Router(config-voicecard)# dsp services dspfarmRouter(config-voicecard)# exitRouter(config)# dspfarm transcoder maximum sessions 15Router(config)# dspfarmRelated Commands
dspfarm (voice-card)
To add a specified voice card to those participating in a digital signal processor (DSP) resource pool, use the dspfarm command in voice-card configuration mode. To remove the specified card from participation in the DSP resource pool, use the no form of this command.
dspfarm
no dspfarm
Syntax Description
This command has no arguments or keywords.
Command Default
A card participates in the DSP resource pool
Command Modes
Voice-card configuration
Command History
Usage Guidelines
DSP mapping occurs when DSP resources on one AIM or network module are available for processing of voice time-division multiplexing (TDM) streams on a different network module or on a voice/WAN interface card (VWIC). This command is used on Cisco 3660 routers with multiservice interchange (MIX) modules installed or on Cisco 2600 series routers with AIMs installed.
To reach voice-card configuration mode for a particular voice card, from global configuration mode enter the voice-card command and the slot number for the AIM or network module that you want to add to the pool. See the voice-card command reference for details on slot numbering.
The assignment of DSP pool resources to particular TDM streams is based on the order in which the streams are configured with the ds0-group command for T1/E1 channel-associated signaling (CAS) or with the pri-group command for ISDN PRI.
The assignment of DSP pool resources does not occur dynamically during call signaling.
Examples
The following example adds to the DSP resource map the DSP resources on the network module in slot 5 on a Cisco 3660 with a MIX module:
voice-card 5dspfarmThe following example makes available the DSP resources on an AIM on a modular access router:
voice-card 0dspfarmRelated Commands
dspfarm confbridge maximum sessions
To specify the maximum number of concurrent conference sessions for which digital-signal-processor (DSP) farm resources should be allocated, use the dspfarm confbridge maximum sessions command in global configuration mode. To reset to the default, use the no form of this command.
dspfarm confbridge maximum sessions number
no dspfarm confbridge maximum sessions
Syntax Description
number
Number of conference sessions. A single DSP supports 1 conference session with up to 6 participants.
Command Default
0 sessions
Command Modes
Global configuration
Command History
Usage Guidelines
The router on which this command is used must be equipped with one or more digital T1/E1 packet voice trunk network modules (NM-HDVs) or high-density voice (HDV) transcoding/conferencing DSP farms (NM-HDV-FARMs) to provide DSP resources.
Before using this command, you must disable DSP-farm service using the no dspfarm command.
The maximum number of conference sessions depends upon DSP availability in the DSP farm. A single DSP supports one conference session with up to six participants. However, you may need to allocate additional DSP resources for transcoding to support conferences. If all participants use G.711 or G.729 codecs, you need not allocate any additional DSP resources because transcoding is done in the conferencing DSP.
When you use this command, take into consideration the number of DSPs allocated for transcoding services with the dspfarm transcoder maximum sessions command.
Examples
The following example sets the maximum number of conferencing sessions to 8:
Router# dspfarm confbridge maximum sessions 8Related CommandsT
dspfarm connection interval
To specify the time interval during which to monitor Real-Time Transport Protocol (RTP) inactivity before deleting an RTP stream, use the dspfarm connection interval command in global configuration mode. To reset to the default, use the no form of this command.
dspfarm connection interval seconds
no dspfarm connection interval
Syntax Description
seconds
Interval, in seconds, during which to monitor RTP inactivity. Range is from 60 to 10800. Default is 600.
Command Default
600 seconds
Command Modes
Global configuration
Command History
Usage Guidelines
The router on which this command is used must be equipped with one or more digital T1/E1 packet voice trunk network modules (NM-HDVs) or high-density voice (HDV) transcoding/conferencing DSP farms (NM-HDV-FARMs) to provide digital-signal-processor (DSP) resources.
After each interval, RTP streams are checked for inactivity. If all RTP streams for a particular call are inactive, the RTP timer, as set with the dspfarm rtp timeout command, is started. When the RTP timer expires, the call is deleted.
Examples
The following example sets the connection interval to 60 seconds:
Router(config)# dspfarm connection interval 60Related Commands
dspfarm rtp timeout
Specifies the RTP timeout interval used to clear hanging connections.
dspfarm profile
To enter DSP farm profile configuration mode and define a profile for digital signal processor (DSP) farm services, use the dspfarm profile command in global configuration mode. To delete a disabled profile, use the no form of this command.
dspfarm profile profile-identifier {conference | mtp | transcode} [security]
no dspfarm profile profile-identifier
Syntax Description
Command Default
No default behavior or values
Command Modes
Global configuration (config)
Command History
12.3(8)T
This command was introduced.
12.4(11)XW
The security keyword was added.
Usage Guidelines
Use this command to create a new profile or delete a disabled profile. After you create a new profile in dspfarm profile configuration mode, use the no shutdown command to enable the profile configuration, allocate resources and associate the profile with the application(s). If the profile cannot be enabled due to lack of resources, the system prompts you with a message "Can not enable the profile due to insufficient resources, resources available to support X sessions; please modify the configuration and retry."
If the DSP farm profile is successfully created, you enter the DSP farm profile configuration mode. You can configure multiple profiles for the same service.
Use the no dspfarm profile command to delete a profile from the system. If the profile is active, you cannot delete it; you must first disable it using the shutdown command. To modify a DSP farm profile, use the shutdown command in dspfarm profile configuration mode before you begin configuration.
The profile identifier uniquely identifies a profile. If the service type and profile identifier are not unique, the user is prompted with a message to choose a different profile identifier.
You must use the security keyword in order to enable secure DSP farm services such as secure transcoding.
Examples
The following example enables DSP farm services profile 20 for conferencing:
Router(config)# dspfarm profile 20 conferenceNote the response if the profile is already being used:
Router(config)# dspfarm profile 6 conferenceProfile id 6 is being used for service TRANSCODINGplease select a different profile idRelated Commands
dspfarm rtp timeout
To specify the Real-Time Transport Protocol (RTP) timeout interval used to clear hanging connections, use the dspfarm rtp timeout command in global configuration mode. To reset to the default, use the no form of this command.
dspfarm rtp timeout seconds
no dspfarm rtp timeout
Syntax Description
Command Default
1200 seconds (20 minutes)
Command Modes
Global configuration
Command History
Usage Guidelines
The router on which this command is used must be equipped with one or more digital T1/E1 packet voice trunk network modules (NM-HDVs) or high-density voice (HDV) transcoding/conferencing DSP farms (NM-HDV-FARMs) to provide digital-signal-processor (DSP) resources.
Use this command to set the RTP timeout interval for when the error condition "RTP port unreachable" occurs.
Examples
The following example sets the RTP timeout value to 600 seconds (10 minutes):
Router# dspfarm rtp timeout 600Related Commands
dspfarm transcoder maximum sessions
To specify the maximum number of transcoding sessions to be supported by the digital-signal-processor (DSP) farm, use the dspfarm transcoder maximum sessions command in global configuration mode. To reset to the default, use the no form of this command.
dspfarm transcoder maximum sessions number
no dspfarm transcoder maximum sessions
Syntax Description
Command Default
0 sessions
Command Modes
Global configuration
Command History
Usage Guidelines
The router on which this command is used must be equipped with one or more digital T1/E1 packet voice trunk network modules (NM-HDVs) or high-density voice (HDV) transcoding/conferencing DSP farms (NM-HDV-FARMs) to provide DSP resources.
Before using this command, you must disable DSP-farm service using the no dspfarm command.
Use this command in conjunction with the dspfarm confbridge maximum sessions commands.
The maximum number of transcoding sessions depends upon DSP availability in the DSP farm. A single DSP supports four transcoding sessions transmission to and from G.711 and G.729 codecs.
Examples
The following example configures an NM-HDV or NM-HDV-FARM, specifies the maximum number of transcoding sessions, and enables DSP-farm services:
Router# configure terminalRouter(config)# no dspfarmRouter(config)# voice-card 2Router(config-voicecard)# dsp services dspfarmRouter(config-voicecard)# exitRouter(config)# dspfarm transcoder maximum sessions 15Router(config)# dspfarmRelated Commands
dspint dspfarm
To enable the digital signal processor (DSP) interface, use the dspint dspfarm command in global configuration mode. This command does not have a no form.
dspint dspfarm slot/port
Syntax Description
Command Default
Enabled
Command Modes
Global configuration
Command History
Usage Guidelines
DSP mapping occurs when DSP resources on one advanced interface module (AIM) or network module are available for processing of voice time-division multiplexing (TDM) streams on a different network module or on a voice/WAN interface card (VWIC). This command is used on Cisco 3660 routers with multiservice interchange (MIX) modules installed or on Cisco 2600 series routers with AIMs installed.
To reach voice-card configuration mode for a particular voice card, from global configuration mode enter the voice-card command and the slot number for the AIM or network module that you want to add to the pool. See the voice-card command reference for details on slot numbering.
The assignment of DSP pool resources to particular TDM streams is based on the order in which the streams are configured using the ds0-group command for T1/E1 channel-associated signaling (CAS) or using the pri-group command for ISDN PRI.
The assignment of DSP pool resources does not occur dynamically during call signaling.
To disable the interface use the no shutdown command.
Examples
The following example creates a DSP farm interface with a slot number of 1 and a port number of 0.
dspint dspfarm 1/0To change codec complexity on the Cisco 7200 series, you must enter the following commands:
Router# configure terminalRouter(config)# dspint dspfarm 2/0Router(config-dspfarm)# codec medium | high ecan-extendedRelated Commands
dtmf timer inter-digit
To configure the dual tone multifrequency (DTMF) interdigit timer for a DS0 group, use the dtmf timer inter-digit command in T1 controller configuration mode. To restore the timer to its default value, use the no form of this command.
dtmf timer inter-digit milliseconds
no dtmf timer inter-digit
Syntax Description
milliseconds
DTMF interdigit timer duration, in milliseconds. Range is from 250 to 3000. The default is 3000.
Command Default
3000 milliseconds
Command Modes
T1 controller configuration
Command History
Usage Guidelines
Use the dtmf timer inter-digit command to specify the duration in milliseconds the router waits to detect the end of DTMF digits. After this period, the router expects no more digits to arrive and establishes the call.
Examples
The following example, beginning in global configuration mode, sets the DTMF interdigit timer value to 250 milliseconds:
controller T1 2ds0-group 2 timeslots 4-10 type e&m-fgb dtmf dniscas-custom 2dtmf timer inter-digit 250Related Commands
dtmf-relay (Voice over Frame Relay)
To enable the generation of FRF.11 Annex A frames for a dial peer, use the dtmf-relay command in dial peer configuration mode. To disable the generation of FRF.11 Annex A frames and return to the default handling of dial digits, use the no form of this command.
dtmf-relay
no dtmf-relay
Syntax Description
This command has no arguments or keywords.
Command Default
Disabled
Command Modes
Dial peer configuration
Command History
Usage Guidelines
Cisco recommends that this command be used with low bit-rate codecs.
When dtmf-relay (VoFR) is enabled, the digital signal processor (DSP) generates Annex A frames instead of passing a dual-tone multifrequency (DTMF) tone through the network as a voice sample. For information about the payload format of FRF.11 Annex A frames, see the Cisco IOS Wide-Area Networking Configuration Guide.
Examples
The following example shows how to enable FRF.11 Annex A frames for VoFR dial peer 200, starting from global configuration mode:
dial-peer voice 200 vofrdtmf-relayRelated Commands
dtmf-relay (Voice over IP)
To specify how an H.323 or Session Initiation Protocol (SIP) gateway relays dual tone multifrequency (DTMF) tones between telephony interfaces and an IP network, use the dtmf-relay command in dial peer voice configuration mode. To remove all signaling options and send the DTMF tones as part of the audio stream, use the no form of this command.
dtmf-relay {[cisco-rtp] [h245-alphanumeric] [h245-signal] [rtp-nte [digit-drop]] [sip-notify]}
no dtmf-relay
Syntax Description
Command Default
DTMF tones are disabled and sent in-band. That is, they are left in the audio stream.
Command Modes
Dial peer voice configuration
Command History
Usage Guidelines
DTMF is the tone generated when you press a button on a touch-tone phone. This tone is compressed at one end of a call; when the tone is decompressed at the other end, it can become distorted, depending on the codec used. The DTMF relay feature transports DTMF tones generated after call establishment out-of-band using either a standard H.323 out-of-band method or a proprietary RTP-based mechanism. For SIP calls, the most appropriate method to transport DTMF tones is RTP-NTE or SIP-NOTIFY.
This command specifies how an H.323 or SIP gateway relays DTMF tones between telephony interfaces and an IP network.
You must include one or more keywords when using this command.
To avoid sending both in-band and out-of band tones to the outgoing leg when sending IP-to-IP gateway calls in-band (rtp-nte) to out-of band (h245-alphanumeric), configure the dtmf-relay command using the rtp-nte and digit-drop keywords on the incoming SIP dial peer. On the H.323 side, and for H.323 to SIP calls, configure this command using either the h245-alphanumeric or h245-signal keyword.
The SIP-NOTIFY method sends NOTIFY messages bidirectionally between the originating and terminating gateways for a DTMF event during a call. If multiple DTMF relay mechanisms are enabled on a SIP dial peer and are negotiated successfully, the SIP-NOTIFY method takes precedence.
SIP NOTIFY messages are advertised in an invite message to the remote end only if the dtmf-relay command is set.
For SIP, the gateway chooses the format according to the following priority:
1.
2.
3.
The gateway sends DTMF tones only in the format that you specify if the remote device supports it. If the H.323 remote device supports multiple formats, the gateway chooses the format according to the following priority:
1.
2.
3.
4.
5.
The principal advantage of the dtmf-relay command is that it sends DTMF tones with greater fidelity than is possible in-band for most low-bandwidth codecs, such as G.729 and G.723. Without the use of DTMF relay, calls established with low-bandwidth codecs may have trouble accessing automated DTMF-based systems, such as voice mail, menu-based Automatic Call Distributor (ACD) systems, and automated banking systems.
Note
•
•
•
Examples
The following example configures DTMF relay with the cisco-rtp keyword when DTMF tones are sent to dial peer 103:
dial-peer voice 103 voipdtmf-relay cisco-rtpThe following example configures DTMF relay with the cisco-rtp and h245-signal keywords when DTMF tones are sent to dial peer 103:
dial-peer voice 103 voipdtmf-relay cisco-rtp h245-signalThe following example configures the gateway to send DTMF in-band (the default) when DTMF tones to are sent dial peer 103:
dial-peer voice 103 voipno dtmf-relayThe following example configures DTMF relay with the digit-drop keyword to avoid both in-band and out-of band tones being sent to the outgoing leg on H.323 to H.323 or H.323 to SIP calls:
dial-peer voice 1 voipsession protocol sipv2dtmf-relay h245-alphanumeric rtp-nte digit-dropThe following example configures DTMF relay with the rtp-nte keyword when DTMF tones are sent to dial peer 103:
dial-peer voice 103 voipdtmf-relay rtp-nteThe following example configures the gateway to send DTMF tones using SIP NOTIFY messages to dial peer 103:
dial-peer voice 103 voipsession protocol sipv2dtmf-relay sip-notifyRelated Commands
notify telephone-event
Configures the maximum interval between two consecutive NOTIFY messages for a particular telephone event.
dualtone
To enter cp-dualtone configuration mode for specifying a custom call-progress tone, use the dualtone command in custom-cptone voice-class configuration mode. To configure the custom-cptone voice class not to detect a call-progress tone, use the no form of this command.
dualtone {busy | conference | disconnect | number-unobtainable | out-of-service | reorder | ringback}
no dualtone {busy | conference | disconnect | number-unobtainable | out-of-service | reorder | ringback}
Syntax Description
Command Default
No call-progress tones are defined within the custom-cptone voice class
Command Modes
Custom-cptone voice-class configuration
Command History
Usage Guidelines
The dualtone command enters cp-dualtone configuration mode and specifies a call-progress tone to be detected. You can specify additional call-progress tones without exiting cp-dualtone configuration mode.
Any call-progress tones that are not specified are not detected.
To delete a call-progress tone from this custom-cptone voice class, use the no form of this command and the keyword for the tone that should not be detected; for example, no dualtone busy.
You must associate the class of custom call-progress tones with a voice port for this command to affect tone detection.
Use the dualtone conference command to define custom join and leave tones for hardware conferences.
Examples
The following example enters cp-dualtone configuration mode and specifies busy tone and ringback tone in the custom-cptone voice class country-x.
Router(config)# voice class custom-cptone country-xRouter(cfg-cptone)# dualtone busyRouter(cfg-cp-dualtone)# frequency 440 480Router(cfg-cp-dualtone)# cadence 500 500Router(cfg-cp-dualtone)# exitRouter(cfg-cptone)# dualtone ringbackRouter(cfg-cp-dualtone)# frequency 400 440Router(cfg-cp-dualtone)# cadence 2000 4000The following example deletes ringback tone from the custom-cptone voice class country-x.
Router(config)# voice class custom-cptone country-xRouter(cfg-cptone)# no dualtone ringbackThe following example configures a conference leave tone. The configured leave tone must be associated with a digital signal processor (DSP) farm profile.
Router(config)# voice class custom-cptone leavetoneRouter(cfg-cptone)# dualtone conferenceRouter(cfg-cp-dualtone)# frequency 500 500Router(cfg-cp-dualtone)# cadence 100 100 100 100 100Related Commands
