Cisco IOS Voice Commands: V

Transcription

1 Cisco IOS Voice Commands: V This chapter contains commands to configure and maintain Cisco IOS voice applications. The commands are presented in alphabetical order. Some commands required for configuring voice may be found in other Cisco IOS command references. Use the command reference master index or search online to find these commands. For detailed information on how to configure these applications and features, refer to the Cisco IOS Voice Configuration Guide. VR-2893

2 vad (dial peer) Cisco IOS Voice Commands: V vad (dial peer) To enable voice activity detection (VAD) for the calls using a particular dial peer, use the vad command in dial peer configuration mode. To disable VAD, use the no form of this command. vad [aggressive] no vad [aggressive] aggressive Reduces noise threshold from 78 to 62 dbm. Available only when session protocol multicast is configured. VAD is enabled Aggressive VAD is enabled in multicast dial peers Dial peer configuration 11.3(1)T 12.0(4)T 12.2(11)T This command was introduced on Cisco 3600 series. This command was implemented as a dial-peer command on Cisco MC3810 (in prior releases, the vad command was available only as a voice-port command). The aggressive keyword was added. Use this command to enable voice activity detection. With VAD, voice data packets fall into three categories: speech, silence, and unknown. Speech and unknown packets are sent over the network; silence packets are discarded. The sound quality is slightly degraded with VAD, but the connection monopolizes much less bandwidth. If you use the no form of this command, VAD is disabled and voice data is continuously sent to the IP backbone. When configuring voice gateways to handle fax calls, VAD should be disabled at both ends of the IP network because it can interfere with the successful reception of fax traffic. When the aggressive keyword is used, the VAD noise threshold is reduced from 78 to 62 dbm. Noise that falls below the 62 dbm threshold is considered to be silence and is not sent over the network. Additionally, unknown packets are considered to be silence and are discarded. The following example enables VAD for a Voice over IP (VoIP) dial peer, starting from global configuration mode: dial-peer voice 200 voip vad VR-2894

3 Cisco IOS Voice Commands: V vad (dial peer) Related Commands Command Description comfort-noise Generates background noise to fill silent gaps during calls if VAD is activated. dial-peer voice Enters dial peer configuration mode, defines the type of dial peer, and defines the tag number associated with a dial peer. vad (voice-port) Enables VAD for the calls using a particular voice port. VR-2895

4 vad (SPA-DSP) Cisco IOS Voice Commands: V vad (SPA-DSP) To enable or disable voice activity detection (vad) settings configured locally irrespective of the external vad settings, use the vad command in config dspfarm profile mode. vad {on off} override on off override Enables the local vad settings irrespective of the external vad settings. Disables the local vad settins irrespective of the external vad settings. Overrides the external vad settings with local vad configuration details. By default, VAD is enabled. DSP Farm Profile Configuration Mode (config-dspfarm-profile) Cisco IOS XE 3.2S This command was introduced. Use this command to enable voice activity detection locally irrespective of external VAD settings. With VAD, voice data packets fall into three categories: speech, silence, and unknown. Speech and unknown packets are sent over the network; silence packets are discarded. The sound quality is slightly degraded with VAD, but the connection monopolizes much less bandwidth. If you disable VAD, voice data is continuously sent to the IP backbone. The following example enables VAD and overrides external vad settings with local vad settings: Router(config)# dspfarm profile 1 Router(config-dspfarm-profile)# vad on override Router(config-dspfarm-profile)# do show running-config!!! dspfarm profile 1 transcode codec g711ulaw codec g711alaw codec g729ar8 codec g729abr8 maximum sessions 588 associate application SBC vad on override! VR-2896

5 Cisco IOS Voice Commands: V vad (SPA-DSP) The following example disables local vad settings and overrides external vad setting configuration: Router(config)# dspfarm profile 1 Router(config-dspfarm-profile)# vad off override Router(config-dspfarm-profile)# do show running-config!!! dspfarm profile 1 transcode codec g711ulaw codec g711alaw codec g729ar8 codec g729abr8 maximum sessions 588 associate application SBC vad off override! Related Commands Command Description dsp services dspfarm Enables the DSP-farm services. dspfarm profile Enters the DSP farm profile configuration mode, and defines a profile for the DSP farm services. show dspfarm (SPA-DSP) Displays DSP farm service information, such as operational status and DSP resource allocation for transcoding. VR-2897

6 vbd-playout-delay Cisco IOS Voice Commands: V vbd-playout-delay To configure the voice-band-detection playout-delay buffer on a Cisco router, use the vbd-playout-delay command in voice service session configuration mode. To disable the buffer, use the no form of this command. vbd-playout-delay {maximum milliseconds minimum milliseconds mode {fixed [no-timestamps] passthrough} nominal milliseconds} no vbd-playout-delay maximum Sets the maximum playout buffer delay, in milliseconds (ms). Range: 40 to Default: milliseconds Delay time, in milliseconds (ms). minimum Sets the minimum playout buffer delay, in ms. Range: 10 to 40. Default: 40. mode Configures voice-band-detection playout buffer adaptation mode. fixed Sets the jitter buffer to a constant delay. no-timestamps (Optional) Fixes the jitter buffer at a constant delay without time stamps. passthrough Sets the jitter buffer passthrough mode for clock compensation. nominal Sets the nominal playout buffer delay, in ms. Range: 10 to Default: 60. Defaults The voice-band-detection playout-delay buffer is disabled. Voice service session configuration (conf-voi-serv-sess) 12.2(8)T 12.4(24)T 12.4(24)T6 This command was introduced. This command was modified. The minimum time range value was changed from 4 to 1700 ms to a range of 10 to 40 ms. The default value 4 was increased to 40 ms. The maximum time value was decreased from 1700 to 1000 ms and the default of 200 was increased to 1000 ms. The nominal time range value was changed from 0 to 1500 ms to a range of 10 to 1000 ms. The default value of 100 was decreased to 60 ms. This command was modified. The no-timestamps keyword was added and passthrough keyword usage guidelines were clarified. Use this command to set the playout jitter buffer. When a voice band is detected, the call uses the G.711 codec, and the playout delay values that you set are picked up. The original voice-call parameters are restored after the fax or modem call is completed. The no-timestamps keyword sets the jitter buffer at a constant delay without reading time stamps. VR-2898

7 Cisco IOS Voice Commands: V vbd-playout-delay Note The passthough keyword is a special mode used to handle clock drifting properly. We recommend this keyword only when instructed by your Cisco representative. The following example configures ATM adaptation layer 2 (AAL2) voice-band-detection playout-delay adaptation mode and sets the mode to fixed: voice service voatm session protocol aal2 vbd-playout-delay mode fixed The following example configures AAL2 voice-band-detection playout-delay adaptation mode and sets the mode at a constant delay without timestamps: voice service voatm session protocol aal2 vbd-playout-delay mode fixed no-timestamps The following example sets the nominal AAL2 voice-band-detection playout-delay buffer to 12 ms: voice service voatm session protocol aal2 vbd-playout-delay nominal 12 The following example sets the AAL2 voice-band-detection playout-buffer delay to a maximum of 55 ms: voice service voatm session protocol aal2 vbd-playout-delay maximum 55 The following example sets the AAL2 voice-band-detection playout-buffer delay to a minimum of 22 ms: voice service voatm session protocol aal2 vbd-playout-delay minimum 22 Related Commands Command Description voice-service Specifies the voice encapsulation type and enters voice service configuration mode. VR-2899

8 vbr-rt Cisco IOS Voice Commands: V vbr-rt To configure the real-time variable bit rate (VBR) for VoATM voice connections, use the vbr-rt command in the appropriate configuration mode. To disable VBR for voice connections, use the no form of this command. vbr-rt peak-rate average-rate burst no vbr-rt peak-rate Peak information rate (PIR) for the voice connection, in kbps. If it does not exceed your carrier s line rate, set it to the line rate. Range is from 56 to average-rate Average information rate (AIR) for the voice connection in kbps. burst Burst size, in number of cells. Range is from 0 to No real-time VBR settings are configured For an ATM permanent virtual connection (PVC) or switched virtual circuit (SVC): Interface-ATM-VC configuration For a virtual circuit (VC) class: VC-class configuration For ATM VC bundle members: Bundle-vc configuration 12.0 This command was introduced on Cisco MC (5)XM This command was implemented on Cisco 3600 series routers and modified to support Simple Gateway Control Protocol (SGCP) and Media Gateway Control Protocol (MGCP). 12.2(2)T This command was integrated into Cisco IOS 12.2(2)T. 12.2(11)T This command was implemented on the Cisco AS5300 and Cisco AS5850. This command configures traffic shaping between voice and data PVCs. Traffic shaping is required so that the carrier does not discard calls. To configure voice and data traffic shaping, you must configure the peak, average, and burst options for voice traffic. Configure the burst value if the PVC will carry bursty traffic. Peak, average, and burst values are needed so that the PVC can effectively handle the bandwidth for the number of voice calls. Calculate the minimum peak, average, and burst values for the number of voice calls as follows: Peak Value Peak value = (2 x the maximum number of calls) x 16K = VR-2900

9 Cisco IOS Voice Commands: V vbr-rt Average Value Calculate according to the maximum number of calls that the PVC will carry times the bandwidth per call. The following formulas give you the average rate in kbps: For VoIP: G.711 with 40- or 80-byte sample size: Average value = max calls x 128K = G.726 with 40-byte sample size: Average value = max calls x 85K = G.729a with 10-byte sample size: Average value = max calls x 85K = For VoATM adaptation layer 2 (VoAAL2): G.711 with 40-byte sample size: Average value = max calls x 85K = G.726 with 40-byte sample size: Average value = max calls x 43K = G.729a with 10-byte sample size: Average value = max calls x 43K = If voice activity detection (VAD) is enabled, bandwidth usage is reduced by as much as 12 percent with the maximum number of calls in progress. With fewer calls in progress, bandwidth savings are less. Burst Value Set the burst size as large as possible, and never less than the minimum burst size. Guidelines are as follows: Minimum burst size = 4 x number of voice calls = Maximum burst size = maximum allowed by the carrier = When you configure data PVCs that will be traffic shaped with voice PVCs, use aal5snap encapsulation and calculate the overhead as 1.13 times the voice rate. The following example configures the traffic-shaping rate for ATM PVC 20. Peak, average, and burst rates are calculated based on a maximum of 20 calls on the PVC. pvc 20 encapsulation aal5mux voice vbr-rt Related Commands Command Description encapsulation aal5 Configures the AAL and encapsulation type for an ATM PVC, SVC, or VC class. VR-2901

10 vcci Cisco IOS Voice Commands: V vcci To identify a permanent virtual circuit (PVC) to the call agent, use the vcci command in ATM virtual circuit (VC) configuration mode. To restore the default value, use the no form of this command. vcci pvc-identifier no vcci pvc-identifier Identifier for the PVC. Range is from 0 to There is no default value. No default behavior or values ATM virtual circuit configuration mode 12.1(5)XM 12.2(2)T 12.2(11)T This command was introduced. This command was integrated into Cisco IOS 12.2(2)T. This command was implemented on the Cisco AS5300 and Cisco AS5850. The pvc-identifier argument is a unique 15-bit value for each PVC. The call agent sets up a call with the gateway by specifying the PVC using the pvc-identifier. The following example shows how to assign a PVC identifier: Router(config-if-atm-vc)# vcci 5278 Related Commands Command mgcp pvc Description Starts the MGCP daemon. Creates an ATM PVC for voice traffic. VR-2902

11 Cisco IOS Voice Commands: V video codec (dial peer) video codec (dial peer) To assign a video codec to a VoIP dial peer, use the video codec command in dial peer configuration mode. To remove a video codec, use the no form of this command. video codec {h261 h263 h263+ h264} no video codec h261 Video codec H.261 h263 Video codec H.263 h263+ Video codec H.263+ h264 Video codec H.264 No video codec is configured. Dial peer configuration 12.4(11)T This command was introduced. Use this command to configure a video codec for a VoIP dial peer. If no video codec is configured, the default is transparent codec operation between the endpoints. The following example shows configuration for video codec H.263+ on VoIP dial peer 30: dial-peer voice 30 voip video codec h263+ Related Commands Command video codec (voice-class) Description Specifies a video codec for a voice class. VR-2903

12 video codec (voice class) Cisco IOS Voice Commands: V video codec (voice class) To specify a video codec for a voice class, use the video codec command in voice class configuration mode. To remove the video codec, use the no form of this command. video codec {h261 h263 h263+ h264} no video codec {h261 h263 h263+ h264} h261 Apply this preference to video codec H.261 h263 Apply this preference to video codec H.263 h263+ Apply this preference to video codec H.263+ h264 Apply this preference to video codec H.264 No video codec is configured. Voice class configuration 12.4(11)T This command was introduced. Use this command to specify one or more video codecs for a voice class. The following example shows configuration for voice class codec 10 with two audio codec preferences and three video codec preferences: voice class codec 10 codec preference 1 g711alaw codec preference 2 g722 video codec h261 video codec h263 video codec h264 Related Commands Command video codec (dial peer) Description Specifies a video codec for a VoIP dial peer. VR-2904

13 Cisco IOS Voice Commands: V video screening video screening To enable transcoding and transsizing between two call legs when configuring SIP, use the video screening command in foice service SIP configuration mode. To disable transcoding and transsizing, use no form of this command. video screening no video screening This command has no arguments or keywords. Video screening is disabled. Voice service SIP configuration. 15.1(4)M The command was introduced. Use this command to enable conversion of video streams if there is a mismatch between two call legs. The following example enters the voice-card configuration mode and enables video screening: Router(config)# voice service voip Router(config-voicecard)# sip Router((conf-serv-sip)# video screening Related Commands Command codec profile video codec Description Defines the video capabilities needed for video endpoints. Assigns a video codec to a VoIP dial peer. VR-2905

14 vmwi Cisco IOS Voice Commands: V vmwi To enable DC voltage or FSK visual message-waiting indictator (VMWI) on a Cisco VG224 onboard analog FXS voice port, use the vmwi command in voice-port configuration mode. To reset VMWI to default, use the no form of this command. vmwi {dc-voltage fsk} no vmwi dc-voltage fsk DC voltage VMWI is enabled on this FXS port. FSK VMWI is enabled on this FXS port. Default. FSK VMWI is enabled. Voice-port configuration (config-voiceport) 12.4(20)YA 12.4(22)T This command was introduced. This command was integrated into Cisco IOS 12.4(22)T. This command with the dc-voltage keyword enables the message-waiting lamp to flash on an analog phone that requires DC voltage to activate a visual indicator. This command with the fsk keyword enables the message-waiting lamp to flash on an analog phone that requires an FSK message to activate a visual indicator. DC Voltage VMWI is supported for the SCCP telephony control (STC) application only. For all other applications, such as MGCP, FSK will be used even if you configure the vmwi dc-voltage command on the voice gateway. The example shows how to enable DC Voltage VMWI on port 2/0 on a Cisco VG224. Router(config)#voice-port 2/0 Router(config-voiceport)#vmwi dc-voltage Router(config-voiceport)#end Related Commands Command stcapp Description Enables basic SCCP call-control features for FXS analog ports on Cisco IOS voice gateways VR-2906

15 Cisco IOS Voice Commands: V vofr vofr To enable Voice over Frame Relay (VoFR) on a specific data-link connection identifier (DLCI) and to configure specific subchannels on that DLCI, use the vofr command in frame relay DLCI configuration mode. To disable VoFR on a specific DLCI, use the no form of this command. Switched Calls vofr [data cid] [call-control [cid]] no vofr [data cid] [call-control [cid]] Switched Calls to Cisco MC3810 Multiservice Concentrators Running Cisco IOS s Before 12.0(7)XK and 12.1(2)T vofr [cisco] no vofr [cisco] Cisco-Trunk Permanent Calls vofr data cid call-control cid no vofr data cid call-control cid FRF.11 Trunk Calls vofr [data cid] [call-control cid] no vofr [data cid] [call-control cid] data (Required for Cisco-trunk permanent calls. Optional for switched calls.) Selects a subchannel (CID) for data other than the default subchannel, which is 4. cid (Optional) Specifies the subchannel to be used for data. Range is from 4 to 255. The default is 4. If data is specified, enter a valid CID. call-control (Optional) Reserves a subchannel for call-control signaling. cisco cid (Optional) Cisco proprietary voice encapsulation for VoFR with data is carried on CID 4 and call-control on CID 5. (Optional) Specifies the subchannel to be used for call-control signaling. Valid range is from 4 to 255. The default is 5. If call-control is specified and a CID is not entered, the default CID is used. Disabled Frame relay DLCI configuration VR-2907

16 vofr Cisco IOS Voice Commands: V 12.0(3)XG 12.0(4)T 12.0(7)XK 12.1(2)T This command was introduced on Cisco 2600 series, Cisco 3600 series, and Cisco 7200 series routers and Cisco MC3810. This command was integrated into Cisco IOS 12.0(4)T. The use of the cisco option was modified. Beginning in this release, use the cisco option only when configuring connections to Cisco MC3810 running Cisco IOS s before 12.0(7)XK and 12.1(2)T. This command was integrated into Cisco IOS 12.1(2)T. Table 244 lists the different options of the vofr command and which combination of options is used beginning in Cisco IOS 12.0(7)XK and 12.1(2)T. Table 244 Combinations of the vofr Command Type of Call Switched call (user dialed or auto-ringdown) to other routers supporting VoFR Cisco-trunk permanent call (private-line) to other routers supporting VoFR FRF.11 trunk call (private-line) to other routers supporting VoFR Command Combination to Use vofr [data cid] [call-control [cid]] 1 vofr data cid call-control cid vofr [data cid] [call-control cid] 2 1. The recommended form of this command to use is vofr data 4 call-control For FRF.11 trunk calls, the call-control option is not required. It is required only if you mix FRF.11 trunk calls with other types of voice calls on the same PVC. The following example, beginning in global configuration mode, shows how to enable VoFR on serial interface 1/1, DLCI 100. The example configures CID 4 for data; no call-control CID is defined. interface serial 1/1 frame-relay interface-dlci 100 vofr To configure CID 4 for data and CID 5 for call-control (both defaults), enter the following command: vofr call-control To configure CID 10 for data and CID 15 for call-control, enter the following command: vofr data 10 call-control 15 To configure CID 4 for data and CID 15 for call-control, enter the following command: vofr call-control 15 To configure CID 10 for data and CID 5 for call-control, enter the following command: vofr data 10 call-control To configure CID 10 for data with no call-control, enter the following command: vofr data 10 VR-2908

17 Cisco IOS Voice Commands: V vofr Related Commands Command Description class Assigns a VC class to a PVC. frame-relay interface-dlci Assigns a DLCI to a specified Frame Relay subinterface. VR-2909

18 voice Cisco IOS Voice Commands: V voice To enable voice resource pool services for resource pool management, use the voice command in service profile configuration mode. To disable voice services, use the no form of this command. voice no voice This command has no arguments or keywords. Disabled Service profile configuration mode 12.2(2)XA 12.2(2)XB1 12.2(11)T This command was introduced on the Cisco AS5350 and AS5400. This command was implemented on the Cisco AS5850 platform. This command was integrated into Cisco IOS 12.2(11)T. The following example shows that voice service is available and enables voice resource pool service using the voice command in service profile configuration mode: Router(config)# resource-pool profile service voip Router(config-service-profile)#? Service Profile Configuration Commands: default Set a command to its defaults exit Exit from resource-manager configuration mode help Description of the interactive help system modem Configure modem service parameters no Negate a command or set in its defaults voice Configure voice service parameters Router(config-service-profile)# voice Related Commands Command resource-pool enable resource-pool profile service voip Description Enables resource pool management. Defines the VoIP service profile for resource pool management. VR-2910

19 Cisco IOS Voice Commands: V voicecap configure voicecap configure To apply a voicecap on NextPort platforms, use the voicecap configure command in voice-port configuration mode. To remove a voicecap, use the no form of this command. voicecap configure {name} no voicecap configure {name} name Designates which voicecaps to use on this voice port. No default values or behavior Voice-port configuration 12.3(4)T This command was introduced. The character value for the name argument must be identical to the value entered when you created the voicecap using the voicecap entry command. The following example configures a voicecap with the name qualityerl: Router> enable Router# configure terminal Router(config)# voicecap entry qualityerl v270=120 Router(config)# voice-port 3/0:D Router(config-voiceport)# voicecap configure qualityerl Related Commands Command voicecap entry Description Creates a voicecap on NextPort platforms. VR-2911

20 voicecap entry Cisco IOS Voice Commands: V voicecap entry To create a voicecap, use the voicecap entry command in global configuration mode. To disable a voicecap, use the no form of this command. voicecap entry [name string] no voicecap entry [name string] name string (Optional) A word and a string of characters that uniquely identify a voicecap. The name argument specifies a unique identifier for a voicecap. The string argument specifies one or more voicecap register entries, similar to a modemcap. Each entry is of the form vindex=value, where index refers to a specific V register, and value designates the value for that V register. No voice caps can be applied to configure firmware. Global configuration 12.3(4)T 12.3(11)T 12.4(4)XC 12.4(9)T This command was introduced. This command was integrated into Cisco IOS 12.3(11)T. This command was modified to include GSMAMR-NB codec capability. This command was integrated into Cisco IOS 12.4(9)T. This command configures firmware through voicecap strings. This command allows you to assign values to specific registers. Voicecaps are applied to specific voice ports at system startup. The voicecap values can be entered in a DSP-recognizable format called raw format. They can also be entered in standard format, which allows you to use commonly accessible values, such as decibels. Starting with Cisco IOS 12.4(4)XC, this command can be used to configure GSMAMR-NB codecs on Cisco AS5350XM and Cisco AS5400XM platforms. The register values for GSMAMR-NB are shown in Table 245. VR-2912

21 Cisco IOS Voice Commands: V voicecap entry Table 245 GSMAMR-NB Register Values V-Reg # Default Description Register Values and Additional Notes 0 0 Sets how Adaptive Multi-Rate (AMR) responds to an incoming codec mode request (CMR) that is not a member of the mode set. 1 0 Sets how AMR handles packets with a frame type (AMR rate) that is not a member of the mode set. 0 = Drop the packet with the bad CMR. 1 = Ignore the CMR (do not change rates) but process the rest of the packet data normally. 2 = Change the rate to the highest rate in the mode set lower than the rate requested by the CMR. 0 = Drop the packet with the bad frame-type. 1 = Attempt to decode the packet. The following example creates a voicecap string for a GSMAMR-NB codec named gsmamrnb-ctrl with V register 0 set to 1: Router> enable Router# configure terminal Router(config)# voicecap entry gsmamrnb-ctrl v0=1 Related Commands Command voicecap configure Description Applies a voicecap to the specified voice ports. VR-2913

22 voice call capacity mir Cisco IOS Voice Commands: V voice call capacity mir To set the value for the minimum interval between reporting (MIR), use the voice call capacity mir command in global configuration mode. To turn off these attributes, use the no form of this command. voice call {carrier trunk-group prefix} capacity mir seconds no voice call {carrier trunk-group prefix} capacity mir carrier trunk-group prefix seconds Carrier code address family Trunk group address family E.164 prefix Minimum interval, in seconds, with a range of 1 to 3600 seconds and a default of 10. This value cannot be set higher than the time configured for the capacity update interval. 10 seconds. Global configuration. 12.3(1) This command was introduced. Because the available circuit (AC) attribute of a destination is very dynamic, reporting of this attribute should be handled carefully. AC should be reported as frequently as possible so that the location server has better information about the resources. However, the location server should not be overwhelmed with too many updates. All of the AC reporting, called the interesting point of AC, is performed when the specified event happens within the minimum interval between reporting (MIR) time since last reporting. This command sets the amount of time used for the interval to control the number of interesting points that are reported so not to overwhelm the location server with too many AC updates. The seconds argument cannot be set higher than the time configured for the capacity update interval. The following example shows the minimum interval between reporting for the carrier address family set to 25 seconds: Router(config)# voice call carrier capacity mir 25 VR-2914

23 Cisco IOS Voice Commands: V voice call capacity mir Related Commands Command Description capacity update Changes the capacity update for prefixes associated with a dial peer. interval (dial peer) capacity update Change the capacity update for carriers or trunk groups. interval (trunk group) voice call capacity stw Set the value for STW. VR-2915

24 voice call capacity reporting Cisco IOS Voice Commands: V voice call capacity reporting To turn on the reporting of maxima (first derivative) or inflection (second derivative) points in available capacity, use the voice call capacity reporting command in global configuration mode. To turn off the reporting, use the no form of this command. voice call {carrier trunk-group prefix} capacity reporting {maxima inflection} no voice call {carrier trunk-group prefix} capacity reporting {maxima inflection} carrier Carrier code address family. trunk-group Trunk group address family. prefix E.164 prefix. maxima Maxima (first derivative) point in available capacity. inflection Inflection (second derivative) point in available capacity. Defaults The capacity reporting function is turned off. Global configuration. 12.3(1) This command was introduced. The smoothed curve of the available circuits (AC) has maxima, minima, and inflection points. When the curve has reached these points, this represents a change in the call rate. VR-2916

25 Cisco IOS Voice Commands: V voice call capacity reporting Maximum, minimum and inflection points are illustrated in Figure 7. Figure 7 Maximum, Minimum, and Inflection Points for Available Capacity Maximum Inflection point Smoothed available capacity Minimum Time The following example shows the reporting of the available capacity inflection point on the trunk group is turned on: Router(config)# voice call trunk-group capacity reporting inflection Related Commands Command voice call capacity mir voice call capacity timer interval voice call trigger hwm Description Sets the values for the minimum interval between reporting (MIR) and smoothing transition time for weight (STW). Sets the periodic interval for reporting capacity from carrier, trunk group, or prefix databases Sets the value for percentage change, low water mark and high water mark in the available capacity in the trunk group or prefix databases. VR-2917

26 voice call capacity stw Cisco IOS Voice Commands: V voice call capacity stw To set the value for smoothing transition time for weight (STW), use the voice call capacity stw command in global configuration mode. To turn off these attributes, use the no form of this command. voice call {carrier trunk-group prefix} capacity stw seconds no voice call {carrier trunk-group prefix} capacity stw seconds carrier Carrier code address family trunk-group Trunk group address family prefix E.164 prefix seconds Transitions time can be from 0 to 60 seconds with a default of seconds. Global configuration. 12.3(1) This command was introduced. Because the available circuit (AC) attribute of a destination is very dynamic, reporting of this attribute should be handled carefully. AC should be reported as frequently as possible so that the location server has better information about the resources. However, the location server should not be overwhelmed with too many updates. A smoothing algorithm is applied to the quantity of AC being reported. This algorithm eliminates reporting of noise. The degree of smoothing can be configured with the voice call capacity stw command. This command sets the smoothing transition time for weight, which is the time it takes for current smoothed value of AC to come half way between the current smoothed value and the current instantaneous value of AC. Lower stw values speed the smoothed value of AC as it approaches the instantaneous value of AC. When stw is set to 0, the smoothed value is always equal to the instantaneous value of AC. The following example shows the smoothing time for weight for the carrier address family set to 25 seconds: Router(config)# voice call carrier capacity stw 25 VR-2918

27 Cisco IOS Voice Commands: V voice call capacity stw Related Commands Command Description capacity update Changes the capacity update for prefixes associated with a dial peer. interval (dial peer) capacity update Change the capacity update for carriers or trunk groups. interval (trunk group) voice call capacity mir Set the value for MIR. VR-2919

28 voice call capacity timer interval Cisco IOS Voice Commands: V voice call capacity timer interval To set the periodic interval for reporting capacity from carrier, trunk group, or prefix databases, use the voice call capacity timer interval command in global configuration mode. To turn off the interval, use the no form of this command. voice call {carrier trunk-group prefix} capacity timer interval seconds no voice call {carrier trunk-group prefix} capacity timer interval seconds carrier trunk-group prefix seconds Carrier code address family Trunk group address family E.164 prefix Value from 10 to 3600 seconds. 25 seconds Global configuration 12.3(1) This command was introduced. For the reporting interval, a periodic timer called the capacity update timer handles updates of available circuit (AC) information and can be configured using the voice call capacity timer interval command. For example, if AC has changed since the last reporting, the AC is again reported when the capacity update timer expires. The following example sets the timer interval for the prefixes set at 15 seconds: Router(config)# voice call prefix capacity timer interval 15 Related Commands Command voice call capacity mir voice call capacity reporting voice call trigger hwm Description Sets the values for the MIR and STW. Turns on the reporting of maxima (first derivative) or inflection (second derivative) points in available capacity. Sets the value for percentage change, low water mark and high water mark in the available capacity in the trunk group or prefix databases. VR-2920

29 Cisco IOS Voice Commands: V voice call convert-discpi-to-prog voice call convert-discpi-to-prog To convert a disconnect message with a progress indicator (PI) to a progress message, use the voice call convert-discpi-to-prog command in global configuration mode. To return to the default condition, use the no form of this command. voice call convert-discpi-to-prog [tunnel-ies always [tunnel-ies]] no voice call convert-discpi-to-prog tunnel-ies always (Optional) Information elements (IEs) are carried in the progress message. (Optional) Converts disconnect message with a PI to a progress message in both preconnected and connected states. A disconnect message with a PI is not converted to a progress message. Global configuration 12.2(1) This command was introduced. 12.3(6) The tunnel-1es keyword was added. 12.3(4)XQ The always keyword with the tunnel-ies keyword were added. 12.3(8)T The always keyword with the tunnel-ies keyword were added. 12.3(9) The always keyword with the tunnel-1es keyword were added. The voice call convert-discpi-to-prog command turns an ISDN disconnect message into a progress message. If you use the tunnel-ies keyword, the information elements are not dropped when the disconnect message is converted to a progress message. The following example changes a disconnect with PI to a progress message containing information elements (IEs): voice call convert-discpi-to-prog tunnel-ies The following example changes a disconnect with PI to a progress message in the preconnected and connected states: voice call convert-discpi-to-prog always VR-2921

30 voice call convert-discpi-to-prog Cisco IOS Voice Commands: V Related Commands Command Description disc_pi_off Enables an H.323 gateway to disconnect a call when it receives a disconnect message with a PI. VR-2922

31 Cisco IOS Voice Commands: V voice call csr data-points voice call csr data-points To set the number of call success rate (CSR) data points, use the voice call csr data-points command in global configuration mode. To disable the setting of the CSR data points, use the no form of this command. voice call {carrier trunk-group prefix} csr data-points value no voice call {carrier trunk-group prefix} csr data-points value carrier Carrier code address family trunk-group Trunk group address family prefix E.164 prefix value Value from 10 to 50 data points. Default is 30 data points. 30 data points Global configuration 12.3(1) This command was introduced. The following example sets the CSR data points for trunk groups at 10: Router(config)# voice call trunk-group csr data-points 10 Related Commands Command voice call csr recording interval voice call csr reporting interval Description Sets the recording interval for CSR. Sets the reporting interval for CSR. VR-2923

32 voice call csr recording interval Cisco IOS Voice Commands: V voice call csr recording interval To set the recording interval for call success rates (CSR), use the voice call csr recording interval command in global configuration mode. To disable the CSR recording interval, use the no form of this command. voice call {carrier trunk-group prefix} csr recording interval minutes no voice call {carrier trunk-group prefix} csr recording interval minutes carrier Carrier code address family. trunk-group Trunk group address family. prefix E.164 prefix. minutes Value from 10 to 1000 minutes with a default of minutes Global configuration 12.3(1) This command was introduced. The following example sets the CSR recording interval for prefixes at 30 minutes: Router(config)# voice call carrier csr recording interval 30 Related Commands Command voice call csr data-points voice call csr reporting interval Description Sets the number of call success rate (CSR) data points. Sets the reporting interval for CSR. VR-2924

33 Cisco IOS Voice Commands: V voice call csr reporting interval voice call csr reporting interval To set the reporting interval for call success rate (CSR), use the voice call csr reporting interval command in global configuration mode. To disable the CSR recording interval, use the no form of this command. voice call {carrier trunk-group prefix} csr reporting interval seconds no voice call {carrier trunk-group prefix} csr reporting interval seconds carrier Carrier code address family. trunk-group Trunk group address family. prefix E.164 prefix. seconds Value from 10 to seconds with a default of seconds Global configuration 12.3(1) This command was introduced. The following example sets the CSR reporting interval for trunk groups at 40 seconds: Router(config)# voice call carrier csr reporting interval 40 Related Commands Command voice call csr data-points voice call csr recording interval Description Sets the number of CSR data points. Sets the recording interval for CSR. VR-2925

34 voice call debug Cisco IOS Voice Commands: V voice call debug To debug a voice call, use the voice call debug command in global configuration mode. To display a full globally unique identifier (GUID) or header as explained in the section, use the no form of this command. voice call debug full-guid short-header no voice call debug full-guid short-header full-guid short-header Displays the GUID in a 16-byte header. Note When the no version of this command is input with the full-guid keyword, the short 6-byte version displays. This is the default. Displays the CallEntry ID in the header without displaying the GUID or module-specific parameters. The short 6-byte header displays. Global configuration 12.2(11)T The new debug header was added to the following platforms: Cisco 2600 series, Cisco 3620, Cisco 3640, Cisco 3660 series, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, Cisco AS5850, and Cisco MC (15)T The header-only argument was removed and the short-header argument was added. Despite its nontraditional syntax (trailing rather than preceding debug ), this is a normal debug command. You can control the contents of the standardized header. Display options for the header are as follows: Short 6-byte GUID Full 16-byte GUID Short header which contains only the CallEntry ID The format of the GUID headers is as follows: //CallEntryID/GUID/Module-Dependent-List/Function-name:. The format of the short header is as follows: //CallEntryID/Function-name:. VR-2926

35 Cisco IOS Voice Commands: V voice call debug When the voice call debug short-header command is entered, the header displays with no GUID or module-specific parameters. When the no voice call debug short-header command is entered, the header, the 6-byte GUID, and module-dependent parameter output displays. The default option is displaying the 6-byte GUID trace. Note Using the no form of this command does not turn off debugging. The following is sample output when the full-guid keyword is specified: Router# voice call debug full-guid! 00:05:12: //1/0E2C8A90-BC00-11D DACCFDCEF87D/VTSP:(0:D):0:0:4385/vtsp_insert_cdb: 00:05:12: //-1/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/CCAPI/cc_incr_if_call_volume: 00:05:12: //1/0E2C8A90-BC00-11D DACCFDCEF87D/VTSP:(0:D):0:0:4385/vtsp_open_voice_and _set_params: 00:05:12: //1/0E2C8A90-BC00-11D DACCFDCEF87D/VTSP:(0:D):0:0:4385/vtsp_modem_proto_fr om_cdb: 00:05:12: //1/0E2C8A90-BC00-11D DACCFDCEF87D/VTSP:(0:D):0:0:4385/set_playout_cdb: 00:05:12: //1/0E2C8A90-BC00-11D DACCFDCEF87D/VTSP:(0:D):0:0:4385/vtsp_dsp_echo_cance ller_control: Note The //-1/ output indicates that CallEntryID for the CCAPI module is not available. Table 246 describes significant fields shown in the display. Table 246 voice call debug full-guid Field Descriptions Field VTSP:(0:D):0:0:4385 vtsp_insert_cdb CCAPI Description VTSP module, port name, channel number, DSP slot, and DSP channel number. Function name. CCAPI module. The following is sample output when the short-header keyword is specified: Router(config)# voice call debug short-header! 00:05:12: //1/vtsp_insert_cdb: 00:05:12: //-1/cc_incr_if_call_volume: 00:05:12: //1/vtsp_open_voice_and_set_params: 00:05:12: //1/vtsp_modem_proto_from_cdb: 00:05:12: //1/set_playout_cdb: 00:05:12: //1/vtsp_dsp_echo_canceller_control: Note The //-1/ output indicates that CallEntryID for CCAPI is not available. VR-2927

36 voice call debug Cisco IOS Voice Commands: V Related Commands Command Description debug rtsp api Displays debug output for the RTSP client API. debug rtsp client Displays debug output for the RTSP client data. session debug rtsp error Displays error message for RTSP data. debug rtsp pmh Displays debug messages for the PMH. debug rtsp socket Displays debug output for the RTSP client socket data. debug voip ccapi error Traces error logs in the CCAPI. debug voip ccapi inout Traces the execution path through the CCAPI. debug voip ivr all Displays all IVR messages. debug voip ivr applib Displays IVR API libraries being processed. debug voip ivr Displays IVR call setup being processed. callsetup debug voip ivr Displays IVR digits collected during the call. digitcollect debug voip ivr Displays IVR dynamic prompt play debug. dynamic debug voip ivr error Displays IVR errors. debug voip ivr script Displays IVR script debug. debug voip ivr Displays IVR settlement activities. settlement debug voip ivr states Displays IVR states. debug voip ivr Displays the TCL commands used in the script. tclcommands debug voip rawmsg Displays the raw VoIP message. debug vtsp all Enables debug vtsp session, debug vtsp error, and debug vtsp dsp. debug vtsp dsp Displays messages from the DSP. debug vtsp error Displays processing errors in the VTSP. debug vtsp event Displays the state of the gateway and the call events. debug vtsp port Limits VTSP debug output to a specific voice port. debug vtsp rtp Displays the voice telephony RTP packet debugging. debug vtsp send-nse Triggers the VTSP software module to send a triple redundant NSE. debug vtsp session Traces how the router interacts with the DSP. debug vtsp stats Debugs periodic statistical information sent and received from the DSP debug vtsp vofr Displays the first 10 bytes of selected VoFR subframes for the interface. subframe debug vtsp tone Displays the types of tones generated by the VoIP gateway. VR-2928

37 Cisco IOS Voice Commands: V voice call disc-pi-off voice call disc-pi-off To enable the gateway to treat a disconnect message with progress indicator (PI) like a standard disconnect without a PI, use the voice call disc-pi-off command in global configuration mode. To reset to the default, use the no form of this command. voice call disc-pi-off no voice call disc-pi-off This command has no keywords or arguments. Gateway disconnects incoming call leg when it receives a disconnect message with PI. Global configuration 12.3(5) This command was introduced. 12.3(7)T This command was integrated into Cisco IOS 12.3(7)T. Use this command if the gateway is connected to a switch that sends a release immediately after it receives a Disconnect with PI. To properly handle the call, the switch should open a backward voice path and keep the call active. Otherwise the rotary dial peer feature does not work because the incoming call leg is disconnected. Using this command enables the gateway to handle a disconnect with PI like a regular disconnect message so that you can use the rotary dial peer feature. The following example enables the gateway to properly handle a disconnect with PI: voice call disc-pi-off Related Commands Command disc_pi_off voice call convert-discpi-to-prog Description Enables an H.323 gateway to disconnect a call when it receives a disconnect message with a PI. Converts a disconnect message with a PI to a progress message. VR-2929

38 voice call send-alert Cisco IOS Voice Commands: V voice call send-alert To enable the terminating gateway to send an alert message instead of a progress message after it receives a call setup message, use the voice call send-alert command in global configuration mode. To reset to the default, use the no form of this command. voice call send-alert no voice call send-alert This command has no arguments or keywords. The terminating gateway sends a progress message after it receives a call Setup message. Global configuration 12.1(3)XI4 This command was introduced. 12.1(5)T This command was not supported in this release. 12.1(5.3)T This command was integrated into Cisco IOS 12.1(5.3)T. 12.2(1) This command was integrated into Cisco IOS In Cisco IOS 12.1(3)XI and later, the terminating gateway sends a Progress message with a progress indicator (PI) after it receives a Setup message. Previously, the gateway responded with an Alert message after receiving a call. In some cases, if the terminating switch does not forward the progress message to the originating gateway, the originating gateway does not cut-through the voice path until a Connect is received and the caller does not hear a ringback tone. In these cases, you can use the voice call send-alert command to make the gateway backward compatible with releases earlier than Cisco IOS 12.1(3)XI. If you configure the voice call send-alert command, the terminating gateway sends an Alert message after it receives a Setup message from the originating gateway. To complete calls from a PRI to an FXS interface, configure the voice call send-alert command on the FXS device. The following example configures the gateway to send an Alert message: voice call send-alert Related Commands Command progress_ind Description Sets a specific PI in call Setup, Progress, or Connect messages from an H.323 VoIP gateway. VR-2930

39 Cisco IOS Voice Commands: V voice call trap deviation voice call trap deviation To configure the percentage deviation for voice call trap parameters, use the voice call trap deviation command in global configuration mode. To disable the configured percentage deviation, use the no form of this command. voice call trap deviation percent [vad] no voice call trap deviation percent [vad] percent vad The percentage deviation for trapping calls. The range of acceptable values is 1 to 100. The default is 49. (Optional) Specifies the deviation for calls with voice activity detection (VAD) turned on. This command is enabled by default, and the deviation for trapping calls is set to 49 percent. Global configuration (config) 12.4(12) This command was introduced in a release earlier than Cisco IOS 12.4(12). 15.0(1)M The no form of this command was modified. Prior to 15.0(1)M, if a non-default percent value was configured, it could be disabled by entering the no voice call trap deviation percent command, even if the percent value was not the configured value. For example, if the voice call trap deviation 30 command was configured, the no voice call trap deviation 40 command disabled the initial command. Beginning in 15.0(1)M, the percent value in the no form of the command must match the configured non-default value. For example, if the voice call trap deviation 30 command is configured, the only way to disable it is to enter the no voice call trap deviation 30 command. If the no voice call trap deviation 40 command is entered, the command-line interface displays this message: Please enter correct deviation. The following example shows how to set the deviation value for trapping calls to 30 percent: Router(config)# voice call trap deviation 30 vad VR-2931

40 voice call trigger hwm Cisco IOS Voice Commands: V voice call trigger hwm To set the value for high water mark in the available capacity in the trunk group or prefix databases, use the voice call trigger hwm command in global configuration mode. To disable the trigger point, use the no form of this command. voice call {carrier trunk-group prefix} trigger hwm percent no voice call {carrier trunk-group prefix} trigger hwm percent carrier trunk-group prefix percent Carrier code address family Trunk group address family E.164 prefix Value can be 50 to 100 percent with a default of 80. If set to 100, this trigger will be turned off. 80 percent Global configuration. 12.3(1) This command was introduced. Available circuits are reported when the value of AC goes above a threshold, called the high water mark. This can be configured with the voice call trigger hwm command. When the hwm option is selected and the value is set to 100, no update is sent due to high water mark. The following example sets the trigger for available capacity on trunk groups to send at a high water mark of 75%: Router(config)# voice call trunk-group trigger hwm 75 Related Commands Command voice call capacity mir voice call capacity reporting voice call capacity timer interval Description Sets the values for the minimum interval between reporting (MIR) and smoothing transition time for weight (STW). Turns on the reporting of maxima (first derivative) or inflection (second derivative) points in available capacity. Sets the periodic interval for reporting capacity from carrier, trunk group, or prefix databases VR-2932