-
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
bearer-capability clear-channel
busyout monitor action graceful
busyout monitor action shutdown
Cisco IOS Voice Commands:
B
This chapter contains commands to configure and maintain Cisco IOS voice applications. The commands are presented in alphabetical order. Some commands required for configuring voice may be found in other Cisco IOS command references. Use the command reference master index or search online to find these commands.
For detailed information on how to configure these applications and features, refer to the Cisco IOS Voice Configuration Library.
backhaul-session-manager
To enter backhaul session manager configuration mode, use the backhaul-session-manager command in global configuration mode.
backhaul-session-manager
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values
Command Modes
Global configuration
Command History
Usage Guidelines
Use the backhaul-session-manager command to switch to backhaul session manager configuration mode from global configuration mode. Use the exit command to exit backhaul session manager configuration mode and return to global configuration mode.
Examples
The following example enters backhaul session manager configuration mode:
Router(config)# backhaul-session-managerRouter(config-bsm)#Related Commands
bandwidth (dial peer)
To set the maximum bandwidth on a POTS dial peer for an H.320 call, use the bandwidth command in dial peer configuration mode. To remove the bandwidth setting, use the no form of this command.
bandwidth maximum value [maximum value]
no bandwidth
Syntax Description
Command Default
No maximum bandwidth is set.
Command Modes
Dial peer configuration
Command History
Usage Guidelines
Use this command to set the maximum and minimum bandwidth for an H.320 POTS dial-peer. Only the maximum bandwidth is required. The value must be entered in increments of 64 kbps. The minimum bandwidth setting is optional, and the value must be either 64 kbps or equal to the maximum value setting.
Examples
The following example shows configuration for POTS dial peer 200 with a maximum bandwidth of 1024 kbps:
dial-peer voice 200 potsbandwidth maximum 1024The following example shows configuration for POTS dial peer 11 with a maximum bandwidth of 640 and a minimum of 64:
dial-peer voice 11 potsbandwidth maximum 640 minimum 64Related Commands
bandwidth
Specifies the maximum aggregate bandwidth for H.323 traffic and verifies the available bandwidth of the destination gatekeeper.
bandwidth
To specify the maximum aggregate bandwidth for H.323 traffic and verify the available bandwidth of the destination gatekeeper, use the bandwidth command in gatekeeper configuration mode. To disable maximum aggregate bandwidth, use the no form of this command.
bandwidth {interzone | total | session} {default | zone zone-name} bandwidth-size
no bandwidth {interzone | total | session} {default | zone zone-name}
Syntax Description
Command Default
Maximum aggregate bandwidth is unlimited by default.
Command Modes
Gatekeeper configuration
Command History
Usage Guidelines
This command, in conjunction with the bandwidth remote command, replaces the zone gatekeeper command.
To specify maximum bandwidth for traffic between one zone and any other zone, use the default keyword with the interzone keyword.
To specify maximum bandwidth for traffic within one zone or for traffic between that zone and another zone (interzone or intrazone), use the default keyword with the total keyword.
To specify maximum bandwidth for a single session within a specific zone, use the zone keyword with the session keyword.
To specify maximum bandwidth for a single session within any zone, use the default keyword with the session keyword.
Examples
The following example configures the default maximum bandwidth for traffic between one zone and another zone to 5000 kbps:
gatekeeperbandwidth interzone default 5000The following example configures the default maximum bandwidth for all zones to 5000 kbps:
gatekeeperbandwidth total default 5000The following example configures the default maximum bandwidth for a single session within any zone to 2000 kbps:
gatekeeperbandwidth session default 2000The following example configures the default maximum bandwidth for a single session with a specific zone to 1000 kbps:
gatekeeperbandwidth session zone example 1000Related Commands
bandwidth check-destination
To enable the gatekeeper to verify available bandwidth resources at the destination endpoint, use the bandwidth check-destination command in gatekeeper configuration mode. To disable resource verification, use the no form of this command.
bandwidth check-destination
no bandwidth check-destination
Syntax Description
This command has no arguments or keywords.
Command Default
Resource verification is disabled by default.
Command Modes
Gatekeeper configuration
Command History
Examples
The following example activates bandwidth resource verification at the destination:
gatekeeperbandwidth check-destinationRelated Commands
bandwidth remote
To specify the total bandwidth for H.323 traffic between this gatekeeper and any other gatekeeper, use the bandwidth remote command in gatekeeper configuration mode. To disable total bandwidth specified, use the no form of this command.
bandwidth remote bandwidth-size
no bandwidth remote
Syntax Description
Command Default
Total bandwidth is unlimited by default.
Command Modes
Gatekeeper configuration
Command History
Usage Guidelines
This command, with the bandwidth command, replaces the zone gatekeeper command.
Examples
The following example configures the remote maximum bandwidth to 100,000 kbps:
gatekeeperbandwidth remote 100000Related Commands
battery-reversal
To specify battery polarity reversal on a Foreign Exchange Office (FXO) or Foreign Exchange Station (FXS) port, use the battery-reversal command in voice-port configuration mode. To disable battery reversal, use the no form of this command.
battery-reversal [answer]
no battery-reversal [answer]
Syntax Description
answer
(Optional) Configures an FXO port to support answer supervision by detection of battery reversal.
Command Default
Battery reversal is enabled
Command Modes
Voice-port configuration
Command History
Usage Guidelines
The battery-reversal command applies to FXO and FXS voice ports. On Cisco 2600 and 3600 series routers, only analog voice ports in VIC-2FXO-M1 and VIC-2FXO-M2 voice interface cards are able to detect battery reversal; analog voice ports in VIC-2FXO and VIC-2FXO-EU voice interface cards do not detect battery reversal. On digital voice ports, battery reversal is supported only on E1 Mercury Exchange Limited Channel Associated Signaling (MEL CAS); it is not supported in T1 channel associated signaling (CAS) or E1 CAS.
FXS ports normally reverse battery upon call connection. If an FXS port is connected to an FXO port that does not support battery reversal detection, you can use the no battery-reversal command on the FXS port to prevent unexpected behavior.
FXO ports in loopstart mode normally disconnect calls when they detect a second battery reversal (back to normal). You can use the no battery-reversal command on FXO ports to disable this action.
The battery-reversal command restores voice ports to their default battery-reversal operation.
If an FXO voice port is connected to the PSTN and supports battery reversal, use the battery-reversal command with the answer keyword to configure answer supervision. This configures the FXO voice port to detect when a call is answered in order to provide correct billing information.
If the voice port, PSTN, or PBX does not support battery reversal, do not use the battery-reversal command because it prevents outgoing calls from being connected. Use the supervisory answer dualtone command instead.
If an FXO port or its peer FXS port does not support battery reversal, avoid configuring battery-reversal or battery-reversal answer on the FXO port. On FXO ports that do not support battery reversal, the battery-reversal command can cause unpredictable behavior, and the battery-reversal answer command prevents calls from being answered. To ensure that battery reversal answer is disabled on FXO ports that do not support battery reversal, use the no battery-reversal command.
Examples
The following example disables battery reversal on voice port 1/0/0 on a router:
voice-port 1/0/0no battery-reversalThe following example enables battery reversal to provide answer supervision on voice port 1/0/0 on a router:
voice-port 1/0/0battery-reversal answerRelated Commands
bearer-capability clear-channel
To specify the information transfer capability of the bearer capability information element (IE) in the outgoing ISDN SETUP message for Session Initiation Protocol (SIP) early-media calls that negotiate the clear-channel codec, use the bearer-capability clear-channel command in SIP configuration mode. To reset the information transfer capability of the bearer capability IE to speech (default), use the no form of this command.
bearer-capability clear-channel {speech | udi | rdi | audio | tones | video}
no bearer-capability clear-channel
Syntax Description
Command Default
The default information transfer capability setting for the bearer-capability IE is speech.
Command Modes
SIP configuration (conf-serv-sip)
Command History
Usage Guidelines
When a Cisco voice gateway receives a SIP early-media call and negotiates the clear-channel codec, the default for the information transfer capability octet (octet 3) of the bearer capability IE in the outgoing ISDN SETUP message is set to speech. Use the bearer-capability clear-channel command to change the information transfer capability of the bearer capability IE to a different value.
Note
Changing the information transfer capability of the bearer capability IE affects only SIP early-media calls. The information transfer capability value is always speech for SIP delayed-media calls, even when the clear-channel codec is negotiated.
You can display the current information transfer capability setting for the bearer capability IE using the show running-config command. To show only voice service configuration information, limit the display output to the section on voice service (see the "Examples" section).
Note
Examples
The following examples show how to configure the information transfer capability of the bearer capability IE to UDI to allow for 64 kb/s data transfer over ISDN and how to display the current setting.
Use the following commands to change the information transfer capability setting in the bearer capability IE to udi:
voice service voipsipbearer-capability clear-channel udiUse the following command to display the current information transfer capability setting:
Router# show running-config | section voice servicevoice service voiph323sipbearer-capability clear-channel udibilling b-channel
To enable the H.323 gateway to access B-channel information for all H.323 calls, use the billing b-channel command in H.323 voice service configuration mode. To return to the default setting, use the no form of this command.
billing b-channel
no billing b-channel
Syntax Description
This command has no arguments or keywords.
Command Default
B-channel information is disabled.
Command Modes
H.323 voice service configuration
Command History
Usage Guidelines
This command enables the H.323 application to receive B-channel information of incoming ISDN calls. The B-channel information appears in H.323 ARQ / LRQ messages and can be used during call transfer or to route a call.
Examples
The following example adds B-channel information to the H.323 gateway:
Router(config)# voice service voipRouter(conf-voi-serv)# h323Router(conf-serv-h323)# billing b-channelRelated Commands
h323
Enables H.323 voice service configuration commands.
voice service
Enters voice-service configuration mode and specifies the voice encapsulation type.
bind
To bind the source address for signaling and media packets to the IP address of a specific interface, use the bind command in SIP configuration mode. To disable binding, use the no form of this command.
bind {control | media | all} source-interface interface-id
no bind
Syntax Description
Note
Command Default
Binding is disabled.
Command Modes
SIP configuration
Command History
Usage Guidelines
If the bind command is not enabled, the IP layer still provides the best local address.
Enter SIP configuration mode from voice-service configuration mode, as shown in the example:
Examples
The following example sets up binding on a SIP network:
Router(config)# voice serv voipRouter(conf-voi-serv)# sipRouter(conf-serv-sip)# bind control source-interface FastEthernet 0Related Commands
bind interface
To bind an interface to a Cisco CallManager group, use the bind interface command in SCCP Cisco CallManager configuration mode. To unbind the selected interface, use the no form of this command.
bind interface interface-type interface-number
no bind interface interface-type interface-number
Syntax Description
Command Default
Interfaces are not associated with any Cisco CallManager group.
Command Modes
SCCP Cisco CallManager configuration
Command History
Usage Guidelines
The selected interface is used for all calls that belong to the profiles that are associated to this Cisco CallManager group. If the interface is not selected, it selects the best interface's IP address in the gateway. Interfaces are selected according to user requirements. If there is only one group interface, configuration is not needed.
Note
Examples
The following example binds the interface to a specific Cisco CallManager group:
Router(config-sccp-ccm)# bind interface fastethernet 2:1Related Commands
block-caller
To configure call blocking on caller ID, use the block-caller command in dial peer voice configuration mode. To disable call blocking on caller ID, use the no form of this command.
block-caller number
no block-caller number
Syntax Description
Command Default
Call blocking is disabled; the router does not block any calls for any listed directory numbers (LDNs) based on caller ID numbers
Command Modes
Dial peer voice configuration
Command History
Modification
12.1(2)XF
This command was introduced on the Cisco 800 series routers.
12.1(5)T
This command was integrated into Cisco IOS Release 12.1(5)T.
This command is available on Cisco 800 series routers that have plain old telephone service (POTS) ports. For each dial peer, you can enter up to ten caller ID numbers to block. The routers do not accept additional caller ID numbers if ten numbers are already present. In that case, a number must be removed before another caller ID number can be added for blocking.
If you do not specify the block-caller command for a local directory, all voice calls to that local directory are accepted. If you specify the block-caller command for a local directory, the router verifies that the incoming calling-party number does not match any caller ID numbers in that local directory before processing or accepting the voice call. Each specified caller ID number and incoming calling-party number is compared from right to left, up to the number of digits in the specified caller ID number or incoming calling-party number, whichever has fewer digits.
This command is effective only if you subscribe to caller ID service. If you enable call blocking on caller ID without subscribing to the caller ID service, the routers do not perform the verification process on calling-party numbers and do not block any calls.
Examples
The following example configures a router to block calls from a caller whose caller ID number is 408-555-0134.
dial-peer voice 1 potsblock-caller 4085550134Related Commands
bootup e-lead off
To prevent an analog ear and mouth (E&M) voice port from keying the attached radio on router boot up, use the bootup e-lead off command in voice-port configuration mode. To allow the analog E&M voice port to key the attached radio on boot up, use the no form of this command.
bootup e-lead off
no bootup e-lead off
Syntax Description
This command has no arguments or keywords.
Command Default
The analog E&M voice port keys the attached radio on radio boot up.
Command Modes
Voice-port configuration
Command History
12.3(4)XD
This command was introduced.
12.3(7)T
This command was integrated into Cisco IOS Release 12.3(7)T.
Usage Guidelines
This command configures the E-lead behavior on boot up for both voice ports on the voice interface card (VIC).
Examples
The following example configures the analog E&M voice port to not key the attached radio on router boot up:
voice-port 1/0/0bootup e-lead offbusyout forced
To force a voice port into the busyout state, use the busyout forced command in voice-port configuration mode. To remove the voice port from the busyout state, use the no form of this command.
busyout forced
no busyout forced
Syntax Description
This command has no arguments or keywords.
Command Default
The voice-port is not in the busyout state.
Command Modes
Voice-port configuration
Command History
Usage Guidelines
If a voice port is in the forced busyout state, only the no busyout forced command can restore the voice port to service.
To avoid conflicting command-line interface (CLI) commands, do not use the busyout forced command and the ds0 busyout command on the same controller.
Examples
The following example forces analog voice port 3/1/1 on a Cisco 3600 router into the busyout state:
voice-port 3/1/1busyout forcedThe following example forces digital voice port 0/0:12 on a Cisco 3600 router into the busyout state:
voice-port 0/0:12busyout forcedRelated Commands
bus yout monitor
To place a voice port into the busyout monitor state, enter the busyout monitor command in voice-port configuration mode. To remove the busyout monitor state from the voice port, use the no form of this command.
busyout monitor {serial interface-number | ethernet interface-number | keepalive} [in-service]
no busyout monitor {serial interface-number | ethernet interface-number | keepalive}
Syntax Description
Command Default
The voice port does not monitor any interfaces.
Command Modes
Voice-port configuration
Command History
Usage Guidelines
When you place a voice port in the busyout monitor state, the voice port monitors the specified interface and enters the busyout state when the interface is down. This down state forces the rerouting of calls.
The busyout monitor command monitors only the up or down status of an interface—not end-to-end TCP/IP connectivity.
When an interface is operational, a busied-out voice port returns to its normal state.
This feature can monitor LAN, WAN, and virtual subinterfaces.
A voice port can monitor multiple interfaces at the same time. To configure a voice port to monitor multiple interfaces, reenter the busyout monitor command for each additional interface to be monitored.
If you specify more than one monitored interface for a voice port, all the monitored interfaces must be down to trigger busyout on the voice port.
You can combine in-service and out-of-service monitoring on a voice port. The following rule describes the action if monitored interfaces change state. A voice port is busied out if either of the following occurs:
•
•
Examples
The following example shows configuration of analog voice port 1/2 to busy out if serial port 0 or 1 comes into service:
voice-port 1/2busyout monitor serial 0 in-servicebusyout monitor serial 1 in-serviceThe following example shows configuration of digital voice port 1/2/2 on a Cisco 3600 series router to busy out if serial port 0 goes out of service:
voice-port 1/2/2 busyout monitor serial 0The following example shows configuration of the voice port to monitor two serial interfaces and an Ethernet interface. When all these interfaces are down, the voice port is busied out. When at least one interface is operating, the voice port is put back into a normal state.
voice-port 3/0:0busyout monitor ethernet 0/0busyout monitor serial 1/0busyout monitor serial 2/0The following example shows configuration of the voice port to be busied out in case of a keepalive failure:
voice-port 10busyout monitor keepaliveRelated Commands
busyout monitor action
To place a voice port into graceful or shutdown busyout state when triggered by the busyout monitor, use the busyout monitor action command in voice-port configuration mode. To remove the voice port from the busyout state, use the no form of this command.
busyout monitor action {graceful | shutdown | alarm blue}
no busyout monitor action {graceful | shutdown | alarm blue}
Syntax Description
graceful
Graceful busyout state.
shutdown
D-channel shutdown busyout state.
alarm blue
Shutdown state with a blue alarm, also known as an alarm-indication signal (AIS).
Command Default
Default voice busyout behavior without this command is a forced busyout.
Default voice busyout behavior for PRI depends on whether or not the ISDN switch type supports service messages:
•
•
Command Modes
Voice-port configuration
Command History
Usage Guidelines
Use this command to control busyout behavior that is triggered by the busyout monitor command.
This command with the graceful keyword busies out the voice port immediately or, if there is an active call on this voice port, waits until the call is over.
This command with the shutdown keyword has the following attributes:
•
•
Examples
The following example shows analog voice-port busyout state set to graceful:
voice-port 2/0:15busyout monitor action gracefulThe following example shows E1 PRI voice-port busyout state set to shutdown:
voice-port 1/1:15 (E1 PRI)busyout monitor gatekeeperbusyout monitor action shutdownThe following example shows T1 PRI voice-port busyout state set to shutdown:
voice-port 0/1:23 (T1 PRI)busyout monitor gatekeeperbusyout monitor action shutdownRelated Commands
busyout monitor action graceful
To place a voice port into the graceful busyout state when triggered by the busyout monitor, use the busyout monitor action graceful command in voice-port configuration mode. To remove the voice port from the graceful busyout state, use the no form of this command.
busyout monitor action graceful
no busyout monitor action graceful
Syntax Description
This command has no arguments or keywords.
Command Default
Forced busyout
Command Modes
Voice-port configuration
Command History
12.4(6)T
This command was introduced to replace the busyout action graceful command.
Usage Guidelines
For switches that support the service messages feature, the busyout monitor action graceful command busies out the voice port immediately if the busyout behavior is triggered. However, if there is an active call on the voice port, the voice port will not busy out until after the call has ended.
For ISDN switches that do not support the service messages features, the busyout monitor action graceful command busies out the voice port immediately if the busyout behavior is triggered, even if there is an active call on the voice port.
Examples
The following example shows the analog voice-port busyout state set to graceful:
voice-port 1/1/1busyout monitor action gracefulRelated Commands
busyout monitor action shutdown
To specify that the D channel is to be brought down when the busyout condition is triggered on a PRI voice port, use the busyout monitor action shutdown command in voice-port configuration mode. To cancel this action, use the no form of this command.
busyout monitor action shutdown
no busyout monitor action shutdown
Syntax Description
This command has no arguments or keywords.
Command Default
Default voice busyout behavior for PRI is to transmit B-channel out-of-service (OOS) messages for ISDN switch types that support such service messages, and to keep the D channel active. For ISDN switch types that do not support service messages, the default voice busyout behavior is to bring down the D channel.
ISDN switch types that support service messages are NI, 4ESS (user side only), 5ESS (user side only), and DMS100.
Command Modes
Voice-port configuration
Command History
12.4(6)T
This command was introduced to replace the busyout action shutdown command.
Usage Guidelines
Prior to Cisco IOS Release 12.2(8)T, when the voice busyout condition is triggered on a PRI voice port, the D channel is deactivated until the busyout trigger is cleared. Some ISDN switch types however, support in-service and OOS Q.931 messages that permit the B channels to be taken out of service while still keeping the D channel active. Starting in Release 12.3(8)T for these ISDN switch types, OOS messages are sent and the D channel is kept active when the voice busyout condition is triggered.
To specify that the D channel is to be brought down whenever the busyout condition is triggered, regardless of the ISDN switch type, the busyout action shutdown command was introduced in Cisco IOS Release 12.3(6). The busyout monitor action shutdown command was introduced in Cisco IOS Release 12.4(6)T to replace the busyout action shutdown command.
The busyout monitor action shutdown command is available only under PRI voice ports.
Examples
The following example shows an E1 PRI voice-port busyout state set to shutdown:
voice-port 1/1:15 (E1 PRI)busyout monitor gatekeeperbusyout monitor action shutdownThe following example shows a T1 PRI voice-port busyout state set to shutdown:
voice-port 0/1:23 (T1 PRI)busyout monitor gatekeeperbusyout monitor action shutdownRelated Commands
busyout monitor backhaul
To configure a voice port to enter busyout-monitor state with backhaul-L3 connectivity monitoring during a wide-area-network (WAN) failure, use the busyout monitor backhaul command in voice-port configuration mode. To disable busyout-monitor state, use the no form of this command.
busyout monitor backhaul
no busyout monitor backhaul
Syntax Description
This command has no arguments or keywords.
Command Default
If this command is not used, the voice port is not configured to enter busyout state during a WAN failure.
Command Modes
Voice-port configuration
Command History
Usage Guidelines
Use this command to implement backhaul-L3 connectivity monitoring.
Examples
The following example configures a voice port to enter busyout-monitor state with backhaul-L3 connectivity monitoring during a WAN failure:
Router(config-voiceport)# busyout monitor backhaulRelated Commands
busyout monitor action
Places a voice port into busyout state.
busyout monitor
Configures a voice port to enter busyout-monitor state.
busyout monitor gatekeeper
To configure a voice port to enter the busyout state if connectivity to the gatekeeper is lost, use the busyout monitor gatekeeper command in voice-port configuration mode. To configure the monitor to trigger a busyout when any voice port assigned to a specific voice class loses connectivity to the gatekeeper, use the busyout monitor gatekeeper command in voice-class configuration mode. To disable the busyout monitoring state for the gatekeeper, use the no form of this command.
busyout monitor gatekeeper
no busyout monitor gatekeeper
Syntax Description
This command has no arguments or keywords.
Command Default
If this command is not used, the voice port or voice class is not configured to enter a busyout state if connectivity to the gatekeeper is lost.
Command Modes
Voice-port configuration
Voice-class configurationCommand History
Usage Guidelines
Use this command to monitor the connection between the gateway and gatekeeper.
Examples
The following example shows the busyout monitor state set to busyout the port according to the state of the gatekeeper:
voice-port 1/1/1busyout monitor gatekeeperThe following example enters voice-class (busyout) configuration mode and creates a voice class named 33. The monitor is set to busyout when any voice port in voice class 33 loses connectivity to the gatekeeper:
voice-class busyout 33busyout monitor gatekeeperRelated Commands
busyout monitor probe
To configure a voice port to enter the busyout state if a Service Assurance Agent (SAA) probe signal is returned from a remote IP-addressable interface after the expiration of a specified delay or loss threshold, use the busyout monitor probe command in voice-port configuration mode or voice class busyout mode. To configure a voice port not to monitor SAA probe signals, use the no form of this command.
busyout monitor probe ip-address [codec codec-type] [icpif number | loss percent delay milliseconds ] [grace-period seconds]
no busyout monitor probe ip-address
Syntax Description
Command Default
If the busyout monitor probe command is not entered, the voice port does not monitor SAA probe signals.
If the busyout monitor probe command is entered with no optional keywords or arguments, the default codec type is G.711 a-law, the default loss and delay thresholds are the threshold values that are configured with the call fallback threshold delay-loss command, and the loss of SAA connectivity causes an immediate forced busyout condition.
Command Modes
Voice-port configuration and voice class busyout
Command History
Usage Guidelines
A voice port can monitor multiple interfaces at the same time. To configure a voice port to monitor multiple interfaces, enter the busyout monitor probe command for each additional interface to be monitored.
The busyout monitor probe command is effective only if the call fallback function is enabled on the source router, and the SAA responder is enabled on the target router.
The SAA probe is transmitted periodically with a period determined by the call fallback function.
Low thresholds of ICPIF, loss, and delay result in early busyout when the link deteriorates, thereby raising the voice minimum quality level. High thresholds prevent busyout until loss and delay are long, allowing transmission of lower-quality voice.
Caution
Before the introduction of the grace-period keyword to the busyout monitor probe command, the loss of SAA probe connectivity was sufficient to immediately enforce busyout, causing service and connectivity problems in some networks because busyout conditions could occur frequently and abruptly. To improve busyout monitoring via SAA probes, the grace-period setting allows for an additional timer that must expire before a busyout condition is enforced. That is, the SAA probes and the period of grace must both expire before a busyout condition is invoked. If the SAA IP connectivity is restored within the period of grace, the busyout condition does not occur.
Note
The grace-period keyword is not available in Cisco IOS Release 12.3T.
Examples
The following example shows how to configure analog voice port 1/1/0 to use an SAA probe with a G.711a-law profile to probe the link to two remote interfaces that have IP addresses and to busy out the voice port if SAA probe connectivity is lost for at least 5 seconds. Both links have a loss exceeding 25 percent or a packet delay of more than 1.5 seconds.
voice-port 1/1/0busyout monitor probe 209.165.202.128 codec g711a loss 25 delay 1500 grace-period 45busyout monitor probe 209.165.202.129 codec g711a loss 25 delay 1500 grace-period 45Related Commands
busyout seize
To change the busyout action for a Foreign Exchange Office (FXO) or Foreign Exchange Station (FXS) voice port, use the busyout seize command in voice-port configuration mode. To restore the default busyout action, use the no form of this command.
busyout seize {ignore | repeat}
no busyout seize
Syntax Description
ignore
Specifies the type of ignore procedure, depending on the type of voice port signaling. See Table 1 for more information.
repeat
Specifies the type of repeat procedure, depending on the type of voice port signaling. See Table 1 for more information.
Command Default
See Table 1 for the default actions for different voice ports and signaling types
Command Modes
Voice-port configuration
Command History
Usage Guidelines
The busyout seize command is valid for both analog and digital voice ports. On digital voice ports, the busyout actions are valid whether the busyout results from a voice-port busyout event or from the ds0-busyout command.
The voice port returns to an idle state when the event that triggered the busyout disappears.
Table 1 describes the busyout actions for the busyout seize settings on each voice port type.
The busyout action for E and M voice ports is to seize the far end by setting lead busy.
Examples
The following example shows configuration of analog voice port 1/1 to perform the ignore actions when busied out:
voice-port 1/1 busyout seize ignoreThe following example shows configuration of digital voice port 0:2 to perform the repeat actions when busied out:
voice-port 0:2 busyout seize repeatRelated Commands
