-
Cisco IOS Multiservice Applications Command Reference, Release 12.1
-
About the Cisco IOS Software Documentation
-
Using Cisco IOS Software
-
Multiservice Application Commands: A through Ca
-
Multiservice Applications Commands: Cb through D
-
Multiservice Applications Commands: E through P
-
Multiservice Applications Commands: R through Sh
-
Multiservice Applications Commands: Si through Z
-
Table Of Contents
Multiservice Applications Commands:
A through Cacable downstream interleave-depth
cable flap-list insertion-time
cable flap-list power-adjust threshold
cable spectrum-group frequency
cable spectrum-group hop period
cable spectrum-group hop threshold
cable telco-return spd dhcp-authenticate
cable telco-return spd dhcp-server
cable telco-return spd dial-timer
cable telco-return spd factory-default
cable telco-return spd manual-dial
cable telco-return spd password
cable telco-return spd phonenum
cable telco-return spd ppp-authenticate
cable telco-return spd radius-realm
cable telco-return spd service-provider
cable telco-return spd threshold
cable telco-return spd username
cable upstream admission-control
cable upstream freq-adj averaging
cable upstream modulation-profile
cable-modem downstream saved channel
cable-modem upstream preamble qpsk
call application voice language
call application voice pin-len
call application voice redirect-number
call application voice retry-count
call application voice set-location
call application voice uid-len
call application voice warning-time
Multiservice Applications Commands:
A through Ca
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.acc-qos
To generate an SNMP event if the quality of service for a dial peer drops below a specified level, use the acc-qos command in dial-peer configuration mode. To restore the default value, use the no form of this command.
acc-qos {best-effort | controlled-load | guaranteed-delay}
no acc-qos
Syntax Description
Defaults
best-effort
Command Modes
Dial-peer configuration
Command History
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 voipacc-qos guaranteed-delayRelated Commands
req-qos
Specifies the desired quality of service to be used in reaching a specified dial peer in Voice over IP.
alias static
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]
no 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
Defaults
No static aliases exist.
Command Modes
Gatekeeper configuration
Command History
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.comalias static 191.7.8.5 gkid gk.zone1.com terminal e164 14085551212 h323id bobs_terminalalt-dial
To configure an alternate dial-out string for dial peers on the Cisco MC3810, use the alt-dial command in dial-peer configuration mode. To delete the alternate dial-out string, use the no form of this command.
alt-dial string
no alt-dial string
Syntax Description
Defaults
No alternate dial-out string is configured.
Command Modes
Dial-peer configuration
Command History
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,5559871answer-address
To specify the full E.164 telephone number to be used to identify the dial peer of an incoming call, use the answer-address command in dial-peer configuration mode. To disable the configured telephone number, use the no form of this command.
answer-address [+]string[T]
no answer-address
Syntax Description
Defaults
The default value is enabled with a null string.
Command Modes
Dial-peer configuration
Command History
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 potsanswer-address +5559626Related Commands
application
To associate a specific interactive voice response (IVR) application with a POTS dial peer, use the application command in dial-peer configuration mode. To discontinue this association, use the no form of this command.
application name
no application name
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
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 potsapplication c5answer-address 1234destination-pattern 100port 1/0/0Related Commands
arq reject-unknown-prefix
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-prefix
no arq reject-unknown-prefix
Syntax Description
This command has no arguments or keywords.
Defaults
The gatekeeper accepts and processes all incoming ARQs.
Command Modes
Gatekeeper configuration
Command History
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.comzone remote gk415 cisco.com 172.21.139.91zone 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:
•
•
•
atm compression
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}
no atm compression {per-packet | per-interface | per-vc}
Syntax Description
Defaults
per-packet
Command Modes
Interface configuration
Command History
Usage Guidelines
This command applies to ATM configuration on the Cisco MC3810.
Examples
The following example configures per-packet ATM compression:
interface atm0atm compression per-packetatm scramble-enable
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-enable
no atm scramble-enable
Syntax 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.
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 atm0atm scramble-enableatm video aesa
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]
no atm video aesa
Syntax Description
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.
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 atm0atm video aesa defaultOn a Cisco MC3810, the following example shows the ATM interface NSAP address set to a specific ESI value:
interface atm0/1atm video aesa 444444444444Related Commands
audio-prompt load
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 name
Syntax Description
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
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.auauto-cut-through
To enable the Cisco MC3810 to complete a call when a PBX does not provide an M-lead response, use the auto-cut-through command in voice-port configuration mode. To disable the auto-cut-through operation, use the no form of this command.
auto-cut-through
no auto-cut-through
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Voice-port configuration
Command History
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/1auto-cut-throughbusyout forced
To force the voice port into busyout state, use the busyout forced command in voice-port configuration mode. To remove the voice port from busyout state, use the no form of this command.
busyout forced
no busyout forced
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
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 forcedRelated 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.
busyout-monitor interface
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
no busyout-monitor interface interface number
Syntax Description
Defaults
The voice port is not in busyout monitor state.
Command Modes
Voice-port configuration
Command History
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:0busyout monitor interface Ethernet0/0busyout monitor interface Serial1/0busyout monitor interface Serial2/0Related Commands
busyout-seize
To change the busyout seize procedure for a voice port, use the busyout-seize command in voice-port configuration mode. To restore the default busyout seize state on the voice port, use the no form of this command.
busyout-seize {ignore | repeat}
no busyout-seize {ignore | repeat}
Syntax Description
Defaults
On busyout, the loop is closed and remains in the busyout state.
Command Modes
Voice-port configuration
Command History
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 ignoreRelated 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.
cable arp
To activate cable Address Resolution Protocol (ARP), use the cable arp command in cable interface configuration mode. To disable cable ARP, use the no form of this command.
cable arp
no cable arp
Syntax Description
This command has no arguments or keywords.
Defaults
ARP enabled
Command Modes
Cable interface configuration
Command History
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/0cable arpRelated Commands
cable channel-change
To move a cable modem from its current upstream channel to another upstream channel, use the cable channel-change command in cable interface configuration mode. To disable this feature, use the no form of this command.
cable channel-change sid channel
no cable channel-change sid channel
Syntax Description
Defaults
0
Command Modes
Cable interface configuration
Command History
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/0cable channel-change 50 4cable dhcp-giaddr
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]
no cable dhcp-giaddr
Syntax Description
Defaults
No control of giaddr from the cable code.
Command Modes
Cable interface configuration
Command History
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/0cable dhcp-giaddr primarycable downstream annex
To set the MPEG framing format for a downstream port on a cable modem card to either Annex A (Europe) or Annex B (North America), use the cable downstream annex command in cable interface configuration mode.
cable downstream annex {A | B}
Syntax Description
Defaults
Annex B
Command Modes
Cable interface configuration
Command History
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
Caution
Examples
The following example sets the MPEG framing format to Annex A:
interface cable 6/0cable downstream annex Bcable downstream channel-id
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
no cable downstream channel-id
Syntax Description
Defaults
The unit number of the downstream device.
Command Modes
Cable interface configuration
Command History
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/0cable downstream channel-id 44The following example restores the downstream channel id configuration to the default configuration:
interface cable 6/0cable downstream channel-idcable downstream frequency
To set the fixed center frequency for downstream radio frequency carrier in hertz (Hz), use the cable downstream frequency command in cable interface configuration mode. To set no fixed center frequency, use the no form of this command.
cable downstream frequency down-freq-hz
no cable downstream frequency
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
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
Examples
The following example sets the downstream center frequency:
interface cable 6/0cable downstream frequency 96000000cable downstream if-output
To activate a downstream port on a cable modem card for digital data transmissions over the HFC network, use the cable downstream if-output command in cable interface configuration mode. To disable the 44-MHz intermediate frequency (IF) carrier, use the no form of this command.
cable downstream if-output
no cable downstream if-output
Syntax Description
This command has no arguments or keywords.
Defaults
Downstream carrier enabled
Command Modes
Cable interface configuration
Command History
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/0cable downstream if-outputcable downstream interleave-depth
To set the downstream interleave depth, use the cable downstream interleave-depth command in cable interface configuration mode. To restore the default setting, use the no form of this command.
cable downstream interleave-depth {8 | 16 | 32 | 64 | 128}
no cable downstream interleave-depth
Syntax Description
Defaults
32
Command Modes
Cable interface configuration
Command History
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.
Table 3 Interleave Characteristics and Relationships
Examples
The following example configures the downstream interleave depth to 128 milliseconds:
interface cable 6/0cable downstream interleave-depth 128cable downstream modulation
To set the modulation rate for a downstream port on a cable modem card, use the cable downstream modulation command in cable interface configuration mode.
cable downstream modulation {64qam | 256qam}
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
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
Examples
The following example sets the downstream modulation to 256-QAM:
interface cable 6/0cable downstream modulation 256qamcable downstream rate-limit
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]
no cable downstream rate-limit
Syntax Description
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.
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/0cable downstream rate-limit token-bucketRelated Commands
cable flap-list aging
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
no cable flap-list aging
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
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 2Related Commands
cable flap-list insertion-time
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
no cable flap-list insertion-time
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
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 62Related Commands
cable flap-list power-adjust threshold
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
no cable flap-list power-adjust threshold
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
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
Examples
The following example shows the power-adjust threshold being set to 5 dBmV:
cable flap-list power-adjust threshold 5Related Commands
cable flap-list size
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
no cable flap-list size
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
Examples
The following example limits the flap-list table size to no more than 200 modems:
cable flap-list size 200Related Commands
cable helper-address
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}
no cable helper-address IP-address {cable-modem | host}
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
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/0cable helper-address 172.23.66.44 cable-modemThe following example forwards UDP broadcasts from hosts to the DHCP server at 172.23.66.44:
interface cable 6/0cable helper-address 172.23.66.44 hostcable insertion-interval
To limit the amount of time that a cable modem can request an upstream frequency for the first time from the Cisco uBR7200 series, use the cable insertion-interval command in cable interface configuration mode. To configure the automatic setting and ignore any minimum or maximum time settings, use the no form of this command.
cable insertion-interval [automatic] [min | max]
no cable insertion-interval
Syntax Description
Defaults
Automatic
Command Modes
Cable interface configuration
Command History
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/0cable insertion-interval automaticThe following example specifies automatic insertion intervals that vary from 500 ms to 2000 ms:
interface cable 6/0cable insertion-interval min 500The following example specifies automatic insertion intervals that vary from 50 ms to 1000 ms:
interface cable 6/0cable insertion-interval max 1000cable ip-multicast-echo
To enable IP multicast echo, use the cable ip-multicast-echo command in cable interface configuration mode. To disable IP multicast echo, use the no form of this command.
cable ip-multicast-echo
no cable ip-multicast-echo
Syntax Description
This command has no arguments or keywords.
Defaults
Enable
Command Modes
Cable interface configuration
Command History
Examples
The following example disables IP multicast echo:
interface cable 6/0no cable ip-multicast-echocable ip-broadcast-echo
To activate upstream IP broadcast echo so that the Cisco uBR7200 series can echo broadcast packets, use the cable ip-broadcast-echo command in cable interface configuration mode. To disable the upstream IP broadcast echo, use the no form of this command.
cable ip-broadcast-echo
no cable ip-broadcast-echo
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
Examples
The following example activates IP broadcast echo:
interface cable 6/0cable ip-broadcast-echocable match address
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
no cable match address
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
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/0cable match address renoThe following example specifies that the multicast stream defined by the access list number 102 be encrypted:
interface cable 6/0cable match address 102Related Commands
cable modem change-frequency
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
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
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/0cable modem 172.172.172.12 change-freq 57000000Related Commands
cable modem max-hosts
Specifies the maximum number of hosts supported by a specific cable modem.
cable modem max-hosts
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}
no cable modem {mac-addr | ip-addr} max-hosts
Syntax Description
Defaults
0
Command Modes
Cable interface configuration
Command History
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/0cable modem 172.172.172.12 max-hosts 40Related Commands
cable modulation-profile
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
no 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
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
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
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 uw8cable modulation-profile 2 initial 5 34 0 48 qpsk scrambler 152 no-diff 128 fixed uw16cable modulation-profile 2 station 5 34 0 48 qpsk scrambler 152 no-diff 128 fixed uw16cable modulation-profile 2 short 6 75 6 8 16qam scrambler 152 no-diff 144 fixed uw8cable modulation-profile 2 long 8 220 0 8 16qam scrambler 152 no-diff 160 fixed uw8
Note
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.
cable privacy
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]
no cable privacy
Syntax Description
Defaults
Mandatory
Command Modes
Cable interface configuration
Command History
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 authenticationauthorize-multicast turn on BPI multicast authorizationkek KEK Key Parmsmandatory force privacy be mandatorytek TEK Key ParmsThe following example forces Baseline Privacy to be used for all cable modems:
cable privacy mandatoryThe following example turns on BPI modem authentication:
cable privacy authenticate-modemThe following example turns on BPI multicast authorization:
cable privacy authorize-multicastRelated Commands
cable privacy kek
To set key encryption keys (KEKs) grace-time and life-time values for baseline privacy on an HFC network, use the cable privacy kek command in global configuration mode. To restore the default values, use the no form of this command.
cable privacy kek {grace-time [seconds] | life-time [seconds]}
no cable privacy kek {grace-time | life-time}
Syntax Description
Defaults
grace-time: 600 seconds
life-time: 604800 seconds
Command Modes
Global configuration
Command History
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 800The following example sets the KEK privacy life-time to 750000 seconds:
cable privacy kek life-time 750000cable privacy tek
To set traffic encryption keys (TEKs) grace-time and life-time values for baseline privacy on an HFC network, use the cable privacy tek command in global configuration mode. To restore the default value, use the no form of this command.
cable privacy tek {grace-time [seconds] | life-time [seconds]}
no cable privacy {tek grace-time | life-time}
Syntax Description
Defaults
grace-time: 600 seconds
life-time: 43200 seconds
Command Modes
Global configuration
Command History
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 800The following example sets the traffic encryption key life-time to 800000 seconds:
cable privacy tek life-time 800000cable proxy-arp
To activate cable proxy Address Resolution Protocol (ARP) on the cable interface, use the cable proxy-arp command in cable interface configuration mode. To disable this feature, use the no form of this command.
cable proxy-arp
no cable proxy-arp
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
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/0cable proxy-arpcable qos permission
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}
no cable qos permission
Syntax Description
Defaults
Enable by modem and SNMP.
Command Modes
Global configuration
Command History
Examples
The following example enables cable modems to request arbitrary QoS parameters:
cable qos permission modemsRelated Commands
cable qos permission enforce
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
no cable qos permission enforce
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
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 modemInterface SID Online Timing Receive QoS IP address MACaddressState Offset PowerCable6/0/U0 1 online 2848 0.00 4 19.2.20.139 0010.7b6b.7215CMTS01# show cable qos profile 4Service Prio Max Guarantee Max Max tx TOS TOS Create Bclass upstream upstream downstream burst mask value by privbandwidth bandwidth bandwidth enab4 7 128000 64000 2048000 255 0x0 0x0 cm noCMTS01(config)# cable qos profile 225 max-upstream 256CMTS01(config)# cable qos permission enforce 225CMTS01# clear cable modem all resetCMTS01# show cable modemInterface SID Online Timing Receive QoS IP address MACaddressState Offset PowerCable6/0/U0 1 offline 2848 0.25 2 19.2.20.139 0010.7b6b.7215CMTS01# debug cable reg....00:15:59: Finished parsing REG Request00:15:59: Overriding Provisioned QoS Parameters In REG-REQ....CMTS01# show cable modemInterface SID Online Timing Receive QoS IP address MACaddressState Offset PowerCable6/0/U0 1 online 2852 0.00 225 19.2.20.139 0010.7b6b.7215CMTS01# show cable qos profile 225Service Prio Max Guarantee Max Max tx TOS TOS Create Bclass upstream upstream downstream burst mask value by privbandwidth bandwidth bandwidth enab225 0 256000 0 0 0 0x0 0x0 management noRelated Commands
cable qos profile
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}
no cable qos profile {groupnum | ip-precedence | guaranteed-upstream | max-burst | max-downstream | priority | tos-overwrite | value}
Syntax Description
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.
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 8cable qos profile 4 max-burst 16cable qos profile 4 max-downstream 128cable qos profile 4 priority 4cable qos profile 4 tos-overwrite 0x2Related Commands
cable qos permission
Specifies permission for updating the cable router QoS table.
show cable qos profile
Displays cable router QoS profiles.
cable relay-agent-option
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-option
no cable relay-agent-option
Syntax Description
This command has no keywords or arguments.
Defaults
no cable relay-agent-option
Command Modes
Cable interface configuration
Command History
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/0cable relay-agent-optioncable shared-secret
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
no cable shared-secret
Syntax Description
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
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/0cable shared-secret 7 3344912349988cisco@xapowenaspasdpuy230jhm...sfcable source-verify
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]
no 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
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/0cable source-verify dhcpRelated 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.
cable spectrum-group
To create a spectrum group, use the cable spectrum-group command in global configuration mode. To disable this spectrum group, use the no form of this command.
cable spectrum-group group-number type {blind | scheduled | daily periodic-sec seconds}
no cable spectrum-group group-number type {blind | scheduled | daily periodic-sec seconds}
Syntax Description
Defaults
No spectrum group is defined.
Command Modes
Global configuration
Command History
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
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 blindcable spectrum-group 2 type scheduled dailycable spectrum-group 3 type scheduled periodic-sec 48000Related Commands
Configures a continuous frequency band setting for a cable spectrum group.
Configures a spectrum group to use a center frequency.
cable spectrum-group band
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]
no cable spectrum-group group-number
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
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 5The following example deletes the frequency band created in the previous example:
cable spectrum-group 4 time Monday 12:00:00 delete band 5000004 40000000 5Related Commands
Creates a spectrum group of a specified type.
Configures a spectrum group to use a center frequency.
cable spectrum-group frequency
To configure a list of upstream frequencies and nominal power levels that each spectrum group can use when an upstream frequency change is necessary, use the cable spectrum-group frequency command in global configuration mode. To delete a spectrum group list, use the no form of this command.
cable spectrum-group group-number [time day hh:mm:ss] [delete] frequency ctr-freq-hz [power-level-dbmv]
no cable spectrum-group group-number
Syntax Description
Defaults
Operator must determine a value based on the spectrum allocation plan.
Command Modes
Global configuration
Command History
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 6500000cable spectrum-group 1 frequency 7000000cable spectrum-group 2 frequency 750000 -5cable spectrum-group 3 time 02:00:00 frequency 9000000cable spectrum-group 3 time 12:00:00 frequency 9500000 -5Related Commands
Creates a spectrum group of a specified type.
Configures a continuous frequency band setting for a cable spectrum group.
cable spectrum-group hop period
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
no cable spectrum-group groupnum hop period
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
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 60Related Commands
cable spectrum-group hop threshold
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]
no cable spectrum-group groupnum hop threshold
Syntax Description
Defaults
100 percent
Command Modes
Global configuration
Command History
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 20Related Commands
cable spectrum-group hop period
Sets the minimum frequency-hop interval for a cable spectrum group.
cable spectrum-group shared
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
no cable spectrum-group groupnum shared
Syntax Description
Defaults
Upstream port frequency the same for all ports in the spectrum group.
Command Modes
Global configuration
Command History
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 sharedcable telco-return enable
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 enable
no cable telco-return enable
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
Examples
The following example enables telephone return support:
interface cable 6/0cable telco-return enableRelated Commands
Specifies the intervals for sending TCD enrollment messages and TSI messages in a cable-routed system.
cable telco-return interval
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
no cable telco-return interval
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
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/0cable telco-return interval 40Related Commands
cable telco-return enable
Enables telephone return support in a cable-routed system.
cable telco-return spd dhcp-authenticate
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
no cable telco-return spd dhcp-authenticate
Syntax Description
Defaults
FALSE (0)—Disable the DHCP Authenticate parameter in TCD messages.
Command Modes
Cable interface configuration
Command History
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/0cable telco-return spd 2 dhcp-authenticateRelated Commands
cable telco-return spd dhcp-server
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
no cable telco-return spd dhcp-server
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
Examples
The following example specifies the IP address of the DHCP Server parameter in TCD messages:
interface cable 6/0cable telco-return spd 2 dhcp-server 206.44.207.255Related Commands
cable telco-return spd dial-timer
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
no cable telco-return spd dial-timer
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
Examples
The following example sets the Demand Dial Timer in TCD messages to 7200 seconds (12 minutes):
interface cable 6/0cable telco-return spd 2 dial-timer 7200Related Commands
cable telco-return spd factory-default
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
no cable telco-return spd
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
Usage Guidelines
The SPD specified is the factory default SPD.
Examples
The following example indicates the SPD used by cable modem:
interface cable 6/0cable telco-return spd 2 factory-defaultRelated Commands
cable telco-return spd manual-dial
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
no cable telco-return spd number manual-dial
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
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/0cable telco-return spd 1 manual-dialRelated Commands
cable telco-return spd password
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
no cable telco-return spd password
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
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/0cable telco-return spd 2 password 9JwoKd7Related Commands
cable telco-return spd phonenum
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
no cable telco-return spd number phonenum
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
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/0cable telco-return spd 2 phonenum 9255551212Related Commands
cable telco-return spd ppp-authenticate
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]
no cable telco-return spd ppp-authenticate
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
Examples
The following command specifies that the PPP Authentication parameter be included in TCD messages:
interface cable 6/0cable telco-return spd 2 ppp-authenticate chapRelated Commands
cable telco-return spd radius-realm
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
no cable telco-return spd number radius-realm
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
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/0cable telco-return spd 2 radius-realm sunolRelated Commands
cable telco-return spd service-provider
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
no cable telco-return spd number service-provider
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
Examples
The following command specifies that the Service Provider Name parameter be included in TCD messages:
interface cable 6/0cable telco-return spd 2 service-provider san_joseRelated Commands
cable telco-return spd threshold
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
no cable telco-return spd threshold
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
Examples
The following command specifies that the Connection Attempt Threshold parameter be included in TCD messages:
interface cable 6/0cable telco-return spd 2 threshold 200Related Commands
cable telco-return spd username
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
no cable telco-return spd number username
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
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/0cable telco-return spd 3 username sandyRelated Commands
cable time-server
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]
no cable time-server
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
Examples
The following example enables the time-of-day server:
cable time-server enablecable upstream admission-control
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
no cable upstream usport admission-control
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
Examples
The following example limits overbooking on upstream port 4 to 500 percent:
interface cable 6/0cable upstream 4 admission-control 500cable upstream channel-width
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]
no cable upstream usport channel-width
Syntax Description
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.
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/0cable upstream 2 channel-width 200000The 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/0cable upstream 3 channel-width 1600000 3200000Related Commands
cable upstream data-backoff
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}
no cable upstream usport data-backoff
Syntax Description
Defaults
0 (start), 4 (end)
Command Modes
Cable interface configuration
Command History
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/0cable upstream 2 data-backoff automaticcable upstream fec
To enable upstream forward error correction (FEC), use the cable upstream fec command in cable interface configuration mode. To disable FEC, use the no form of this command.
cable upstream usport fec
no cable upstream usport fec
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
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/0cable upstream 0 fecRelated Commands
cable upstream fec-strength
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
no cable upstream usport fec-strength
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
Examples
The following example shows how to comfigure the cable upstream fec-strength command:
interface cable 6/0cable upstream 2 fec-strength 3Related Commands
cable upstream frequency
To enter a fixed frequency of the upstream radio frequency (RF) carrier for an upstream port, use the cable upstream frequency command in cable interface configuration mode. To restore the default value for this command, use the no form of this command.
cable upstream usport frequency up-freq-hz
no cable upstream usport frequency up-freq-hz
Syntax Description
Defaults
Upstream center frequency is not configured to a fixed value.
Command Modes
Cable interface configuration
Command History
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/0cable upstream 0 frequency 5700000cable upstream freq-adj averaging
To control power adjustments on a Cisco uBR7200 series cable router by setting the frequency threshold, use the cable upstream freq-adj averaging interface configuration command. To disable power adjustments, use the no form of this command.
cable upstream n freq-adj averaging % of frequency adjustment
no cable upstream freq-adj averaging
Syntax Description
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
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 50Related Commands
cable upstream hop algorithm
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}
no cable upstream usport hop algorithm
Syntax Description
Defaults
Optimum
Command Modes
Cable interface configuration
Command History
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/0cable upstream 3 hop algorithm optimumRelated Commands
cable upstream minislot-size
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
no cable upstream usport minislot-size
Syntax Description
Defaults
8
Command Modes
Cable interface configuration
Command History
Usage Guidelines
Caution
Examples
The following example sets the minislot size on upstream port 4 to 16 (or 256 symbols):
interface cable 6/0cable upstream 4 minislot-size 16cable upstream modulation
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]
no cable upstream usport modulation
Syntax Description
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
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/0cable upstream 3 modulation qpsk qam16Related Commands
cable upstream modulation-profile
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
no cable upstream usport modulation-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
Examples
The following example assigns modulation profile 8 to upstream port 2:
interface cable 6/0cable upstream 2 modulation-profile 8Related Commands
cable upstream power-adjust
To control power adjustment methods on the Cisco uBR7200 series cable routers, use the cable upstream power-adjust command in interface configuration mode. To disable power adjustments, use the no form of this command.
cable upstream n power-adjust [continue] [noise % of power adjustment] [threshold #]
no cable upstream power-adjust
Syntax Description
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
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 50Related Commands
cable upstream power-level
To set the input power level for the upstream radio frequency (RF) carrier in decibels per millivolt (dBmV), use the cable upstream power-level command in cable interface configuration mode. To restore the default value for this command, use the no form of this command.
cable upstream usport power-level dbmv
no cable upstream usport power-level dbmv
Syntax Description
Defaults
0 dBmV
Command Modes
Cable interface configuration
Command History
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
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/0cable upstream 0 power-level -5Related Commands
cable upstream range-backoff
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}
no cable upstream usport range-backoff
Syntax Description
Defaults
0 (start), 4 (end)
Command Modes
Cable interface configuration
Command History
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/0cable upstream 2 range-backoff automaticcable upstream rate-limit
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]]
no cable upstream usport rate-limit
Syntax Description
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.
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/0cable upstream 4 rate-limit token-bucketRelated Commands
cable upstream scrambler
To enable the cable upstream scrambler, use the cable upstream scrambler command in cable interface configuration mode. To restore the default configuration value for this command, use the no form of this command.
cable upstream usport scrambler
no cable upstream usport scrambler
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
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
Examples
The following example activates the upstream scrambler:
interface cable 6/0cable upstream 0 scrambler#Related Commands
cable upstream shutdown
To disable the upstream port, use the cable upstream shutdown command in cable interface configuration mode. To enable the upstream port, use the no form of this command.
cable upstream usport shutdown
no cable upstream usport shutdown
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
Examples
The following example disables the upstream port:
interface cable 6/0cable upstream 0 shutdowncable-modem compliant bridge
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 bridge
no cable-modem compliant bridge
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
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 0cable-modem compliant bridgeRelated Commands
cable-modem downstream saved channel
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
no 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
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 0no cable-modem downstream saved channel 91000000 33Related Commands
cable-modem fast-search
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-search
no cable-modem fast-search
Syntax Description
There are no keywords or arguments for this command.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
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 0cable-modem fast-searchRelated Commands
cable-modem upstream preamble qpsk
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 qpsk
no cable-modem upstream preamble qpsk
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Interface configuration
Command History
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 0cable-modem upstream preamble qpskRelated Commands
cable-modem voip best-effort
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-effort
no cable-modem voip best-effort
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
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 0no cable-modem voip best-effortRelated Commands
call application voice
To create an application and to indicate the location where the corresponding TCL files that implement this application are located, use the call application voice command in global configuration mode. To remove the defined application and all configured parameters associated with it, use the no form of the command.
call application voice application-name location
no call application voice application-name location
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
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.tclRelated Commands
call application voice language
To define the language of the audio file for the specified application and to pass that information to the specified application, use the call application voice language command in global configuration mode. To remove the associated language of the audio file from the application, use the no form of this command.
call application voice application-name language number language
no call application voice application-name language number language
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
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.
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 encall application voice prepaid language 2 spRelated Commands
call application voice load
To reload the selected TCL script from the URL, use the call application voice load command in privileged EXEC mode.
call application voice load name
Syntax Description
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
The software checks the signature lock to ensure it is a Cisco-supported TCL script.
Note
00:02:54: %IVR-3-BAD_IVR_SIG: Script signature is invalidExamples
The following example shows how to reload the TCL script called clid_4digits_npw_3.tcl:
call application voice load clid_4digits_npw_3.tclcall application voice pin-len
To define the number of characters in the personal identification number (PIN) for the designated application, use the call application voice pin-len command in global configuration mode. To restore default values for this command, use the no form of this command.
call application voice application-name pin-len number
no call application voice application-name pin-len number
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
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.
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 4Related Commands
call application voice redirect-number
To define the telephone number to which a call will be redirected—for example, the operator telephone number of the service provider—for the designated application, use the call application voice redirect-number command in global configuration mode. To cancel this particular parameter, use the no form of this command.
call application voice application-name redirect-number number
no call application voice application-name redirect-number number
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration mode
Command History
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.
Examples
The following example shows how to define a redirect number for the application named prepaid:
call application voice prepaid redirect-number 5551111Related Commands
