- A
- B
- cac master through call application stats
- call application voice through call denial
- call fallback through called-number (dial peer)
- caller-id (dial peer) through ccm-manager switchover-to-backup
- ccs connect (controller) through clear vsp statistics
- clid through credentials (sip-ua)
- default (auto-config application) through direct-inward-dial
- disable-early-media through dualtone
- E
- F
- G
- H
- icpif through irq global-request
- isdn bind-l3 through ixi transport http
- K
- L
- map q850-cause through mgcp package-capability
- mgcp persistent through mmoip aaa send-id secondary
- mode (ATM/T1/E1 controller) through mwi-server
- N
- O
- package through pattern
- periodic-report interval through proxy h323
- Q
- R
- sccp through service-type call-check
- session through sgcp tse payload
- show aal2 profile through show call filter match-list
- show call history fax through show debug condition
- show dial-peer through show gatekeeper zone prefix
- show gateway through show modem relay statistics
- show mrcp client session active through show sip dhcp
- show sip service through show trunk hdlc
- show vdev through show voice statistics memory-usage
- show voice trace through shutdown (voice-port)
- signal through srv version
- ss7 mtp2-variant through switchover method
- target carrier-id through timeout tsmax
- timeouts call-disconnect through timing clear-wait
- timing delay-duration through type (voice)
- U
- vad (dial peer) through voice-class sip encap clear-channel
- voice-class sip error-code-override through vxml version 2.0
- W
- Z
Cisco IOS Voice Command Reference
Bias-Free Language
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
- Updated:
- December 22, 2013
Chapter: O
- offer call-hold
- operation
- options-ping
- options-ping (dial peer)
- outbound-proxy
- outbound retry-interval
- outgoing called-number
- outgoing calling-number
- outgoing dialpeer
- outgoing media local ipv4
- outgoing media remote ipv4
- outgoing port
- outgoing signaling local ipv4
- outgoing signaling remote ipv4
- output attenuation
Cisco IOS Voice Commands:
O
This chapter contains the commands to configure and maintain Cisco IOS voice applications. The commands are presented in alphabetical order. Some commands required for configuring voice may be found in other Cisco IOS command references. Use the master index of commands or search online to find these commands.
For detailed information on how to configure these applications and features, refer to the Cisco IOS Voice Configuration Library.
offer call-hold
To specify globally how the Session Initiation Protocol (SIP) gateway should initiate call-hold requests, use the offer call-hold command in SIP user-agent configuration mode. To disable a method of initiating call hold, use the no form of this command.
offer call-hold {conn-addr | direction-attr}
no offer call-hold {conn-addr | direction-attr}
Syntax Description
Command Default
direction-attr
Command Modes
SIP user-agent configuration
Command History
|
|
|
|---|---|
12.3(8)T |
This command was introduced. |
Usage Guidelines
Cisco SIP gateways support receiving call-hold requests in either of the two formats, but the direction attribute is recommended. Specifying a call-hold format is only available globally with the offer call-hold command; configuration is not available at the dial-peer level.
Examples
The following example initiates call hold by configuring the gateway to send a=sendonly in the Session Description Protocol (SDP). Using the direction-attr keyword is the current and preferred method to initiate call hold.
sip-ua
retry invite 3
offer call-hold direction-attr
The following example initiates call hold by configuring the gateway to send 0.0.0.0 as the IP address in the c=line.
sip-ua
retry invite 3
offer call-hold conn-addr
Related Commands.
|
|
|
|---|---|
show sip-ua status |
Displays status for the SIP UA. |
suspend-resume |
Enables SIP Suspend and Resume functionality. |
operation
To select a specific cabling scheme for E&M ports, use the operation command in voice-port configuration mode. To restore the default, use the no form of this command.
operation {2-wire | 4-wire}
no operation {2-wire | 4-wire}
Syntax Description
2-wire |
Two-wire E&M cabling scheme. |
4-wire |
Four-wire E&M cabling scheme. |
Command Default
2-wire E&M cabling scheme
Command Modes
Voice-port configuration
Command History
|
|
|
|---|---|
11.3(1)T |
This command was introduced on the Cisco 3600 series. |
11.3(1)MA |
This command was implemented on the Cisco MC3810. |
Usage Guidelines
This command affects only voice traffic. Signaling is independent of 2-wire versus 4-wire settings. If the wrong cable scheme is specified, the user might get voice traffic in only one direction.
Using this command on a voice port changes the operation of both voice ports on a VPM card. The voice port must be shut down and then opened again for the new value to take effect.
This command is not applicable to FXS or FXO interfaces because they are, by definition, 2-wire interfaces.
Examples
The following example specifies that an E&M port uses a 4-wire cabling scheme:
voice-port 1/0/0
operation 4-wire
The following example specifies that an E&M port uses a 2-wire cabling scheme:
voice-port 1/1
operation 2-wire
options-ping
To enable in-dialog OPTIONS, use the options-ping command in global configuration mode. To disable, use the no form of this command.
options-ping seconds
no options-ping seconds
Syntax Description
seconds |
Intervals, in seconds OPTIONS transactions are sent. Range is 60-1200, there is no default. |
Command Default
This command is disabled by default.
Command Modes
Global
Command History
|
|
|
|---|---|
12.4(11)T |
This command was introduced. |
Usage Guidelines
The in-dialog OPTIONS refresh command eanbles an alterante refresh mechanism to RTP/RTCP media inactivity timer and session timer can be used on SIP-to-SIP and SIP-to-H.323 calls. The refresh with in-dialog OPTIONS method is meant to only be hop-to-hop, and not end-to-end. Since session timer achieves similar results, the OPTIONs refresh/ping will not take affect when session timer is negotiated. The behavior on the H.323 endpoint is as if it was a TDM-SIP call. The generating in-dialog OPTIONS is enabled at the global level or dialpeer level. The system default setting is disabled. This feature can be use by both a TDM voice gateway and an IP-to-IP gateway.
Examples
The following example sets the in-dialog refresh time to 60 seconds:
Router(conf-serv-sip)# options-ping 60
Related Commands
|
|
|
|---|---|
options-ping |
Enables in-dialog OPTIONS at the global level. |
options-ping (dial peer) |
Enables in-dialog OPTIONS on a dial-peer. |
options-ping (dial peer)
To enable in-dialog OPTIONS, use the options-ping command in global configuration mode. To disable, use the no form of this command.
options-ping seconds
no options-ping seconds
Syntax Description
seconds |
Intervals, in seconds OPTIONS transactions are sent. Range is 60-1200, there is no default. |
Command Default
This command is disabled by default.
Command Modes
dial peer configuration mode
Command History
|
|
|
|---|---|
12.4(11)T |
This command was introduced. |
Usage Guidelines
The in-dialog OPTIONS refresh command eanbles an alterante refresh mechanism to RTP/RTCP media inactivity timer and session timer can be used on SIP-to-SIP and SIP-to-H.323 calls. The refresh with in-dialog OPTIONS method is meant to only be hop-to-hop, and not end-to-end. Since session timer achieves similar results, the OPTIONs refresh/ping will not take affect when session timer is negotiated. The behavior on the H.323 endpoint is as if it was a TDM-SIP call. The generating in-dialog OPTIONS is enabled at the global level or dialpeer level. The system default setting is disabled. This feature can be use by both a TDM voice gateway and an IP-to-IP gateway.
Examples
The following example sets the in-dialog refresh time to 60 seconds:
Router(conf-serv-sip)# options-ping 60
Related Commands
|
|
|
|---|---|
options-ping |
Enables in-dialog OPTIONS at the global level. |
options-ping (dial peer) |
Enables in-dialog OPTIONS on a dial-peer. |
outbound-proxy
To configure a Session Initiation Protocol (SIP) outbound proxy for outgoing SIP messages globally on a Cisco IOS voice gateway, use the outbound-proxy command in voice service SIP configuration mode. To globally disable forwarding of SIP messages to a SIP outbound proxy globally, use the no form of this command.
outbound-proxy {dhcp | ipv4:ip-address[:port-number] | dns:host:domain [reuse]}
no outbound-proxy
Syntax Description
Command Default
The Cisco IOS voice gateway does not forward outbound SIP messages to a proxy.
Command Modes
Voice service VoIP SIP configuration (conf-serv-sip)
Command History
Usage Guidelines
You can use the outbound-proxy command in voice service SIP configuration mode to specify outbound proxy settings globally for a Cisco IOS voice gateway. You can also use the voice-class sip outbound-proxy command in dial peer voice configuration mode to configure settings for an individual dial peer that override or defer to the global settings for the gateway. However, if both a Cisco Unified Communications Manager Express (CME) and a SIP gateway are configured on the same router, then there is a scenario that can cause incoming SIP messages from line-side phones to be confused with SIP messages coming from the network side. To avoid failed calls caused by this scenario, disable the SIP outbound proxy setting for all line-side phones on a dial peer using the outbound-proxy system command in voice register global configuration mode.
Examples
The following example shows how to specify the SIP outbound proxy globally for a Cisco IOS voice gateway using an IP address:
Router> enable
Router# configure terminal
Router(config)# voice service voip
Router(conf-voi-serv)# sip
Router(conf-serv-sip)# outbound-proxy ipv4:10.1.1.1
The following example shows how to specify the SIP outbound proxy globally for a Cisco IOS voice gateway using a destination hostname and domain:
Router> enable
Router# configure terminal
Router(config)# voice service voip
Router(conf-voi-serv)# sip
Router(conf-serv-sip)# outbound-proxy dns:sipproxy:example.com
The following example shows how to specify the SIP outbound proxy globally for a Cisco IOS voice gateway using the DHCP protocol:
Router> enable
Router# configure terminal
Router(config)# voice service voip
Router(conf-voi-serv)# sip
Router(conf-serv-sip)# outbound-proxy dhcp
Related Commands
outbound retry-interval
To define the retry period for attempting to establish the outbound relationship between border elements, use the outbound retry-interval command in Annex G neighbor service configuration mode. To disable the command, use the no form of this command.
outbound retry-interval interval
no outbound retry-interval
Syntax Description
interval |
Amount of time, in seconds, to establish the outbound relationship. Range is from 1 to 2147483. The default is 30. |
Defaults
30 seconds
Command Modes
Annex G neighbor service configuration (config-nxg-neigh-svc)
Command History
|
|
|
|---|---|
12.2(11)T |
This command was introduced. |
Usage Guidelines
Service relationships are defined to be unidirectional. When a service relationship is established between border element A and border element B, A is entitled to send requests to B and expect responses. For B to send requests to A and expect responses, a second service relationship must be established. From A's perspective, the service relationship it establishes with B is designated as the "outbound" service relationship.
Use this command to set the retry period for attempting to bring up the outbound relationship between border elements.
Examples
The following example shows how to set the retry interval to 300 seconds (5 minutes):
Router(config-nxg-neigh-svc)# outbound retry-interval 300
Related Commands
outgoing called-number
To configure debug filtering for outgoing called numbers, use the outgoing called-number command in call filter match list configuration mode. To disable, use the no form of this command.
outgoing called-number string
no outgoing called-number string
Syntax Description
Defaults
No default behavior or values
Command Modes
Call filter match list configuration
Command History
|
|
|
|---|---|
12.3(4)T |
This command was introduced. |
Usage Guidelines
The outgoing called number goes out after number translation and expansion.
Examples
The following example shows the voice call debug filter set to match outgoing called number 8288807:
call filter match-list 1 voice
outgoing called-number 8288807
Related Commands
outgoing calling-number
To configure debug filtering for outgoing calling numbers, use the outgoing calling-number command in call filter match list configuration mode. To disable, use the no form of this command.
outgoing calling-number string
no outgoing calling-number string
Syntax Description
Defaults
No default behavior or values
Command Modes
Call filter match list configuration
Command History
|
|
|
|---|---|
12.3(4)T |
This command was introduced. |
Usage Guidelines
The outgoing calling number goes out after number translation and expansion.
Examples
The following example shows the voice call debug filter set to match outgoing calling number 8288807:
call filter match-list 1 voice
outgoing calling-number 8288807
Related Commands
outgoing dialpeer
To configure debug filtering for the outgoing dial peer, use the outgoing dialpeer command in call filter match list configuration mode. To disable, use the no form of this command.
outgoing dialpeer tag
no outgoing dialpeer tag
Syntax Description
tag |
Digits that identify a specific dial peer. Valid entries are 1 to 2,147,483,647. |
Command Default
No default behavior or values
Command Modes
Call filter match list configuration
Command History
|
|
|
|---|---|
12.3(4)T |
This command was introduced. |
Examples
The following example shows the voice call debug filter set to match outgoing dial peer 12:
call filter match-list 1 voice
outgoing dialpeer 12
Related Commands
outgoing media local ipv4
To configure debug filtering for the outgoing media local IPv4 addresses for the voice gateway receiving the media stream, use the outgoing media local ipv4 command in call filter match list configuration mode. To disable, use the no form of this command.
outgoing media local ipv4 ip_address
no outgoing media local ipv4 ip_address
Syntax Description
ip_address |
IP address of the local voice gateway |
Command Default
No default behavior or values
Command Modes
Call filter match list configuration
Command History
|
|
|
|---|---|
12.3(4)T |
This command was introduced. |
Examples
The following example shows the voice call debug filter set to match outgoing media on the local voice gateway, which has IP address 192.168.10.255:
call filter match-list 1 voice
outgoing media local ipv4 192.168.10.255
Related Commands
outgoing media remote ipv4
To configure debug filtering for the outgoing media remote IPv4 addresses for the voice gateway receiving the media stream, use the outgoing media remote ipv4 command in call filter match list configuration mode. To disable, use the no form of this command.
outgoing media remote ipv4 ip_address
no outgoing media remote ipv4 ip_address
Syntax Description
ip_address |
IP address of the remote IP device |
Command Default
No default behavior or values
Command Modes
Call filter match list configuration
Command History
|
|
|
|---|---|
12.3(4)T |
This command was introduced. |
Examples
The following example shows the voice call debug filter set to match outgoing media on the remote IP device, which has IP address 192.168.10.255:
call filter match-list 1 voice
outgoing media remote ipv4 192.168.10.255
Related Commands
outgoing port
To configure debug filtering for the outgoing port, use the outgoing port command in call filter match list configuration mode. To disable, use the no form of this command.
Cisco 2600, Cisco 3600, and Cisco 3700 Series
outgoing port {slot-number/subunit-number/port | slot/port:ds0-group-no}
no outgoing port {slot-number/subunit-number/port | slot/port:ds0-group-no}
Cisco 2600 and Cisco 3600 Series with a High-Density Analog Network Module (NM-HDA)
outgoing port {slot-number/subunit-number/port}
no outgoing port {slot-number/subunit-number/port}
Cisco AS5300
outgoing port controller-number:D
no outgoing port controller-number:D
Cisco AS5400
outgoing port card/port:D
no outgoing port card/port:D
Cisco AS5800
outgoing port {shelf/slot/port:D | shelf/slot/parent:port:D}
no outgoing port {shelf/slot/port:D | shelf/slot/parent:port:D}
Cisco MC3810
outgoing port slot/port
no outgoing port slot/port
Syntax Description
Cisco 2600, Cisco 3600 and Cisco 3700 Series
Cisco AS5300
controller-number |
T1 or E1 controller. |
:D |
D channel associated with ISDN PRI. |
Cisco AS5400
card |
Specifies the T1 or E1 card. Valid entries for the card argument are 1 to 7. |
port |
Specifies the voice port number. Valid entries are 0 to 7. |
:D |
Indicates the D channel associated with ISDN PRI. |
Cisco AS5800
Cisco MC3810
Command Default
No default behavior or values
Command Modes
Call filter match list configuration
Command History
|
|
|
|---|---|
12.3(4)T |
This command was introduced. |
Examples
The following example shows the voice call debug filter set to match outgoing port 1/1/1 on a Cisco 3660 voice gateway:
call filter match-list 1 voice
outgoing port 1/1/1
Related Commands
outgoing signaling local ipv4
To configure debug filtering for the outgoing signaling local IPv4 addresses for the gatekeeper managing the signaling, use the outgoing signaling local ipv4 command in call filter match list configuration mode. To disable, use the no form of this command.
outgoing signaling local ipv4 ip_address
no outgoing signaling local ipv4 ip_address
Syntax Description
ip_address |
IP address of the local voice gateway |
Command Default
No default behavior or values
Command Modes
Call filter match list configuration
Command History
|
|
|
|---|---|
12.3(4)T |
This command was introduced. |
Examples
The following example shows the voice call debug filter set to match outgoing signaling on the local voice gateway, which has IP address 192.168.10.255:
call filter match-list 1 voice
outgoing signaling local ipv4 192.168.10.255
Related Commands
outgoing signaling remote ipv4
To configure debug filtering for the outgoing signaling remote IPv4 addresses for the gatekeeper managing the signaling, use the outgoing signaling remote ipv4 command in call filter match list configuration mode. To disable, use the no form of this command.
outgoing signaling remote ipv4 ip_address
no outgoing signaling remote ipv4 ip_address
Syntax Description
ip_address |
IP address of the remote IP device |
Command Default
No default behavior or values
Command Modes
Call filter match list configuration
Command History
|
|
|
|---|---|
12.3(4)T |
This command was introduced. |
Examples
The following example shows the voice call debug filter set to match outgoing signaling on the remote IP device, which has IP address 192.168.10.255:
call filter match-list 1 voice
outgoing signaling remote ipv4 192.168.10.255
Related Commands
output attenuation
To configure a specific output attenuation value or enable automatic gain control, use the output attenuation command in voice-port configuration mode. To disable the selected output attenuation value, use the no form of this command.
output attenuation {decibels | auto-control [auto-dbm]}
no output attenuation {decibels | auto-control [auto-dbm]}
Syntax Description
Command Default
For Foreign Exchange Office (FXO), Foreign Exchange Station (FXS), and ear and mouth (E&M)
ports: decibels: 0 decibels
auto-dbm: -9 dBm
Command Modes
Voice-port configuration
Command History
Usage Guidelines
A system-wide loss plan must be implemented using both the input gain and output attenuation commands. You must consider other equipment (including PBXs) in the system when creating a loss plan. The default value for this command assumes that a standard transmission loss plan is in effect, meaning that there must be an attenuation of -6 dB between phones. Connections are implemented to provide -6 dB of attenuation when the input gain and output attenuation commands are configured with the default value of 0 dB.
You cannot increase the gain of a signal to the public switched telephone network (PSTN), but you can decrease it. If the voice level is too high, you can decrease the volume by either decreasing the input gain or increasing the output attenuation.
You can increase the gain of a signal coming into the router. If the voice level is too low, you can increase the input gain by using the input gain command.
The auto-control keyword and auto-dbm argument are available on an ear and mouth (E&M) voice port only if the signal type for that port is Land Mobile Radio (LMR). The auto-control keyword enables automatic gain control, which is performed by the digital signal processor (DSP). Automatic gain control adjusts speech to a comfortable volume when it becomes too loud or too soft. Because of radio network loss and other environmental factors, the speech level arriving at a router from an LMR system could be very low. You can use automatic gain control to ensure that the speech is played back at a more comfortable level. Because the gain is inserted digitally, the background noise can also be amplified. Automatic gain control is implemented as follows:
•
Output level: -9 dB
•Gain range: -12 dB to 20 dB
•Attack time (low to high): 30 milliseconds
•Attack time (high to low): 8 seconds
Examples
On the Cisco 3600 series router, the following example configures a 3-dB loss to be inserted at the transmit side of the interface:
voice-port 1/0/0
output attenuation 3
On the Cisco 3600 series router, the following example configures a 3-dB gain to be inserted at the transmit side of the interface:
voice-port 1/0/0
output attenuation -3
On the Cisco AS5300, the following example configures a 3-dB loss to be inserted at the transmit side of the interface:
voice-port 0:D
output attenuation 3
Feedback