Table Of Contents
snmp enable peer-trap poor-qov
Voice-Related Commands
This chapter documents voice-related commands used to configure Voice over IP, Voice over Frame Relay, Voice over HDLC, and Voice over ATM. Commands in this section are listed alphabetically. For this release, Voice over IP is specific to the Cisco 3600 series; Voice over Frame Relay, Voice over ATM, Voice over HDLC, and Frame Relay-ATM Interworking are specific to the Cisco MC3810. For information on how to configure Voice over IP, Voice over Frame Relay, Voice over ATM, or Voice over HDLC, refer to the Voice, Video, and Home Applications Configuration Guide.
Table 1 describes which commands apply to each protocol.
acc-qos
To generate an SNMP event if the quality of service for a dial peer drops below a specified level, use the acc-qos dial-peer configuration command. Use the no form of this command to restore the default value.
acc-qos {best-effort | controlled-load | guaranteed-delay}
no acc-qos
Syntax Description
Default
best-effort
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is only applicable to Cisco 3600 series VoIP peers.
Use the acc-qos dial-peer configuration command to generate an SNMP event if the quality of service for specified dial peer drops below the specified level. When a dial peer is used, the Cisco IOS software reserves a certain amount of bandwidth so that the selected quality of service can be provided. Cisco IOS software uses Resource Reservation Protocol (RSVP) to request quality of service guarantees from the network.
To select the most appropriate value for this command, you need to be familiar with the amount of traffic this connection supports and what kind of impact you are willing to have on it. The Cisco IOS software generates a trap message when the bandwidth required to provide the selected quality of service is not available.
Example
The following example selects guaranteed-delay as the specified level below which an SNMP trap message will be generated:
dial-peer voice 10 voipacc-qos guaranteed-delayRelated Commands
req-qos
alt-dial
To configure an alternate dial-out string for dial peers on the Cisco MC3810, use the alt-dial dial-peer configuration command. Use the no form of this command to delete the alternate dial-out string.
alt-dial string
no alt-dial string
Syntax Description
Default
No alternate dial-out string is configured.
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Cisco MC3810 POTS, VoFR, VoATM, and VoHDLC dial peers.
The alt-dial command is used for the on-net-to-off-net alternative dialing function. The string replaces the destination-pattern string for dialing out.
Example
The following example configures an alternate dial-out string of 9,5559871:
alt-dial 9,5559871answer-address
To specify the full E.164 telephone number to be used to identify the dial peer of an incoming call, use the answer-address dial-peer configuration command. Use the no form of this command to disable the configured telephone number.
answer-address [+]string[t]
no answer-address
Syntax Description
Default
The default value is enabled with a null string.
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is applicable to both Cisco 3600 series VoIP and POTS dial peers.
Use the answer-address command to identify the origin (or dial peer) of incoming calls from the IP network. Cisco IOS software identifies the dial peers of a call in one of two ways: either by identifying the interface through which the call is received or through the telephone number configured with the answer-address command. In the absence of a configured telephone number, the peer associated with the interface will be associated with the incoming call.
For calls coming in from a POTS interface, the answer-address command is not used to select an incoming dial peer. The incoming POTS dial peer is selected on the basis of the port configured for that dial peer.
There are certain areas in the world (for example, in certain European countries) where valid telephone numbers can vary in length. Use the optional control character t to indicate that a particular answer-address value is a variable-length dial-string. In this case, the system will not match the dialed numbers until the interdigit timeout value has expired.
Note
The Cisco IOS software does not check the validity of the E.164 telephone number; it accepts any series of digits as a valid number.
Example
The following example configures the E.164 telephone number, "555-9626" as the dial peer of an incoming call:
dial-peer voice 10 potsanswer-address +5559626Related Commands
destination-pattern
port
prefix
timeouts interdigitatm compression
To specify the software compression mode on the Cisco MC3810, use the atm compression interface configuration command. Use the no form of this command to remove the compression mode setting.
atm compression {per-packet | per-interface | per-vc}
no atm compression {per-packet | per-interface | per-vc}
Syntax Description
Default
per-packet
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to ATM configuration on the Cisco MC3810.
Example
The following example configures per-packet ATM compression:
interface atm0atm compression per-packetclear voice port
To clear voice port calls in progress on the Cisco MC3810, use the clear voice port privileged EXEC command.
clear voice port [slot/port]
Syntax Description
slot/port
(Optional) The voice port slot number and port number. If you do not specify a voice port, all calls on all voice ports are cleared.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
If you do not specify a voice port, all calls on all voice ports are cleared. A confirmation prompt is displayed.
Example
The following example clears all calls on voice port 1/2 on the Cisco MC3810:
clear voice port 1/2clock rate line
To configure the line clock rate for serial ports 0 or 1 in DTE mode on the Cisco MC3810, use the clock rate line interface configuration command. Use the no form of this command to cancel the clock rate line value.
clock rate line rate
no clock rate line rate
Syntax Description
Default
No clock rate is set.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command specifies the rate of the incoming clock so that the appropriate internal clock scaling can be performed.
To configure the clock rate for a serial port in DTE mode, use the clock rate network-clock command.
Example
The following configures the clock rate on serial 1 in DTE mode:
interface serial 1clock rate line 2048Related Commands
clock rate network-clock
clock source
network-clock base-rateclock rate network-clock
To configure the network clock speed for serial ports 0 or 1 in DCE mode on the Cisco MC3810, use the clock rate network-clock interface configuration command. Use the no form of this command to cancel the network clock speed value.
clock rate network-clock rate
no clock rate network-clock rate
Syntax Description
Default
No clock rate is set.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command uses a synchronized clock on the serial port. The use of this command allows the clock on the serial port to be synchronized with the clock source of controller T1 0.
To configure the clock rate for a serial port in DTE mode, use the clock rate line command.
Example
The following configures the clock rate on serial 1 in DCE mode:
interface serial 1clock rate network-clock 2048Related Commands
clock rate line
clock source
network-clock base-ratecodec (dial-peer)
To specify the voice coder rate of speech for a dial peer, use the codec dial-peer configuration command. Use the no form of this command to reset the default value.
codec {g711alaw | g711ulaw | g729r8}
no codec
Syntax Description
g711alaw
G.711 A-Law 64,000 bits per second (bps).
g711ulaw
G.711 u-Law 64,000 bps.
g729r8
G.729 8000 bps. This is the default CODEC.
Default
g729r8
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is only applicable to Cisco 3600 series VoIP peers.
Use the codec command to define a specific voice coder rate of speech for a dial peer.
For toll quality, use g711alaw or g711ulaw. These values provide high-quality voice transmission but use a significant amount of bandwidth. For almost toll quality (and a significant savings in bandwidth), use the g729r8 value.
If codec values for the VoIP peers of a connection do not match, the call will fail.
Note
Example
The following example configures a voice coder rate that provides toll quality and uses a relatively high amount of bandwidth:
dial-peer voice 10 voipcodec g711alawcompress
To configure whether compression is applied to the voice connection on the ATM permanent virtual circuit (PVC) for the Cisco MC3810, use the compress ATM virtual circuit configuration command. Use the no form of this command to turn off compression.
compress
no compress
Syntax Description
This command has no arguments or keywords.
Default
No compression
Command Mode
ATM virtual circuit configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 12.0.
This command applies to the ATM configuration on the Cisco MC3810.
Example
The following example configures ATM PVC 20 to support voice compression:
pvc 20compresscross-connect
To cross-connect two groups of digital signal level 0s (DS0s) from two controllers on the Cisco MC3810, or to cross-connect the Universal I/O (UIO) serial port for pass-through traffic to a trunk controller, use the cross-connect global configuration command. Use the no form of this command to remove the cross-connect function for the given controller.
For pass-through between two controllers, use the following commands:
cross-connect id controller-1 tdm-group-no-1 controller-2 tdm-group-no-2
no cross-connect id controller-1 tdm-group-no-1 controller-2 tdm-group-no-2
For pass-through traffic from a UIO serial port to a trunk controller, use the following commands:
cross-connect id interface-serial controller tdm-group-no
no cross-connect id interface-serial controller tdm-group-no
Note
Syntax Description
For pass-through between two controllers:
For pass-through from a UIO serial port to a controller
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, Voice over HDLC, and Frame Relay-ATM Interworking on the Cisco MC3810.
Example
The following example configures a pass-through cross-connect from serial port 0 to controller T1 1 on TDM group 20.
cross-connect 10 serial0 T1 1 20Related Commands
destination-pattern
To specify either the prefix or the full E.164 telephone number (depending on your dial plan) to be used for a dial peer, use the destination-pattern dial-peer configuration command. Use the no form of this command to disable the configured prefix or telephone number.
destination-pattern [+]string[t]
no destination-pattern
Syntax Description
Default
enabled with a null string
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is applicable to both VoIP and POTS dial peers on all platforms.
Use the destination-pattern command to define the E.164 telephone number for this dial peer.
This pattern is used to match dialed digits to a dial peer. The dial peer is then used to complete the call. When a router receives voice data, it compares the called number (the full E.164 telephone number) in the packet header with the number configured as the destination pattern for the voice-telephony peer. The router then strips out the left-justified numbers corresponding to the destination pattern. If you have configured a prefix, the prefix is appended to the front of the remaining numbers, creating a dial string, which the router then dials. If all numbers in the destination pattern are stripped-out, the user receives a dial tone.
There are certain areas in the world (for example, in certain European countries) where valid telephone numbers can vary in length. Use the optional control character t to indicate that a particular destination-pattern value is a variable-length dial-string. In this case, the system does not match the dialed numbers until the interdigit timeout value has expired.
Note
Example
The following example configures the E.164 telephone number, "555-7922," for a dial peer:
dial-peer voice 10 potsdestination-pattern +5557922Related Commands
answer-address
prefix
timeouts interdigitdial-control-mib
To specify attributes for the call history table, use the dial-control-mib global configuration command.
dial-control-mib {max-size number | retain-timer number}
Syntax Description
Default
The default call history table length is 50 table entries. The default retain timer is 15 minutes.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series.
Example
The following example configures the call history table to hold 400 entries, with each entry remaining in the table for 10 minutes:
configure terminaldial-control-mib max-size 400dial-control-mib retain-timer 10dial-peer terminator
To designate a special character to be used as a terminator for variable length dialed numbers, use the dial-peer terminator global configuration command. Use the no form of this command to disable the designated terminating character.
dial-peer terminator character
no dial-peer terminator character
Syntax Description
character
Designates the terminating character for a variable-length dialed number. Valid numbers and characters are #, *, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, and d.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 12.0.
This command applies only to the Cisco 3600 series.
There are certain areas in the world (for example, in certain European countries) where valid telephone numbers can vary in length. When a dialed-number string has been identified as a variable length dialed-number, the system waits until the configured value for the timeouts interdigits command has expired before placing the call. To avoid waiting until the interdigit timeout value has expired, you can designate a special character as a terminator—meaning that when you dial that character, the system no longer waits for any additional digits and places the call. Use the dial-peer terminator global configuration command to designate a particular character as a terminator.
Example
The following example configures # as the special terminating character for variable-length dialed-numbers:
configure terminaldial-peer terminator #Related Commands
answer-address
destination-pattern
timeouts interdigitdial-peer voice
To enter dial-peer configuration mode (and specify the method of voice-related encapsulation), use the dial-peer voice global configuration command.
For the Cisco 3600 series:
dial-peer voice number {voip | pots}
For the Cisco MC3810:
dial-peer voice tag-number {pots | voatm | vofr | vohdlc}
Syntax Description
For the Cisco 3600 series Voice over IP:
For the Cisco MC3810:
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to all voice applications on both the Cisco MC3810 and the Cisco 3600 series.
Use the dial-peer voice global configuration command to switch to the dial-peer configuration mode from the global configuration mode. Use the exit command to exit the dial-peer configuration mode and return to the global configuration mode.
Example
The following example accesses dial-peer configuration mode and configures a POTS peer identified as dial peer 10:
configure terminaldial-peer voice 10 potsRelated Commands
voice-port
expect-factor
To specify when the router will generate an alarm to the network manager, indicating that the expected quality of voice has dropped, use the expect-factor dial-peer configuration command. Use the no form of this command to reset the default value.
expect-factor value
no expect-factor value
Syntax Description
value
Integers that represent the ITU specification for quality of voice as described in G.113. Valid entries are from 0 to 20, with 0 representing toll quality.
Default
10
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Cisco 3600 series VoIP peers.
Voice over IP monitors the quality of voice received over the network. Use the expect-factor command to specify when the router will generate an SNMP trap to the network manager.
Example
The following example configures toll quality of voice when connecting to a dial peer:
dial-peer voice 10 voipexpect-factor 0fax-rate
To establish the rate at which a fax will be sent to the specified dial peer, use the fax-rate dial-peer configuration command. Use the no form of this command to reset the default value.
fax-rate {2400 | 4800 | 7200 | 9600 | 14400 | disable | voice}
no fax-rate
Syntax Description
Default
voice
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is only applicable to Cisco 3600 series VoIP peers.
Use the fax-rate command to specify the fax transmission rate to the specified dial peer.
The values for this command apply only to the fax transmission speed and do not affect the quality of the fax itself. The higher values provide a faster transmission speed but monopolize a significantly larger portion of the available bandwidth. Slower transmission speeds use less bandwidth.
If the fax-rate command is set above the codec rate in the same dial peer, the data sent over the network for fax transmission will be above the bandwidth reserved for RVSP. Because more network bandwidth will be monopolized by the fax transmission, we do not recommend setting the fax-rate value higher than the codec value. If the fax-rate value is set lower than the codec value, faxes will take longer to transmit but will use less bandwidth.
Example
The following example configures a transmission speed of 9600 bps for faxes sent to a dial peer:
dial-peer voice 10 voipfax-rate 9600Related Commands
codec
forward-digits
To configure forward digits for voice calls on the Cisco MC3810, use the forward-digits dial-peer configuration command. Use the no form of this command to restore the default value.
forward-digits {num-digit | all}
no forward-digits {num-digit | all}
Syntax Description
Default
No digits are forwarded.
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies only to the Cisco MC3810.
Forwarded digits are always right-justified so that extra leading digits are stripped.
Example
The following example configures forward digits for a POTS dial peer on a Cisco MC3810:
dial-peer voice 1 pots destination-pattern 8... forward-digits allRelated Commands
fr-atm connect dlci
To map a Frame Relay DLCI to an ATM virtual circuit descriptor (VCD) for the FRF.5 Frame Relay-ATM interworking function on the Cisco MC3810, use the fr-atm connect dlci interface configuration command. The encapsulation type of the current interface must be Frame Relay or Frame Relay 1490 (IETF). Use the no form of this command to remove the DLCI to VCD map.
fr-atm connect dlci dlci atm-interface pvc [name | [vpi/] vci]
no fr-atm connect dlci dlci atm-interface pvc [name | [vpi/] vci]
Syntax Description
Default
No Frame Relay-ATM mapping is configured.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Frame Relay-ATM Interworking on the Cisco MC3810.
Note
Example
The following example configures a Frame Relay-ATM Interworking connection on FR-ATM interface 20, in which Frame Relay DLCI 100 is mapped to ATM VCI/VPI 100/200 for ATM interface 0.
interface fr-atm 20fr-atm connect dlci 100 atm0 100/200icpif
To specify the Calculated Planning Impairment Factor (ICPIF) for calls sent by a dial peer, use the icpif dial-peer configuration command. Use the no form of this command to restore the default value.
icpif number
no icpif number
Syntax Description
number
Integer, expressed in equipment impairment factor units, specifying the ICPIF value. Valid entries are 0 to 55. The default is 30.
Default
30
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is applicable only to Cisco 3600 series VoIP peers.
Use the icpif command to specify the maximum acceptable impairment factor for the voice calls sent by the selected dial peer.
Example
The following example disables the icpif command:
dial-peer voice 10 voipicpif 0interface fr-atm
To create a Frame Relay-ATM Interworking interface on the Cisco MC3810 and to enter Frame Relay-ATM Interworking configuration mode, use the interface fr-atm global configuration command. Use the no form of this command to delete the Frame Relay-ATM Interworking interface.
interface fr-atm number
no interface fr-atm number
Syntax Description
Default
Frame Relay-ATM Interworking interface 20 is configured by default.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Frame Relay-ATM Interworking on the Cisco MC3810 only.
Use the interface fr-atm command to enter Frame Relay-ATM interworking interface configuration mode. When you enter this command for the first time, an interface number is created dynamically. You can configure up to 21 Frame Relay-ATM interworking interfaces.
Note
Example
The following example configures Frame Relay-ATM Interworking interface number 20:
interface fr-atm 20Related Command
fr-atm connect dlci
ip udp checksum
To calculate the UDP checksum for voice packets transmitted by the dial peer, use the ip udp checksum dial-peer configuration command. Use the no form of this command to disable this feature.
ip udp checksum
no ip udp checksum
Syntax Description
This command has no arguments or keywords.
Default
disabled
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is applicable to Cisco 3600 series VoIP peers.
Use the ip udp checksum command to enable UDP checksum calculation for each of the outbound voice packets. This command is disabled by default to speed up the transmission of the voice packets. If you suspect that the connection has a high error rate, you should enable ip udp checksum to prevent bad voice packets forwarded to the DSP.
Example
The following example calculates the UDP checksum for voice packets transmitted by this dial peer:
dial-peer voice 10 voipip udp checksumRelated Commands
loop-detect
loop-detect
To enable loop detection for T1, use the loop-detect controller configuration command. Use the no form of the command to cancel the loop detect operation.
loop-detect
no loop-detect
Syntax Description
This command has no arguments or keywords.
Default
Loop detection is disabled.
Command Mode
Controller configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
Example
The following example configures loop detection for controller T1 0:
controller t1 0loop-detectRelated Commands
loopback
mode (Voice over ATM)
To set the mode of the T1/E1 controller and enter specific configuration commands for each mode type, use the mode controller configuration command. Use the no form of this command to restore the default mode of the controller.
mode {atm | cas}
no mode {atm | cas}
Syntax Description
Default
No mode is configured.
Command Mode
Controller configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to the Cisco MC3810 with the digital voice module (DVM) installed.
When no mode is selected, channel groups and clear channels (data mode) can be created using the channel group and tdm-group commands, respectively.
On the Cisco MC3810, some DS0s are used exclusively for different signaling modes. The DS0 channels have the following limitations when mixing different applications (such as voice and data) on the same network trunk:
•
•
Examples
The following example configures ATM mode on controller T1 0. This step is required for Voice over ATM:
controller T1 0mode atmThe following example configures CAS mode on controller T1 1:
controller T1 1mode casRelated Commands
channel-group
tdm-group
voice-groupnetwork-clock base-rate
To configure the network clock base rate for universal I/O serial ports 0 and 1 on the Cisco MC3810, use the network-clock base-rate global configuration command. Use the no form of this command to disable the current network clock base rate.
network-clock base-rate {56k | 64k}
no network-clock base-rate {56k | 64k}
Syntax Description
56k
Sets the network clock base rate to 56 kilobits per second (kbps).
64k
Sets the network clock base rate to 64kbps.
Default
56 kbps
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, Voice over HDLC, and Frame Relay-ATM Interworking on the Cisco MC3810.
Example
The following example sets the network clock base-rate to 64 kbps:
network-clock base-rate 64kRelated Commands
network-clock-select (MC3810)
network-clock-switchnetwork-clock-select (MC3810)
To use the network clock source to provide timing to the system backplane pulse code modulation (PCM) bus, use the network-clock-select global configuration command. Use the no form of this command to cancel the network clock selection.
network-clock-select priority [serial 0 | system | controller]
no network-clock-select priority [serial 0 | system | controller]
Syntax Description
Default
No network clock source is specified.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, Voice over HDLC, and Frame Relay-ATM Interworking on the Cisco MC3810.
Example
The following example sets the priority of four network clock sources. When the clock source with the highest priority (controller T1 0) fails, the Cisco MC3810 switches the clock source to the second highest priority (controller T1 1).
network-clock-select 1 T1 0 network-clock-select 2 T1 1 network-clock-select 3 serial 0 network-clock-select 4 SystemRelated Commands
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 global configuration command. Use the no form of this command to cancel the network clock delay time selection.
network-clock-switch [switch-delay | never] [restore-delay | never]
no network-clock-switch delay
Syntax Description
Default
10 seconds
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, Voice over HDLC, and Frame Relay-ATM Interworking on the Cisco MC3810.
Example
The following command 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 20Related Commands
num-exp
To define how to expand an extension number into a particular destination pattern, use the num-exp global configuration command. Use the no form of this command to cancel the configured number expansion.
num-exp extension-number expanded-number
no num-exp extension-number expanded-number
Syntax Description
Default
No number expansion is defined.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series.
Use the num-exp global configuration command to define how to expand a particular set of numbers (for example, an extension number) into a particular destination pattern. With this command, you can map 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 less than seven digits.
Use a period (.) as a variable or wild card, representing a single number. Use a separate period for each number you want to represent with a wildcard—meaning that if you want to replace four numbers in an extension with wildcards, type in four periods.
Examples
The following example expands the extension number 55541 to be expanded to 14085555541:
num-exp 65541 14085555541The following example expands all five-digit extensions beginning with 5 to append the following numbers at the beginning of the extension number 1408555:
num-exp 5.... 1408555....port (voice)
To associate a dial peer with a specific voice port, use the port dial-peer configuration command. Use the no form of this command to cancel this association.
For the Cisco 3600 series:
port slot-number/subunit-number/port
no port
For the Cisco MC3810:
port slot/port
no port
Syntax Description
Default
No port is configured.
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is applicable only to POTS peers on both the Cisco 3600 series and the Cisco MC3810.
Use the port configuration command to associate the designated voice port with the selected dial peer.
This command is used for calls incoming from a telephony interface to select an incoming dial peer and for calls coming from the VoIP network to match a port with the selected outgoing dial peer.
Examples
The following example associates a Cisco 3600 series dial peer with voice port 1, which is located on subunit 0, and accessed through port 0:
dial-peer voice 10 potsport 1/0/0The following example associates a Cisco MC3810 dial peer with voice port 1/1:
port 1/1preference
To indicate the preference order of the dial peer on the Cisco MC3810, use the preference dial-peer configuration command. Setting the preference is useful in selecting the desired dial peer when multiple dial peers are matched for a dial string. Use the no form of this command to remove the preference value on the voice port.
preference value
no preference value
Syntax Description
value
An integer value from 0 to 10, where the lower the number, the higher the preference. The default value is 0 (highest preference).
Default
0 (highest preference)
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Cisco MC3810 POTS, Voice over Frame Relay, Voice over ATM, and Voice over HDLC dial peers.
Note
Examples
The following example configures POTS dial peer 10 to a preference of 1 and VoFR dial peer 20 to a preference of 2:
dial-peer voice 10 potspreference 1dial-peer voice 20 vofrpreference 2prefix
To specify the prefix of the dialed digits for this dial peer, use the prefix dial-peer configuration command. Use the no form of this command to disable this feature.
prefix string
no prefix
Syntax Description
string
Integers representing the prefix of the telephone number associated with the specified dial peer. Valid numbers are 0 through 9, and a comma (,). Use a comma to include a pause in the prefix.
Default
Null string
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Cisco 3600 series and Cisco MC3810 POTS peers.
Use the prefix command to specify a prefix for a specific dial peer. When an outgoing call is initiated to this dial peer, the prefix string value is sent to the telephony interface first, before the telephone number associated with the dial peer.
If you want to configure different prefixes for dialed numbers on the same interface, you need to configure different dial peers.
Example
The following example specifies a prefix of "9" and then a pause:
dial-peer voice 10 potsprefix 9,Related Commands
answer-address
destination-patternreq-qos
To specify the desired quality of service to be used in reaching a specified dial peer, use the req-qos dial-peer configuration command. Use the no form of this command to restore the default value for this command.
req-qos {best-effort | controlled-load | guaranteed-delay}
no req-qos
Syntax Description
Default
best-effort. The no form of this command restores the default value.
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is applicable only to Cisco 3600 series VoIP peers.
Use the req-qos command to request a specific quality of service to be used in reaching a dial peer. Like acc-qos, when you issue this command, the Cisco IOS software reserves a certain amount of bandwidth so that the selected quality of service can be provided. Cisco IOS software uses Resource Reservation Protocol (RSVP) to request quality of service guarantees from the network.
Example
The following example configures guaranteed-delay as the desired (requested) quality of service to a dial peer:
dial-peer voice 10 voipreq-qos guaranteed-delayRelated Commands
acc-qos
session protocol
To establish a session protocol for calls between the local and remote routers via the packet network, use the session protocol dial-peer configuration command. Use the no form of this command to reset the default value for this command.
session protocol cisco
no session protocol
Syntax Description
Default
cisco
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
For Cisco IOS Release 12.0, Cisco Session Protocol (cisco) is the only applicable session protocol. This command is applicable only to Cisco 3600 series VoIP peers.
Example
The following example selects Cisco Session Protocol as the session protocol:
dial-peer voice 10 voipsession protocol ciscoRelated Commands
session target
session target
To specify a network-specific address for a specified dial peer, use the session target dial-peer configuration command. Use the no form of this command to disable this feature.
For the Cisco 3600 series Voice over IP:
session target {ipv4:destination-address | dns:[$s$. | $d$. | $e$. | $u$.] host-name | loopback:rtp | loopback:compressed | loopback:uncompressed}
no session target
For the Cisco MC3810 Voice over Frame Relay:
session target interface{FR-ATM interface | Serial interface dlci}
no session target interface {FR-ATM interface | Serial interface dlci}
For Cisco MC3810 Voice over ATM:
session target interface ATM interface pvc [name | vpi/vci | vci]
no session target interface ATM interface pvc [name | vpi/vci | vci]
For Cisco MC3810 Voice over HDLC:
session target interface serial-port-number
no session target interface serial-port-number
Syntax Description
For the Cisco 3600 series Voice over IP:
For the Cisco MC3810 Voice over Frame Relay:
For the Cisco MC3810 Voice over ATM:
For the Cisco MC3810 Voice over HDLC:
interface
Specifies the interface number.
serial-port-number
Specifies the serial port number on the Cisco MC3810. The valid range is 0 to 1.
Default
The default for this command is enabled with no IP address or domain name defined.
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to both the Cisco 3600 series and the Cisco MC3810.
Use the session target command to specify a network-specific address or domain name for a dial peer. Whether you select a network-specific address or a domain name depends on the session protocol you select.
The session target loopback command is used for testing the voice transmission path of a call. The loopback point will depend on the call origination and the loopback type selected.
The session target dns command can be used with or without the specified wildcards. Using the optional wildcards can reduce the number of VoIP dial peer session targets you need to configure if you have groups of numbers associated with a particular router.
Examples
The following example configures a session target using DNS for a host, "voice_router," in the domain "cisco.com":
dial-peer voice 10 voipsession target dns:voice_router.cisco.comThe following example configures a session target using DNS, with the optional $u$. wildcard. In this example, the destination pattern has been configured to allow for any four-digit extension, beginning with the numbers 1310222. The optional wildcard $u$. indicates that the router will use the unmatched portion of the dialed number—in this case, the four-digit extension, to identify the dial peer. As in the previous example, the domain is "cisco.com."
dial-peer voice 10 voipdestination-pattern 1310222....session target dns:$u$.cisco.comThe following example configures a session target using dns, with the optional $d$. wildcard. In this example, the destination pattern has been configured for 13102221111. The optional wildcard $d$. indicates that the router will use the destination pattern to identify the dial peer in the "cisco.com" domain.
dial-peer voice 10 voipdestination-pattern 13102221111session target dns:$d$.cisco.comThe following example configures a session target using DNS, with the optional $e$. wildcard. In this example, the destination pattern has been configured for 12345. The optional wildcard $e$. indicates that the router will reverse the digits in the destination pattern, add periods between the digits, and then use this reverse-exploded destination pattern to identify the dial peer in the "cisco.com" domain.
dial-peer voice 10 voipdestination-pattern 12345session target dns:$e$.cisco.comThe following example configures a session target for Voice over Frame Relay on a Cisco MC3810 with a session target on serial port1 and a DLCI of 200:
dial-peer voice 11 vofrdestination-pattern 13102221111session target Serial1 200The following example configures a session target for Voice over ATM on a Cisco MC3810. The session target is sent to ATM interface 0, and for a PVC with a VCI of 20.
dial-peer voice 12 voatmdestination-pattern 13102221111session target atm0 pvc 20The following example configures a session target on serial port 0 for Voice over HDLC on a Cisco MC3810:
dial-peer voice 13 vohdlcdestination-pattern 13102221111session target serial0Related Commands
destination-pattern
session protocolshow call active voice
To show the active call table, use the show call active voice privileged EXEC command.
show call active voice
Syntax Description
This command has no arguments or keywords.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series.
Use the show call active voice privileged EXEC command to display the contents of the active call table, which shows all of the calls currently connected through the router.
For each call, there are two call legs, usually a POTS call leg and a VoIP call leg. A call leg is a discrete segment of a call connection that lies between two points in the connection. Each dial peer creates a call leg, as shown in Figure 1.
Figure 1 Call Legs Example
These two call legs are associated by the connection ID. The connection ID is global across the voice network, so that you can associate two call legs on one router with two call legs on another router, thereby providing an end-to-end view of a call.
Example
The following is sample output from the show call active voice command:
router# show call active voiceGENERIC: SetupTime=21072 Index=0 PeerAddress= PeerSubAddress= PeerId=0 PeerIfIndex=0 LogicalIfIndex=0 ConnectTime=0 CallState=3 CallOrigin=2 ChargedUnits=0 InfoType=0 TransmitPackets=375413 TransmitBytes=7508260 ReceivePackets=377734 ReceiveBytes=7554680VOIP: ConnectionId[0x19BDF910 0xAF500007 0x0 0x58ED0] RemoteIPAddress=17635075 RemoteUDPPort=16394 RoundTripDelay=0 SelectedQoS=0 SessionProtocol=1 SessionTarget= OnTimeRvPlayout=0 GapFillWithSilence=0 GapFillWithPrediction=600 GapFillWithInterpolation=0 GapFillWithRedundancy=0 HiWaterPlayoutDelay=110 LoWaterPlayoutDelay=64 ReceiveDelay=94 VADEnable=0 CoderTypeRate=0GENERIC: SetupTime=21072 Index=1 PeerAddress=+14085271001 PeerSubAddress= PeerId=0 PeerIfIndex=0 LogicalIfIndex=5 ConnectTime=21115 CallState=4 CallOrigin=1 ChargedUnits=0 InfoType=1 TransmitPackets=377915 TransmitBytes=7558300 ReceivePackets=375594 ReceiveBytes=7511880TELE: ConnectionId=[0x19BDF910 0xAF500007 0x0 0x58ED0] TxDuration=16640 VoiceTxDuration=16640 FaxTxDuration=0 CoderTypeRate=0 NoiseLevel=0 ACOMLevel=4 OutSignalLevel=-440 InSignalLevel=-440 InfoActivity=2 ERLLevel=227 SessionTarget=Table 2 provides an alphabetical listing of the fields in this output and a description of each field.
Related Commands
show call history voice
show dial-peer voice
show num-exp
show voice-portshow call history voice
To display the call history table, use the show call history voice privileged EXEC command.
show call history voice last number
Syntax Description
last number
Displays the last calls connected, where the number of calls displayed is defined by the argument number. Valid entries for the argument number is any number from 1 to 2147483647.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series.
Use the show call history voice privileged EXEC command to display the call history table. The call history table contains a listing of all calls connected through this router in descending time order since Voice over IP was enabled. You can display subsets of the call history table by using specific keywords. To display the last calls connected through this router, use the keyword last, and define the number of calls to be displayed with the argument number.
Example
The following is sample output from the show call history voice command:
router# show call history voiceGENERIC: SetupTime=20405 Index=0 PeerAddress= PeerSubAddress= PeerId=0 PeerIfIndex=0 LogicalIfIndex=0 DisconnectCause=NORMAL DisconnectText= ConnectTime=0 DisconectTime=20595 CallOrigin=2 ChargedUnits=0 InfoType=0 TransmitPackets=0 TransmitBytes=0 ReceivePackets=0 ReceiveBytes=0VOIP: ConnectionId[0x19BDF910 0xAF500006 0x0 0x56590] RemoteIPAddress=17635075 RemoteUDPPort=16392 RoundTripDelay=0 SelectedQoS=0 SessionProtocol=1 SessionTarget= OnTimeRvPlayout=0 GapFillWithSilence=0 GapFillWithPrediction=0 GapFillWithInterpolation=0 GapFillWithRedundancy=0 HiWaterPlayoutDelay=0 LoWaterPlayoutDelay=0 ReceiveDelay=0 VADEnable=0 CoderTypeRate=0TELE: ConnectionId=[0x19BDF910 0xAF500006 0x0 0x56590] TxDuration=3030 VoiceTxDuration=2700 FaxTxDuration=0 CoderTypeRate=0 NoiseLevel=0 ACOMLevel=0 SessionTarget=Table 3 provides an alphabetical listing of the fields in this output and a description of each field.
Related Commands
show call active voice
show dial-peer voice
show num-exp
show voice-portshow dial-peer voice
To display configuration information for dial peers, use the show dial-peer voice privileged EXEC command.
For the Cisco 3600 series:
show dial-peer voice [number]
For the Cisco MC3810:
show dial-peer voice [number] [summary]
Syntax Description
For the Cisco 3600 series:
For the Cisco MC3810:
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series, Voicer over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
Use the show dial-peer voice privileged EXEC command to display the configuration for all VoIP and POTS dial peers configured for the router. To show configuration information for only one specific dial peer, use the argument number to identify the dial peer.
Example
The following is sample output from the show dial-peer voice command for a POTS dial peer:
router# show dial-peer voice 1VoiceEncapPeer1tag = 1, dest-pat = `+14085291000',answer-address = `',group = 0, Admin state is up, Operation state is downPermission is Both,type = pots, prefix = `',session-target = `', voice port =Connect Time = 0, Charged Units = 0Successful Calls = 0, Failed Calls = 0Accepted Calls = 0, Refused Calls = 0Last Disconnect Cause is ""Last Disconnect Text is ""Last Setup Time = 0The following is sample output from the show dial-peer voice command for a VoIP dial peer:
router# show dial-peer voice 10VoiceOverIpPeer10tag = 10, dest-pat = `',incall-number = `+14087',group = 0, Admin state is up, Operation state is downPermission is Answer,type = voip, session-target = `',sess-proto = cisco, req-qos = bestEffort,acc-qos = bestEffort,fax-rate = voice, codec = g729r8,Expect factor = 10,Icpif = 30, VAD = disabled, Poor QOV Trap = disabled,Connect Time = 0, Charged Units = 0Successful Calls = 0, Failed Calls = 0Accepted Calls = 0, Refused Calls = 0Last Disconnect Cause is ""Last Disconnect Text is ""Last Setup Time = 0Table 4 explains the fields contained in both of these examples.
Related Commands
show call active voice
show call-history voice
show num-exp
show voice-portshow dialplan incall number
To pair different voice ports and telephone numbers together for troubleshooting, use the show dialplan incall number privileged EXEC command.
show dialplan incall slot-number/subunit-number/port number dial string
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series.
Occasionally, an incoming call cannot be matched to a dial peer in the dial peer database. One reason this might occur is that the specified destination cannot be reached via the voice interface through which the incoming call came. Use the show dialplan incall number command as a troubleshooting method to resolve the call destination by pairing voice ports and telephone numbers together until there is a match.
Example
The following example tests whether the telephone extension 57681 can be reached through voice port 1/0/1:
show dialplan incall 1/0/1 number 57681Related Commands
You can use the master indexes or search online to find documentation of related commands.
show dialplan number
show dialplan number
To show which dial peer is reached when a particular telephone number is dialed, use the show dialplan number privileged EXEC command.
show dialplan number dial string
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series, and to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
The show dialplan number command is used to test if the dial-plan configuration is valid and working as expected.
Example
The following example displays the dial peer associated with the destination pattern of 54567:
router# show dialplan number 51234Macro Exp.: 14085551234VoiceOverIpPeer1004tag = 1004, destination-pattern = `+1408555....',answer-address = `',group = 1004, Admin state is up, Operation state is uptype = voip, session-target = `ipv4:1.13.24.0',ip precedence: 0 UDP checksum = disabledsession-protocol = cisco, req-qos = best-effort,acc-qos = best-effort,fax-rate = voice, codec = g729r8,Expect factor = 10, Icpif = 30,VAD = enabled, Poor QOV Trap = disabledConnect Time = 0, Charged Units = 0Successful Calls = 0, Failed Calls = 0Accepted Calls = 0, Refused Calls = 0Last Disconnect Cause is ""Last Disconnect Text is ""Last Setup Time = 0Matched: +14085551234 Digits: 7Target: ipv4:172.13.24.0Table 5 explains the fields contained in this example.
Related Commands
show dialplan incall number
show num-exp
To show the number expansions configured, use the show num-exp privileged EXEC command.
show num-exp [dialed-number]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series.
Use the show num-exp privileged EXEC command to display all of the number expansions configured for this router. To display number expansion for only one number, specify that number by using the dialed-number argument.
Example
The following is sample output from the show num-exp command:
router# show num-expDest Digit Pattern = '0...' Translation = '+14085270...'Dest Digit Pattern = '1...' Translation = '+14085271...'Dest Digit Pattern = '3..' Translation = '+140852703..'Dest Digit Pattern = '4..' Translation = '+140852804..'Dest Digit Pattern = '5..' Translation = '+140852805..'Dest Digit Pattern = '6....' Translation = '+1408526....'Dest Digit Pattern = '7....' Translation = '+1408527....'Dest Digit Pattern = '8...' Translation = '+14085288...'Table 6 explains the fields in the sample output.
Related Commands
show call active voice
show call history voice
show dial-peer voice
show voice-portshow voice call
To show the call status for all voice ports on the Cisco MC3810, use the show voice call privileged EXEC command.
show voice call [summary]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
This command provides the status at these levels of the call handling module:
•
•
•
•
Example
The following is a sample display from the show voice call summary command for analog voice ports on the Cisco MC3810:
router# show voice call summary1/1 (orig): eecm = ST_DIGIT_COLLECT, LFXS= call_progress, CPD= failure_cont1/2 ( ): eecm = IDLE, LFXS= idle, CPD= idle1/3 ( ): eecm = IDLE, LFXS= idle, CPD= idle1/4 ( ): eecm = IDLE, LFXO= idle, CPD= idle1/5 ( ): eecm = IDLE, LEM= idle, CPD= idle1/6 ( ): eecm = IDLE, LEM= idle, CPD= idleTable 7 explains the fields in the sample output.
Related Commands
show dial-peer voice
show voice dsp
show voice-portshow voice dsp
To show the current status of all DSP voice channels, use the show voice dsp privileged EXEC command.
show voice dsp
Syntax Description
This command has no arguments or keywords.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
Example
The following is sample output from the show voice dsp command for the Cisco MC3810:
router# show voice dspDSP# 0, channel# 0 G729A BUSYDSP# 0, channel# 1 G729A BUSYDSP# 1, channel# 2 FAX IDLEDSP# 1, channel# 3 FAX IDLEDSP# 2, channel# 4 NONE BADDSP# 2, channel# 5 NONE BADDSP# 3, channel# 6 NONE BADDSP# 3, channel# 7 NONE BADDSP# 4, channel# 8 NONE BADDSP# 4, channel# 9 NONE BADDSP# 5, channel# 10 NONE BADDSP# 5, channel# 11 NONE BADTable 8 explains the fields in the sample output.
Table 8 Show Voice DSP Field Descriptions
DSP
Number of the DSP
Channel
Number of the channel and its status.
Related Commands
show dial-peer voice
show voice call summary
show voice-portshow voice port
To display configuration information about a specific voice port, use the show voice port privileged EXEC command.
For the Cisco 3600 series:
show voice port slot-number/subunit-number/port
For the Cisco MC3810:
show voice port [slot/port] [summary]
Syntax Description
For the Cisco 3600 series:
For the Cisco MC3810:
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series, Voice over Frame Relay, Voice over ATM, Voice over HDLC, and Frame Relay-ATM Interworking on the Cisco MC3810.
Use the show voice port privileged EXEC command to display configuration and voice interface card-specific information about a specific port.
Example
The following is sample output from the show voice port command for an E&M voice port on the Cisco 3600 series:
router# show voice port 1/0/0E&M Slot is 1, Sub-unit is 0, Port is 0Type of VoicePort is E&MOperation State is unknownAdministrative State is unknownThe Interface Down Failure Cause is 0Alias is NULLNoise Regeneration is disabledNon Linear Processing is disabledMusic On Hold Threshold is Set to 0 dBmIn Gain is Set to 0 dBOut Attenuation is Set to 0 dBEcho Cancellation is disabledEcho Cancel Coverage is set to 16msConnection Mode is NormalConnection Number isInitial Time Out is set to 0 sInterdigit Time Out is set to 0 sAnalog Info Follows:Region Tone is set for northamericaCurrently processing noneMaintenance Mode Set to None (not in mtc mode)Number of signaling protocol errors are 0Voice card specific Info Follows:Signal Type is wink-startOperation Type is 2-wireImpedance is set to 600r OhmE&M Type is unknownDial Type is dtmfIn Seizure is inactiveOut Seizure is inactiveDigit Duration Timing is set to 0 msInterDigit Duration Timing is set to 0 msPulse Rate Timing is set to 0 pulses/secondInterDigit Pulse Duration Timing is set to 0 msClear Wait Duration Timing is set to 0 msWink Wait Duration Timing is set to 0 msWink Duration Timing is set to 0 msDelay Start Timing is set to 0 msDelay Duration Timing is set to 0 msThe following is sample output from the show voice port command for an FXS voice port on the Cisco 3600 series:
router# show voice port 1/0/0Foreign Exchange Station 1/0/0 Slot is 1, Sub-unit is 0, Port is 0Type of VoicePort is FXSOperation State is DORMANTAdministrative State is UPThe Interface Down Failure Cause is 0Alias is NULLNoise Regeneration is enabledNon Linear Processing is enabledMusic On Hold Threshold is Set to 0 dBmIn Gain is Set to 0 dBOut Attenuation is Set to 0 dBEcho Cancellation is enabledEcho Cancel Coverage is set to 16msConnection Mode is NormalConnection Number isInitial Time Out is set to 10 sInterdigit Time Out is set to 10 sAnalog Info Follows:Region Tone is set for northamericaCurrently processing noneMaintenance Mode Set to None (not in mtc mode)Number of signaling protocol errors are 0Voice card specific Info Follows:Signal Type is loopStartRing Frequency is 25 HzHook Status is On HookRing Active Status is inactiveRing Ground Status is inactiveTip Ground Status is inactiveDigit Duration Timing is set to 100 msInterDigit Duration Timing is set to 100 msHook Flash Duration Timing is set to 600 msThe following is sample output from the show voice port command for an FXS voice port on the Cisco MC3810:
router# show voice port 1/2Voice port 1/2 Slot is 1, Port is 2Type of VoicePort is FXSOperation State is UPAdministrative State is UPNo Interface Down FailureDescription is not setNoise Regeneration is enabledNon Linear Processing is enabledIn Gain is Set to 0 dBOut Attenuation is Set to 0 dBEcho Cancellation is enabledEcho Cancel Coverage is set to 8 msConnection Mode is normalConnection Number is not setInitial Time Out is set to 10 sInterdigit Time Out is set to 10 sCoder Type is g729ar8Companding Type is u-lawVoice Activity Detection is disabledRinging Time Out is 180 sWait Release Time Out is 30 sNominal Playout Delay is 80 millisecondsMaximum Playout Delay is 160 millisecondsAnalog Info Follows:Region Tone is set for northamericaCurrently processing VoiceMaintenance Mode Set to None (not in mtc mode)Number of signaling protocol errors are 0Impedance is set to 600r OhmAnalog interface A-D gain offset = -3 dBAnalog interface D-A gain offset = -3 dBVoice card specific Info Follows:Signal Type is loopStartRing Frequency is 20 HzHook Status is On HookRing Active Status is inactiveRing Ground Status is inactiveTip Ground Status is activeDigit Duration Timing is set to 100 msInterDigit Duration Timing is set to 100 msRing Cadence are [20 40] * 100 msecInterDigit Pulse Duration Timing is set to 500 msThe following is sample output from the show voice port summary command for all voice ports on a Cisco MC3810 with an analog voice module (AVM):
router# show voice port summaryIN OUT ECHOPORT SIG-TYPE ADMIN OPER IN-STATUS OUT-STATUS CODEC VAD GAIN ATTN CANCEL1/1 fxs-ls up up on-hook idle 729a n 0 0 y1/2 fxs-ls up up on-hook idle 729a n 0 0 y1/3 e&m-wnk up up idle idle 729a n 0 0 y1/4 e&m-wnk up up idle idle 729a n 0 0 y1/5 fxo-ls up up idle on-hook 729a n 0 0 y1/6 fxo-ls up up idle on-hook 729a n 0 0 yTable 9 explains the fields in the sample output.
Related Commands
show call active voice
show call history voice
show dial-peer voice
show num-expshutdown (dial-peer)
To change the administrative state of the selected dial peer from up to down, use the shutdown dial-peer configuration command. Use the no form of this command to change the administrative state of this dial peer from down to up.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Default
no shutdown
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series, Voice over Frame Relay, Voice over ATM, Voice over HDLC, and Frame Relay-ATM Interworking on the Cisco MC3810.
When a dial peer is shut down, you cannot initiate calls to that peer. This command is applicable to both Cisco 3600 series and Cisco MC3810 VoIP and POTS peers.
Example
The following example changes the administrative state of voice telephony dial peer 10 to down:
configure terminaldial-peer voice 10 potsshutdownshutdown (DS1 Link)
To shutdown a DS1 link (send a Blue Alarm), use the shutdown controller configuration command. Use the no form of the command to activate the DS1 (cancel the sending of the Blue Alarm).
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Default
no shutdown
Command Mode
Controller configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
Example
The following example shuts down a DS 1 link on controller T1 0:
controller T1 0shutdownsnmp enable peer-trap poor-qov
To generate poor quality of voice notification for applicable calls associated with VoIP dial peers, use the snmp enable peer-trap poor-qov dial-peer configuration command. Use the no form of this command to disable this notification.
snmp enable peer-trap poor-qov
no snmp enable peer-trap poor-qov
Syntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command is applicable only to VoIP peers on the Cisco 3600 series; VoFR, VoATM, VoHDLC peers on the Cisco MC3810.
Use the snmp enable peer-trap poor qov command to generate poor quality of voice notifications for applicable calls associated with this dial peer. If you have an SNMP manager that will use SNMP messages when voice quality drops, you might want to enable this command. Otherwise, you should disable this command to reduce unnecessary network traffic.
Example
The following example enables poor quality of voice notifications for calls associated with VoIP dial peer 10:
dial-peer voice 10 voipsnmp enable peer-trap poor-qovRelated Commands
snmp-server enable trap voice poor-qov
snmp-server enable traps
snmp trap link-statustdm-group
To configure a list of time slots for creating clear channel groups (pass-through) for Time Division Multiplexing (TDM) cross-connect, use the tdm-group controller configuration command. Use the no form of this command to delete a clear channel group.
tdm-group tdm-group-no timeslot timeslot-list [type {e&m | fxs [loop-start | ground-start] | fxo [loop-start | ground-start] | fxs-melcas | fxo-melcas | e&m-melcas}]
no tdm-group tdm-group-no
Syntax Description
Default
No TDM group is configured.
Command Mode
Controller configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
Note
Example
The following example configures TDM group number 20 on controller T1 1 to support FXO ground-start:
controller T1 1mode castdm-group 20 20 type fxs ground-startRelated Commands
mode
vad (dial peer)
To enable voice activity detection (VAD) for the calls using this dial peer, use the vad dial-peer configuration command. Use the no form of this command to disable VAD.
vad
no vad
Syntax Description
This command has no arguments or keywords.
Default
Enabled
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command applies to Voice over IP on the Cisco 3600 series.
Use the vad command to enable voice activity detection. With VAD, silence is not transmitted over the network, only audible speech. If you enable VAD, the sound quality is slightly degraded but the connection monopolizes much less bandwidth. If you use the no form of this command, VAD is disabled and voice data is continuously transmitted to the IP backbone.
Note
Example
The following example enables VAD:
dial-peer voice 10 voipvadRelated Commands
comfort-noise
voice-encap
To define the data segmentation size on an HDLC interface to support voice over HDLC, use the voice-encap interface configuration command. Use the no form of this command to delete the setting.
voice-encap size
no voice-encap size
Syntax Description
Default
No data segmentation size is defined.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over HDLC on the Cisco MC3810.
Example
The following example configures serial interface 1 to support a data segmentation size of 64 for Voice over HDLC:
interface serial 1voice-encap 64voice-group
To configure a list of timeslots for voice channel associated signaling (CAS) on the T1/E1 controller on the Cisco MC3810, use the voice-group controller configuration command. Use the no form of this command to delete the CAS group.
voice-group voice-group-no timeslots timeslot-list type {e&m-immediate | e&m-delay |
e&m-wink | e&m-melcas | fxs-ground-start | fxs-loop-start | fxs-melcas |
fxo-ground-start | fxo-loop-start | fxo-melcas}
no voice-group voice-group-no timeslots timeslot-list
Syntax Description
Default
No voice group is configured.
Command Mode
Controller configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
This command is only available if the mode cas command is enabled.
Example
The following example configures a voice group on controller T1 0 on a Cisco MC3810:
controller T1 0mode casvoice-group 10 timeslots10 64Related Commands
channel-group
mode (Voice over ATM)
tdm-groupvoice local-bypass
To directly cross-connect local POTS calls without going through a Digital Signal Processor (DSP), use the voice local-bypass global configuration command. Use the no form of this command to cancel the voice local-bypass disable operation.
voice local-bypass
no voice local-bypass
Syntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 MA.
This command applies to Voice over Frame Relay, Voice over ATM, Voice over HDLC, and Frame Relay-ATM Interworking on the Cisco MC3810.
This command allows you to pass uncompressed voice traffic for local POTS calls.
Example
The following example configures the Cisco MC3810 to directly cross-connect local calls without going through a Digital Signal Processor (DSP):
voice local-bypass
