|
|
This book documents commands used to configure Voice over ATM, Voice over Frame Relay, Voice over HDLC, Voice over IP, video, head-end universal broadband features, and subscriber-end universal broadband features. Commands in this book are listed alphabetically. For information on how to configure Voice over ATM, Voice over Frame Relay, Voice over HDLC, Voice over IP, video, head-end universal broadband features, and subscriber-end universal broadband features, refer to the
Cisco IOS Multiservice Applications Configuration Guide.
Syntax Description
best-effort Indicates that Resource Reservation Protocol (RSVP) makes no bandwidth reservation. This is the default. controlled-load Indicates that RSVP guarantees a single level of preferential service, presumed to correlate to a delay boundary. The controlled load service uses admission (or capacity) control to ensure that preferential service is received even when the bandwidth is overloaded. guaranteed-delay Indicates that RSVP reserves bandwidth and guarantees a minimum bit rate and preferential queuing if the bandwidth reserved is not exceeded.
Defaults
best-effort
Command Modes
Dial-peer configuration
Command History
11.3(1)T This command was introduced.
Release
Modification
Usage Guidelines
This command is only applicable to VoIP dial peers.
Use the acc-qos dial-peer configuration command to generate an SNMP event if the quality of service for specified dial peer drops below the specified level. When a dial peer is used, the Cisco IOS software reserves a certain amount of bandwidth so that the selected quality of service can be provided. Cisco IOS software uses RSVP to request quality of service guarantees from the network.
To select the most appropriate value for this command, you need to be familiar with the amount of traffic this connection supports and what kind of impact you are willing to have on it. The Cisco IOS software generates a trap message when the bandwidth required to provide the selected quality of service is not available.
Examples
The following example selects guaranteed-delay as the specified level below which an SNMP trap message will be generated:
dial-peer voice 10 voip acc-qos guaranteed-delay
Related Commands
req-qos Specifies the desired quality of service to be used in reaching a specified dial peer in Voice over IP.
Command
Description
To create a static entry in the local alias table, use the alias static command in gatekeeper configuration mode. To remove a static entry, use the no form of this command.
alias static ip-signalling-addr [port] gkid gatekeeper-name [ras ip-ras-addr port] [terminal | mcu | gateway {h320 | h323-proxy | voip}] [e164 e164-address] [h323id h323-id]
Syntax Description
ip-signalling-addr IP address of the H.323 node, used as the address to signal when establishing a call. [port] (Optional) Port number other than the endpoint Call Signalling well-known port number (1720). gkid gatekeeper-name Name of the local gatekeeper whose zone this node is a member of. ras ip-ras-addr (Optional) Node RAS signalling address. If omitted, the ip-signalling-addr parameter is used in conjunction with the RAS well-known port. port (Optional) Port number other than the RAS well-known port number (1719). terminal (Optional) Indicates that the alias refers to a terminal. mcu (Optional) Indicates that the alias refers to an MCU. gateway (Optional) Indicates that the alias refers to a gateway. h320 (Optional) Indicates that the alias refers to an H.320 node. h323-proxy (Optional) Indicates that the alias refers to an H.323 proxy. voip (Optional) Indicates that the alias refers to VoIP. e164 e164-address (Optional) Specifies the node E.164 address. This keyword and argument can be used more than once to specify as many E.164 addresses as needed. Note that there is a maximum number of 128 characters that can be entered for this address. To avoid exceeding this limit, you can enter multiple alias static commands with the same call signalling address and different aliases. h323id h323-id (Optional) Specifies the node H.323 alias. This keyword and argument can be used more than once to specify as many H.323 ID aliases as needed. Note that there is a maximum number of 256 characters that can be entered for this address. To avoid exceeding this limit, you can enter multiple alias static commands with the same call signalling address and different aliases.
Defaults
No static aliases exist.
Command Modes
Gatekeeper configuration
Command History
11.3(2)NA and 12.0(3)T This command was introduced.
Release
Modification
Usage Guidelines
The local alias table can be used to load static entries by performing as many of the commands as necessary. Aliases for the same IP address can be added in different commands, if required.
Typically, static aliases are needed to access endpoints that do not belong to a zone (that is, they are not registered with any gatekeeper), or whose gatekeeper is inaccessible for some reason.
Examples
The following example creates a static terminal alias in the local zone:
zone local gk.zone1.com zone1.com alias static 191.7.8.5 gkid gk.zone1.com terminal e164 14085551212 h323id bobs_terminal
Syntax Description
string The alternate dial-out string.
Defaults
No alternate dial-out string is configured.
Command Modes
Dial-peer configuration
Command History
11.3 MA This command was introduced.
Release
Modification
Usage Guidelines
This command applies to Cisco MC3810 POTS, VoFR, VoATM, and VoHDLC dial peers.
The alt-dial command is used for the on-net-to-off-net alternative dialing function. The string replaces the destination-pattern string for dialing out.
Examples
The following example configures an alternate dial-out string of 9,5559871:
alt-dial 9,5559871
Syntax Description
+ (Optional) Character indicating an E.164 standard number. string Series of digits that specify the E.164 or private dialing plan telephone number. Valid entries are: T (Optional) Control character indicating that the answer-address value is a variable length dial-string.
Defaults
The default value is enabled with a null string.
Command Modes
Dial-peer configuration
Command History
11.3(1)T This command was introduced.
Release
Modification
Usage Guidelines
This command is applicable to both Cisco 3600 series VoIP and POTS dial peers.
Use the answer-address command to identify the origin (or dial peer) of incoming calls from the IP network. Cisco IOS software identifies the dial peers of a call in one of two ways: either by identifying the interface through which the call is received or through the telephone number configured with the answer-address command. In the absence of a configured telephone number, the peer associated with the interface will be associated with the incoming call.
For calls coming in from a POTS interface, the answer-address command is not used to select an incoming dial peer. The incoming POTS dial peer is selected on the basis of the port configured for that dial peer.
There are certain areas in the world (for example, in certain European countries) where valid telephone numbers can vary in length. Use the optional control character t to indicate that a particular answer-address value is a variable-length dial-string. In this case, the system will not match the dialed numbers until the interdigit time-out value has expired.
 |
Note The Cisco IOS software does not check the validity of the E.164 telephone number; it accepts any series of digits as a valid number. |
Examples
The following example configures the E.164 telephone number, 555-9626, as the dial peer of an incoming call:
dial-peer voice 10 pots answer-address +5559626
Related Commands
destination-pattern Specifies either the prefix or the full E.164 telephone number (depending on your dial plan) to be used for a dial peer. port (dial peer) Enables an interface on a PA-4R-DTR port adapter to operate as a concentrator port. prefix Specifies the prefix of the dialed digits for this dial peer.
Command
Description
Syntax Description
name Indicates the name of the predefined IVR application. Incoming calls using this POTS dial peer will be handed off to this application.
Defaults
No default behavior or values.
Command Modes
Dial-peer configuration mode
Command History
11.3(6)NA2 This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring interactive voice response (IVR) or any of the IVR-related features to associate a predefined session application with an incoming POTS dial peer. Calls using this incoming POTS dial peer will be handed to the predefined specified session application.
Examples
This following example shows how to define an application and how to apply it to an incoming POTS dial peer:
call application voice c4 tftp://santa/username/clid_4digits_npw_3.tcl ! dial-peer voice 100 pots application c5 answer-address 1234 destination-pattern 100 port 1/0/0
Related Commands
call application voice Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application. call application voice load Reloads this designated TCL script. call application voice pin-length Defines the number of characters in the PIN for the application and passes that information to the application. call application voice redirect-number Defines the telephone number to which a call will be redirected---for example, the operator telephone number of the service provider---for the designated application. call application voice retry-count Defines the number of times a caller is permitted to reenter the PIN for a designated application and passes that information to the application. call application voice set-location Defines the location, language, and category of the audio files for the designated application and passes that information to the application. call application voice uid-length Defines the number of characters in the UID for the designated application and passes that information to the application. call application voice warning-time Defines the number of seconds a user is warned before their allowed calling time runs out for the designated application.
Command
Description
To enable the gatekeeper to reject Admission Requests (ARQs) for zone prefixes that are not configured, use the arq reject-unknown-prefix command in gatekeeper configuration mode. To reenable the gatekeeper to accept and process all incoming ARQs, use the no form of this command.
arq reject-unknown-prefixSyntax Description
This command has no arguments or keywords.
Defaults
The gatekeeper accepts and processes all incoming ARQs.
Command Modes
Gatekeeper configuration
Command History
11.3(6)Q, 11.3(7)NA, and 12.0(3)T This command was introduced.
Release
Modification
Usage Guidelines
Use the arq reject-unknown-prefix command to configure the gatekeeper to reject any incoming ARQs for a destination E.164 address that does not match any of the configured zone prefixes.
When an endpoint or gateway initiates an H.323 call, it sends an ARQ to its gatekeeper. The gatekeeper uses the configured list of zone prefixes to determine where to direct the call. If the called address does not match any of the known zone prefixes, the gatekeeper attempts to hairpin the call out through a local gateway. If you do not want your gateway to do this, then use the arq reject-unknown-prefix command. (hairpin is a term used in telephony that means to send a call back in the direction that it came from. For example, if a call cannot be routed over IP to a gateway that is closer to the target phone, the call is typically sent back out the local zone, back the way it came from.)
This command is typically used to either restrict local gateway calls to a known set of prefixes or deliberately fail such calls so that an alternate choice on a gateway's rotary dial-peer is selected.
Examples
Consider a gatekeeper configured as follows:
zone local gk408 cisco.com zone remote gk415 cisco.com 172.21.139.91 zone prefix gk408 1408....... zone prefix gk415 1415.......
In this example configuration, the gatekeeper manages a zone containing gateways to the 408 area code, and it knows about a peer gatekeeper with gateways to the 415 area code. Using the zone prefix command, the gatekeeper is then configured with the appropriate prefixes so that calls to those area codes hop off in the optimal zone.
If the arq request-unknown-prefix command is not configured, the gatekeeper handles calls in the following way:
If the arq reject-unknown-prefix command is configured, the gatekeeper handles calls in the following way:
To specify the software compression mode on the Cisco MC3810, use the atm compression command in interface configuration mode. To remove the compression mode setting, use the no form of this command.
atm compression {per-packet | per-interface | per-vc}
Syntax Description
per-packet Specifies packet-by-packet compression mode (no history). This is the default. per-interface Specifies one context per interface (with history). per-vc Specifies one context for every virtual circuit (with history).
Defaults
per-packet
Command Modes
Interface configuration
Command History
11.3 MA This command was introduced.
Release
Modification
Usage Guidelines
This command applies to ATM configuration on the Cisco MC3810.
Examples
The following example configures per-packet ATM compression:
interface atm0 atm compression per-packet
To enable scrambling on E1 links, use the atm scramble-enable command in interface configuration mode. To disable scrambling, use the no form of this command.
atm scramble-enableSyntax Description
This command has no arguments or keywords.
Defaults
By default, payload scrambling is off.
Command Modes
Interface configuration
Command History
12.0(5)XK and 12.0(7)T This command was introduced for ATM interface configuration on the Cisco MC3810.
Release
Modification
Usage Guidelines
Enable scrambling on E1 links only. On T1 links, the default B8ZS line encoding normally ensures sufficient reliability. Scrambling improves data reliability on E1 links by randomizing the ATM cell payload frames to avoid continuous nonvariable bit patterns and improve the efficiency of the ATM cell delineation algorithms.
The scrambling setting must match that of the far end.
Examples
On a Cisco MC3810, the following example shows how to set the ATM0 E1 link to scramble payload:
interface atm0 atm scramble-enable
To set the unique ATM end-station address (AESA) for an ATM video interface that is using switched virtual circuit (SVC) mode, use the atm video aesa command in ATM interface configuration mode. To remove any configured address for the interface, use the no form of this command.
atm video aesa [default | esi-address]
Syntax Description
default (Optional) Automatically creates an NSAP address for the interface, based on a prefix from the ATM switch (26 hexadecimal characters), the MAC address (12 hexadecimal characters) as the ESI (end station identifier), and a selector byte (two hexadecimal characters). esi-address (Optional) Defines the 12 hexadecimal characters used as the end-station identifier (ESI). The ATM switch provides the prefix (26 hexadecimal characters), and the video selector byte provides the remaining two hexadecimal characters.
Defaults
The default keyword is the default.
Command Modes
Interface configuration
Command History
12.0(5)XK and 12.0(7)T This command was introduced for ATM interface configuration on the Cisco MC3810.
Release
Modification
Usage Guidelines
You cannot specify the ATM interface NSAP address in its entirety. The system creates either all of the address or part of it, depending on how you use this command.
Examples
On a Cisco MC3810, the following example shows the ATM interface NSAP address set automatically:
interface atm0 atm video aesa default
On a Cisco MC3810, the following example shows the ATM interface NSAP address set to a specific ESI value:
interface atm0/1 atm video aesa 444444444444
Related Commands
show atm video-voice address Displays the NSAP address for the ATM interface.
Command
Description
To initiate loading the selected audio file (.au) (the file that contains the announcement prompt for the caller) from Flash memory into RAM, use the audio-prompt load command in privileged EXEC mode.
audio-prompt load nameSyntax Description
name | Indicates the location of the audio file that you want to be loaded from memory, Flash memory, or an FTP server. Presently, with Cisco IOS Release 11.3(6)NA2, the URL pointer refers to the directory where Flash memory is stored. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3(6)NA2 This command was introduced.
Release
Modification
Usage Guidelines
The first time the IVR application plays a prompt, it reads it from the URL (or the specified location for the .au file, such as Flash or TFP) into RAM. Then it plays the script from RAM. An example of the sequence of events are:
The router will only load the audio file when the script initially plays that prompt after the router restarts. If the audio file is changed, you must run this EXEC command to reread the file. This will generate an error message if the file is not accessible, or if there is a format error.
Examples
The following example shows how to load the enter_pin.au audio file from Flash memory into RAM
audio-prompt load flash:enter_pin.auSyntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Voice-port configuration
Command History
11.3 MA This command was introduced.
Release
Modification
Usage Guidelines
The auto-cut-through command applies to E&M voice ports only on the Cisco MC3810.
Examples
The following example enables the Cisco MC3810 to complete a call when a PBX does not provide an M-lead response:
voice-port 1/1 auto-cut-through
Syntax Description
This command has no arguments or keywords.
Defaults
The voice-port is not in busyout state.
Command Modes
Voice-port configuration
Command History
12.0(3)T This command was introduced.
Release
Modification
Usage Guidelines
When you force a voice port into busyout state, you must enter the no busyout forced command to remove the busyout state from the voice port.
Examples
The following example configures the voice port on the Cisco MC3810 into forced busyout state:
voice-port 1/1
busyout forced
Related Commands
busyout-monitor interface interface Places a voice port on the Cisco MC3810 multiservice concentrator into the busyout monitor state. busyout-seize Changes the busyout seize procedure fro a voice port on the Cisco MC3810 multiservice concentrator. show voice busyout Displays information about the voice busyout state on the Cisco MC3810 multiservice concentrator. voice-port busyout Places all voice ports associated with a serial or ATM interface into a busyout state.
Command
Description
To place a voice port into busyout monitor state, enter the busyout-monitor interface command in voice-port configuration mode. To remove the busyout monitor state on the voice port, use the no form of this command.
busyout-monitor interface interface number
Syntax Description
interface The name of the associated interface or subinterface that will be monitored to trigger a voice-port busyout, for example serial, atm, or ethernet. number The slot and port position of the interface or subinterface, for example, 0/1, 1/1.0, and so on.
Defaults
The voice port is not in busyout monitor state.
Command Modes
Voice-port configuration
Command History
12.0(3)T This command was introduced for the Cisco MC3810. 12.0(5)XK and 12.0(7)T The command was modified for the Cisco 2600 and 3600 series. 12.0(5)XE and 12.0(7)T The command was modified for the Cisco 7200 series routers.
Release
Modification
Usage Guidelines
When you place a voice port in busyout monitor state, the voice port monitors the specified interface and enters the busyout state when the interface is down. This forces rerouting of calls when an interface is down.
If you specify more than one monitored interface for a voice port, all the monitored interfaces must be down in order to trigger busyout on the voice port.
The 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 interfaces, as well as subinterfaces.
Examples
The following example configures 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:0 busyout monitor interface Ethernet0/0 busyout monitor interface Serial1/0 busyout monitor interface Serial2/0
Related Commands
Forces a voice port on the Cisco MC3810 multiservice concentrator into the busyout state. busyout-seize Changes the busyout seize procedure fro a voice port on the Cisco MC3810 multiservice concentrator. show voice busyout Displays information about the voice busyout state on the Cisco MC3810 multiservice concentrator. voice-port busyout Places all voice ports associated with a serial or ATM interface into a busyout state.
Command
Description
Syntax Description
ignore On busyout, leaves the loop open and ignores the incoming signal. repeat On busyout, seizes the far end and ignores all incoming signals until the far end release. Remove the seize signal, wait for one second before starting to seize the far end again.
Defaults
On busyout, the loop is closed and remains in the busyout state.
Command Modes
Voice-port configuration
Command History
12.0(3)T This command was introduced.
Release
Modification
Usage Guidelines
This command is only supported on the Cisco MC3810.
Examples
The following example configures the busyout seize to the ignore state:
voice-port 1/1
busyout-seize ignore
Related Commands
Forces a voice port on the Cisco MC3810 multiservice concentrator into the busyout state. busyout-monitor interface interface Places a voice port on the Cisco MC3810 multiservice concentrator into the busyout monitor state. show voice busyout Displays information about the voice busyout state on the Cisco MC3810 multiservice concentrator. voice-port busyout Places all voice ports associated with a serial or ATM interface into a busyout state.
Command
Description
Syntax Description
This command has no arguments or keywords.
Defaults
ARP enabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
ARP is an Internet protocol used to map IP addresses to MAC addresses on computers and other equipment installed in a network. You need to activate ARP requests so the Cisco uBR7200 series can perform IP address resolution on the downstream path.
Examples
The following example activates cable ARP requests for port 0 on the cable modem card installed in slot 6 of the Cisco uBR7200 series:
interface cable 6/0 cable arp
Related Commands
cable proxy-arp Activates cable proxy ARP on the cable interface.
Command
Description
Syntax Description
sid Service identifier (SID) of the cable modem. Valid values are from 1 to 8191. channel User-defined or user-selected. Valid values are from 0 to 6 depending on which cable modem line card is installed in the Cisco uBR7200 series.
Defaults
0
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Moving a cable modem to a new channel can improve performance, increase bandwidth availability, or troubleshoot a cable modem. The SID identifies the particular cable modem you wish to move.
Examples
The following example moves the cable modem identified with SID 50 to channel 4:
interface cable 6/0 cable channel-change 50 4
To modify the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets with a Relay IP address before they are forwarded to the DHCP server, use the cable dhcp-giaddr command in cable interface configuration mode. To set the GIADDR field to its default, use the no form of this command.
cable dhcp-giaddr [policy | primary]
Syntax Description
policy (Optional) Selects the control policy, so the primary address is used for cable modems and the secondary addresses are used for hosts. primary (Optional) Always selects the primary address to be used for giaddr.
Defaults
No control of giaddr from the cable code.
Command Modes
Cable interface configuration
Command History
12.0(4)T This command was introduced.
Release
Modification
Usage Guidelines
This command allows you to configure the cable modem subnet as the primary address and the host subnet as the secondary address.
Examples
The following example sets the primary address to be used always for giaddr.
interface cable 6/0 cable dhcp-giaddr primary
Syntax Description
A Annex A. The downstream is compatible with the European MPEG framing format specified in ITU-TJ.83 Annex A. This option is not supported in Cisco IOS Release 12.1. B Default. The downstream is compatible with the North American MPEG framing format specified in ITU-TJ.83 Annex B.
Defaults
Annex B
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
The MPEG framing format must be compatible with the downstream symbol rate you set. Annex B is the North America standard and Annex A is the European standard. You should review your local standards and specifications for downstream MPEG framing to determine which format you should use.
|
Note The cable modem card downstream ports and the cable modems on the HFC network connected through these ports must be set to the same MPEG framing format. |
 |
Caution In Cisco IOS Release 12.1, only Annex B MPEG framing format is supported. |
Examples
The following example sets the MPEG framing format to Annex A:
interface cable 6/0 cable downstream annex B
To configure the downstream channel ID, use the cable downstream channel-id command in cable interface configuration mode. To set the downstream channel ID to its default value, use the no form of this command.
cable downstream channel-id id
Syntax Description
id Specifies a downstream channel ID. Valid values are from 1 to 255.
Defaults
The unit number of the downstream device.
Command Modes
Cable interface configuration
Command History
12.0(4)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command to make sure each downstream channel has a unique ID when there are multiple Cisco uBR7200 series routers acting as CMTSes at a headend facility.
Cisco IOS assigns the default ID number of each downstream channel in the order in which devices connected to the downstream channels appear to the CMTS. The downstream channel connected to the first device that appears to the CMTS is configured with a default ID of 1, the downstream channel connected to the second device that appears is configured with an ID of 2, and so on. By assigning default values in this manner, a single CMTS guarantees unique channel IDs. However, this scheme does not guarantee unique channel IDs when more than one CMTS exists on a network.
Examples
The following example configures the downstream channel on the cable modem card in slot 6 of a Cisco uBR7200 series router with a channel ID of 44:
interface cable 6/0 cable downstream channel-id 44
The following example restores the downstream channel id configuration to the default configuration:
interface cable 6/0 cable downstream channel-id
Syntax Description
down-freq-hz The known center frequency of the downstream carrier in Hz. The valid range is 54,000,000 to 1,020,000,000 Hz.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
The downstream frequency of your RF output must be set to match the expected input frequency of your upconverter. To do this, you enter the fixed center frequency of the downstream channel for the downstream port. (You can also select a default which does not set a specific fixed value.) The valid range for a fixed center frequency is 54,000,000 to 1,020,000,000 Hz. The center frequency is also used to configure an IF-to-RF upconverter that must be installed in your downstream path.
The digital carrier frequency is specified to be the center of a 6.0 MHz channel. For example, EIA channel 95 spans 90.000 to 96.000 MHz. The center frequency is 93.000 MHz, which is the digital carrier frequency that should be configured as the downstream frequency. The typical range for current CATV headends is 88,000,000 to 860,000,000 Hz.
|
Note This command currently has no effect on external upconverters; it is informational only. |
Examples
The following example sets the downstream center frequency:
interface cable 6/0 cable downstream frequency 96000000
Syntax Description
This command has no arguments or keywords.
Defaults
Downstream carrier enabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Examples
The following example enables the downstream port 0 on the cable modem card installed in slot 6 of a Cisco uBR7200 series:
interface cable 6/0 cable downstream if-output
Syntax Description
8 | 16 | 32 | 64 | 128 Indicates the downstream interleave depth in milliseconds.
Defaults
32
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
This command sets the minimum latency of the system. A higher interleave depth provides more protection from bursts of noise on the HFC network; however, higher depth also increases downstream latency. Table 3 below shows interleave characteristics and their relation to each other.
| I (Number of Taps) | J (Increment) | Burst Protection 64 QAM/256 QAM | Latency 64 QAM/256 QAM |
|---|---|---|---|
8 | 16 | 5.9 milliseconds/4.1 milliseconds | 0.22 ms/0.15 ms |
16 | 8 | 12 milliseconds/8.2 milliseconds | 0.48 ms/0.33 ms |
32 | 4 | 24 milliseconds/16 milliseconds | 0.98 ms/0.68 ms |
64 | 2 | 47 milliseconds/33 milliseconds | 2.0 ms/1.4 ms |
128 | 1 | 95 milliseconds/66 milliseconds | 4.0 ms/2.8 ms |
Examples
The following example configures the downstream interleave depth to 128 milliseconds:
interface cable 6/0 cable downstream interleave-depth 128
Syntax Description
64qam Modulation rate is 6 bits per downstream symbol. 256qam Modulation rate is 8 bits per downstream symbol.
Defaults
64qam
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Downstream modulation defines the speed in symbols per second at which data travels downstream to the subscriber's cable modem. A symbol is the basic unit of modulation. QPSK encodes 2 bits per symbol, 16-QAM encodes 4 bits per symbol, 64-QAM encodes 6 bits per symbol, and 256-QAM encodes 8 bits per symbol.
|
Note Setting a downstream modulation rate of 256-QAM requires approximately a 6 dB higher signal-to-noise ratio (SNR) than 64-QAM at the subscriber's cable modem. If your network is marginal or unreliable at 256-QAM, use the 64-QAM format instead. |
Examples
The following example sets the downstream modulation to 256-QAM:
interface cable 6/0 cable downstream modulation 256qam
To enable DOCSIS rate limiting on downstream traffic, use the cable downstream rate-limit command in cable interface configuration mode. To disable DOCSIS rate limiting on downstream traffic, use the no form of this command.
cable downstream rate-limit [token-bucket [[shaping [granularity msec | max-delay msec]] | weighted-discard] [exp-weight]
Syntax Description
token-bucket (Optional) Specifies the token bucket filter algorithm. shaping (Optional) Enables rate limiting on the downstream port using the token bucket policing algorithm with default traffic shaping parameters. granularity msec (Optional) Specifies traffic shaping granularity in milliseconds. Valid values are 1, 2, 4, 8, or 16 milliseconds. max-delay msec (Optional) Specifies the maximum traffic shaping buffering delay in milliseconds. Valid values are 128, 256, 512, or 1028 milliseconds. weighted-discard (Optional) Specifies the weighted discard algorithm. exp-weight (Optional) Specifies the weight for the exponential moving average of loss rate. Valid values are from 1 to 4.
Defaults
cable downstream rate-limit, which enforces strict DOCSIS-complaint rate limiting.
Command Modes
Cable interface configuration
Command History
11.3(6) NA This command was introduced. 12.0(4)XI The shaping keyword was added.
Release
Modification
Usage Guidelines
When you enter this command without an option, it enables strict DOCSIS-compliant rate limiting, which sets the burst rate to the interface speed.
Examples
The following example applies the token bucket filter algorithm:
interface cable 6/0 cable downstream rate-limit token-bucket
Related Commands
Sets DOCSIS rate limiting for an upstream port on a cable modem card.
Command
Description
To specify the number of days to keep a cable modem in the flap-list table before aging it out of the table, use the cable flap-list aging command in global configuration mode. To disable this feature, use the no form of this command.
cable flap-list aging number-of-days
Syntax Description
number-of-days Specifies how many days of cable modem performance is retained in the flap list. Valid values are from 1 to 60 days.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
Flapping refers to the rapid disconnecting and reconnecting of a cable modem that is having problems holding its connection to the CMTS. A flap list is a table maintained by the Cisco uBR7200 series for every modem (active or not) that is having communication difficulties. The flap list contains modem MAC addresses and logs the time of the most recent activity. You can configure the size and entry thresholds for the flap list.
Examples
The following example specifies that the flap-list table retain two days of performance for this cable modem:
cable flap-list aging 2
Related Commands
Sets the insertion time interval that determines whether a cable modem is placed in the flap list. Specifies the power-adjust threshold for recording a cable modem flap-list event. Specifies the maximum number of cable modems reported in the flap-list table. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To set the cable flap-list insertion time interval, use the cable flap-list insertion-time command in global configuration mode. To disable insertion time, use the no form of this command.
cable flap-list insertion-time seconds
Syntax Description
seconds Insertion time interval in seconds. Valid values are from 60 to 86400 seconds.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
This command controls the operation of a flapping modem detector. When a cable modem makes insertion requests more frequently than the period of time defined by this command, the cable modem is placed in the flap list.
Examples
The following example sets the insertion time interval to 62 seconds:
cable flap-list insertion-time 62
Related Commands
cable flap-list aging Specifies the number of days a cable modem remains in the flap-list table before being aged out of the table. Specifies the power-adjust threshold for recording a cable modem flap-list event. Specifies the maximum number of cable modems reported in the flap-list table. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To specify the power-adjust threshold for recording a flap-list event, use the cable flap-list power-adjust threshold command in global configuration mode. To disable power-adjust thresholds, use the no form of this command.
cable flap-list power-adjust threshold dBmV
Syntax Description
dBmV Specifies the minimum power adjustment in decibels per millivolt that will result in a flap-list event. Valid values are from 1 to 10 dBmV.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
This command controls the operation of a flapping modem detector. When the power adjustment of a cable modem exceeds the configured threshold value, the modem is placed in the flap list.
|
Note A power adjustment threshold of less than 2 dBmV might cause excessive flap list event recording. Cisco recommends setting this threshold value to 3 dBmV or higher. |
Examples
The following example shows the power-adjust threshold being set to 5 dBmV:
cable flap-list power-adjust threshold 5
Related Commands
cable flap-list aging Specifies the number of days a cable modem remains in the flap-list table before being aged out of the table. Sets the insertion time interval that determines whether a cable modem is placed in the flap list. Specifies the maximum number of cable modems reported in the flap-list table. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To specify the maximum number of cable modems that can be listed in the flap-list table, use the cable flap-list size command in global configuration mode. To specify the default flap-list table size, use the no form of this command.
cable flap-list size number
Syntax Description
number Specifies the maximum number of cable modems that will report flap performance to the flap-list table. Valid values are from 1 to 8192.
Defaults
8192
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Examples
The following example limits the flap-list table size to no more than 200 modems:
cable flap-list size 200
Related Commands
cable flap-list aging Specifies the number of days a cable modem remains in the flap-list table before being aged out of the table. Sets the insertion time interval that determines whether a cable modem is placed in the flap list. Specifies the power-adjust threshold for recording a cable modem flap-list event. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To specify a destination IP address for User Datagram Protocol (UDP) broadcast (DHCP) packets, use the cable helper-address command in cable interface configuration mode. To disable this feature, use the no form of this command.
cable helper-address IP-address {cable-modem | host}
Syntax Description
IP-address The IP address of a DHCP server to which UDP broadcast packets will be sent. cable-modem Specifies that only cable modem UDP broadcasts are forwarded. host Specifies that only host UDP broadcasts are forwarded.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
If you specify a secondary IP address, the GIADDR field in the DHCP requests will be sent to the primary address for DHCP requests received from cable modems, and to the secondary IP address for DHCP requests received from hosts.
Examples
The following example forwards UDP broadcasts from cable modems to the DHCP server at 172.23.66.44:
interface cable 6/0 cable helper-address 172.23.66.44 cable-modem
The following example forwards UDP broadcasts from hosts to the DHCP server at 172.23.66.44:
interface cable 6/0 cable helper-address 172.23.66.44 host
Syntax Description
automatic (Optional) Causes the Cisco uBR7200 series MAC scheduler for each upstream cable modem to vary the initial ranging times available to new cable modems joining the network. min (Optional) Minimum time in milliseconds that the Cisco uBR7200 series is allowed to specify in MAP messages as the initial ranging time for cable modems. Valid values are from 25 to 200 milliseconds. Default is 50 milliseconds. max (Optional) Maximum time in milliseconds that the Cisco uBR7200 series is allowed to specify in MAP messages as the initial ranging time for cable modems. Valid values are from 500 to 2000 milliseconds. Default is 2000 milliseconds (2 seconds).
Defaults
Automatic
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
Use this command to specify the minimum and maximum ranging times that will appear in MAP messages sent by the Cisco uBR7200 series. MAP messages define the precise time intervals during which modems can send.
The default insertion interval setting (automatic) configures the Cisco uBR7200 series to automatically vary (between 50 milliseconds and 2 seconds) the initial ranging times available to new cable modems that attempt to join the network.
Use the automatic keyword with this command when you have to bring a large number of modems online quickly (for example, after a major power failure). Override the automatic keyword by specifying an insertion interval.
Examples
The following example specifies automatic insertion intervals that vary from 50 ms to 2000 ms:
interface cable 6/0 cable insertion-interval automatic
The following example specifies automatic insertion intervals that vary from 500 ms to 2000 ms:
interface cable 6/0 cable insertion-interval min 500
The following example specifies automatic insertion intervals that vary from 50 ms to 1000 ms:
interface cable 6/0 cable insertion-interval max 1000
Syntax Description
This command has no arguments or keywords.
Defaults
Enable
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Examples
The following example disables IP multicast echo:
interface cable 6/0 no cable ip-multicast-echo
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Examples
The following example activates IP broadcast echo:
interface cable 6/0 cable ip-broadcast-echo
To specify that IP multicast streams be encrypted, use the cable match address command in cable interface configuration mode. Use the no form of this command if you do not want to use encryption.
cable match address access-list
Syntax Description
access-list Specifies that the IP multicast streams defined by the access list be encrypted. Access lists can be IP access list numbers or an IP access list name. Valid access list numbers are from 100 to 199.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
Configure the access list using the ip access-list command. For information on this command, refer to the Cisco IOS IP and IP Routing Command Reference publication.
Examples
The following example specifies that the multicast stream defined by the access list named reno be encrypted:
interface cable 6/0 cable match address reno
The following example specifies that the multicast stream defined by the access list number 102 be encrypted:
interface cable 6/0 cable match address 102
Related Commands
ip access-list Defines an IP access list by name.
Command
Description
To override the frequency used by a cable modem, use the cable modem change-frequency command in EXEC mode.
cable modem [mac-addr | ip-addr] change-frequency [ds-frequency-hz] [us-channel-id]
Syntax Description
mac-addr | ip-addr (Optional) Specifies either the MAC address or the IP address of the cable modem whose frequency is to be changed. ds-frequency-hz (Optional) Specifies the downstream frequency for the cable modem (in Hertz). us-channel-id (Optional) Specifies the upstream channel ID.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example changes the downstream frequency of the cable modem having IP address 172.172.172.12 to 57 MHz:
interface cable 6/0 cable modem 172.172.172.12 change-freq 57000000
Related Commands
cable modem max-hosts Specifies the maximum number of hosts supported by a specific cable modem.
Command
Description
To specify the maximum number of CPE devices (hosts) that can be supported by a specific cable modem, use the cable modem max-hosts command in cable interface configuration mode. To set the number of hosts to 0, use the no form of this command.
cable modem {mac-addr | ip-addr} max-hosts {n | default}
Syntax Description
mac-addr | ip-addr Specifies either the MAC address or the IP address of the cable modem. max-hosts {n | default} Specifies either the maximum number of hosts supported by the cable modem (from 0 to 255), or specifies the default value of 0.
Defaults
0
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example limits the cable modem having IP address 172.172.172.12 to a maximum of 40 attached CPE devices:
interface cable 6/0 cable modem 172.172.172.12 max-hosts 40
Related Commands
Overrides the frequency used by a cable modem.
Command
Description
To define the cable modulation profile, use the cable modulation-profile command in global configuration mode. To remove the specified modulation profile, use the no form of this command.
cable modulation-profile profile iuc fec-tbytes fec-len burst-len guard-t mod scrambler seed diff pre-len last-cw uw-len
Syntax Description
profile Modulation profile number. iuc Interval usage code. Valid entries are: initial, long, request, short, or station. fec-tbytes The number of bytes that can be corrected per FEC code word. Valid values are from 0 to 10, where 0 means no FEC. fec-len FEC code word length. Valid values are from 16 to 253. burst-len Maximum burst length in minislots. Valid values are from 0 to 255, where 0 means no limit. guard-t Guard time in symbols. The time between successive bursts. mod Modulation. Valid entries are 16qam and qpsk. scrambler Enable or disable scrambler. Valid entries are scrambler and no-scrambler. seed Scrambler seed in hexidecimal format. Valid values are from 0x0000 to 0x7FFF. diff Enable or disable differential encoding. Valid entries are diff and no-diff. pre-len Preamble length in bits. Valid values are from 2 to 128. last-cw Handling of FEC for last code word. Valid entries are fixed for fixed code word length and shortened for shortened last code word. uw-len Upstream unique word length. Enter uw8 for 8-bit unique words or uw16 for 16-bit unique code words.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
You can use the no form of this command to remove all modulation profiles except modulation profile 1. In the case of modulation profile 1, the no form of this command sets all of the parameters in a burst to default values.
|
Caution Changes to modulation profiles causes changes to the physical layer. Because changing physical layer characteristics affects router performance and function, this task should be reserved for expert users. |
Examples
The following example defines the burst parameters for profile 2:
The request burst is defined to have 0 fec-tbytes, 16 KB fec-len, a burst-len of 1, a guard time of 8, a mod value of qpsk, scrambler enabled with a seed value of 152, differential encoding disabled, a preamble length of 64 bits, a fixed code word length, and 8-bit unique words for upstream unique word length. The remaining initial, station, short, and long bursts are defined in similar fashion for profile 2.
cable modulation-profile 2 request 0 16 1 8 qpsk scrambler 152 no-diff 64 fixed uw8 cable modulation-profile 2 initial 5 34 0 48 qpsk scrambler 152 no-diff 128 fixed uw16 cable modulation-profile 2 station 5 34 0 48 qpsk scrambler 152 no-diff 128 fixed uw16 cable modulation-profile 2 short 6 75 6 8 16qam scrambler 152 no-diff 144 fixed uw8 cable modulation-profile 2 long 8 220 0 8 16qam scrambler 152 no-diff 160 fixed uw8
|
Note You have to create all of the bursts (request, initial, station, short and long) for this modulation profile to use the modulation profile command. |
See the show cable modulation-profile command for a description of the output display fields.
Related Commands
Assigns a modulation profile to an interface on a cable router. show cable modulation-profile Displays modulation profile group information.
Command
Description
To enable privacy in the system, use the cable privacy command in cable interface configuration mode. To disable privacy, use the no form of this command.
cable privacy [mandatory | authenticate-modem | authorize-multicast]
Syntax Description
mandatory (Optional) Enforce Baseline Privacy for all modems. authenticate-modem (Optional) Use AAA protocols to authenticate all modems during BPI initialization. authorize-multicast (Optional) Use AAA protocols to authorize all multicast stream (IGMP) join requests.
Defaults
Mandatory
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
While the default for this command is to enable privacy, it is not mandatory.
Examples
The following examples all begin in cable interface configuration mode. The first example displays the options available with the cable privacy command:
cable privacy ? authenticate-modem turn on BPI modem authentication authorize-multicast turn on BPI multicast authorization kek KEK Key Parms mandatory force privacy be mandatory tek TEK Key Parms
The following example forces Baseline Privacy to be used for all cable modems:
cable privacy mandatory
The following example turns on BPI modem authentication:
cable privacy authenticate-modem
The following example turns on BPI multicast authorization:
cable privacy authorize-multicast
Related Commands
ping cable-modem Determines whether a specific cable modem is online.
Command
Description
Syntax Description
grace-time seconds (Optional) Length of key encryption grace-time in seconds. Valid range is 300 to 1800 seconds. life-time seconds (Optional) Length of the key encryption life-time in seconds.Valid range is 86400 to 6048000.
Defaults
grace-time: 600 seconds
life-time: 604800 seconds
Command Modes
Global configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Baseline privacy on an HFC network is configured with key encryption keys (KEKs) and traffic encryption keys (TEKs). The encryption is based on 40-bit or 56-bit data encryption standard (DES) encryption algorithms.
A KEK is assigned to a cable modem based on the cable modem service identifier (SID) and permits the cable modem to connect to the Cisco uBR7200 series when baseline privacy is activated. KEKs can be set to expire based on a grace-time or a life-time value.
The grace-time keyword is used to assign a temporary key to a cable modem to access the network. The life-time keyword is used to assign a more permanent key to a cable modem.
A cable modem that has a grace-time or life-time key assigned by the Cisco uBR7200 series will request a new key before the current one expires.
Examples
The following example sets the KEK privacy grace-time to 800 seconds:
cable privacy kek grace-time 800
The following example sets the KEK privacy life-time to 750000 seconds:
cable privacy kek life-time 750000
Syntax Description
grace-time seconds (Optional) Length of traffic encryption grace-time in seconds. Valid range is 300 to 1800 seconds. Default is 600 seconds. life-time seconds (Optional) Length of the traffic encryption life-time in seconds.Valid range is 1800 to 6048000. Default is 43200 seconds.
Defaults
grace-time: 600 seconds
life-time: 43200 seconds
Command Modes
Global configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Baseline privacy on an HFC network is configured with key encryption keys (KEKs) and traffic encryption keys (TEKs). The encryption is based on 40-bit or 56-bit data encryption standard (DES) encryption algorithms.
The TEK is assigned to a cable modem when its kek has been established. The TEK is used to encrypt data traffic between the cable modem and the Cisco uBR7200 series. TEKs can be set to expire based on a grace-time or a life-time value.
The grace-time keyword is used to assign a temporary key to a cable modem to access the network. The life-time keyword is used to assign a more permanent key to a cable modem.
A cable modem that has a grace-time or life-time key assigned by the Cisco uBR7200 series will request a new key before the current one expires.
Examples
The following example sets the traffic encryption key grace-time to 800 seconds:
cable privacy tek grace-time 800
The following example sets the traffic encryption key life-time to 800000 seconds:
cable privacy tek life-time 800000
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Because the downstream and upstream are separate interfaces, cable modems cannot directly perform address resolution with other cable modems on the cable plant. This command allows cable modems to perform address resolution through a proxy.
Examples
The following example activates proxy ARP for host-to-host communications:
interface cable 6/0 cable proxy-arp
To specify permission for updating the quality of service (QoS) table, use the cable qos permission command in global configuration mode. To remove a previously enabled permission, use the no form of this command.
cable qos permission {create-snmp | modems | update-snmp}
Syntax Description
create-snmp Permits creation of QoS table entries by Simple Network Management Protocol (SNMP). modems Permits creation of QoS table entries by modem registration requests. update-snmp Permits dynamic update of QoS table entries by SNMP.
Defaults
Enable by modem and SNMP.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Examples
The following example enables cable modems to request arbitrary QoS parameters:
cable qos permission modems
Related Commands
Overrides the provisioned QoS profile of the cable modem and enforces a specific CMTS-local QoS profile. Configures a QoS profile. show cable qos permission Displays the status of permissions for changing QoS tables for a cable router. show cable qos profile Displays cable router QoS profiles.
Command
Description
To override the provisioned quality of service (QoS) profile of the cable modem and enforce a specific CMTS-local QoS profile, use the cable qos permission enforce command in global configuration mode. To allow cable modems to use the QoS profile they were configured to use, use the no form of this command.
cable qos permission enforce index
Syntax Description
index Specifies the number of the QoS profile to be enforced on all cable modems connecting to the CMTS. Valid values are from 1 to 255.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3(9)NA This command was introduced.
Release
Modification
Usage Guidelines
This command allows CMTS operators to enforce a profile on all connected cable modems to ensure that rate limiting is properly implemented.
If the QoS profile to be enforced does not exist at the CMTS during registration, the CMTS uses the QoS profile configured for the registering cable modem.
Examples
The following example shows how a cable modem with a QoS profile 4 created by the cable modem (cm) is reset to use QoS profile 225 enforced by the cable router (management):
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MAC
address
State Offset Power
Cable6/0/U0 1 online 2848 0.00 4 19.2.20.139 0010.7b6b.7215
CMTS01# show cable qos profile 4
Service Prio Max Guarantee Max Max tx TOS TOS Create B
class upstream upstream downstream burst mask value by priv
bandwidth bandwidth bandwidth enab
4 7 128000 64000 2048000 255 0x0 0x0 cm no
CMTS01(config)# cable qos profile 225 max-upstream 256
CMTS01(config)# cable qos permission enforce 225
CMTS01# clear cable modem all reset
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MACaddress
State Offset Power
Cable6/0/U0 1 offline 2848 0.25 2 19.2.20.139 0010.7b6b.7215
CMTS01# debug cable reg
....
00:15:59: Finished parsing REG Request
00:15:59: Overriding Provisioned QoS Parameters In REG-REQ
....
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MACaddress
State Offset Power
Cable6/0/U0 1 online 2852 0.00 225 19.2.20.139 0010.7b6b.7215
CMTS01# show cable qos profile 225
Service Prio Max Guarantee Max Max tx TOS TOS Create B
class upstream upstream downstream burst mask value by priv
bandwidth bandwidth bandwidth enab
225 0 256000 0 0 0 0x0 0x0 management no
Related Commands
Specifies permission for updating the cable router QoS table. Configures a QoS profile. show cable qos permission Displays the status of permissions for changing QoS tables for a cable router. show cable qos profile Displays cable router QoS profiles.
Command
Description
To configure a QoS profile, use the cable qos profile command in global configuration mode. To either set default values for profile group numbers 1 or 2, or to remove the QoS profile if no specific parameters remain, use the no form of this command.
cable qos profile {groupnum | ip-precedence | guaranteed-upstream | max-burst | max-upstream | max-downstream | priority | tos-overwrite | value}
Syntax Description
groupnum QoS profile group number. Qos profiles 1 and 2 are required by the system; they are preconfigured and can be modified but cannot be removed. QoS profile 1 is used during registration; QoS profile 2 is the default QoS profile. ip-precedence Sets the bits in the ToS byte that enable you to configure individual data rate limits on a per-modem basis. Valid values are from 0 to 7. guaranteed-upstream Guaranteed minimum upstream rate in kilobits per second. Valid values are from 0 to 100000 kbps. Default value is 0 (no reserved rate). max-burst Maximum upstream transmit burst size in minislots that the modem can send for any single transmit burst. Valid values are from 0 to 255 minislots. Default value is 0 (no limit). max-upstream Maximum upstream data rate in kilobits per second that a modem using this QoS profile will receive. Valid values are from 0 to 255 kbps. Default value is 0 (no upstream rate limit). max-downstream Maximum downstream data rate in kilobits per second that a modem using this QoS profile will receive. Valid values are from 0 to 255 kbps. Default value is 0 (no downstream rate limit). priority Relative priority number assigned to upstream traffic by this QoS profile. Valid values are from 0 to 7, with 7 being the highest priority. Default value is 0. tos-overwrite Overwrite the Type of Service (ToS) field in the IP datagrams received on the upstream before forwarding them downstream. This parameter sets the mask bits to a hexadecimal value to help the CMTS identify datagrams for QoS on the backbone. value The value substituted for the ToS value.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced. 12.0(5)T The ip-precedence argument was added and the range for the max-downstream argument was increased.
Release
Modification
Examples
The following example configures QoS profile 4 with a guaranteed upstream rate of 8 kbps, maximum transmission burst of 16 minislots, maximum downstream rate of 128 kbps, with a priority of 4, cable baseline privacy set, and a tos-overwrite mask and value byte (in hex) of 0x2:
cable qos profile 4 guaranteed-upstream 8 cable qos profile 4 max-burst 16 cable qos profile 4 max-downstream 128 cable qos profile 4 priority 4 cable qos profile 4 tos-overwrite 0x2
Related Commands
cable qos permission Specifies permission for updating the cable router QoS table. show cable qos profile Displays cable router QoS profiles.
Command
Description
To enable the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server, use the cable relay-agent-option command in cable interface configuration mode. To disable MAC address insertion, use the no form of this command.
cable relay-agent-optionSyntax Description
This command has no keywords or arguments.
Defaults
no cable relay-agent-option
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
This functionality enables a DHCP server to identify the user (cable modem) sending the request and initiate appropriate action based on this information.
Examples
The following example enables the insertion of DHCP relay agent information into DHCP packets:
interface cable 6/0 cable relay-agent-option
To configure authentication and data privacy parameters, use the cable shared-secret command in cable interface configuration mode. To disable authentication during the cable modem registration phase, use the no form of this command.
cable shared-secret [0 | 7] authentication-key
Syntax Description
0 (Optional) Specifies that an unencrypted message will follow. 7 (Optional) Specifies that an encrypted message will follow. authentication-key Text string is a shared secret string. When you enable the service password-encryption option, the password is stored in encrypted form. The text string is a 64-character authentication key.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Use this command to activate authentication so that all cable modems must return a known text string to register with the Cisco uBR7200 series for access to the HFC network.
Examples
The following example activates cable modem authentication using 3344912349988...sf as the shared secret key and indicating that an encrypted message follows:
interface cable 6/0 cable shared-secret 7 3344912349988cisco@xapowenaspasdpuy230jhm...sf
To turn on cable modem upstream verification, use the cable source-verify command in cable interface configuration mode. To disable verification, use the no form of this command.
cable source-verify [dhcp]
Syntax Description
dhcp (Optional) Specifies that queries will be sent to verify unknown source IP addresses in upstream data packets.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced. 12.0(7)T The dhcp keyword was added.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series sends DHCP LEASEQUERIES to verify unknown source IP addresses in upstream data packets. For maximum protection, turn on the DHCP relay-agent information option on the Cisco uBR7200 series when using this feature.
Examples
The following example turns on cable modem upstream verification and configures the Cisco uBR7200 series to send DHCP LEASEQUERIES to verify unknown source IP addresses in upstream data packets:
interface cable 6/0 cable source-verify dhcp
Related Commands
Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forwards the packet to a DHCP server.
Command
Description
Syntax Description
group-number Spectrum group number. Valid range is from 1 to 32. blind Creates a spectrum group that enables the upstream frequency and input power level to change whenever noise impairs upstream data traffic. scheduled daily Creates a spectrum group that enables the upstream frequency and power level to change at a set time during the day. scheduled periodic-sec Creates a spectrum group that enables the upstream frequency and power level to change at a specified interval in seconds. seconds Rate in seconds when upstream frequency and power level change.
Defaults
No spectrum group is defined.
Command Modes
Global configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Upstream traffic may be affected by noise or other cable plant impairments. The spectrum manager monitors the upstream traffic. If station maintenance messages from cable modems are not received for approximately 2.5 minutes, the spectrum manager reassigns a different upstream frequency to the upstream channel.
Frequency agility is configured and activated using spectrum groups. A spectrum group is a table of frequencies that can be used by upstream ports to implement a frequency-hopping policy. There are two types of policies, blind and scheduled, with two corresponding types of spectrum groups.
|
Note The cable interface will not operate until you either create and configure a spectrum group or set a fixed upstream frequency. From the interface configuration prompt, an interface is assigned membership in a spectrum group. From the interface point of view, the spectrum group also represents the set of upstreams connected to the same group of fiber nodes. This allows the spectrum manager to know if the upstream spectrum is shared. |
A maximum of 32 spectrum groups can be configured in the system.
Examples
The following example creates three types of spectrum groups and sets the periodic rate to 48000 seconds:
cable spectrum-group 1 blind cable spectrum-group 2 type scheduled daily cable spectrum-group 3 type scheduled periodic-sec 48000
Related Commands
Configures a continuous frequency band setting for a cable spectrum group. Configures a spectrum group to use a center frequency.
Command
Description
To configure a continuous frequency band setting for a spectrum group, use the cable spectrum-group band command in global configuration mode. To delete the band settings for a spectrum group, use the no form of this command.
cable spectrum-group group-number [time day hh:mm:ss] [delete] band start-freq-hz end-freq-hz [power-level-dbmv]
Syntax Description
group-number Spectrum group number. Valid values are from 1 to 32. time day hh:mm:ss (Optional) For scheduled spectrum groups, makes the frequency band setting available on the specified day at the specified time in hours (hh), minutes (mm), and seconds (ss). delete (Optional) Removes the frequency band setting from use at the specified time. start-freq-hz Lower boundary of the frequency band. end-freq-hz Upper boundary of the frequency band. power-level-dbmv (Optional) Nominal input power level in decibels per millivolt (dBmV). Valid values are from -10 to +10 dBmV. Some cable plants might want to change only the input power level and not frequency on a daily time schedule.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3 XA1 This command was introduced.
Release
Modification
Usage Guidelines
This command specifies that a continuous frequency band setting be used as a unit of allocated spectrum within this spectrum group. Cable plants can choose to set up a daily schedule that changes the input power level and not the frequency.
Examples
The following example specifies that all the upstream ports for spectrum-group 4 share the same spectrum from 5000004 Hz to 40000000 Hz with a power level of 5 dBmV on Mondays at noon:
cable spectrum-group 4 time Monday 12:00:00 band 5000004 40000000 5
The following example deletes the frequency band created in the previous example:
cable spectrum-group 4 time Monday 12:00:00 delete band 5000004 40000000 5
Related Commands
Creates a spectrum group of a specified type. Configures a spectrum group to use a center frequency.
Command
Description
Syntax Description
group-number Spectrum group number. Valid range is 1 to 32. Configuring a spectrum group with multiple entries of this type defines a list of frequencies which are available for use as upstream frequencies. time day hh:mm:ss (Optional) For scheduled spectrum groups, specifies the day and time of day that the frequency and input power level should change. Valid entries for the day argument are: Monday: mon Tuesday: tue Wednesday: wed Thursday: thu Friday: fri Saturday: sat Sunday: sun Valid entries for the hh: argument are 00 to 23. Valid entries for the mm: argument are 00 to 59. Valid entries for the ss: argument are 00 to 59. delete (Optional) Removes the frequency setting from use at the specified time. ctr-freq-hz Upstream frequency in Hz. Valid range is 5,000,000 to 42,000,000 Hz. power-level-dbmv (Optional) Nominal input power level. Valid range is -10 to +10 decibels per millivolt (dBmV). Some cable plants might want to change only the input power level and not the frequency on a daily time schedule.
Defaults
Operator must determine a value based on the spectrum allocation plan.
Command Modes
Global configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
After you create a spectrum group, you need to configure a list of upstream frequencies and nominal power levels that each spectrum group can use when an upstream frequency change is necessary. Each spectrum group should have its own list of upstream frequencies. Valid frequencies are 5,000,000 to 42,000,000 Hz; valid power levels are -10 dBmV to 10 dBmV. The power level value should only be entered if you want to change only the power level as part of spectrum management. The standard power level is 0 dBmV.
Examples
The following example creates spectrum group frequencies:
cable spectrum-group 1 frequency 6500000 cable spectrum-group 1 frequency 7000000 cable spectrum-group 2 frequency 750000 -5 cable spectrum-group 3 time 02:00:00 frequency 9000000 cable spectrum-group 3 time 12:00:00 frequency 9500000 -5
Related Commands
Creates a spectrum group of a specified type. Configures a continuous frequency band setting for a cable spectrum group.
Command
Description
To set the minimum frequency-hop interval, use the cable spectrum-group hop period command in global configuration mode. To delete the frequency hop interval for this spectrum group, use the no form of this command.
cable spectrum-group groupnum hop period seconds
Syntax Description
groupnum Spectrum group number. Valid values are from 1 to 32. seconds Specifies the frequency-hop time period in seconds. Valid values are from 1 to 3600 seconds. Default value is 300 seconds.
Defaults
300 seconds
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series router polls each cable modem at a default rate of once every 10 seconds. When ingress noise causes the loss of keepalive messages for a specified period of time, a new frequency is selected from the allocation table and a UCD update is performed.
If the destination channel is expected to be impaired, the minimum period between frequency hops can be reduced to a small value such as 10 seconds. This allows the frequency hop to continue more rapidly until a clear channel is found. If excessive frequency hop is a concern, the minimum period between hops can be increased.
Examples
The following example reduces the minimum frequency-hop interval to 60 seconds:
cable spectrum-group hop period 60
Related Commands
Specifies a hop threshold for a cable spectrum group.
Command
Description
To specify a frequency hop threshold for a spectrum group, use the cable spectrum-group hop threshold command in global configuration mode. To delete the hop threshold for this spectrum group, use the no form of this command.
cable spectrum-group groupnum hop threshold [percent]
Syntax Description
groupnum Spectrum group number. Valid values are from 1 to 32. percent (Optional) Specifies the frequency hop threshold as a percentage of cable modems going offline. Valid range is from 1 to 100 percent.
Defaults
100 percent
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series router polls each cable modem at a default rate of once every 10 seconds. When ingress noise causes loss of keepalive messages from a configurable percentage of all cable modems, resulting in those cable modems going offline, a new frequency is selected from the allocation table and a UCD update is performed.
Use this command to prevent a single failing cable modem from affecting service to other good cable modems.
Examples
The following example sets the threshold that triggers frequency hop to 20 percent of all cable modems for spectrum-group 4:
cable spectrum-group 4 hop threshold 20
Related Commands
cable spectrum-group hop period Sets the minimum frequency-hop interval for a cable spectrum group.
Command
Description
To specify that the upstream ports in a spectrum group share the same upstream frequency, use the cable spectrum-group shared command in global configuration mode. To delete this specification, use the no form of this command.
cable spectrum-group groupnum shared
Syntax Description
groupnum Spectrum group number. Valid values are from 1 to 32.
Defaults
Upstream port frequency the same for all ports in the spectrum group.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
Because this command forces upstream ports to use the same spectrum, do not use this command for overlapping carriers.
Examples
The following example specifies that all the upstream ports for spectrum-group 4 share the same upstream frequency:
cable spectrum-group 4 shared
To enable telephone return support, use the cable telco-return enable command in cable interface configuration mode. To disable telephone return support, use the no form of this command.
cable telco-return enableSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example enables telephone return support:
interface cable 6/0 cable telco-return enable
Related Commands
Specifies the intervals for sending TCD enrollment messages and TSI messages in a cable-routed system.
Command
Description
To specify the intervals for sending Telephony Channel Descriptor (TCD) enrollment messages and transmitting subscriber information (TSI) messages, use the cable telco-return interval command in cable interface configuration mode. To set the time interval to the default, use the no form of this command.
cable telco-return interval seconds
Syntax Description
seconds Specifies the interval in seconds for sending TCD or TSI messages. Valid range is from 2 to 60 seconds. Default value is 2 seconds.
Defaults
2 seconds
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
Downstream traffic must be precluded by TCD messages to enable upstream telco return traffic. TCD messages contain information necessary for the telco return cable modem to access the headend/ISP network access server over the PSTN.
Use this command to specify how often TCD and TSI messages are sent.
Examples
The following example specifies the interval for sending TCD enrollment messages and transmitting subscriber information (TSI) messages as 40 seconds:
interface cable 6/0 cable telco-return interval 40
Related Commands
cable telco-return enable Enables telephone return support in a cable-routed system.
Command
Description
To set the DHCP Authenticate parameter in Telephony Channel Descriptor (TCD) messages to TRUE (1), specifying the DHCP server that must be used, use the cable telco-return spd dhcp-authenticate command in cable interface configuration mode. To set the DHCP Authenticate parameter to the default value and remove the parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number dhcp-authenticate
Syntax Description
number Specifies the service provider descriptor (SPD) number.
Defaults
FALSE (0)---Disable the DHCP Authenticate parameter in TCD messages.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
The DHCP Authenticate parameter, which is an optional parameter, is expressed as a boolean value.
Examples
The following example sets the DHCP Authenticate parameter:
interface cable 6/0 cable telco-return spd 2 dhcp-authenticate
Related Commands
cable telco-return spd dhcp-server Specifies the IP address of the DHCP server parameter in TCD messages in a cable-routed system. cable telco-return spd dial-timer Specifies the Demand Dial Timer TCD parameter for TCD messages in a cable-routed system. cable telco-return spd factory-default Indicates the SPD used by cable modems during the factory default procedure. cable telco-return spd ppp-authenticate Specifies the PPP Authentication parameter in TCD messages in a cable-routed system. cable telco-return spd phonenum Specifies the Telephone Numbers parameter in TCD messages in a cable-routed system. cable telco-return spd threshold Specifies the Connection Attempt Threshold parameter for TCD messages in a cable-routed system.
Command
Description
To specify the IP address of the DHCP Server parameter in TCD messages, use the cable telco-return spd dhcp-server command in cable interface configuration mode. To set the default value and remove the parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number dhcp-server ip address
Syntax Description
spd number Specifies the service provider descriptor (SPD) number. ip address Specifies the IP address of the DHCP server.
Defaults
0
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example specifies the IP address of the DHCP Server parameter in TCD messages:
interface cable 6/0 cable telco-return spd 2 dhcp-server 206.44.207.255
Related Commands
cable telco-return spd dhcp-authenticate Sets the DHCP Authenticate parameter in TCD messages as TRUE (1), which specifies the DHCP server that must be used in a cable-routed system. cable telco-return spd dial-timer Specifies the Demand Dial Timer TCD parameter for TCD messages in a cable-routed system. cable telco-return spd factory-default Indicates the SPD used by cable modems during the factory default procedure. cable telco-return spd ppp-authenticate Specifies the PPP Authentication parameter in TCD messages in a cable-routed system. cable telco-return spd phonenum Specifies the Telephone Numbers parameter in TCD messages in a cable-routed system. cable telco-return spd threshold Specifies the Connection Attempt Threshold parameter for TCD messages in a cable-routed system.
Command
Description
To specify the Demand Dial Timer parameter for TCD messages, use the cable telco-return spd dial-timer command in cable interface configuration mode. To set the default value and remove the dial-timer parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number dial-timer seconds
Syntax Description
number Specifies the service provider descriptor (SPD) number. seconds Specifies the Demand Dial Timer parameter for TCD messages in seconds. Valid range is from 0 to 4294967295 seconds.
Defaults
0 seconds
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example sets the Demand Dial Timer in TCD messages to 7200 seconds (12 minutes):
interface cable 6/0 cable telco-return spd 2 dial-timer 7200
Related Commands
cable telco-return spd dhcp-server Specifies the IP address of the DHCP server parameter in TCD messages in a cable-routed system. cable telco-return spd dhcp-authenticate Sets the DHCP Authenticate parameter in TCD messages as TRUE (1), which specifies the DHCP server that must be used in a cable-routed system. cable telco-return spd factory-default Indicates the SPD used by cable modems during the factory default procedure. cable telco-return spd ppp-authenticate Specifies the PPP Authentication parameter in TCD messages in a cable-routed system. cable telco-return spd phonenum Specifies the Telephone Numbers parameter in TCD messages in a cable-routed system. cable telco-return spd threshold Specifies the Connection Attempt Threshold parameter for TCD messages in a cable-routed system.
Command
Description
To indicate the service provider descriptor (SPD) used by cable modems during the factory default procedure, use the cable telco-return spd factory-default command in cable interface configuration mode. To restore the default, use the no form of this command.
cable telco-return spd number factory-default
Syntax Description
number Specifies the SPD number.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
The SPD specified is the factory default SPD.
Examples
The following example indicates the SPD used by cable modem:
interface cable 6/0 cable telco-return spd 2 factory-default
Related Commands
cable telco-return spd dhcp-authenticate Sets the DHCP Authenticate parameter in TCD messages as TRUE (1), which specifies the DHCP server that must be used in a cable-routed system. cable telco-return spd dhcp-server Specifies the IP address of the DHCP server parameter in TCD messages in a cable-routed system. cable telco-return spd dial-timer Specifies the Demand Dial Timer TCD parameter for TCD messages in a cable-routed system. cable telco-return spd factory-default Indicates the SPD used by cable modems during the factory default procedure. cable telco-return spd ppp-authenticate Specifies the PPP Authentication parameter in TCD messages in a cable-routed system. cable telco-return spd phonenum Specifies the Telephone Numbers parameter in TCD messages in a cable-routed system. cable telco-return spd threshold Specifies the Connection Attempt Threshold parameter for TCD messages in a cable-routed system.
Command
Description
To specify the Manual Dial parameter in TCD messages, use the cable telco-return spd manual-dial command in cable interface configuration mode. To remove the parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number manual-dial
Syntax Description
number Specifies the service provider descriptor (SPD) number.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following command specifies that the Manual Dial parameter be included in TCD messages. In this example, the SPD number is 1.
interface cable 6/0 cable telco-return spd 1 manual-dial
Related Commands
cable telco-return spd username Specifies the Login Username parameter in TCD messages in a cable-routed system. cable telco-return spd password Specifies the Login Password parameter in TCD messages in a cable-routed system. cable telco-return spd radius-realm Specifies the RADIUS Realm SPD parameter in TCD messages in a cable-routed system.
Command
Description
To specify the login password parameter in TCD messages, use the cable telco-return spd password command in cable interface configuration mode. To remove the parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number password string
Syntax Description
number Specifies the service provider descriptor (SPD) number. string Specifies the login password.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following command specifies that the Login Password parameter be included in TCD messages. In this example, the SPD number is 2 and the password is 9JwoKd7.
interface cable 6/0 cable telco-return spd 2 password 9JwoKd7
Related Commands
cable telco-return spd service-provider Specifies the Service Provider Name parameter in TCD messages in a cable-routed system. cable telco-return spd username Specifies the Login Username parameter in TCD messages in a cable-routed system. cable telco-return spd radius-realm Specifies the RADIUS Realm SPD parameter in TCD messages in a cable-routed system.
Command
Description
To specify the Telephone Numbers parameter in TCD messages, use the cable telco-return spd phonenum command in cable interface configuration mode. To delete any or all previously entered telephone numbers, use the no form of this command.
cable telco-return spd number phonenum string
Syntax Description
number Specifies the service provider descriptor (SPD) number. string Specifies the telephone number to be used by the telephone numbers parameter in TCD messages.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
You can repeat this command to enter up to three telephone numbers that are mapped to the telephone numbers parameters in TCD messages. The phone numbers appear as Phone Number 1, Phone Number 2, and Phone Number 3 in the order in which you enter them.
Examples
The following example inserts the telephone number (925) 555-1212 into the TCD messages for SPD 2:
interface cable 6/0 cable telco-return spd 2 phonenum 9255551212
Related Commands
cable telco-return spd dhcp-authenticate Sets the DHCP Authenticate parameter in TCD messages as TRUE (1), which specifies the DHCP server that must be used in a cable-routed system. cable telco-return spd dhcp-server Specifies the IP address of the DHCP server parameter in TCD messages in a cable-routed system. cable telco-return spd dial-timer Specifies the Demand Dial Timer TCD parameter for TCD messages in a cable-routed system. cable telco-return spd factory-default Indicates the SPD used by cable modems during the factory default procedure. cable telco-return spd ppp-authenticate Specifies the PPP Authentication parameter in TCD messages in a cable-routed system. cable telco-return spd threshold Specifies the Connection Attempt Threshold parameter for TCD messages in a cable-routed system.
Command
Description
To specify the PPP Authentication parameter in TCD messages, use the cable telco-return spd ppp-authenticate command in cable interface configuration mode. To remove the parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number ppp-authenticate [both | chap | pap]
Syntax Description
number Specifies the service provider descriptor (SPD) number. both (Optional) Specifies both PAP and CHAP authentication. chap (Optional) Specifies CHAP authentication. pap (Optional) Specifies PAP authentication.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following command specifies that the PPP Authentication parameter be included in TCD messages:
interface cable 6/0 cable telco-return spd 2 ppp-authenticate chap
Related Commands
cable telco-return spd dhcp-authenticate Sets the DHCP Authenticate parameter in TCD messages as TRUE (1), which specifies the DHCP server that must be used in a cable-routed system. cable telco-return spd dhcp-server Specifies the IP address of the DHCP server parameter in TCD messages in a cable-routed system. cable telco-return spd dial-timer Specifies the Demand Dial Timer TCD parameter for TCD messages in a cable-routed system. cable telco-return spd factory-default Indicates the SPD used by cable modems during the factory default procedure. cable telco-return spd phonenum Specifies the Telephone Numbers parameter in TCD messages in a cable-routed system. cable telco-return spd threshold Specifies the Connection Attempt Threshold parameter for TCD messages in a cable-routed system.
Command
Description
To specify the RADIUS Realm parameter in TCD messages, use the cable telco-return spd radius-realm command in cable interface configuration mode. To remove the parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number radius-realm string
Syntax Description
number Specifies the service provider descriptor (SPD) number. string Specifies the RADIUS Realm name.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example activates the RADIUS Realm parameter in TCD messages for SPD 2 and identifies the RADIUS realm named sunol:
interface cable 6/0 cable telco-return spd 2 radius-realm sunol
Related Commands
cable telco-return spd service-provider Specifies the Service Provider Name parameter in TCD messages in a cable-routed system. cable telco-return spd username Specifies the Login Username parameter in TCD messages in a cable-routed system. cable telco-return spd password Specifies the Login Password parameter in TCD messages in a cable-routed system.
Command
Description
To specify the Service Provider Name parameter in TCD messages, use the cable telco-return service-provider command in cable interface configuration mode. To remove the parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number service-provider string
Syntax Description
number Specifies the service provider descriptor (SPD) number. string Specifies the service provider name.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following command specifies that the Service Provider Name parameter be included in TCD messages:
interface cable 6/0 cable telco-return spd 2 service-provider san_jose
Related Commands
cable telco-return spd username Specifies the Login Username parameter in TCD messages in a cable-routed system. cable telco-return spd password Specifies the Login Password parameter in TCD messages in a cable-routed system. cable telco-return spd radius-realm Specifies the RADIUS Realm SPD parameter in TCD messages in a cable-routed system.
Command
Description
To specify the Connection Attempt Threshold parameter for TCD messages, use the cable telco-return spd threshold command for cable interface configuration mode. To set the default threshold number, use the no form of this command.
cable telco-return spd number threshold number
Syntax Description
number Specifies the service provider descriptor (SPD) number. number Specifies the connection attempt threshold. Valid range is from 1 to 255. Default value is 1.
Defaults
1
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following command specifies that the Connection Attempt Threshold parameter be included in TCD messages:
interface cable 6/0 cable telco-return spd 2 threshold 200
Related Commands
cable telco-return spd dhcp-authenticate Sets the DHCP Authenticate parameter in TCD messages as TRUE (1), which specifies the DHCP server that must be used in a cable-routed system. cable telco-return spd dhcp-server Specifies the IP address of the DHCP server parameter in TCD messages in a cable-routed system. cable telco-return spd dial-timer Specifies the Demand Dial Timer TCD parameter for TCD messages in a cable-routed system. cable telco-return spd factory-default Indicates the SPD used by cable modems during the factory default procedure. cable telco-return spd ppp-authenticate Specifies the PPP Authentication parameter in TCD messages in a cable-routed system. cable telco-return spd phonenum Specifies the Telephone Numbers parameter in TCD messages in a cable-routed system.
Command
Description
To specify the Login Username parameter in TCD messages, use the cable telco-return spd username command in cable interface configuration mode. To remove the parameter from subsequent TCD messages, use the no form of this command.
cable telco-return spd number username string
Syntax Description
number Specifies the service provider descriptor (SPD) number. string Specifies the login username.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following command specifies that the Login Username parameter be included in TCD messages. In this example, the login username is sandy and the SPD is 3.
interface cable 6/0 cable telco-return spd 3 username sandy
Related Commands
cable telco-return spd service-provider Specifies the Service Provider Name parameter in TCD messages in a cable-routed system. cable telco-return spd password Specifies the Login Password parameter in TCD messages in a cable-routed system. cable telco-return spd radius-realm Specifies the RADIUS Realm SPD parameter in TCD messages in a cable-routed system.
Command
Description
To enable the integrated time-of-day (ToD) server on the Cisco uBR7200 series, enter the cable time-server command in global configuration mode. To disable the time-of-day server function, use the no form of this command, or enter the command with the disable keyword.
cable time-server [enable | disable]
Syntax Description
enable (Optional) Starts the time-of-day server as a background task. disable (Optional) Stops the time-of-day server.
Defaults
Disabled
Command Modes
Global configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example enables the time-of-day server:
cable time-server enable
To specify the percentage of overbooking that will be allowed on the upstream channel, use the cable upstream admission-control command in cable interface configuration mode. To disable upstream admission control, use the no form of this command.
cable upstream usport admission-control percentage
Syntax Description
usport Specifies the upstream port. percentage Sets the admission control as a percentage of the upstream channel capacity. Valid values are from 10 to 1000 percent.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3(6) NA This command was introduced.
Release
Modification
Examples
The following example limits overbooking on upstream port 4 to 500 percent:
interface cable 6/0 cable upstream 4 admission-control 500
To specify an upstream channel width for an upstream port, use the cable upstream channel-width command in cable interface configuration mode. To set the channel width back to the default setting of 1600000 Hz, use the no form of this command.
cable upstream usport channel-width first-choice-width [last-choice-width]
Syntax Description
usport Specifies the port number. first-choice-width Specifies upstream channel width in hertz (Hz). Valid values are: 200000 (160000 symbols/sec), 400000 (320000 symbols/sec), 800000 (640000 symbols/sec), 1600000 (1280000 symbols/sec), and 3200000 (2560000 symbols/sec). last-choice-width (Optional) The upstream channel width in hertz. The valid values are the same as those for the first-choice-width parameter. Use this parameter with the Cisco MC16S cable modem card to enable symbol rate management algorithms. The symbol rate automatically steps up from the first-choice-width value to the highest value until a stable channel is established.
Defaults
1600000 Hz
Command Modes
Cable interface configuration
Command History
11.3(5)NA This command was introduced. 12.0(4)XI The last-choice-width argument was added.
Release
Modification
Usage Guidelines
The last-choice-width parameter is only supported by the Cisco MC16S cable modem line card. When the MC16S card is installed, the system attempts to increase the channel width from the first-choice-width value to the last-choice-width value one step at a time.
Examples
The following example configures upstream port 2 with a channel width of 200,000 Hz (which is equivalent to a symbol rate of 160 kilosymbols/second):
interface cable 6/0 cable upstream 2 channel-width 200000
The following example configures upstream port 3 to step from a channel width of 1600000 Hz to a channel width of 3200000 Hz in increments of 200000 Hz:
interface cable 6/0 cable upstream 3 channel-width 1600000 3200000
Related Commands
cable upstream fec-strength Overrides the FEC setting specified in the modulation profile for an upstream channel. cable upstream hop algorithm Configures the frequency hop algorithm for the upstream port of a cable router. cable upstream modulation Overrides modulation types specified in the modulation profile for the specified upstream channel.
Command
Description
To specify automatic or fixed start and stop values for data backoff, use the cable upstream data-backoff command in cable interface configuration mode. To use the default data backoff values, use the no form of this command.
cable upstream usport data-backoff {automatic | start end}
Syntax Description
usport Specifies the upstream port number. automatic Specifies automatic data backoff start and stop values. start Binary exponential algorithm. Sets the start value for data backoff. Valid values are from 0 to 15. end Binary exponential algorithm. Sets the end value for data backoff. Valid values are from 0 to 15.
Defaults
0 (start), 4 (end)
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
The DOCSIS-specified method of contention resolution for cable modems wishing to send data or requests on the upstream channel is a truncated binary exponential back-off with the initial back-off window and the maximum back-off window controlled by the CMTS. The Cisco uBR7200 series router specifies back-off window values for both data and initial ranging, and sends these values downstream as part of the Bandwidth Allocation Map (MAP) MAC message. The values are power-of-two values. For example, a value of 4 indicates a window between 0 and 15; a value of 10 indicates a window between 0 and 1023.
Cisco recommends that you use the automatic settings for data backoff.
Examples
The following example sets the automatic data backoff values for port 2:
interface cable 6/0 cable upstream 2 data-backoff automatic
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series uses forward error correction (FEC) to attempt to correct any upstream data that might have been corrupted. To use this feature, you need to activate FEC on the upstream RF carrier. When FEC is activated, the Cisco uBR7200 series commands all cable modems on the network to activate FEC.
Examples
The following example activates upstream forward error correction:
interface cable 6/0 cable upstream 0 fec
Related Commands
cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an upstream port. cable upstream power-level Sets the input power level for the upstream RF carrier in decibels per millivolt (dBmV). cable upstream scrambler Enables the cable upstream scrambler. cable upstream shutdown Disables the upstream port.
Command
Description
To override the forward error correction (FEC) setting specified in the modulation profile for this upstream channel, use the cable upstream fec-strength command in cable interface configuration mode. To restore the default value, use the no form of this command.
cable upstream usport fec-strength t-bytes
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. t-bytes Overrides the FEC strength specified in the modulation profile for this upstream channel. Valid values are from 0 to 10, where:
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example shows how to comfigure the cable upstream fec-strength command:
interface cable 6/0 cable upstream 2 fec-strength 3
Related Commands
cable upstream fec Enables the upstream FEC. cable upstream channel-width Specifies an upstream channel width for a headend cable router. cable upstream hop algorithm Configures the frequency hop algorithm for the upstream port of a cable router. cable upstream modulation Overrides modulation types specified in the modulation profile for the specified upstream channel.
Command
Description
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. up-freq-hz The upstream center frequency is configured to a fixed value. The valid range is from 5,000,000 to 42,000,000 Hz.
Defaults
Upstream center frequency is not configured to a fixed value.
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
The upstream channel frequency of your RF output must be set to comply with the expected input frequency of your Cisco cable modem line card. To configure an upstream channel frequency, you may:
To configure the default upstream frequency (which is no fixed frequency), enter the cable upstream usport frequency command without specifying a center frequency.
Examples
The following example configures the upstream center frequency for port 0 (located in slot 6) to 5700000 Hz:
interface cable 6/0 cable upstream 0 frequency 5700000
Syntax Description
n | Specifies the upstream port number. |
averaging | Specifies that a percentage of frequency adjustment packets is required to change the adjustment method from the regular power adjustment method to the noise power adjustment method. |
% of frequency adjustment | Specifies the percentage of frequency adjustment packets required to switch from the regular power adjustment method to the noise power adjustment method. Valid range is from 10 to 100%. |
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(7)T This command was introduced.
Release
Modification
Examples
The following example illustrates how to change the power adjustment method when the frequency adjustment packet count reaches 50 percent:
cable upstream 0 freq-adj averaging 50
Related Commands
cable upstream power-adjust Controls power adjustment methods on the Cisco uBR7200 series cable routers. show cable flap-list Displays a list of cable modems that have exceeded the threshold number of power adjustments. show cable modem Displays cable modem configuration settings.
Command
Description
To configure the frequency hop algorithm for the upstream port, use the cable upstream hop algorithm command in cable interface configuration mode. To configure the optimum algorithm, use the no form of this command.
cable upstream usport hop algorithm {blind | optimum}
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. blind Selects the blind frequency hop algorithm. optimum Selects the optimum hop algorithm.
Defaults
Optimum
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command is only supported on the Cisco MC16S cable modem card.
Examples
The following example configures the optimum hop algorithm:
interface cable 6/0 cable upstream 3 hop algorithm optimum
Related Commands
cable upstream channel-width Specifies an upstream channel width for a headend cable router. cable upstream fec-strength Overrides the FEC setting specified in the modulation profile for an upstream channel. cable upstream modulation Overrides modulation types specified in the modulation profile for the specified upstream channel.
Command
Description
To specify the minislot size (in ticks) for a specific upstream interface, use the cable upstream minislot-size command in cable interface configuration mode. To set the default minislot size of 8 if this is valid for the current channel width setting, use the no form of this command.
cable upstream usport minislot-size size
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. size Specifies the minislot size in time ticks. Valid minislot sizes are: 2 (32 symbols), 4 (64 symbols), 8 (128 symbols), 16 (256 symbols), 32 (512 symbols), 64 (1024 symbols), and 128 (2048 symbols).
Defaults
8
Command Modes
Cable interface configuration
Command History
11.3(6) NA This command was introduced.
Release
Modification
Usage Guidelines
|
Caution Using values of 64 or 128 for higher symbol rates such as 1280 kilosymbols/second or 2560 kilosymbols/second can cause performance problems. Depending on your current setting's symbol rate, you should select the minislot size (in ticks) that yields a minislot size of 32 or 64 symbols. |
Examples
The following example sets the minislot size on upstream port 4 to 16 (or 256 symbols):
interface cable 6/0 cable upstream 4 minislot-size 16
To override modulation types specified in the modulation profile for the specified upstream channel, use the cable upstream modulation command in cable interface configuration mode. To disable overriding modulation profiles, use the no form of this command.
cable upstream usport modulation first-choice-mod [last-choice-mod]
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. first-choice-mod Overrides the modulation type specified in the modulation profile for this channel. Valid values are qpsk or qam16. last-choice-mod (Optional) Valid values are qpsk or qam16. Make sure this parameter is different from the first-choice-mod setting or it will be ignored. When used, this parameter enables modulation management algorithms.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This feature is only supported on the Cisco MC16S cable modem card.
The Cisco uBR7200 series cable router first attempts to apply the modulation type specified in the first choice parameter. Then the cable router attempts to apply the modulation type specified in the second choice parameter. Whenever possible, the cable router tries to raise the modulation type to qam16.
Examples
The following example shows how to configure the cable upstream modulation command:
interface cable 6/0 cable upstream 3 modulation qpsk qam16
Related Commands
cable upstream modulation-profile Assigns a modulation profile to an interface on a cable router. cable upstream channel-width Specifies an upstream channel width for a headend cable router. cable upstream fec-strength Overrides the FEC setting specified in the modulation profile for an upstream channel. cable upstream hop algorithm Configures the frequency hop algorithm for the upstream port of a cable router.
Command
Description
To assign a modulation profile to an upstream interface, use the cable upstream modulation-profile command in cable interface configuration mode. To assign modulation profile 1 to the interface, use the no form of this command.
cable upstream usport modulation-profile profile
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. profile Assigns the modulation profile to the specified interface.
Defaults
Modulation profile 1
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Examples
The following example assigns modulation profile 8 to upstream port 2:
interface cable 6/0 cable upstream 2 modulation-profile 8
Related Commands
cable modulation-profile Defines the modulation profile for a cable router.
Command
Description
Syntax Description
n | Specifies the upstream port number. |
continue | Specifies the regular power adjustment method (minimum power adjustments). |
noise | Specifies that a percentage of power adjustment packets is required to change the adjustment method from the regular power adjustment method to the noise power adjustment method. |
% of power adjustment | Specifies the percentage of power adjustment packets required to switch from the regular power adjustment method to the noise power adjustment method. Valid range is from 10 to 100%. |
threshold # | Specifies the power adjustment threshold. The threshold range is from 0 to 10dB. |
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(7)T This command was introduced.
Release
Modification
Examples
The following example illustrates how to change the power adjustment method when the percentage of power adjustment packets reaches 50 percent:
cable upstream 0 power-adjust noise 50
Related Commands
cable upstream frequency Configures a fixed frequency of the upstream RF carrier for an upstream port. show cable flap-list Displays a list of cable modems that have exceeded the threshold number of power adjustments. show cable modem Displays cable modem configuration settings.
Command
Description
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. dbmv Decibels per millivolt designating the upstream signal input power level. Valid range is -10 dBmV to 25 dBmV.
Defaults
0 dBmV
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series controls the output power levels of the cable modems to meet the desired upstream input power level. The nominal input power level for the upstream RF carrier is specified in decibels per millivolt (dBmV). The default setting of 0 dBmV is the optimal setting for the upstream power level.
The valid range for the input power level depends on the data rate. At 1.6 MHz, the valid range is -10 dBmV to 25 dBmV. Higher values cause the modems to increase their transmit power, achieving a greater carrier-to-noise ratio (CNR). If your power levels operate at greater than the maximum valid level, you must use an inline attenuator to bring the power level to within the valid range.
|
Caution If you increase the input power level, the cable modems on your HFC network will increase their transmit power level. This might cause an increase in the carrier-to-noise ratio (CNR) on the network. Be careful if you adjust this parameter. You might violate the upstream return laser design parameters. |
You should not adjust your input power level by more than 5 dB in a 30-second interval. If you increase the power level by more than 5 dB within 30 seconds, cable modem service on your network will be disrupted. If you decrease the power level by more than 5 dB within 30 seconds, cable modems on your network will be forced offline.
When you run cable upstream 0 power-level, Cisco recommends that the adjacent channel not have a large variation. The recommended maximum input power variance is 5 to 6 dBmV.
Examples
The following example sets the input power level for upstream port 0 to -5 dBmV:
interface cable 6/0 cable upstream 0 power-level -5
Related Commands
cable upstream fec Enables the upstream FEC. cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an upstream port. cable upstream scrambler Enables the cable upstream scrambler. cable upstream shutdown Disables the upstream port.
Command
Description
To specify automatic or configured initial ranging backoff calculation, use the cable upstream range-backoff command in cable interface configuration mode. To set default values, use the no form of this command.
cable upstream usport range-backoff {automatic | start end}
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. automatic Specifies the fixed data backoff start and end values. start Binary exponential algorithm. Sets the start value for initial ranging backoff. Valid values are from 0 to 15. end Binary exponential algorithm. Sets the end value for initial ranging backoff. Valid values are from 0 to 15.
Defaults
0 (start), 4 (end)
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
The DOCSIS-specified method of contention resolution for cable modems wishing to send data or requests on the upstream channel is a truncated binary exponential back-off with the initial back-off window and the maximum back-off window controlled by the CMTS. The Cisco uBR7200 series router specifies back-off window values for both data and initial ranging, and sends these values downstream as part of the Bandwidth Allocation Map (MAP) MAC message. The values are power-of-two values. For example, a value of 4 indicates a window between 0 and 15; a value of 10 indicates a window between 0 and 1023.
The automatic setting is optimized for up to 250 cable modems per upstream port. Set manual values for data back-off windows only when operating with more than 250 cable modems per upstream port.
Examples
The following example sets the range backoff to automatic for upstream port 2:
interface cable 6/0 cable upstream 2 range-backoff automatic
To set DOCSIS rate limiting for an upstream port on a cable modem card, use the cable upstream rate-limit command in cable interface configuration mode. To disable DOCSIS rate limiting for the upstream port, use the no form of this command.
cable upstream usport rate-limit [token-bucket [shaping]]
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. token-bucket (Optional) Enables rate limiting for the specified upstream cable interface using the token bucket policing algorithm. shaping (Optional) Enables rate limiting for the specified upstream cable interface using the token bucket policing algorithm with traffic shaping.
Defaults
Token bucket algorithm with traffic shaping.
Command Modes
Cable interface configuration
Command History
11.3(6)NA This command was introduced. 11.3(9)NA The shaping keyword was added.
Release
Modification
Usage Guidelines
Upstream rate limiting allows upstream bandwidth requests from rate-exceeding cable modems to be buffered without incurring TCP-related timeouts and retransmits. This enables the Cisco uBR7200 series to enforce the peak upstream rate for each cable modem without degrading overall TCP performance for the subscriber CPEs. Upstream grant shaping is per cable modem (SID).
When the token-bucket algorithm is configured, the Cisco uBR7200 series will automatically drop packets in violation of allowable upstream bandwidth.
Use of the default value (the upstream port's rate limit) enforces strict DOCSIS-compliant rate limiting.
Examples
The following example configures the token bucket filter algorithm with traffic shaping on upstream port 4:
interface cable 6/0 cable upstream 4 rate-limit token-bucket
Related Commands
cable downstream rate-limit Enables DOCSIS rate limiting on downstream traffic.
Command
Description
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
This command causes cable modems to enable their pseudo-random scrambler circuitry to improve the robustness of the upstream receiver on the line card.
The scrambler on the upstream RF carrier enables cable modems on the HFC network to use built-in scrambler circuitry for upstream data transmissions. The scrambler circuitry improves reliability of the upstream receiver on the cable modem card. The upstream scrambler is activated by default and should not be disabled under normal circumstances.
|
Caution Scrambler must be activated for normal operation. Deactivate only for prototype modems that do not support scrambler. |
Examples
The following example activates the upstream scrambler:
interface cable 6/0 cable upstream 0 scrambler#
Related Commands
cable upstream fec Enables the upstream FEC. cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an upstream port. cable upstream power-level Sets the input power level for the upstream RF carrier in decibels per millivolt (dBmV). cable upstream shutdown Disables the upstream port.
Command
Description
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card.
Defaults
Upstream port enabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Examples
The following example disables the upstream port:
interface cable 6/0 cable upstream 0 shutdown
To enable DOCSIS-compliant transparent bridging for a cable access router interface at startup, use the cable-modem compliant bridge command in cable interface configuration command. To disable DOCSIS-compliant bridging for the interface, use the no form of this command.
cable-modem compliant bridgeSyntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
It is normally not necessary to enter this command in data-over-cable bridging applications because DOCSIS-compliant bridging is enabled by default. If you wish to do full transparent bridging rather than DOCSIS-compliant bridging, use the no form of the command, then configure full transparent bridging using CLI commands.
Examples
The following example shows how to enter the cable-modem compliant bridge command for a cable access router interface, starting from global configuration mode:
interface cable-modem 0 cable-modem compliant bridge
Related Commands
Modifies the saved downstream channel setting and upstream power value on a cable access router interface. Enables a faster downstream search algorithm on a cable access router interface. Enables the QPSK modulation scheme in the upstream direction from the cable modem interface to the headend. Allows voice calls to be sent upstream over the cable interface via best effort.
Command
Description
To modify the saved downstream channel setting and upstream power value on a cable access router interface, use the cable-modem downstream saved channel command in cable interface configuration mode. To remove the saved settings, which will be resaved at the next initialization cycle, use the no form of this command.
cable-modem downstream saved channel ds-frequency us-power
Syntax Description
ds-frequency Downstream channel frequency in Hz, which can be from 91000000 to 860000000. us-power Upstream power level in decibels per millivolt (dBmV), which can be from 8 to 61.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
This command is auto-generated by the operation of the cable MAC layer process. The DOCSIS RFI specification requires that cable modems remember the downstream frequency and upstream power of the last successfully ranged session. These parameters are called up as the first downstream frequency and upstream power to use the next time the cable modem is booted. This operation dramatically speeds up the channel search.
Use the no cable-modem downstream saved channel ds-frequency us-power command to remove the saved frequency and power setting from the running configuration, which will be resaved at the next initialization cycle.
Cisco recommends that this command NOT be used by end users of the Cisco uBR924 cable access router.
Examples
The following example shows how to remove the downstream frequency of 91000000 Hz and the upstream power level of 33 dBmV from the running configuration of a cable-modem interface, starting from global configuration mode:
interface cable-modem 0 no cable-modem downstream saved channel 91000000 33
Related Commands
cable max-hosts Enables DOCSIS-compliant transparent bridging for a cable modem interface at startup. Enables a faster downstream search algorithm on a cable access router interface. Enables the QPSK modulation scheme in the upstream direction from the cable modem interface to the headend. Allows voice calls to be sent upstream over the cable interface via best effort.
Command
Description
To enable a faster downstream search algorithm on a cable access router interface, use the cable-modem fast-search command in cable interface configuration mode. To disable the downstream fast-search feature, use the no form of this command.
cable-modem fast-searchSyntax Description
There are no keywords or arguments for this command.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
This feature speeds up the frequency search performed by the cable access router. Normally it takes the cable access router about 30 to 50 seconds to sample 30 to 50 frequencies. The cable-modem fast-search command can reduce this search time. However, there might be some cases where this fast-search algorithm might not perform as well as the default algorithm. Trial and error is the only way to discover how well this feature works for your environment.
Examples
The following example shows how to enter the cable-modem fast-search command, beginning in global configuration mode:
interface cable-modem 0 cable-modem fast-search
Related Commands
cable max-hosts Enables DOCSIS-compliant transparent bridging for a cable modem interface at startup. Modifies the saved downstream channel setting and upstream power value on a cable access router interface. Enables the QPSK modulation scheme in the upstream direction from the cable modem interface to the headend. Allows voice calls to be sent upstream over the cable interface via best effort.
Command
Description
To enable the QPSK modulation scheme in the upstream direction from the cable access router interface to the headend, use the cable-modem upstream preamble qpsk command in cable interface configuration mode. To disable upstream modulation for the interface, use the no form of this command.
cable-modem upstream preamble qpskSyntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Examples
The following example shows how to enter the cable-modem upstream preamble qpsk command for a cable access router interface, beginning in global configuration mode:
interface cable-modem 0 cable-modem upstream preamble qpsk
Related Commands
cable max-hosts Enables DOCSIS-compliant transparent bridging for a cable modem interface at startup. Modifies the saved downstream channel setting and upstream power value on a cable access router interface. Enables a faster downstream search algorithm on a cable access router interface. Allows voice calls to be sent upstream over the cable interface via best effort.
Command
Description
To allow voice calls to be sent upstream over the cable interface via best effort, use the cable-modem voip best-effort command in cable interface configuration mode. To disable best-effort voice calls, use the no form of this command.
cable-modem voip best-effortSyntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
This command allows you to configure the voice traffic on a Cisco uBR924 to allow only calls having a high priority service identifier (SID) to be connected.
If the dynamic configuration of high priority queues for voice traffic fails, or if the far end cannot support the multiple SIDs and multiple classes of service required by high priority traffic, the flag set by this command will be checked. If enabled (the default setting), the call will be allowed to go through. If disabled, the call will fail.
Examples
The following example shows how to disable best-effort voice calls on a Cisco uBR924 cable interface beginning in global configuration mode:
interface cable-modem 0 no cable-modem voip best-effort
Related Commands
cable max-hosts Enables DOCSIS-compliant transparent bridging for a cable modem interface at startup. Modifies the saved downstream channel setting and upstream power value on a cable access router interface. Enables a faster downstream search algorithm on a cable access router interface. Enables the QPSK modulation scheme in the upstream direction from the cable modem interface to the headend.
Command
Description
Syntax Description
application-name Character string that defines the name of the application. location The location of the TCL file in URL format. Valid storage locations are TFTP, FTP, and Flash.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring interactive voice response (IVR) or one of the IVR-related features (such as Debit Card) to define the name of an application and to identify the location of the TCL script associated with this application.
Examples
This example shows how to define the application "prepaid" and the TFTP server location of the associated TCL script:
call application voice prepaid tftp://keyer/debitcard.tcl
Related Commands
call application voice language Defines the language of the audio file for the designated application and passes that information to the application. call application voice load Reload the designated TCL script. call application voice pin-len Defines the number of characters in the personal identification number (PIN) for the application and passes that information to the application. call application voice redirect-number Defines the telephone number to which a call will be redirected---for example, the operator telephone number of the service provider---for the designated application. call application voice retry-count Defines the number of times a caller is permitted to reenter the PIN for a designated application and passes that information to the application. call application voice set-location Defines the location, language, and category of the audio files for the designated application and passes that information to the application. call application voice uid-len Defines the number of characters in the UID for the designated application and passes that information to the application. call application voice warning-time Defines the number of seconds a user is warned before their allowed calling time runs out for the designated application.
Command
Description
Syntax Description
application-name The name of the application to which the language parameters are being passed. number Tag that uniquely identifies an audio file. Valid entries are 0 to 9. language Defines the language of the associated audio file. Valid entries are:
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring IVR (depending on the TCL script being used) or one of the IVR-related features (such as Debit Card) to define the language of the audio file for the specified application and to pass that information to the specified application.
Table 4 lists TCL script names and the corresponding parameters that are required for each TCL scripts.
| TCL Script Name | Description ---Summary | Parameters to Configure |
|---|---|---|
clid_4digits_npw_3_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. The length of digits allowed for the account number and password are configurable through the command-line interface (CLI). If the authentication fails, it allows the caller to retry. The retry number is also configured through the CLI. |
|
clid_authen_col_npw_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. If the authentication fails, it allows the caller to retry. The retry number is configured through CLI. The account number and PIN are collected separately. |
|
clid_authen_collect_cli.tcl | This script authenticates the account number and PIN using ANI and DNIS. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_col_npw_3_cli.tcl | This script authenticates using ANI and NULL for account and PIN respectively. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. |
|
clid_col_npw_npw_cli.tcl | This script authenticates using ANI and NULL for account and pin respectively. If authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected together. |
|
Examples
The following example shows how to define English and Spanish as the languages of the audio files associated with the application named prepaid:
call application voice prepaid language 1 en call application voice prepaid language 2 sp
Related Commands
call application voice Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application. call application voice load Reload the designated TCL script. call application voice pin-len Defines the number of characters in the PIN for the application and passes that information to the application. call application voice redirect-number Defines the telephone number to which a call will be redirected---for example, the operator telephone number of the service provider---for the designated application. call application voice retry-count Defines the number of times a caller is permitted to reenter the PIN for a designated application and passes that information to the application. call application voice set-location Defines the location, language, and category of the audio files for the designated application and passes that information to the application. call application voice uid-len Defines the number of characters in the UID for the designated application and passes that information to the application. call application voice warning-time Defines the number of seconds a user is warned before their allowed calling time runs out for the designated application.
Command
Description
Syntax Description
name Defines the TCL application to use for the call.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
The software checks the signature lock to ensure it is a Cisco-supported TCL script.
|
Note If the TCL script does not have a valid Cisco-supported signature, the software fails to load the script and generates the following error message:00:02:54: %IVR-3-BAD_IVR_SIG: Script signature is invalid |
Examples
The following example shows how to reload the TCL script called clid_4digits_npw_3.tcl:
call application voice load clid_4digits_npw_3.tcl
Syntax Description
application-name The name of the application to which the PIN length parameter is being passed. number Defines the number of allowable characters in PINs associated with the specified application. Valid entries are 0 to 10.
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring IVR (depending on the TCL script being used) or one of the IVR-related features (such as Debit Card) to define the number of allowable characters in a PIN for the specified application and to pass that information to the specified application.
Table 5 lists TCL script names and the corresponding parameters that are required for each TCL scripts.
| TCL Script Name | Description---Summary | Parameters to Configure |
|---|---|---|
clid_4digits_npw_3_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. The length of digits allowed for the account number and password are configurable through the command-line interface (CLI). If the authentication fails, it allows the caller to retry. The retry number is also configured through the CLI. |
|
clid_authen_col_npw_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_authen_collect_cli.tcl | This script authenticates the account number and PIN using ANI and DNIS. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_col_npw_3_cli.tcl | This script authenticates using ANI and NULL for account and PIN respectively. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. |
|
clid_col_npw_npw_cli.tcl | This script authenticates using ANI and NULL for account and pin respectively. If authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected together. |
|
Examples
The following example shows how to define a PIN length of 4 characters for the application named prepaid:
call application voice prepaid pin-len 4
Related Commands
call application voice Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application. call application voice language Defines the language of the audio file for the designated application and passes that information to the application. call application voice load Reload this designated TCL script. call application voice redirect-number Defines the telephone number to which a call will be redirected---for example, the operator telephone number of the service provider---for the designated application. call application voice retry-count Defines the number of times a caller is permitted to reenter the PIN for a designated application and passes that information to the application. call application voice set-location Defines the location, language, and category of the audio files for the designated application and passes that information to the application. call application voice uid-len Defines the number of characters in the UID for the designated application and passes that information to the application. call application voice warning-time Defines the number of seconds a user is warned before their allowed calling time runs out for the designated application.
Command
Description
Syntax Description
application-name The name of the application to which the redirect telephone number parameter is being passed. number Defines the designated operator telephone number of the service provider (or any other number designated by the customer). This is the number that calls are terminated to when, for example, debit time allowed has run out or the debit amount is exceeded.
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring IVR (depending on the TCL script being used) or one of the IVR-related features (such as Debit Card) to define the telephone number to which a call will be redirected.
Table 6 lists TCL script names and the corresponding parameters that are required for each TCL scripts.
| TCL Script Name | Description ---Summary | Parameters to Configure |
|---|---|---|
clid_4digits_npw_3_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. The length of digits allowed for the account number and password are configurable through the command-line interface (CLI). If the authentication fails, it allows the caller to retry. The retry number is also configured through the CLI. |
|
clid_authen_col_npw_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_authen_collect_cli.tcl | This script authenticates the account number and PIN using ANI and DNIS. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_col_npw_3_cli.tcl | This script authenticates using ANI and NULL for account and PIN respectively. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. |
|
clid_col_npw_npw_cli.tcl | This script authenticates using ANI and NULL for account and pin respectively. If authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected together. |
|
Examples
The following example shows how to define a redirect number for the application named prepaid:
call application voice prepaid redirect-number 5551111
Related Commands
call application voice Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application. call application voice language Defines the language of the audio file for the designated application and passes that information to the application. call application voice load Reload the designated TCL script. call application voice pin-len Defines the number of characters in the PIN for the application and passes that information to the application. call application voice retry-count Defines the number of times a caller is permitted to reenter the PIN for a designated application and passes that information to the application. call application voice set-location Defines the location, language, and category of the audio files for the designated application and passes that information to the application. call application voice uid-len Defines the number of characters in the UID for the designated application and passes that information to the application. call application voice warning-time Defines the number of seconds a user is warned before their allowed calling time runs out for the designated application.
Command
Description
Syntax Description
application-name The name of the application to which the number of possible retries is being passed. number Defines the number of times the caller is permitted to re-enter PIN digits.Valid entries for this parameter are 1 to 5.
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring IVR (depending on the TCL script being used) or one of the IVR-related features (such as Debit Card) to define how many times a user can reenter a PIN.
Table 7 lists TCL script names and the corresponding parameters that are required for each TCL scripts.
| TCL Script Name | Description ---Summary | Parameters to Configure |
|---|---|---|
clid_4digits_npw_3_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. The length of digits allowed for the account number and password are configurable through the command-line interface (CLI). If the authentication fails, it allows the caller to retry. The retry number is also configured through the CLI. |
|
clid_authen_col_npw_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_authen_collect_cli.tcl | This script authenticates the account number and PIN using ANI and DNIS. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_col_npw_3_cli.tcl | This script authenticates using ANI and NULL for account and PIN respectively. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. |
|
clid_col_npw_npw_cli.tcl | This script authenticates using ANI and NULL for account and pin respectively. If authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected together. |
|
Examples
The following example shows how to define that a user can re-enter a PIN 3 times before being disconnected for the application named prepaid:
call application voice prepaid retry-count 3
Related Commands
call application voice Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application. call application voice language Defines the language of the audio file for the designated application and passes that information to the application. call application voice load Reload the designated TCL script. call application voice pin-len Defines the number of characters in the PIN for the application and passes that information to the application. call application voice redirect-number Defines the telephone number to which a call will be redirected---for example, the operator telephone number of the service provider---for the designated application. call application voice set-location Defines the location, language, and category of the audio files for the designated application and passes that information to the application. call application voice uid-len Defines the number of characters in the UID for the designated application and passes that information to the application. call application voice warning-time Defines the number of seconds a user is warned before their allowed calling time runs out for the designated application.
Command
Description
Syntax Description
application-name The name of the application to which the set-location parameters are being passed. language Defines the language associated with the audio files. Possible values for this parameter are: category Defines a particular category group. Audio files can be divided into category groups (from 0 to 4). For example, audio files representing the days and months can be category 1, audio files representing units of currency can be category 2, audio files representing units of time: seconds, minutes, and hours can be category 3. Min = 0, Max = 4 (0 means all). location Defines the location (audio file URL or directory in the TFTP server) where the audio files are stored.
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring IVR (depending on the TCL script being used) or one of the IVR-related features (such as Debit Card) to define the location, language, and category of the audio files for the designated application and pass that information to the application.
Table 8 lists TCL script names and the corresponding parameters that are required for each TCL scripts.
| TCL Script Name | Description ---Summary | Parameters to Configure |
|---|---|---|
clid_4digits_npw_3_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. The length of digits allowed for the account number and password are configurable through the command-line interface (CLI). If the authentication fails, it allows the caller to retry. The retry number is also configured through the CLI. |
|
clid_authen_col_npw_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_authen_collect_cli.tcl | This script authenticates the account number and PIN using ANI and DNIS. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_col_npw_3_cli.tcl | This script authenticates using ANI and NULL for account and PIN respectively. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. |
|
clid_col_npw_npw_cli.tcl | This script authenticates using ANI and NULL for account and pin respectively. If authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected together. |
|
Examples
The following example shows how to configure the call application voice set-location command for the application named prepaid. In this example, the language defined is English, the category into which the audio files are group is Category 0 (meaning all) and the location is the keyer directory on the TFTP server.
call application voice prepaid set-location en 0 tftp://keyer/
Related Commands
call application voice Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application. call application voice language Defines the language of the audio file for the designated application and passes that information to the application. call application voice load Reload this designated TCL script. call application voice pin-len Defines the number of characters in the PIN for the application and passes that information to the application. call application voice redirect-number Defines the telephone number to which a call will be redirected---for example, the operator telephone number of the service provider---for the designated application. call application voice retry-count Defines the number of times a caller is permitted to reenter the PIN for a designated application and passes that information to the application. call application voice uid-len Defines the number of characters in the UID for the designated application and passes that information to the application. call application voice warning-time Defines the number of seconds a user is warned before their allowed calling time runs out for the designated application.
Command
Description
Syntax Description
application-name The name of the application to which the UID length parameter is being passed. number Defines the number of allowable characters in UIDs associated with the specified application. Valid entries are 1 to 20.
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring IVR (depending on the TCL script being used) or one of the IVR-related features (such as Debit Card) to define the number of allowable characters in a UID for the specified application and to pass that information to the specified application.
Table 9 lists TCL script names and the corresponding parameters that are required for each TCL scripts.
| TCL Script Name | Description ---Summary | Parameters to Configure |
|---|---|---|
clid_4digits_npw_3_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. The length of digits allowed for the account number and password are configurable through the command-line interface (CLI). If the authentication fails, it allows the caller to retry. The retry number is also configured through the CLI. |
|
clid_authen_col_npw_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_authen_collect_cli.tcl | This script authenticates the account number and PIN using ANI and DNIS. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_col_npw_3_cli.tcl | This script authenticates using ANI and NULL for account and PIN respectively. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. |
|
clid_col_npw_npw_cli.tcl | This script authenticates using ANI and NULL for account and pin respectively. If authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected together. |
|
Examples
The following example shows how to configure 4 allowable characters in the UID for the application named prepaid:
call application voice prepaid uid-len 4
Related Commands
call application voice Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application. call application voice language Defines the language of the audio file for the designated application and passes that information to the application. call application voice load Reload this designated TCL script. call application voice pin-len Defines the number of characters in the PIN for the application and passes that information to the application. call application voice redirect-number Defines the telephone number to which a call will be redirected---for example, the operator telephone number of the service provider---for the designated application. call application voice retry-count Defines the number of times a caller is permitted to reenter the PIN for a designated application and passes that information to the application. call application voice set-location Defines the location, language, and category of the audio files for the designated application and passes that information to the application. call application voice warning-time Defines the number of seconds a user is warned before their allowed calling time runs out for the designated application.
Command
Description
Syntax Description
application-name The name of the application to which the warning time parameter is being passed. number Defines the number of seconds the user is warned before the allowed calling time runs out. Valid entries are 10 to 600.
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
12.0(7)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command when configuring IVR (depending on the TCL script being used) or one of the IVR-related features (such as Debit Card) to define the number of seconds a user is warned before the allowed calling time runs out for the specified application and to pass that information to the specified application.
Table 10 lists TCL script names and the corresponding parameters that are required for each TCL scripts.
| TCL Script Name | Description ---Summary | Parameters to Configure |
|---|---|---|
clid_4digits_npw_3_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. The length of digits allowed for the account number and password are configurable through the command-line interface (CLI). If the authentication fails, it allows the caller to retry. The retry number is also configured through the CLI. |
|
clid_authen_col_npw_cli.tcl | This script authenticates the account number and PIN respectively using ANI and NULL. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_authen_collect_cli.tcl | This script authenticates the account number and PIN using ANI and DNIS. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected separately. |
|
clid_col_npw_3_cli.tcl | This script authenticates using ANI and NULL for account and PIN respectively. If the authentication fails, it allows the caller to retry. The retry number is configured through the CLI. |
|
clid_col_npw_npw_cli.tcl | This script authenticates using ANI and NULL for account and pin respectively. If authentication fails, it allows the caller to retry. The retry number is configured through the CLI. The account number and PIN are collected together. |
|
Examples
The following example shows how to configure a 30-second warning time for the application named prepaid:
call application voice prepaid warning-time 30
Related Commands
call application voice language Defines the language of the audio file for the designated application and passes that information to the application. call application voice load Reload this designated TCL script. call application voice location Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application. call application voice pin-len Defines the number of characters in the PIN for the application and passes that information to the application. call application voice redirect-number Defines the telephone number to which a call will be redirected---for example, the operator telephone number of the service provider---for the designated application. call application voice retry-count Defines the number of times a caller is permitted to reenter the PIN for a designated application and passes that information to the application. call application voice set-location Defines the location, language, and category of the audio files for the designated application and passes that information to the application. call application voice uid-len Defines the number of characters in the UID for the designated application and passes that information to the application.
Command
Description
Syntax Description
This command has no arguments or keywords.
Defaults
Call waiting is enabled.
Command Modes
Interface configuration
Command History
12.0(3)T This command was introduced.
Release
Modification
Usage Guidelines
This command is applicable for Cisco 800 series routers.
You must specify this command when creating a dial peer. This command will not work if it is not specified within the context of a dial peer. For information on creating a dial peer, refer to the Cisco 800 Series Routers Software Configuration Guide.
Examples
The following example disables call waiting:
no call-waiting
Related Commands
destination-pattern Specifies either the prefix, the full E.164 telephone number, or an ISDN directory number (depending on the dial plan) to be used for a dial peer." dial-peer voice Enters dial-peer configuration mode, defines the type of dial peer, and defines the tag number associated with a dial peer. port (dial-peer) Enables an interface on a PA-4R-DTR port adapter to operate as a concentrator port. ring Sets up a distinctive ring for telephones, fax machines, or modems connected to a Cisco 800 series router. show dial-peer voice Displays configuration information and call statistics for dial peers.
Command
Description
Syntax Description
string A string of digits including wildcards that specifies the telephone number of the voice-port dial peer
Defaults
Disabled
Command Modes
Dial-peer configuration
Command History
12.0(4)T This command was introduced.
Release
Modification
Usage Guidelines
This command applies to the Cisco 2600 series and 3600 series routers only. It is ignored on the Cisco MC3810 and the Cisco 7200 series.
The called-number (dial-peer) command is used only when the dial peer type is VoFR and you are using the frf11-trunk (FRF.11) session protocol; it is ignored at all times on the Cisco MC3810, and on all other platforms when using the cisco-switched session protocol.
Because FRF.11 does not provide any end-to-end messaging to manage a trunk, the called-number (dial-peer) command is necessary to allow the router to establish an incoming trunk connection. The E.164 number is used to find a matching dial peer during call setup.
Examples
The following example shows how to configure a Cisco 2600 series or 3600 series router for a static FRF.11 trunk connection to a specific telephone number (555-2150), beginning in global configuration mode:
voice-port 1/0/0 connection trunk 5558000 exit dial-peer voice 100 pots destination pattern 5552150 exit dial-peer voice 200 vofr session protocol frf11-trunk called-number 5552150 destination pattern 5558000
Related Commands
codec (dial-peer) Specifies the voice coder rate of speech for a Voice over Frame Relay dial peer. connection Specifies a connection mode for a voice port. destination-pattern Specifies either the prefix, the full E.164 telephone number, or an ISDN directory number (depending on the dial plan) to be used for a dial peer. dtmf-relay (Voice over Frame Relay) Enables the generation of FRF.11 Annex A frames for a dial peer. fax-rate Establishes the rate at which a fax will be sent to the specified dial peer. preference Indicates the preferred order of a dial peer within a rotary hunt group. session protocol Establishes a session protocol for calls between the local and remote routers via the packet network. session target Specifies a network-specific address for a specified dial peer or destination gatekeeper. signal-type Sets the signalling type to be used when connecting to a dial peer. vad (dial peer) Enables VAD for the calls using a particular dial peer.
Command
Description
Syntax Description
filename Identifies the codec file stored in VFC Flash memory. slot-number Identifies the slot where the VFC is installed. Valid values are 0, 1, and 2.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
When VCWare is unbundled, it automatically adds DSPWare to Flash memory, creates both the capability and default file lists, and populates these lists with the default files for that version of VCWare. The capability list defines the available voice codecs for H.323 capability negotiation. Use the cap-list vfc command to add the indicated voice codec overlay file (defined by filename) to the capability file list in Flash memory.
Examples
The following example adds the following codec to the list included in Flash memory:
config terminal cap-list cdc-g711-1.0.14.0.bin vfc 0
Related Commands
default-file vfc Specifies an additional (or different) file from the ones in the default file list and stored in VFC Flash memory.
Command
Description
Syntax Description
t1 Specifies T1connectivity of 1.544 Mbps through the telephone-switching network, using AMI or B8ZS coding. e1 Specifies wide-area digital transmission scheme used predominately in Europe. that carries data at a rate of 2.048 Mbps. slot Slot number of the interface. bay (Optional) Card interface bay number in a slot (RSP platform only).
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.0(5)XE and 12.0(7)T This command was introduced.
Examples
The following example configures T1 data transmission on port 1 on the Cisco 7200 series router:
card type t1 1
Posted: Sun Mar 19 14:34:40 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.