Cisco IOS CMTS Cable Command Reference
Cable Commands: show cable m to show cable u

Table Of Contents

Cable Commands: show cable m through show cable u

show cable mac-domain cable forwarding

show cable mac-domain cgd-associations

show cable mac-domain downstream-service-group

show cable mac-domain rcc

show cable mac-domain upstream-service-group

show cable metering-status

show cable modem

show cable modem access-group

show cable modem auth-profile

show cable modem calls

show cable modem classifiers

show cable modem cnr

show cable modem connectivity

show cable modem counters

show cable modem cpe

show cable modem docsis device-class

show cable modem docsis version

show cable modem domain-name

show cable modem errors

show cable modem extended-power

show cable modem flap

show cable modem ipv6

show cable modem mac

show cable modem maintenance

show cable modem offline

show cable modem partial-mode

show cable modem partial-service

show cable modem phy

show cable modem primary-channel

show cable modem primary-channel summary total

show cable modem privacy

show cable modem qos

show cable modem registered

show cable modem remote-query

show cable modem resiliency

show cable modem rf-adapt

show cable modem rogue

show cable modem service-type-id

show cable modem service-flow

show cable modem sysDescr

show cable modem summary

show cable modem summary wb-rf

show cable modem tcs summary

show cable modem type

show cable modem unregistered

show cable modem vendor

show cable modem voice

show cable modem wideband

show cable modem wideband phy

show cable modem wideband primary-channel

show cable modem wideband rcs-status

show cable modulation-profile

show cable multicast authorization

show cable multicast db

show cable multicast debug

show cable multicast dsid

show cable multicast qos

show cable multicast statistics failure

show cable noise

show cable privacy

show cable qos enforce-rule

show cable qos permission

show cable qos profile

show cable rate-adapt

show cable rate-limit-ccf

show cable redundancy

show cable resiliency

show cable rf-adapt

show cable rf-status

show cable rsvp flow-db

show cable service-class

show cable service-voice downstream-type

show cable signal-quality

show cable spectrum-analysis

show cable spectrum-group

show cable subscriber-usage

show cable tech-support

show cable throttle-modem

show cable upstream service-flow summary

show cable urm

show cable us-sg


Cable Commands: show cable m through show cable u


Revised: July 2012, OL-15510-15

New Commands

Command
Cisco IOS Software Release

show cable mac-domain cable forwarding

12.3(23)BC

show cable mac-domain cgd-associations

12.3(23)BC

show cable modem domain-name

12.2(33)SCA

show cable modem ipv6

12.2(33)SCA

show cable modem voice

12.3(23)BC

show cable modem primary-channel

12.3(23)BC

show cable modem type

12.2(33)SCA

show cable modem wideband primary-channel

12.3(23)BC

show cable rate-adapt

12.3(23)BC2

show cable service-voice downstream-type

12.3(23)BC

show cable mac-domain rcc

12.2(33)SCB

show cable rf-status

12.2(33)SCB

show cable rsvp flow-db

12.2(33)SCB

show cable modem auth-profile

12.2(33)SCB

show cable modem service-type-id

12.2(33)SCB

show cable modem summary wb-rf

12.2(33)SCB

show cable modem wideband rcs-status

12.2(33)SCB

show cable multicast authorization

12.2(33)SCB

show cable multicast db

12.2(33)SCB

show cable multicast dsid

12.2(33)SCB

show cable multicast qos

12.2(33)SCB

show cable modem service-flow

12.2(33)SCB1

show cable mac-domain upstream-service-group

12.2(33)SCC

show cable rate-limit-ccf

12.2(33)SCC

show cable signal-quality

12.2(33)SCC

show cable spectrum-analysis

12.2(33)SCC

show cable us-sg

12.2(33)SCC

show cable modem partial-mode

12.2(33)SCD2

show cable multicast debug

12.2(33)SCE

show cable urm

12.2(33)SCE

show cable modem rf-adapt

12.2(33)SCF

show cable multicast statistics failure

12.2(33)SCF

show cable rf-adapt

12.2(33)SCF

show cable modem extended-power

12.2(33)SCF2

show cable throttle-modem

12.2(33)SCF3

show cable modem partial-service

12.2(33)SCG

show cable modem resiliency

12.2(33)SCG

show cable modem tcs summary

12.2(33)SCG

show cable modem wideband phy

12.2(33)SCG

show cable resiliency

12.2(33)SCG

show cable upstream service-flow summary

12.2(33)SCG

show cable modem sysDescr

12.2(33)SCG2


Modified Commands

Command
Cisco IOS Software Release

show cable mac-domain downstream-service-group

12.3(23)BC

show cable modem

12.3(23)BC, 12.2(33)SCA

show cable modem calls

12.2(33)SCA

show cable modem classifiers

12.2(33)SCA

show cable modem cnr

12.2(33)SCA

show cable modem connectivity

12.2(33)SCA

show cable modem counters

12.2(33)SCA

show cable modem cpe

12.2(33)SCA

show cable modem docsis device-class

12.2(33)SCA

show cable modem errors

12.2(33)SCA

show cable modem flap

12.2(33)SCA

show cable modem mac

12.2(33)SCA

show cable modem maintenance

12.2(33)SCA

show cable modem offline

12.2(33)SCA

show cable modem phy

12.2(33)SCA

show cable modem qos

12.2(33)SCA

show cable modem registered

12.2(33)SCA

show cable modem rogue

12.2(33)SCA

show cable modem remote-query

12.3(23)BC

show cable modem phy

12.2(33)SCA

show cable modem

12.2(33)SCB

show cable mac-domain cgd-associations

12.2(33)SCB

show cable mac-domain downstream-service-group

12.2(33)SCB

show cable modem wideband

12.2(33)SCB

show cable modem wideband rcs-status

12.2(33)SCB

show cable qos enforce-rule

12.2(33)SCB

show cable rate-adapt

12.2(33)SCB

show cable modem service-flow

12.3(23)BC7

show cable modem

12.2(33)SCC

show cable modem cnr

12.2(33)SCC

show cable modem flap

12.2(33)SCC

show cable modem phy

12.2(33)SCC

show cable modem qos

12.2(33)SCC

show cable multicast dsid

12.2(33)SCC

show cable service-class

12.2(33)SCC

show cable mac-domain downstream-service-group

12.2(33)SCD

show cable mac-domain cgd-associations

12.2(33)SCD

show cable mac-domain rcc

12.2(33)SCD

show cable modem

12.2(33)SCD

show cable multicast dsid

12.2(33)SCD

show cable modem

12.2(33)SCD2

show cable modem docsis version

12.2(33)SCD2

show cable qos enforce-rule

12.2(33)SCD2

show cable modem service-flow

12.2(33)SCE

show cable multicast db

12.2(33)SCE

show cable multicast qos

12.2(33)SCE

show cable privacy

12.2(33)SCE

show cable mac-domain cable forwarding

12.2(33)SCF

show cable modem

12.2(33)SCF

show cable modem access-group

12.2(33)SCF

show cable modem calls

12.2(33)SCF

show cable modem cnr

12.2(33)SCF

show cable modem connectivity

12.2(33)SCF

show cable modem counters

12.2(33)SCF

show cable modem docsis version

12.2(33)SCF

show cable modem domain-name

12.2(33)SCF

show cable modem errors

12.2(33)SCF

show cable modem flap

12.2(33)SCF

show cable modem ipv6

12.2(33)SCF

show cable modem mac

12.2(33)SCF

show cable modem maintenance

12.2(33)SCF

show cable modem offline

12.2(33)SCF

show cable modem phy

12.2(33)SCF

show cable modem primary channel

12.2(33)SCF

show cable modem qos service-class

12.2(33)SCF

show cable modem registered

12.2(33)SCF

show cable modem rogue

12.2(33)SCF

show cable modem summary

12.2(33)SCF

show cable modem type

12.2(33)SCF

how cable modem unregistered

12.2(33)SCF

show cable modem vendor

12.2(33)SCF

show cable modem wideband

12.2(33)SCF

show cable multicast db

12.2(33)SCF

show cable modem

12.2(33)SCE4

show cable modem service-flow

12.2(33)SCF2

show cable service-class

12.2(33)SCF2

show cable mac-domain cgd-associations

12.2(33)SCG

show cable mac-domain downstream-service-group

12.2(33)SCG

show cable modem qos

12.2(33)SCG

show cable modem wideband

12.2(33)SCG


show cable mac-domain cable forwarding

To display all the interfaces (wideband and modular) and statistics belonging to the Mac domain, use the show cable mac-domain cable forwarding command in privileged EXEC mode.

show cable mac-domain cable slot/subslot/port forwarding

Syntax Description

slot

Specifies the chassis slot number of the cable interface line card. Valid values are 5 to 8.

subslot

Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port

Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).

forwarding

Displays the forwarding statistics for the cable line cards.


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC

This command was introduced.

12.2(33)SCA

This command is integrated in Cisco IOS Release 12.2(33)SCA.


Usage Guidelines

The show cable mac-domain cable forwarding command does not support wideband and modular interfaces. However, if wideband and modular interfaces belong to the Mac domain, the interfaces are listed in the output with the interface state.

Starting with Cisco IOS Release 12.2(33)SCF, for a chassis loaded with the UBR-MC20X20V or uBR-MC3GX60V line cards, and legacy uBR-MC5X20 line cards, the show cable mac-domain cable forwarding command shall not display the legacy downstream information for the UBR-MC20X20V and the uBR-MC3GX60V line cards.

Examples

The following is sample output of the show cable mac-domain cable forwarding command on the cable interface at 8/0/0:

Router# show cable mac-domain cable 8/0/0 forwarding
Interface            Output            Interface     Reserved/    Interface
Name           Packets   Rate          Bandwidth     Reservable   State
               (bytes)   (bits/sec)     (Kbps)       Bandwidth
------------------------------------------------------------------------------
Ca8/0/0         201358            0        26000     6500/19500         UP
Mo1/0/0:0       344340            0         4160     1040/3120          UP
Mo1/0/0:1       252132            0         7800     1950/5850          UP
Mo1/0/0:2       252132            0         7800     1950/5850          UP
Wi1/0/0:0       198916            0         7803     1951/5852          UP
Wi1/0/0:1         1152            0        10404     2601/7803          UP

Table 147 describes the significant fields shown in the display.

Table 77 show cable mac-domain cable forwarding Field Descriptions 

Field
Description

Interface Name

The name of the interface belonging to Mac domain.

Output Packets/Rate

The cumulative packets output and output rate.

Interface Bandwidth

The total interface bandwidth allocated.

Reserved/Reservable Bandwidth

The total reserved and available bandwidth.

Interface State

Indicates whether the interface is up or down.


show cable mac-domain cgd-associations

To display a summary of the Channel Grouping Domain (CGD) associations for all cable MAC domains, use the show cable mac-domain cgd-associations command in privileged EXEC mode.

Cisco uBR10012 Router

show cable mac-domain cable slot/subslot/port cgd-associations

Cisco uBR7225VXR and Cisco uBR7246VXR Routers

show cable mac-domain cable slot/port cgd-associations

Syntax Description

cable slot/subslot/port

Identifies the cable interface on the Cisco uBR10012 router.

slot—Slot where the line card resides. The valid range is from 5 to 8.

subslot—Subslot where the line card resides. Available slots are 0 or 1.

port—Downstream controller number on the line card. Valid port values are from 0 to 4.

cable slot/port

Identifies the cable interface on the Cisco uBR7246VXR or Cisco uBR7225VXR router.

slot—Slot where the line card resides.

Cisco uBR7246VXR router: The valid range is from 3 to 6.

Cisco uBR7225VXR router: The valid range is from 1 to 2.

port—Downstream port number on the line card. The valid port value is 0 or 1.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.

12.2(33)SCB

This command was integrated into Cisco IOS Release 12.2(33)SCB. Added support for Cisco uBR7246VXR and Cisco uBR7225VXR routers.


Usage Guidelines

The show cable mac-domain cgd-associations command displays the following information for each cable MAC domain:

Shared port adapter (SPA) downstream channels that have been added to each MAC domain.

Upstream channels associated with each SPA downstream channel and the downstream channels of the integrated cable interface line card.

If the All column in the command output indicates Y, then this indicates that all upstream channels associated with the line card downstream channels or SPA downstream channels are configured using the upstream cable connector command. If all upstream channels are not configured, then this column will not be displayed.

The SPA downstream channels that are currently active.

A SPA downstream channel is active when the corresponding modular cable interface, which represents the SPA downstream channel, and its line protocol are up. A SPA downstream channel that is considered active is an operational primary downstream channel in the cable MAC domain.


Note For more information on Channel Grouping Domains, refer to the Cisco DOCSIS 3.0 Downstream Solution Design and Implementation Guide, Release 2.0.


Examples

Cisco IOS Release 12.3(23)BC

The following is a sample output of the show cable mac-domain cgd-associations command for the cable interface line card at slot 6, subslot 0, and port 0:

Router# show cable mac-domain cable 6/0/0 cgd-associations
CGD Host  SPA   DS Channels             Upstreams (All)   Active Remote DS
Ca6/0/0         Local                   1            Y
          1/0/0 0-1                     0

Cisco IOS Release 12.2(33)SCB

The following is a sample output of the show cable mac-domain cgd-associations command for the cable interface line card at slot 7, subslot 0, and port 0:

Router# show cable mac-domain Cable7/0/0 cgd-associations
CGD Host  Resource  DS Channels            Upstreams (AllUS)   Active Remote DS
Ca7/0/0   7/0/0     0                      0
          3/1/0     0-2                    0
                                                               0-2

Cisco IOS Release 12.2(33)SCG

The following example is a sample output of the show cable mac-domain cgd-associations command 
for the Cisco uBR-MC3GX60V cable interface line card sharing downstreams with the Cisco 
Wideband SPA, in Cisco IOS Release 12.2(33)SCG:
Router# show cable mac-domain cable 8/0/0 cgd-associations 
CGD Host  Resource  DS Channels            Upstreams (AllUS)   Active Remote DS
Ca8/0/0   1/1/0     0                      0-3                    Yes 

Table 78 describes the fields shown in the show cable mac-domain cgd-associations command display.

Table 78 show cable cgd-associations Field Descriptions  

Field
Description

CGD Host

MAC domain interface for CGD.

Resource

Downstream cable interface line card.

DS Channels

Downstream RF channels.

Upstreams (AllUS)

Upstream channels in the MAC domain.

Active Remote DS

Active downstream channels.


Related Commands

Command
Description

show cable mac-domain downstream-service-group

Displays MAC Domain Downstream Service Group information for the primary downstream channel.


show cable mac-domain downstream-service-group

To display MAC Domain Downstream Service Group information for a primary downstream channel, use the show cable mac-domain downstream-service-group command in privileged EXEC mode.

Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers

show cable mac-domain cable slot/port downstream-service-group

Cisco uBR10012 Universal Broadband Router

show cable mac-domain cable slot/subslot/port downstream-service-group

Syntax Description

slot

Slot where the line card resides.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR7225VXR router—The valid range is from 1 to 2.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

The subslot used for the cable interface line card. Valid values are 0 or 1.

port

The downstream port used as a primary downstream channel. Valid values are from 0 to 4 (depending on the cable interface).


Command Default

No default behavior or values

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.

12.3(23)BC

This command displays the MAC Domain Downstream Service Group information for primary downstream channels from the SPA as well as the Cisco uBR10-MC5X20 line card.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA.

12.2(33)SCD

This command was modified. Support was added for Cisco uBR7225VXR and Cisco uBR7246VXR routers.


Usage Guidelines

Use the show cable mac-domain downstream-service-group command to display MAC Domain Downstream Service Group (MD-DS-SG) information for the specified primary downstream channel.

For each fiber node, a traditional DOCSIS downstream channel on a Cisco uBR10-MC5X20 cable interface line card is used to carry MAC management and signaling messages, and the associated traditional DOCSIS upstream channel is used for return data traffic and signaling. The traditional DOCSIS downstream channel used in this way for a MAC domain is called the primary downstream channel.


Note Beginning in Cisco IOS Release 12.3(23)BC, either an RF channel from the SPA or a Cisco uBR10-MC5X20 downstream channel can serve as a primary channel in a fiber node. Changes in Cisco IOS Release 12.3(23)BC apply to Cisco IOS Release 12.2(33)SCB but do not apply to Cisco IOS Release 12.2(33)SCA.


Examples

The following two examples display show cable mac-domain downstream-service-group output for the primary downstream channel on the cable interface at slot/subslot/port 5/0/0:

Cisco IOS Release 12.3(21)BC

Router# show cable mac-domain cable5/0/0 downstream-service-group 
Primary  MD-DS-SG         RF                                                            
IF       Id        SPA    Chan                                                          
C5/0/0   1         1/0/0  0 - 1

Cisco IOS Release 12.3(23)BC

Router# show cable mac-domain cable5/0/0 downstream-service-group 
Cable    MD-DS-SG         RF       Local         Remote
IF       Id        SPA    Chan     Primary Chan  Primary Chan
C5/0/0   1         1/0/0  00-01    Yes

In the preceding examples, the MD-DS-SG with ID 1 is used for RF channels 0 and 1 on the Wideband SPA located in slot/subslot/bay 1/0/0.

Cisco IOS Release 12.2(33)SCB

The following example shows a sample output of the show cable mac-domain downstream-service-group command for the primary downstream channel on the cable interface at slot/subslot/port 7/0/0:

Router# show cable mac-domain Cable7/0/0 downstream-service-group
Cable    MD-DS-SG              RF
IF       Id        Resource    Chan     Primary Chan
C7/0/0   1         3/1/0       00-02    0 1 2
                   7/0/0       00       0

Cisco IOS Release 12.2(33)SCD

The following example shows a sample output of the show cable mac-domain downstream-service-group command for the primary downstream channel on the cable interface at slot/port 5/0:

Router# show cable mac-domain cable 5/0 downstream-service-group
Cable    MD-DS-SG              RF
IF       Id        Resource    Chan     Primary Chan
C5/0     1         5/0         00-03    0

Cisco IOS Release 12.2(33)SCG

The following example shows a sample output of the show cable mac-domain 
downstream-service-group command for the Cisco uBR-MC3GX60V cable interface line card with 
primary downstream channel hosted on the Cisco Wideband SPA, in Cisco IOS Release 12.2(33)SCG:
Router# show cable mac-domain cable 8/0/0 downstream-service-group 
Cable    MD-DS-SG              RF
IF       Id        Resource    Chan     Primary Chan
C8/0/0   1         1/1/0       00-03    0 
                   1/3/0       00-03    
                   7/0/0       00-03    
                   8/0/2       00-03    

Table 79 describes the fields shown in the show cable mac-domain downstream-service-group command display.

Table 79 show cable mac-domain downstream-service-group Field Descriptions  

Field
Description

Cable IF

Cable interface.

MD-DS-SG

MAC Domain Downstream Service Group.

Resource

Downstream cable interface line card.

RF Chan

Downstream RF channel.

Primary Chan

Primary downstream channel.


Related Commands

Command
Description

show cable modem

Displays information for registered and unregistered cable modems (including wideband cable modems).

show cable modem wideband

Displays information for registered and unregistered wideband cable modems.


show cable mac-domain rcc

To display runtime receive channel configuration (RCC) on a cable line card interface, use the show cable mac-domain rcc command in privileged EXEC mode.

Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers

show cable mac-domain cable slot/port rcc

Cisco uBR10012 Universal Broadband Router

show cable mac-domain cable slot/subslot/port rcc

Syntax Description

slot

Slot where the line card resides.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR7225VXR router—The valid range is from 1 to 2.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port

Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.

12.2(33)SCD

This command was modified. Support was added for Cisco uBR7225VXR and Cisco uBR7246VXR routers.


Examples

The following is a sample output of the show cable mac-domain rcc command on the cable interface at slot/subslot/port 8/0/0:

Router# show cable mac-domain cable 8/0/0 rcc
RCC-ID   RCP                 RCs MD-DS-SG CMs   WB/RCC-TMPL
1        00 00 00 00 00      2   0        0     WB (101)
2        00 10 00 00 03      3   2        0     RCC-TMPL (1)

The following is a sample output of the show cable mac-domain rcc command on the cable interface at slot/port 5/0:

Router# show cable mac-domain cable 5/0 rcc
RCC-ID   RCP                 RCs MD-DS-SG CMs   WB/RCC-TMPL
1        00 00 00 00 00      3   0        3     WB (25)

Table 80 describes the significant fields shown in the display.

Table 80 show cable mac-domain rcc Field Descriptions

Field
Description

RCC-ID

RCC index per MAC domain. The RCC ID refers to the RCC ID output from the show cable modem wideband command.

RCP

The receive channel profile associated with the RCC object.

RCs

Total number of DS channels.

MD-DS-SG

Indicates the MAC domain DS service group for which the RCC is generated.

CM

Total number of CMs associated with the RCC object.

WB/RCC-TMPL

Indicates the wideband interface or the RCC template.



Note A zero value in the RCP or MD-DS-SG field indicates that the RCC is generated directly through a wideband interface configuration and not through any RCC templates.


Related Commands

Command
Description

show interface rf-status

Displays the logical up and down state for each of the configured RF channels for a wideband interface.


show cable mac-domain upstream-service-group

To display runtime statistics of the MAC domain upstream service group on a cable interface line card, use the show cable mac-domain upstream-service-group command in privileged EXEC mode.

show cable mac-domain cable slot/subslot/port upstream-service-group

Syntax Description

slot

Chassis slot number of the cable interface line card. The valid range is from 0 to 8.

subslot

Secondary slot number of the cable interface line card. Valid values are 0 or 1.

port

Port number. The valid range is from 0 to 4 (depending on the cable interface).

upstream-service-group

Specifies the upstream service group number.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCC

This command was introduced.


Usage Guidelines

This command displays privacy information of a particular CM, identified by its IP address or MAC address.

Examples

The following is a sample output of the show cable mac-domain upstream-service-group command on the cable interface line card at slot/subslot/port 7/1/0:

Router# show cable mac-domain cable 7/1/0 upstream-service-group
Cable MD 7/1/0
US-SG-ID  : 1         US-Chan : U0,1,2,3,4
Primary-DS: 5/1/0:0   US-SG-ID: 1
  MDD US-List   : U0,1,2,3
  MDD Ambiguity : U0,1,2,3
Primary-DS: 3/0/0:0   US-SG-ID: 1
  MDD US-List   : U0,1,2,3,4
  MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:1   US-SG-ID: 1
  MDD US-List   : U0,1,2,3,4
  MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:2   US-SG-ID: 1
  MDD US-List   : U0,1,2,3,4
  MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:3   US-SG-ID: 1
  MDD US-List   : U0,1,2,3,4
  MDD Ambiguity : U0,1,2,3,4

Table 81 describes the significant fields shown in the display.

Table 81 show cable mac-domain upstream-service-group Field Descriptions 

Field
Description

US-SG-ID

Upstream service group ID.

US-chan

Total number of upstream channels on the cable interface line card.

Primary-DS

The primary downstream interface.

MDD US-List

MAC management message: MDD TLV type 7 content, upstream active channel list.

MDD Ambiguity

MAC management message: MDD TLV type 8 content, upstream ambiguity resolution channel list.


Related Commands

Command
Description

show interface rf-status

Displays the logical up and down states for each of the configured RF channels on a wideband interface.


show cable metering-status

To display information about the most recent successful usage-based billing operation, use the show cable metering-status command in privileged EXEC mode.

show cable metering-status [verbose]

Syntax Description

verbose

(Optional) Displays the information in a more readable format.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(9a)BC

This command was introduced.

12.2(33)SCB

SAMIS over Internet Protocol Detail Record (IPDR) was introduced.


Usage Guidelines

The show cable metering-status command displays information about the most recent successful usage-based billing operation. If usage-based billing is configured for File mode, this command displays the device and file name for the record that was last written. If usage-based billing is configured for Streaming mode, this command displays the IP address and port number for the external server to which the billing record was sent.


Note This command displays the status of the last successful billing record operation. If a failure occurred, the CMTS sends an SNMP trap to the SNMP manager with that information.


Examples

The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to write the billing records to a local file system:

Router# show cable metering-status 
destination                       complete-time   flow cpe  status
                                                  aggr supp 
disk0:R7519-UBR7246-200308-004428 Jun 12 09:33:05  No    No  success

The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to stream the billing records to an external server:

Router# show cable metering-status 
destination                       complete-time   flow cpe  status
                                                  aggr supp 
10.11.37.2 :1234                  Jun 12 09:33:05  No   No  success

The following example shows a typical output for the verbose form of the show cable metering-status command:

Router# show cable metering-status verbose 
Destination            : disk0:R7519-UBR7246-20000308-004428
Complete Time          : Jun 12 09:33:05
Flow Aggregate         : Yes
Cpe list suppression   : Yes
Status of last export  : success 

The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to use the Internet Protocol Detail Record (IPDR) Exporter to stream the billing records to an external server:

Router# show cable metering-status
destination                       complete-time   flow cpe  status
                                                  aggr supp 
IPDR_Session1								 Jun 12 09:33:05  N/A N/A success

The following example shows a typical output for the verbose form of the show cable metering-status command when usage-based billing is configured to use the IPDR Exporter to stream the billing records to an external server:

Router# show cable metering-status verbose 
Last export status
Destination            : IPDR_Session1
Complete Time          : Jun 12 09:36:05
Status of last export  : success 

The following example shows the error message that is displayed when you enter the show cable metering-status command but not have enabled usage-based billing:

Router# show cable metering-status 
CMTS Metering collection not enabled

The following example shows if the SAMIS report failed, the output displays the details of the failure:

Router# show cable metering-status verbose
Load for five secs: 0%/0%; one minute: 1%; five minutes: 0%
Time source is NTP, .19:24:53.955 PDT Fri Jun 11 2010
Last export status
Destination            : 20.1.0.2:5959
Complete Time          : Jun11 19:24:40
Flow Aggregate         : No
Full records           : Yes
Cpe list suppression   : No
Source interface       : GigabitEthernet0/1
Status of last export  : write-error (bulk-data)

Table 82 describes the fields displayed by the show cable metering-status command.

Table 82 show cable metering-status Field Descriptions 

Field
Description

destination, Destination

Destination for the billing records. This is a file system device name and file name, if records are being written to a local file system, or an IP address and TCP port number, if records are being streamed to an external server.

complete_time, Complete Time

Date and time when the last billing record was written to a local file or streamed to an external server.

flow aggr, Flow Aggregate

Indicates whether traffic counters are aggregated in the billing records, so that one total is recorded for the upstream service flows and downstream service flows for each CM.

cpe suppress, CPE list suppression

Indicates whether CPE IP addresses are included or suppressed in the billing records:

Yes = CPE addresses are suppressed and are not included in the billing records.

No = CPE addresses are included in the billing records.

status, Status of last export

Indicates the status of the last billing operation:

success—The billing records were successfully written to the filesystem (file mode) or transferred to the billing collection server (streaming mode).

connect-failed—The CMTS was able to open the proper socket connection to the server but could not connect to the server.

data-incomplete—A failure occurred during the file write or the streaming to the collection server, and the records that were written might be incomplete.

disk-full—The billing records could not be written because the filesystem does not have sufficient free space.

no-memory—The processor had insufficient memory to collect the billing records.

open-failure—The transfer failed because the CMTS could not open a new file on the filesystem (file mode) or open a socket to the destination IP address and port (streaming mode).

unknown—An unknown error occurred.

write-error (data-type)—The operating system reported an error when attempting to write the billing records (file mode), or the send to the destination socket failed (streaming mode).

The value of data-type could be file-header, file-end, bulk-data, sflog, bulk-data, ipdr-data, ipdr-sflog, or ipdr-file.


Related Commands

Command
Description

cable metering destination

Enables usage-based billing and streams the billing records to an external server.

cable metering filesystem

Enables usage-based billing and writes the billing records to a file on a local file system.

cable metering source-interface

Enables debugging of usage-based billing operations.

snmp-server enable traps cable

Enables the sending of Simple Network Management Protocol (SNMP) traps for cable-related events.


show cable modem

To display information for the registered and unregistered CMs, use the show cable modem command in privileged EXEC mode.

show cable modem [ip-address | mac-address | cable {slot/port | slot/subslot/port} [upstream port [logical-channel-index]] | name fqdn] queue [verbose] [cm-status]

Cisco IOS Release 12.2(33)SCE and later releases

show cable modem [ip-address | mac-address | cable {slot/cable-interface-index | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] [verbose] [cm-status]

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

verbose

Displays detailed information for the CMs.

cm-status

Displays CM status events.

queue

Displays the downstream hierarchical queueing framework (HQF) queue information for a cable modem.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.


Command Modes

Privileged EXEC (#)

Command History

This table includes the following release-specific history entries:

BC Release

C Release

E Release

N Release

SC Release

T Release

X Release

BC Release
Modification

12.2(15)BC1

Additional lines were added to the show cable modem verbose displays, for one or all cable modems, to show information about the dynamic shared-secret feature. Cable modems that fail the dynamic secret authentication checks and then come online are marked with an exclamation point (!), so that this situation can be investigated.

12.2(4)BC1

Support was added for the Cisco uBR10012 router.

12.2(8)BC2

The output for the Online State field was updated for the cable tftp-enforce command. A pound sign (#) appears next to the state value when a CM was allowed to come online without attempting to download a DOCSIS configuration file through the cable interface with the Cisco CMTS.

12.2(15)BC1c

The verbose option displays whether dynamic service change requests (DSX) are allowed from cable modems.

12.2(15)BC2

Two new states—cc(r1) and cc(r2)—have been added to the CM MAC state field (see Table 101) to indicate the CM status when it has been instructed to change channels and is ranging to obtain a new downstream or upstream channel.

Also, three new states—online(pkd), online(ptd), and expire(pkd)—were added to clarify the BPI state when network access has been disabled in the CM's DOCSIS configuration file.

In addition, the show cable modem verbose command now displays the total amount of time that a CM has been online since last registering.

12.3(13a)BC

New initialization states were added for the MAC State Field:

init(d)—The Cisco CMTS has seen DHCPDISCOVER

init(io)—The Cisco CMTS has seen DHCPOFFER

init(dr)—The Cisco CMTS has seen DHCPREQUEST

init(i)—The Cisco CMTS has seen DHCPACK

init(o)—The Cisco CMTS has seen first TFTP packet for TFTP request for cable modem configuration file

init(t)—The Cisco CMTS has seen the TOD request

See Table 101 for additional information.

12.3(21)BC

All cable bundles are now automatically converted and configured to be in a virtual bundle, and standalone cable interfaces must be manually configured to be in a virtual bundle to operate properly. Previously, new virtual interface bundles and bundle members required reconfiguration, and there could also be standalone interfaces not part of a bundle at all.

12.3(23)BC

The verbose option displays additional information about the cable modem. The following fields have been added to the output of this option:

Host Interface

Primary Downstream

Wideband Capable

Voice Enabled

DS Change Times

C Release
Modification

12.1(4)CX

Support was added for the Cisco uBR10012 router.

12.2(15)CX

The verbose option displays the sysDescr field for each cable modem, when the cable modem remote-query command has been configured. Other fields have also been added to support DOCSIS 2.0 (ATDMA) operation.

E Release
Modification

12.1(10)EC1

Adds an exclamation point to CMs that have exceeded the maximum delay/timing offset specified by the cable map-advance command.

12.1(11b)EC1

The output for the Online State field was updated for the cable tftp-enforce command. A pound sign (#) appears next to the state value when a CM was allowed to come online without attempting to download a DOCSIS configuration file through the cable interface with the Cisco CMTS.

12.1(20)EC1

The three new states—online(pkd), online(ptd), and expire(pkd)—were added to the Cisco IOS Release 12.1 EC train.

N Release
Modification

11.3(5)NA

The output was reorganized and the Receive Power field was added.

SC Release
Modification

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The output column spacing and headings were changed, including some of the following changes:

"BPI Enb" has been changed to "BPI"

"DIP" output field was added to indicate support of dual IP for both IPv4 and IPv6 addressing.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—CMTS router has seen SOLICIT message.

init6(a)—CMTS router has seen ADVERTISE message.

init6(r)—CMTS router has seen REQUEST message.

init6(i)—CMTS router has seen REPLY message.

init6(o)—CMTS router has seen version 6 TFTP request.

init6(t)—CMTS router has seen version 6 TOD request.

12.2(33)SCB

A new keyword, cm-status, was added to display CM status events.

12.2(33)SCC

This command was modified with the following changes:

The command output displays the CM attribute bitmasks.

The command output provides basic receive-statistics for all event code types of the specified CM.

12.2(33)SCD

This command was modified. The cm-status keyword was added to display the CM status events and the queue keyword was added to display downstream HQF queue information on the Cisco uBR7225VXR and Cisco uBR7246VXR routers.

12.2(33)SCD2

This command was modified. The command output was modified to display the cable modems that are in upstream and downstream partial service mode.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCE4

This command was modified. The command output displays online time of the modem since the last counter reset, along with the total time online.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added. The show cable modem verbose command output was modified to display the downstream channel information for the cable modems.

T Release
Modification

2.1(1a)T1

The output of this command was enhanced to show that the Cisco CMTS has detected an unstable return path for a particular CM and has compensated with a power adjustment. An asterisk (*) appears in the power adjustment field for a modem when a power adjustment has been made; an exclamation point (!) appears when the CM has reached its maximum power transmit level and cannot increase its power level further.

12.0(7)T

The detail option was replaced with the verbose option.

X Release
Modification

11.3XA

This command was introduced.

12.0(4)XI

The output was expanded to show the primary service identifier (SID) and the customer premises equipment (CPE) count.

12.0(7)XR

The output of this command was enhanced to show that the Cisco CMTS has detected an unstable return path for a particular CM and has compensated with a power adjustment. An asterisk (*) appears in the power adjustment field for a modem when a power adjustment has been made; an exclamation point (!) appears when the CM has reached its maximum power transmit level and cannot increase its power level further.


Usage Guidelines

This command displays information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, identified by its IP address, MAC address, or its domain name. The output is sorted by the cable interface and the CM MAC address.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.



Tip Several options in the show cable modem command do not pause the screen to display the information page by page, even if the terminal length command has been used to set the page size of your terminal. Paging and pausing the display could result in outdated or stale information for CMs, and thus produce an incorrect snapshot of the current CM state of the system. To capture or review this information, use your terminal program's capture buffer to save the information to a file, and then review it offline.



Tip You can also specify the MAC address or IP address for a CPE device, and the Cisco CMTS will display the information for the CM that is associated with that CPE device in its internal database.



Note If the CPE IP address is no longer associated with a cable modem, the show cable modem command might not display information about the cable modem. To display the IP address of the CPE device for the cable modem, use the clear cable host ip-address command to clear the IP address of the modem from the router database, and then enter the ping docsis mac-address command, which resolves the MAC address by sending the DOCSIS ping to the CM.



Note When an IPv4 CPE is moved from one bundle interface to another bundle interface, the show cable modem command displays duplicate CPE device under the original modem and new modem. CPE ping may also fail. To prevent duplication, use the clear cable host command to manually remove the old CPE device entry before moving the IPv4 CPE from one bundle interface to another. Reload the CPE after moving it to another bundle interface.


Refer to the following document on Cisco.com for additional information about cable interface bundling and virtual interface bundling on the Cisco CMTS:

Cable Interface Bundling and Virtual Interface Bundling on the Cisco CMTS

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.

Operation of the show cable modem Commands with Different Cable Interface Line Cards

The show cable modem commands display the most current information for standard cable interface line cards. If the card itself is down, the show cable modem commands still show whatever information is appropriate (such as offline cable modems and flap list information).

The show cable modem commands function slightly different when used on routers that are using Broadband Processing Engine (BPE) cable interface line cards (such as the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, or Cisco uBR10-MC5X20S/U/H). When BPE cards are the only cable interface cards installed, the show cable modem commands do not display any output until at least one BPE card is up and communicating with the router processor. If the BPE cards are not yet up, the show cable modem command does not display any output.

Examples

Example of the show cable modem Command Output for all CMs

The following sample output from the show cable modem command shows the default CM displays for individual CMs.

Router# show cable modem 
MAC Address    IP Address      I/F     MAC         Prim RxPwr Timing Num  BPI
                                       State       Sid  (db)  Offset CPEs Enbld
0010.7b6b.58c1 0.0.0.0         C4/0/U5 offline     5   -0.25  2285   0    yes
0010.7bed.9dc9 0.0.0.0         C4/0/U5 offline     6   -0.75  2290   0    yes
0010.7bed.9dbb 0.0.0.0         C4/0/U5 offline     7    0.50  2289   0    yes
0010.7b6b.58bb 0.0.0.0         C4/0/U5 offline     8    0.00  2290   0    yes
0010.7bb3.fcd1 10.20.113.2     C5/0/U5 online      1    0.00  1624   0    yes
0010.7bb3.fcdd 0.0.0.0         C5/0/U5 init(r1)    2   -20.00 1624   0    no 
0010.7b43.aa7f 0.0.0.0         C5/0/U5 init(r2)    3    7.25  1623   0    no 

Example of the show cable modem Command for a Specified MAC Address

Router# show cable modem 0010.7bb3.fcd1 
MAC Address    IP Address      I/F     MAC         Prim RxPwr Timing Num  BPI
                                       State       Sid  (db)  Offset CPEs Enbld
0010.7bb3.fcd1 10.20.113.2     C5/0/U5 online      1    0.00  1624   0    Y

Example of the show cable modem Command for all CMs on a Cisco uBR10012 Router

The following shows a typical display for a Cisco uBR10012 router:


Note The asterisk(*) in the Primary SID (Prim Sid) field indicates that the modem has service flows with zero blaze index in Cisco IOS Release 12.3(23)BC.
In Cisco IOS Release 12.2(33)SCB and later, the asterisk that may appear in the Primary SID field does not signify anything.


Router# show cable modem 
MAC Address    IP Address      I/F       MAC         Prim RxPwr  Timing  Num BPI
                                         State       Sid  (db)   Offset  CPE Enb
0010.9507.01db 144.205.151.130 C5/1/0/U5 online(pt)  1     0.25    938   1    N 
0080.37b8.e99b 144.205.151.131 C5/1/0/U5 online      2     -0.25   1268  0    N 
0002.fdfa.12ef 144.205.151.232 C6/1/0/U0 online(pt)  13    -0.25   1920  1    N 
0002.fdfa.137d 144.205.151.160 C6/1/0/U0 online      *16    -0.50   1920  1    N 
0003.e38f.e9ab 144.205.151.237 C6/1/0/U0 online      3     -0.50   1926  1    N 
0003.e3a6.8173 144.205.151.179 C6/1/1/U2 offline     *4     0.50    1929  0    N 
0003.e3a6.8195 144.205.151.219 C6/1/1/U2 online(pt)  22    -0.50   1929  1    N 
0006.28dc.37fd 144.205.151.244 C6/1/1/U2 online(pt)  61    0.00    1925  2    N 
0006.28e9.81c9 144.205.151.138 C6/1/1/U2 online(pt)  2    !0.75    1925  1    N 
0006.28f9.8bbd 144.205.151.134 C6/1/1/U2 #online     25    -0.25   1924  1    N 
0006.28f9.9d19 144.205.151.144 C6/1/1/U2 online(pt)  28    0.25    1924  1    N 
0010.7bed.9b6d 144.205.151.228 C6/1/1/U2 online(pt)  59    0.25    1554  1    N 
0002.fdfa.12db 144.205.151.234 C7/0/0/U0 online      15    -0.75   1914  1    N 
0002.fdfa.138d 144.205.151.140 C7/0/0/U5 online      4     0.00    1917  1    N 
0003.e38f.e85b 144.205.151.214 C7/0/0/U5 online      17   *0.25    1919  1    N 
0003.e38f.f4cb 144.205.151.238 C7/0/0/U5 online(pt)  16    0.00   !2750  1    N 
0003.e3a6.7fd9 144.205.151.151 C7/0/0/U5 online      1     0.25    1922  0    N 
0020.4005.3f06 144.205.151.145 C7/0/0/U0 online(pt)  2     0.00    1901  1    N 
0020.4006.b010 144.205.151.164 C7/0/0/U5 online(pt)  3     0.00    1901  1    N 
0050.7302.3d83 144.205.151.240 C7/0/0/U0 online(pt)  18    -0.25   1543  1    N 
00b0.6478.ae8d 144.205.151.254 C7/0/0/U5 online(pt)  44    0.25    1920  21   N 
00d0.bad3.c0cd 144.205.151.149 C7/0/0/U5 online      19    0.25    1543  1    N 
00d0.bad3.c0cf 144.205.151.194 C7/0/0/U0 online      13    0.00    1546  1    N 
00d0.bad3.c0d5 144.205.151.133 C7/0/0/U0 online      12   *0.50    1546  1    N 

Example of show cable modem Command When no CMs are Online

The following example shows sample output when the cable interface line cards are up, but no cable modems are yet online:

Router# show cable modem 
MAC Address    IP Address      I/F       MAC         Prim RxPwr  Timing  Num BPI
                                         State       Sid  (db)   Offset  CPE Enb

Example of show cable modem Command When no Cable Interface Line Cards are Up

The following example shows sample output when the Cisco CMTS router contains only Broadband Processing Engine (BPE) cable interface line cards and none of the cable interface line cards are up:

Router# show cable modem 

Example of show cable modem verbose Command for a Specified MAC Address

The following example shows sample output for the verbose option for a particular CM:

Router# show cable modem 0010.7bb3.fcd1 verbose 
MAC Address                         : 00C0.7bb3.fcd1
IP Address                          : 10.20.113.2
Prim Sid                            : 1
QoS Profile Index                   : 6
Interface                           : C5/0/U5
sysDescr                            : Vendor ABC DOCSIS 2.0 Cable Modem
Upstream Power                      : 0 dBmV (SNR = 33.25 dBmV)
Downstream Power                    : 0 dBmV (SNR = ----- dBmV)
Timing Offset                       : 1624
Initial Timing Offset               : 2812
Received Power                      : 0.25
MAC Version                         : DOC1.0
Qos Provisioned Mode                : DOC1.0
Enable DOCSIS2.0 Mode               : Y
Phy Operating Mode                  : atdma 
Capabilities                        : {Frag=N, Concat=N, PHS=N, Priv=BPI}
Sid/Said Limit                      : {Max Us Sids=0, Max Ds Saids=0}
Optional Filtering Support          : {802.1P=N, 802.1Q=N}
Transmit Equalizer Support          : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs                   : 0(Max CPEs = 1)
CFG Max-CPE                         : 1
Flaps                               : 373(Jun 1  13:11:01)
Errors                              : 0 CRCs, 0 HCSes
Stn Mtn Failures                    : 0 aborts, 3 exhausted
Total US Flows                      : 1(1 active)
Total DS Flows                      : 1(1 active)
Total US Data                       : 1452082 packets, 171344434 bytes
Total US Throughput                 : 0 bits/sec, 0 packets/sec
Total DS Data                       : 1452073 packets, 171343858 bytes
Total DS Throughput                 : 0 bits/sec, 0 packets/sec
Active Classifiers                  : 0 (Max = NO LIMIT) 
DSA/DSX messages                    : reject all 
Dynamic Secret                      : A3D1028F36EBD54FDCC2F74719664D3F
Total Time Online                   : 16:16 

Note The "Number of CPES" field shows the value set for the CM, not the value for the CMTS that is set by the cable modem max-cpe command. In Cisco IOS Release 12.2(15)BC1 and later releases, the verbose display also includes information about the dynamic shared-secret feature (see the cable dynamic-secret command).



Note An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used for the CM to attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).



Tip The show cable modem command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.


Example of the Updated show cable modem verbose Command for a Specified MAC Address in Cisco IOS Release 12.3(23)BC

The following example shows sample output for the verbose option for a particular CM for the Cisco IOS Release 12.3(23)BC with new output fields:

Router# show cable modem 0000.39b9.ac51 verbose 
MAC Address                         : 0000.39b9.ac51
IP Address                          : 55.1.176.11
Prim Sid                            : 7
QoS Profile Index                   : 5
Host Interface                      : C8/0/0/U5
Primary Downstream                  : Mo3/0/1:3 (RfId : 27)
Wideband Capable                    : N
sysDescr                            : Toshiba PacketCable 1.0 EMTA ; <<HW_REV: 13.0.0; 
VENDOR: Toshiba Corporation; BOOTR: 2.2; SW_REV: 6.1.318; MODEL: PCX3000>>
Upstream Power                      : 29.00 dBmV (SNR = 16.07 dB)
Downstream Power                    : 14.90 dBmV (SNR = 34.30 dB)
Timing Offset                       : 1774  
Initial Timing Offset               : 1774
Curr US Timing Adjust               : 272
Prev US Timing Adjust               : 0
Received Power                      :  0.00 dBmV
MAC Version                         : DOC1.1
QoS Provisioned Mode                : DOC1.0
Enable DOCSIS2.0 Mode               : Y
Phy Operating Mode                  : tdma
Capabilities                        : {Frag=N, Concat=Y, PHS=N, Priv=}
Sid/Said Limit                      : {Max US Sids=0, Max DS Saids=0}
Optional Filtering Support          : {802.1P=N, 802.1Q=N}
Transmit Equalizer Support          : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs                   : 0(Max CPE IPs = 17)
CFG Max-CPE                         : 3
Flaps                               : 7(Sep 16 20:04:13)
Errors                              : 0 CRCs, 0 HCSes
Stn Mtn Failures                    : 0 aborts, 0 exhausted
Total US Flows                      : 1(1 active)
Total DS Flows                      : 1(1 active)
Total US Data                       : 3399 packets, 1956063 bytes
Total US Throughput                 : 0 bits/sec, 0 packets/sec
Total DS Data                       : 125 packets, 10704 bytes
Total DS Throughput                 : 0 bits/sec, 0 packets/sec
Active Classifiers                  : 0 (Max = NO LIMIT) 
CM Upstream Filter Group            : 10
DSA/DSX messages                    : permit all
Voice Enabled                       : NO
DS Change Times                     : 0
Total Time Online                   : 7d22h

Note In Cisco IOS Release 12.3(23)BC, the output for this command does not display information about dynamic shared secret.


Example of show cable modem Command for a CM or CPE With a Specified IPv6 Address

The following example shows sample output for the show cable modem command for a CM with the IPv6 address of 2001:ODBA:4321:600:980D:E743:174F:1E48.


Note The IP Address field shows "---" because the IPv6 address is too long for the size of the output field. To view a complete IPv6 address for a device, use the verbose form of the command.


Router# show cable modem 2001:ODBA:4321:600:980D:E743:174F:1E48
                                                                             B D
MAC Address    IP Address      I/F       MAC         Prim  RxPwr  Timing Num P I
                                         State       Sid   (dBmv) Offset CPE I P
0019.474a.ccd0 ---            C5/0/1/U0 w-online     38    0.00  1580    0   N

Example of the show cable modem verbose Command Output That Shows CM Attribute Masks in Cisco IOS Release 12.2(33)SCC

The following example shows the sample output for the verbose option for a particular CM in Cisco IOS Release 12.2(33)SCC:

Router# show cable modem 001a.c3ff.ce9e verbose 
MAC Address                        : 0019.474a.d396
IP Address                         : 10.10.2.4
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 1
Host Interface                     : C5/0/0/U2
MD-DS-SG / MD-US-SG                : 1 / N/A
MD-CM-SG                           : 0x100
Primary Downstream                 : C5/0/0 (RfId : 240)
Wideband Capable                   : Y
RCP Index                          : 2
RCP ID                             : 00 10 18 33 81
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US2
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Received Power (dBmV)              : 0.00
Timing Offset             (97.6 ns): 1018
Initial Timing Offset              : 1018
Rng Timing Adj Moving Avg(0.381 ns): 0
Rng Timing Adj Lt Moving Avg       : 0
Rng Timing Adj Minimum             : 0
Rng Timing Adj Maximum             : 0
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 457865
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online(pt), Security=assign(tek)}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=BPI+, EAE=N, Key_len=56}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 1(1 active)
Total DS Flows                     : 1(1 active)
Total US Data                      : 12937 packets, 1079852 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 6226 packets, 459372 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 2
Number of Multicast DSIDs Support  : 16
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 7d4h18m
CFG Max IPv6 CPE Prefix             : 1024 (-1 used)

Example of the show cable modem Command Output for a Cable Modem Operating in the MTC Mode

The following example shows the sample output for the verbose option for a particular CM operating in the MTC mode in Cisco IOS Release 12.2(33)SCC:

Router# show cable modem 0014.f831.d596 verbose

MAC Address                        : 001e.6bfa.f02e
IP Address                         : 30.10.0.6
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 5
Host Interface                     : C5/1/0/UB
MD-DS-SG / MD-US-SG                : 1 / 1
MD-CM-SG                           : 0xF0101
Primary Wideband Channel ID        : 48
Primary Downstream                 : Mo3/0/0:0 (RfId : 120)
Wideband Capable                   : Y
RCP Index                          : 3
RCP ID                             : 00 10 00 00 04
Multi-Transmit Channel Mode        : Y
Upstream Channel                   : US1        US2        US3        US4
Ranging Status                     : sta        sta        sta        sta
Upstream Power (dBmV)              : 0.00       0.00       0.00       0.00
Upstream SNR (dB)                  : 36.12      36.12      36.12      33.1
Received Power (dBmV)              : 0.00       1.00       0.00       -0.75
Reported Transmit Power (dBmV)     : 45.00      45.00      45.00      54.75
Peak Transmit Power (dBmV)         : 51.00      51.00      56.00      56.00
Minimum Transmit Power (dBmV)      : 24.00      24.00      21.00      18.00
Timing Offset             (97.6 ns): 2312       2281       2282       2282
Initial Timing Offset              : 2314       2058       2058       2058
Rng Timing Adj Moving Avg(0.381 ns): 7          4          0          -94
Rng Timing Adj Lt Moving Avg       : 63         30         11         -144
Rng Timing Adj Minimum             : -512       -256       -256       -512
Rng Timing Adj Maximum             : 256        57088      57344      57344
Pre-EQ Good                        : 0          0          0          0
Pre-EQ Scaled                      : 0          0          0          0
Pre-EQ Impulse                     : 0          0          0          0
Pre-EQ Direct Loads                : 0          0          0          0
Good Codewords rx                  : 5012       4996       4992       4990
Corrected Codewords rx             : 0          0          0          0
Uncorrectable Codewords rx         : 0          0          0          0
Phy Operating Mode                 : atdma*     atdma*     tdma*      tdma*
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC3.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= w-online, Security=disabled}
Capabilities                       : {Frag=N, Concat=N, PHS=Y}
Security Capabilities              : {Priv=, EAE=Y, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=8, Max DS Saids=24}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 4
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 1(1 active)
Total US Data                      : 6 packets, 1557 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 0 packets, 0 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 2
Number of Multicast DSIDs Support  : 24
MDF Capability Mode                : 2
IGMP/MLD Version                   : IGMPv3
FCType10 Forwarding Support        : Y
Features Bitmask                   : 0x0
Total Time Online                  : 1d16h
CM Initialization Reason           : NO_PRIM_SF_USCHAN
CFG Max IPv6 CPE Prefix             : 16 (-1 used)

Note An asterisk (*) in the Phy Operating Mode row indicates the type of PHY-layer modulation that the CM (operating in the MTC mode) is using: tdma or atdma.


Example of the show cable modem verbose Command Output in Cisco IOS Release 12.2(33)SCE4

The following example shows the sample output for the verbose option for a particular CM in Cisco IOS Release 12.2(33)SCE4:

Router# show cable modem 001a.c3ff.ce9e verbose 
MAC Address                        : 0014.e84f.1630
IP Address                         : 50.6.9.4       
IPv6 Address                       : ---                                    
Dual IP                            : N
Prim Sid                           : 1
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : N/A / N/A
MD-CM-SG                           : 0x2D0000
Primary Downstream                 : C6/1/0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 73    6/1/0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0       
Ranging Status                     : sta       
Upstream Power (dBmV)              : 0.00      
Upstream SNR (dB)                  : 31.26     
Received Power (dBmV)              : 0.50      
Timing Offset             (97.6 ns): 1237      
Initial Timing Offset              : 1237      
Rng Timing Adj Moving Avg(0.381 ns): 503       
Rng Timing Adj Lt Moving Avg       : 402       
Rng Timing Adj Minimum             : 0         
Rng Timing Adj Maximum             : 1024      
Pre-EQ Good                        : 0         
Pre-EQ Scaled                      : 0         
Pre-EQ Impulse                     : 0         
Pre-EQ Direct Loads                : 0         
Good Codewords rx                  : 429       
Corrected Codewords rx             : 0         
Uncorrectable Codewords rx         : 0         
Phy Operating Mode                 : tdma      
sysDescr                           : 
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 20 packets, 6786 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 11255 packets, 720320 bytes
Total DS Throughput                : 5119 bits/sec, 9 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                : 
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    : 
Service Type ID in config file     : 
Active Classifiers                 : 0 (Max = NO LIMIT) 
CM Upstream Filter Group           : 30
CM Downstream Filter Group         : 29
CPE Upstream Filter Group          : 1
CPE Downstream Filter Group        : 1
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 18:53   (18:53    since last counter reset)
!From Cisco IOS Release 12.2(33)SCE4 onwards, the command output shows online time of the 
!modem since the last counter reset.
CFG Max IPv6 CPE Prefix            : 16 (-1 used)

Example of the show cable modem verbose Command in Cisco IOS Release 12.2(33)SCF

The following is a sample output of the show cable modem verbose command in Cisco IOS Release 12.2(33)SCF:

Router# show cable modem 10.1.0.2 verbose
MAC Address                        : 001e.6bfb.0a60
IP Address                         : 10.1.0.2
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 43
Host Interface                     : C7/0/0/UB
MD-DS-SG / MD-US-SG                : 1 / 1
MD-CM-SG                           : 0x3C0101
Primary Wideband Channel ID        : 897 (Wi7/0/0:0)
Primary Downstream                 : In7/0/0:0 (RfId : 720)
Wideband Capable                   : Y
RCP Index                          : 3
RCP ID                             : 00 10 00 00 04
Multi-Transmit Channel Mode        : Y
Upstream Channel                   : US0        US1        US2
Ranging Status                     : sta        sta        sta
Upstream SNR (dB)                  : 33.1       33.1       33.1
Upstream Data SNR (dB)             : 22.78      22.78      22.78
Received Power (dBmV)              : 0.50       0.00       0.00
Reported Transmit Power (dBmV)     : 51.00      51.00      51.00
Peak Transmit Power (dBmV)         : 51.00      51.00      51.00
Minimum Transmit Power (dBmV)      : 24.00      24.00      24.00
Timing Offset             (97.6 ns): 1302       1303       1303

The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for a specific CM identified by its IP address:

Router# show cable modem 80.62.0.4 verbose
MAC Address                        : 0018.6832.0eb2
IP Address                         : 80.62.0.4
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 13
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Upstream Data SNR (dB)             : --
Received Power (dBmV)              : 0.00
Timing Offset             (97.6 ns): 1192
Initial Timing Offset              : 1192
Rng Timing Adj Moving Avg(0.381 ns): -1
Rng Timing Adj Lt Moving Avg       : -7
Rng Timing Adj Minimum             : -256
Rng Timing Adj Maximum             : 0
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 42
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 9 packets, 4545 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 9 packets, 3114 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 4d14h
CFG Max IPv6 CPE Prefix            : 16 (-1 used)

The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for a specific cable interface:

Router# show cable modem Cable 6/1/0 verbose
MAC Address                        : 0018.6832.0eb2
IP Address                         : 80.62.0.4
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 13
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Upstream Data SNR (dB)             : --
Received Power (dBmV)              : 0.00
Timing Offset             (97.6 ns): 1192
Initial Timing Offset              : 1192
Rng Timing Adj Moving Avg(0.381 ns): 0
Rng Timing Adj Lt Moving Avg       : 0
Rng Timing Adj Minimum             : 0
Rng Timing Adj Maximum             : 256
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 66
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 1(Mar 22 22:39:59)
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 1 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 2 packets, 1010 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 2 packets, 692 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 1d2h33m
CFG Max IPv6 CPE Prefix            : 16 (-1 used)
MAC Address                        : 0018.6832.069e
IP Address                         : 80.62.0.3
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 15
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Upstream Data SNR (dB)             : --
Received Power (dBmV)              : 0.50
Timing Offset             (97.6 ns): 1196
Initial Timing Offset              : 1196
Rng Timing Adj Moving Avg(0.381 ns): -39
Rng Timing Adj Lt Moving Avg       : -92
Rng Timing Adj Minimum             : -256
Rng Timing Adj Maximum             : 0
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 54
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 3(Mar 20 09:22:20)
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 1 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 13 packets, 6565 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 13 packets, 4498 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 6d12h
CFG Max IPv6 CPE Prefix            : 16 (-1 used)

The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for all CMs:

Router# show cable modem verbose
MAC Address                        : 0006.2854.740b
IP Address                         : 0.0.0.0
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 12
QoS Profile Index                  : 2
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   :
Ranging Status                     :
Upstream Power (dBmV)              :
Upstream SNR (dB)                  :
Upstream Data SNR (dB)             :
Received Power (dBmV)              :
Timing Offset             (97.6 ns):
Initial Timing Offset              :
Rng Timing Adj Moving Avg(0.381 ns):
Rng Timing Adj Lt Moving Avg       :
Rng Timing Adj Minimum             :
Rng Timing Adj Maximum             :
Pre-EQ Good                        :
Pre-EQ Scaled                      :
Pre-EQ Impulse                     :
Pre-EQ Direct Loads                :
Good Codewords rx                  :
Corrected Codewords rx             :
Uncorrectable Codewords rx         :
Phy Operating Mode                 :
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC1.0
QoS Provisioned Mode               : DOC1.0
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= offline, Security=disabled}
Capabilities                       : {Frag=N, Concat=N, PHS=N}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=0, Max DS Saids=0}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 16
Flaps                              : 8218(Mar 22 03:17:15)
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 222 exhausted
Total US Flows                     : 1(1 active)
Total DS Flows                     : 1(1 active)
Total US Data                      : 454 packets, 32291 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 0 packets, 0 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 00:00
CFG Max IPv6 CPE Prefix            : 16 (-1 used)
MAC Address                        : 0018.6832.0eb2
IP Address                         : 80.62.0.4
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 13
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Upstream Data SNR (dB)             : --
Received Power (dBmV)              : 0.00
Timing Offset             (97.6 ns): 1192
Initial Timing Offset              : 1192
Rng Timing Adj Moving Avg(0.381 ns): -1
Rng Timing Adj Lt Moving Avg       : -7
Rng Timing Adj Minimum             : -256
Rng Timing Adj Maximum             : 0
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 42
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 9 packets, 4545 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 9 packets, 3114 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 4d14h
CFG Max IPv6 CPE Prefix            : 16 (-1 used)

Example of the show cable modem Command Output on the Cisco uBR7225VXR and Cisco uBR7246VXR Routers

The following example shows the sample output for the cm-status option in Cisco IOS Release 12.2(33)SCD on a Cisco uBR7246VXR router:

Router# show cable modem cm-status

I/F MAC Address Event TID Count Error Dups Time

C5/0 001e.6bfb.29a6 Seq out-of-range 1 1 0 1 Jan 18 09:00:19

C7/0   001c.ea2b.79b2 MDD timeout      0     0     1     0     Jan 11 11:29:22
                      QAM failure      0     0     1     0     Jan 11 11:29:02
                      MDD recovery     0     0     1     0     Jan 11 11:30:20
                      QAM recovery     0     0     1     0     Jan 11 11:30:13
C7/0   001c.ea2b.78b0 MDD timeout      0     0     1     0     Jan 11 11:29:16
                      QAM failure      0     0     1     0     Jan 11 11:28:53
                      MDD recovery     0     0     1     0     Jan 11 11:29:59
                      QAM recovery     0     0     1     0     Jan 11 11:29:46

The following example shows the sample output of the queue option for a particular CM in Cisco IOS Release 12.2(33)SCD:

Router# show cable modem 40.3.192.2 queue 
* idx/gqid Len/Limit Deqs      Drops     CIR       MIR/PR     ForwInt  SFID
             pkts    pkts      pkts      kbps       kbps
BE Queues:
    3/43     0/128   103       0         0           0/0      In5/1:1 Ca5/1:22
CIR Queues:
Low Latency Queues:

Example of the show cable modem Command Output for Partial Service Mode

The following example shows the sample output of the show cable modem command that displays the cable modems that are in upstream (indicated by "p" under I/F) and downstream partial service mode (indicated by "p-online" under MAC State):

Router# show cable modem
                                                                               D
MAC Address    IP Address     I/F         MAC           Prim RxPwr  Timing Num I
                                          State         Sid  (dBmv) Offset CPE P
0016.9252.9ac0 2.99.81.4      C7/0/0/U0   online(pt)    1    0.00   1332   0   N
000f.2172.229d 2.99.81.36     C7/0/0/U3   online(pt)    2    0.50   1778   0   N
001e.6bfb.33a0 2.99.81.14     C7/0/0/p    p-online(pt)  3    -0.50  1424   0   N
0022.cef4.3d9a 2.99.81.23     C7/0/0/p    p-online(pt)  4    0.00   1438   0   N
0019.474a.c456 2.99.81.18     C7/0/0/U3   online(pt)    5    0.00   1336   0   N
001e.6bfb.194e 2.99.81.32     C7/0/0/p    p-online(pt)  6    -0.50  1422   0   N
00e0.6f8b.a888 2.99.81.31     C7/0/0/U3   online(pt)    7    0.50   1427   0   N
001e.6bfb.1538 2.99.81.38     C7/0/0/p    p-online(pt)  8    0.00   1423   0   N
001e.6bfb.0d22 2.99.81.29     C7/0/0/p    p-online(pt)  9    0.00   1738   0   N
001e.6bfb.1a7e 2.99.81.30     C7/0/0/p    p-online(pt)  10   0.00   1738   0   N
0019.474a.c418 2.99.81.75     C7/0/0/U1   online(pt)    11   0.00   1335   0   N
001e.6bfa.f58a 2.99.81.9      C7/0/0/p    p-online(pt)  12   0.00   1737   0   N
0022.cef4.3fa2 2.99.81.24     C7/0/0/p    p-online(pt)  13   0.00   1438   0   N
001e.6bfb.1b72 2.99.81.10     C7/0/0/p    p-online(pt)  14   -0.50  1425   0   N
0019.474a.c330 2.99.81.34     C7/0/0/U0   online(pt)    15   0.00   1028   0   N
0023.be50.e578 2.99.81.17     C7/0/0/UB   p-online(pt)  16   0.00   1805   0   N
0025.2e2d.784a 2.99.81.28     C7/0/0/UB   p-online(pt)  17   0.50   1798   0   N
0025.2e2d.748c 2.99.81.26     C7/0/0/UB   p-online(pt)  18   0.00   1798   0   N
001e.6bfa.f070 2.99.81.37     C7/0/0/U3   online(pt)    20   0.50   1735   0   N
0019.474a.c422 2.99.81.20     C8/0/0/U1   online(pt)    1    0.50   1340   0   N
0019.474a.c466 2.99.81.21     C8/0/0/U1   online(pt)    2    0.00   1334   0   N
001e.6bfb.2e96 2.99.81.33     C8/0/0/UB   w-online(pt)  3    0.00   1738   0   N

Table 83 describes the significant fields shown in the display:

Table 83 show cable modem Field Descriptions 

Field
Description

MAC Address

MAC address for the CM.

IP Address

IP address that the DHCP server has assigned to the CM.

IPv6 Address

IPv6 address that the DHCP server has assigned to the CM.

Dual IP

Support of dual IP for both IPv4 and IPv6 addressing.

I/F, Interface

Cable interface line card providing the upstream for this CM.

sysDescr

Vendor and model of the cable modem, as reported by the cable modem. This field displays a value only when the cable modem remote-query command is configured.

Upstream Power

Downstream Power

Upstream and Downstream Power fields are displayed only if the CM remote-query feature has been enabled using the cable modem remote-query command. Upstream Power displays the CM transmit level in dBmV, and Downstream Power displays the dBmV level received at the CM, as measured by the CMTS.

MAC State

Current state of the MAC layer.

Prim SID

Primary SID assigned to this CM.

Host Interface

Host interface name.

Primary Wideband Channel ID

Bonding group ID of the wideband interface assigned to the CM.

MD-DS-SG

MAC Domain Downstream Service Group, the downstream channels of a single MAC domain that reach the cable modem.

DSID

Downstream Service Identifier.

Primary Downstream

Primary downstream channel assigned to the CM.

Wideband Capable

Cable modem is wideband-capable or not.

Downstream Channel DCID RF Channel

Downstream channel and channel ID used by a CM.

Multi-Transmit Channel Mode

Cable modem is in MTC mode or not.

Upstream SNR

Upstream signal-to-noise ratio (SNR) for a particular cable modem (CM), in decibels (dB).

Upstream SM MER (dB)

Upstream station maintenance (SM) modulation error ratio (MER) for a particular cable modem, in decibels (dB).

Upstream Data MER (dB)

Upstream modulation error ratio (MER) for a particular cable modem, in decibels (dB). This field is displayed only when RF adaptation is enabled.

RxPwr, Received Power

Average power in dBmV for the upstream channel symbol rate for the CM. With default settings, 0 dBmV is considered optimal, but a range of -1 to 1 dBmV is allowable. When CMs exceed this range, older Cisco IOS releases supported a drop to as low as -2 dBmV. Recent Cisco IOS releases support a drop to as low as -4 dBmV.

This field supports a resolution of 0.25 dBmV, but the dB resolution level for CMs and for the Cisco CMTS are slightly higher—approximately 1.0 and 1.4 dB.

Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.

Timing Offset and Initial Timing Offset

Timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.

Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).

Reported Transmit Power (dBmV)

Reported Transmit Power level by the cable modem for each upstream channel. This applies only to the cable modems operating in the MTC mode.

Peak Transmit Power (dBmV)

This is the maximum transmit power level that the cable modem in the MTC mode could transmit at for the upstream channel.

Minimum Transmit Power (dBmV)

This is the minimum transmit power level that the cable modem in the MTC mode could transmit at for the upstream channel.

Rng Timing Adj Moving Avg(0.381 ns):
Rng Timing Adj Lt Moving Avg:
Rng Timing Adj Minimum:
Rng Timing Adj Maximum:

A Cisco CMTS router tracking variables to see relative timing offset adjustments.

Pre-EQ Good :
Pre-EQ Scaled :
Pre-EQ Impulse:
Pre-EQ Direct Loads

Equalizer statistics counter.

Good Codewords rx

Good code words for a particular upstream channel. This counter is reset during interface reset.

Corrected Codewords rx

Correctable code words for a particular upstream channel. This counter is reset during interface reset.

Uncorrectable Codewords rx

Uncorrectable code words for a particular upstream channel. This counter is reset during interface reset.

sysDescr

Identifies the vendor and model of the cable modem, as reported by the cable modem. This field displays a value only when the cable modem remote-query.

Num CPEs, CFG Max-CPE

Indicates the number of CPE devices for which the CM is providing services.

Number of CPE IPs

Indicates the maximum number of IP addresses assigned to CPE devices behind this CM, as configured by the cable max-hosts command.

Ver, MAC Version

Displays the maximum supported version of DOCSIS that the CM supports (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).

QoS Prov, QoS Provisioned Mode

Displays the version of DOCSIS that the CM currently is provisioned for (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).

Enable DOCSIS 2.0 Mode

Indicates that the cable modems are allowed to come online when in mixed-mode environments such as DOCSIS 1.0 TDMA, DOCSIS 1.1 TDMA and DOCSIS 2.0 ATDMA. This value is set to Y by default, unless the TLV 39 has been set to disabled (0) in the CM's Registration Request message or in the DOCSIS configuration file.

Phy Operating Mode

Indicates the type of PHY-layer modulation that the CM is using: tdma or atdma. Also indicates the TDMA/ATDMA/SCDA mode that the cable modem is operating on a specific channel.

Modem Status

Indicates the overall modem state and the security state of the primary SID.

BPI Enbld, BPI

Indicates whether or not Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.

DIP

Dual IP flag. Identifies whether or not ("Y" or "N") the CM or CPE supports both IPv4 and IPv6 addressing.

Capabilities

Indicates what the CM reported as its capabilities in its Registration Request message: DOCSIS fragmentation, concatenation, packet header suppression (PHS), and BPI encryption.

Security Capabilities

Indicates the privacy mode used by the CM (BPI or BPI+), early authentication and encryption (EAE) support, and the Key Length.

Optional Filtering Support

Indicates whether 802.1P or 802.1Q packet filtering is enabled for this CM.

Transmit Equalizer Support

Number of taps being used for transmit equalization.

Flaps

Number of flaps reported by this CM, with the date and time of the last flap within the parentheses.

Errors

Number of frame CRC and HCS errors reported for this CM.

Stn Mtn Failures

Number of station maintenance (cable keepalive) messages that the CMTS sent to this CM but did not receive any reply.

Total US Flows

Total number of upstream service flows, with the number of active service flows within the parentheses.

Total DS Flows

Total number of downstream service flows, with the number of active service flows within the parentheses.

Total US Data

Total data this CM has transmitted on the upstream, in packets and bytes.

Total US Throughput

Calculated throughput for this CM on the upstream, if available.

Total DS Data

Total data this CM has received on the downstream, in packets and bytes.

Total DS Throughput

Calculated throughput for this CM on the downstream, if available.

Active Classifiers

Current number of active classifiers for this CM, with the maximum number of allowable classifiers for this CM within the parentheses.

CM Required Attribute

Indicates the current required attribute-mask value.

CM Forbidden Attribute

Indicates the current forbidden attribute-mask value.

DSA/DSX messages

Indicates whether dynamic service changes (DSX) from the cable modem are permitted (permit all) or disallowed (reject all).

Voice Enabled

Indicates whether the CM is voice-enabled.

Number of Multicast DSIDs Support

Indicates the total number of supported multicast DSIDs.

FCType10 Forwarding Support

Indicates FCType10 Forwarding Support.

Dynamic Secret

Dynamically-generated shared secret (a 16-byte hexadecimal value) that was used in the cable modem's previous registration cycle. If the cable modem is currently offline, this field shows all zeroes.

Note This field displays a value only when the cable dynamic-secret command has been used on the CMTS interface.

Total Time Online

Amount of time in days, hours, and minutes that this CM has been continuously online since it last registered with the CMTS. This field begins incrementing whenever the CM enters one of the online(x) MAC states, and is reset to 0 whenever the CM enters any other MAC state.

Event

Event type.

TID

Transaction identifier.

Count

Number of valid messages received.

Dups

Number of duplicate messages received.

Time

Time when last valid event was received.

Len/Limit Pkts

Queue length and limit in packets.

Deqs Pkts

Dequeue packets.

Drops Pkts

Dropped packets.

CIR Kbps

Committed information rate.

MIR/PR Kbps

Maximum information and peak rate.

Forwint

Forwarding interface.

SFID

Service flow identifier.

BE Queues

Best effort queues.

CIR Queues

Committed information rate queues.

Low Latency Queues

Low latency queues.


Table 101 shows the possible values for the MAC state field:

Table 84 Descriptions for the MAC State Field 1

MAC State Value
Description
Ranging Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

Early Authentication and Encryption

assign(epk)

BPI is enabled and KEK is assigned.

assign(ept)

BPI is enabled and TEK is assigned. The registration messages will be encrypted.

Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

If early authentication and encryption is used, the letter `s' is appended to these states to indicate secure registration.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing

If early authentication and encryption is used, the letter `s' is appended to these states to indicate secure registration.

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

resetting

The CM is being reset and will shortly restart the ranging and registration process.

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

expire(epk)

Early authentication and encryption is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(ept)

Early authentication and encryption is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(epk)

Early authentication and encryption is enabled, KEK key assignment is rejected, and the modem has not been authenticated.

reject(pk)

KEK key assignment is rejected, and the modem has not been authenticated.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(ept)

Early authentication and encryption is enabled, TEK key assignment is rejected, and BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.

1 The following symbols appended to the modem state indicate a special condition:

1 An exclamation mark (!) indicates that the cable dynamic-secret command is used with either the mark or reject keyword and the cable modem has failed the dynamic secret authentication check.

1 An ampersand (&) indicates that the cable modem has registered using a self-signed certificate. This is inherently not secure and can be avoided by negating the cable privacy accept-self-signed-certificate command.

1 The asterisk (*) indicates that the cable modem does not satisfy the BPI+ policy and the data traffic is blocked. The cable privacy bpi-plus-policy command enforces this requirement.

1 A hash sign (#) indicates that the cable modem is using an unknown configuration file. To solve this problem, use the cable dynamic-secret command with the reject keyword. This will reject registration for CMs with DOCSIS configuration files.


1 In Cisco IOS Releases 12.1(20)EC, 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails.




Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem counters

Displays downstream and upstream traffic counters for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem domain-name

Updates the cable-specific DNS cache and display the domain name for specified CMs and CPE behind a CM on a Cisco CMTS router.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more CMs.

show cable modem ipv6

Displays IPv6 information for specified CMs and CPE behind a CM on a Cisco CMTS router.

show cable modem mac

Displays MAC layer information for one or more CMs.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more CMs.

show cable modem offline

Displays a list of the CMs that are marked as offline with the Cisco CMTS.

show cable modem partial-mode

Displays information about the cable modems that are in upstream and downstream partial service mode.

show cable modem phy

Displays the DOCSIS PHY layer information for one or more CMs.

show cable modem qos

Displays quality of service (QoS) and service flow information for a particular CM.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem summary

Displays a summary of CMs on one or more cable interfaces.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.

show cable modem vendor

Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem access-group

To display the access groups for the CMs on a particular cable interface, use the show cable modem access-group command in privileged EXEC mode.

Cisco uBR7100 series and Cisco uBR7200 series routers:

show cable modem [ip-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | mac-address] access-group

Cisco uBR10012 routers:

show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] access-group

Syntax Description

ip-address

(Optional) Access-group information displayed for the CM with the specified IP address. (Cisco uBR7100 series and Cisco uBR7200 series routers only.)

mac-address

(Optional) Access-group information displayed for the CM with the specified MAC address. (Cisco uBR7100 series and Cisco uBR7200 series routers only.)

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

access-group

Displays the access groups for the CMs and their associated hosts and other customer premises equipment (CPE) devices.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.2(4)BC1

Support for this command was added for the Cisco uBR10012 router, but only to display access groups on a per-interface basis.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays information only for CMs. To display information for both CMs and their associated hosts and other customer premises equipment (CPE) devices, use the show cable device access-group command. To display information only for hosts, use the show cable host access-group command.

If an SNMP manager is requesting information about CM or CPE devices at the same time that this command is given, the command displays the following error message:

No information is available, please try later.

Wait until the SNMP retrieval is done and retry the CLI command.


Note Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration.


Examples

The following example shows sample output for the show cable modem access-group command on a Cisco uBR7200 series router for a particular CM:

Router# show cable modem 0010.7bb3.fcd1 access-group 
MAC Address    IP Address      Access-group
0010.7bb3.fcd1 10.20.113.2     34 
Upstream Power     : 42 dBmV (SNR = 10 dBmV)
Downstream Power   : 15 dBmV (SNR = 15 dBmV)
Router# 

Note The upstream and downstream power fields will be displayed only if the CM remote-query feature has been enabled using the cable modem remote-query command.


The following example shows sample output for the show cable modem access-group command for a particular cable interface on a Cisco uBR10012 router:

Router# show cable modem c8/1/0 access-group 
MAC Address    IP Address      Access-group
0050.7366.1243 22.1.1.11       1 
0002.b970.0027 23.1.1.10       1 
0006.5314.858d 22.1.1.10       N/A 
Router# 

Table 0-85 describes the fields that are shown in the show cable modem access-group display:

Table 0-85 Descriptions for the show cable modem access-group Fields 

Field
Description

MAC Address

The MAC address for the CM.

IP Address

The IP address that the DHCP server has assigned to the CM.

Access-group

Displays the access group name or number in use (if any) for this CM.



Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable device access-group

Displays a list of CMs and their CPE devices, along with their access groups.

show cable host access-group

Displays a list of hosts and other CPE devices, along with their access groups.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem auth-profile

To display the multicast authorization profile, and profile group information for a particular IP address or MAC address, use the show cable modem auth-profile command in privileged EXEC mode.

show cable modem [ip-address | mac-address] [auth-profile]

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a CM that is displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a CM that is displayed. You can also specify the MAC address for a CPE device behind a CM, and information for that CM will be displayed.

auth-profile

(Optional) Displays the multicast authorization profile, and profile group information.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.


Usage Guidelines

Use this command to display the multicast authorization profile, and the profile group information.

Examples

The following sample output of the show cable modem auth-profile command shows the multicast authorization profile and profile group display for a particular ip-address or mac-address.

Router# show cable modem 30.17.2.23 auth-profile
Multicast Profile Information for 0025.2e34.4377
IP: 30.17.2.121
Multicast Profile Group #           : default
Router#

Related Commands

Command
Description

show cable multicast authorization

Displays the list of defined multicast authorization profiles and all CMs associated with corresponding profiles.

show cable multicast dsid

Displays the entire multicast downstream service identifier (DSID) database content.

show cable multicast qos

Displays the configuration information for MQoS (Group-Config, Group-QoS-Config, Group-Encryption-Config).


show cable modem calls

To display voice call information for a particular CM, use the show cable modem calls command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] calls

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] calls

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

calls

Display voice call information for a CM.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(13a)BC1

Support for voice call information was added to the show cable modem command.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain name of a CM.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


This command supports PacketCable and PacketCable MultiMedia (PCMM) information. Additional information for voice call support with PacketCable and PacketCable MultiMedia (PCMM) is available in the feature document PacketCable and PacketCable Multimedia for the Cisco CMTS available on Cisco.com:

Examples

The following example shows sample output for the default calls option for a particular CM:

Router# show cable modem calls
Cable Modem Call Status Flags:
H: Active high priority calls
R: Recent high priority calls
V: Active voice calls (including high priority)
MAC Address    IP Address      I/F       Prim  CMCallStatus  LatestHiPriCall
                                         Sid                    (min:sec)
000f.66f8.a121 10.8.130.63     C4/0/U0   175   HV                   -

Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable calls

Displays voice call history information and status for the PacketCable Emergency 911 Services Listing and History feature.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem classifiers

To display information about the classifiers for a particular CM, use the show cable modem classifiers command in privileged EXEC mode.

show cable modem {ip-address | mac-address} [name fqdn] classifiers [cache | verbose]

Syntax Description

ip-address

Specifies the IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, classifier information for that CM is displayed.

mac-address

Displays classifier information for the CM with the specified MAC address. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

cache

(Optional) Displays the classifiers in the cache maintained for each CM. (This cache is based on IP header field values and speeds up classifier lookups and reduces per-packet processing overhead.)

verbose

(Optional) Displays detailed information for the CM classifiers.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3 NA

This command was introduced.

12.1(4)CX and 12.2(4)BC1

The number of matches field was added to this command, and the command was restricted to display information for a single CM at a time.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.


Usage Guidelines

This command displays classifier information for a particular CM, identified either by its IP address, MAC address, or domain name.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.



Note For information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration, see the "Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration" section of the show cable modem command.


Examples

The following example shows sample output for the default classifiers option for a particular CM:

Router# show cable modem 10.4.0.81 classifiers 
CfrId  SFID     CM Mac Address  Direction  State    Priority  Matches
6431   26120    0000.399f.a44f  upstream   active   128       -
6429   26054    0000.399f.a44f  upstream   active   128       -
6432   26121    0000.399f.a44f  downstream active   128       1182
6430   26055    0000.399f.a44f  downstream active   128       3934
Router# 

Table 86 describes the fields that are shown in the show cable modem classifiers display:

Table 86 Descriptions for the show cable modem classifiers Fields 

Field
Description

CfrID

Classifier ID for the classifier that is being displayed.

SFID

Service flow ID (SFID) for this classifier.

CM MAC Address

MAC address for the CM.

Direction

Identifies whether this classifier applies to the downstream or the upstream direction.

State

Classifier activation state: active or inactive.

Priority

Classifier rule priority value for this classifier.

Matches

Number of packets that have been matched to this service flow.



Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem cnr

To display information about the upstream carrier-to-noise ratio (CNR) or signal-to-noise ratio (SNR) for a particular cable modem (CM), use the show cable modem command in privileged EXEC mode.

show cable modem {ip-address | mac-address | name fqdn} cnr

Syntax Description

ip-address

IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a customer premise equipment (CPE) device behind a CM, classifier information for that CM is displayed.

mac-address

Classifier information for the CM with the specified MAC address. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

name fqdn

Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable domain name system (DNS) cache on the Cisco CMTS router.


Command Modes

Privileged EXEC (#)

Command History

This table includes the following release-specific history entries:

BC Release

CX Release

SC Release

BC Release
Modification

12.2(4)BC2

The command was changed to its current form of show cable modem cnr.

12.2(8)BC2

Support was added for the Cisco uBR-LCP2-MC16S cable interface line card on the Cisco uBR10012 router.

12.2(11)BC3

Support was added for the Cisco uBR10-MC5X20S cable interface line cards on the Cisco uBR10012 router.

12.2(15)BC1

If a cable modem is offline, its CNR value is now shown as "-----".

12.2(15)BC2

Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC5X20U cable interface line cards.

12.3(17a)BC2

Support was added for the Cisco uBR-MC5X20H cable interface line card.

CX Release
Modification

12.1(7)CX1

This command was introduced (in the form of show cable modem snr) for Cisco uBR7200 series routers using the Cisco uBR-MC16S cable interface line card.

12.2(15)CX

Support was added for the Cisco uBR-MC28U/X cable interface line cards on the Cisco uBR7246VXR router.

SC Release
Modification

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—Cisco CMTS router has seen SOLICIT message.

init6(a)—Cisco CMTS router has seen ADVERTISE message.

init6(r)—Cisco CMTS router has seen REQUEST message.

init6(i)—Cisco CMTS router has seen REPLY message.

init6(o)—Cisco CMTS router has seen version 6 TFTP request.

init6(t)—Cisco CMTS router has seen version 6 TOD request.

12.2(33)SCC

The output of this command was modified to show the CNR and SNR information for multiple upstream connections providing service to a single CM.

12.2(33)SCF

The output of this command was modified to show expected power level, received carrier power level, and CNR information for all the upstream channels providing services to a CM. The SNR information is no longer displayed in the output of this command.


Usage Guidelines

The show cable modem cnr command displays information on the current CNR value for cable modems that are using interfaces on the following cable line cards:

Cisco uBR-MC16U/X

Cisco uBR-MC28U/X

Cisco uBR10-MC5X20S/U/H

Cisco uBR-E-28U

Cisco uBR-E-16U

For cable modems on all other interfaces, this command displays information about the current SNR value of the modem.

In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the Cisco CMTS router before any domain name can be used as part of a cable command.

Starting Cisco IOS Release 12.2(33)SCF, carrier-to-noise plus interference ratio (CNiR [CNR]) can be measured for all upstream channels irrespective of whether spectrum management is enabled or not for the upstream channels. Therefore, the output of the show cable modem cnr command displays only the CNR (CNiR) values for all the upstream channels for a specific cable modem.

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address cnr command might not show a particular cable modem until the Cisco CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address cnr command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when the HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond with a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Cisco IOS Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Examples

The following example is a sample output of the show cable modem cnr command for a CM:

Router# show cable modem 10.20.114.34 cnr 
MAC Address    IP Address      I/F         MAC         Prim  snr/cnr
                                           State       Sid   (db)
00d0.ba77.7595 10.20.114.34    Cable3/0/U5 online      1     45.00

The following example is a sample output of the show cable modem cnr command after an HCCP switchover. The CNR value is missing until traffic is sent to the cable modem (in this case using the ping command).

Router# show cable modem 10.10.10.46 cnr 
MAC Address    IP Address      I/F         MAC         Prim  snr/cnr 
                                           State       Sid   (db)
0002.fd22.aadf 10.10.10.46     C5/1/0/U5   online      1970  ----- 
Router# ping 10.10.10.46 
Router# show cable modem 10.10.10.46 cnr 
MAC Address    IP Address      I/F         MAC         Prim  snr/cnr 
                                           State       Sid   (db)
0002.fd22.aadf 10.10.10.46     C5/1/0/U5   online      1970  42.00 

The following example is a sample output of the show cable modem cnr command for all upstream ports providing service to a specified cable modem in Cisco IOS Release 12.2(33)SCC:

Router# show cable modem 0014.f8c1.fd1a cnr
MAC Address    IP Address      I/F         MAC         SID   snr/cnr
                                           State             (dB)
0014.f8c1.fd1a 10.10.4.1       C5/0/1/U0   online        1        33
001e.6bfb.119a 9.9.9.2         C5/0/1/U1   online        2        33
001e.6bfb.0f9e 9.9.9.3         C5/0/1/U2   online        3        33
0019.474a.d4c4 9.9.9.4         C5/0/1/U3   online        4        33

The following example is a sample output of the show cable modem cnr command for an upstream port providing service to a specified cable modem in Cisco IOS Release 12.2(33)SCF:

Router# show cable modem 0022.cea4.f0fa cnr
MAC Address    IP Address     I/F         MAC          Prim ExPwr  RxPwr  cnr
                                          State        Sid  (dBmv) (dBmv) (dB)
0022.cea4.f0fa 10.10.1.62     C8/1/14/U3  w-online     78   0.0    -0.50  23

Table 87 describes the significant fields shown in the display:

Table 87 show cable modem cnr Field Descriptions 

Field
Description

MAC Address

MAC address of the CM.

IP Address

IP address that the DHCP server has assigned to the CM.

I/F

Cable interface line card providing the upstream for this CM.

MAC State

Current state of the MAC layer (see Table 101).

Prim Sid

Primary Sid assigned to this CM.

In Cisco IOS Release 12.2(33)SCC, this field is renamed to SID and represents multiple upstream connections with unique SIDs providing service to a single CM.

ExPwr (dBmv)

Expected carrier power level, in decibel millivolts (dBmv).

RxPwr (dBmv)

Received carrier power level, in decibel millivolts (dBmv).

snr/cnr (db)

The current upstream CNR or SNR for this particular CM, in decibels (dB). In Cisco IOS Release 12.2(15)BC1 and later releases, this field shows "-----" for offline cable modems.

Note You can also use the show controllers cable command to display the SNR or CNR for a cable interface line card, but this value is only an estimate because it uses a random sampling of modems to determine the average for the card at any particular time. The CNR value shown by the show controllers cable command can therefore appear to fluctuate compared to the individual values shown by the show cable modem cnr command.


Table 101 shows the possible values for the MAC state field.

Table 88 MAC State Field Descriptions 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

CM sent initial ranging.

init(r2)

CM is ranging. The Cisco CMTS received initial ranging from the CM and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

Cable modem has broadcast a DHCP REQUEST packet back to the DHCP server.

init(i)

Cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

Cisco CMTS learns the DHCP offer that is sent to the cable modem from the DHCP server, which has assigned an IP address to the modem.

init(o)

CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (ToD) exchange has started.

resetting

CM is being reset and will shortly restart the registration process.

 

init6(s)

Cisco CMTS router learns the DHCPv6 SOLICIT message from the CM.

init6(a)

Cisco CMTS router learns the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

Cisco CMTS router learns the REQUEST response from the CM to the DHCPv6 server.

init6(i)

Cisco CMTS router learns the REPLY message from the DHCPv6 server to the CM.

init6(o)

Cisco CMTS router learns the REQUEST message from the CM to the TFTP server.

init6(t)

Cisco CMTS router learns the REQUEST message from the CM to the ToD server.

Non-error Status Conditions

cc(r1)

CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the Cisco CMTS. The CM has begun moving to the new channel, and the Cisco CMTS has received the initial ranging of the CM on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

CM is considered offline (disconnected or powered down).

online

CM has registered and is enabled to pass data on the network.

online(d)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the Cisco CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

CM is registered, BPI is enabled and KEK is assigned.

online(pt)

CM is registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

CM is registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

CM is registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the Cisco CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

CM attempted to register, but registration was refused due to a a number of possible errors:

CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

CM has been disabled because of a security violation.

Bad class of service (CoS) value in the DOCSIS configuration file.

CM attempted to create a new CoS configuration but the Cisco CMTS is configured to not permit such changes.

CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and Cisco CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the Cisco CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modulation-profile

Displays modulation profile group information.

show cable modem remote-query

Displays information collected by the remote-query feature.

show controllers cable

Displays information about the interface controllers for a cable interface on the Cisco CMTS router.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem connectivity

To display connectivity statistics for one or more CMs, use the show cable modem connectivity command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] connectivity

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] connectivity

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX and 12.2(4)BC1

This command was introduced (and the connectivity option was removed from the show interface cable sid command).

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays connectivity information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, as identified by its IP address or MAC address.

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.



Note The show cable modem connectivity command replaces the connectivity option for the show interface cable sid command, because the connectivity statistics are better managed on a per-modem basis than on a per-SID basis.


Examples

The following example shows sample output for the show cable modem connectivity command for all online CMs:

Router# show cable modem connectivity 
Prim  1st time    Times  %online     Online time            Offline time
Sid   online      Online          min     avg     max     min     avg     max
1     Apr 28 2003 1      99.67   00:00   1d1h9m  1d1h9m  05:38   04:58   05:38  
2     Apr 28 2003 1      99.66   00:00   1d1h8m  1d1h8m  05:46   05:02   05:46  
3     Apr 28 2003 1      99.69   00:00   1d1h7m  1d1h7m  05:18   04:34   05:18  

The following example shows sample output for the show cable modem connectivity command for all online CMs for a particular cable interface:

Router# show cable modem c8/1/0 connectivity 
Prim  1st time    Times  %online     Online time            Offline time
Sid   online      Online          min     avg     max     min     avg     max
1     Apr 28 2003 1      99.67   00:00   1d1h12m 1d1h12m 05:38   04:58   05:38  
2     Apr 28 2003 1      99.66   00:00   1d1h11m 1d1h11m 05:46   05:02   05:46  
3     Apr 28 2003 1      99.69   00:00   1d1h11m 1d1h11m 05:18   04:34   05:18  

The following example shows sample output for the show cable modem connectivity command for a particular CM:

Router# show cable modem 0010.7bb3.fcd1 connectivity 
Prim  1st time    Times  %online     Online time            Offline time
Sid   online      Online          min     avg     max     min     avg     max
1     May 30 2000 4      99.85   48:20   11h34m  1d2h23m 00:01   00:59   03:00 

Table 89 describes the information shown in the show cable modem connectivity displays:

Table 89 Descriptions for the show cable modem connectivity Fields 

Field
Description

Prim SID

The primary SID assigned to this CM.

1st time online

First time at which the modem with this SID connected.

Times online

Number of times the modem with this SID connected.

% online

Percentage of time the modem with this SID has been connected.

Online time

The minimum, average, and maximum number of days, hours, and minutes the modem with this SID has been connected.

Note A CM is considered online when it has completed the registration process and has communicated with the DHCP, TFTP, and TOD servers.

Offline time

The minimum, average, and maximum number of days, hours, and minutes the modem with this SID has been disconnected.

Note A CM is considered offline after it has missed 16 consecutive station maintenance messages.



Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem counters

To display downstream and upstream traffic counters for one or more cable modems (CMs), use the show cable modem counters command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] counters

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] counters

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

counters

Displays downstream and upstream traffic counters for one or more cable modems.


Defaults

Displays counter information for all CMs.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX and 12.2(4)BC1

This command was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.



Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Examples

The following example shows sample output for the show cable modems counters command for all CMs:

Router# show cable modem counters 
MAC Address    US Packets   US Bytes   DS Packets   DS Bytes
0050.7366.1243 29           2126       29           2126      
0002.b970.0027 1811         116174     29           2126      
0006.5314.858d 329154       21071059   134607       9961268   
Router# 

The following example shows sample output for the show cable modems counters command for all CMs on a particular cable interface:

Router# show cable modem c8/1/0 counters 
MAC Address    US Packets   US Bytes   DS Packets   DS Bytes
0050.7366.1243 29           2126       29           2126      
0002.b970.0027 1811         116174     29           2126      
0006.5314.858d 329154       21071059   134607       9961268   
Router# 

The following example shows sample output for the show cable modems counters command for a particular CM, as identified by its MAC address:

Router# show cable modem 0010.7bb3.fcd1 counters 
MAC Address    US Packets   US Bytes   DS Packets   DS Bytes
0010.7bb3.fcd1 1452082      171344434  1452073      171343858 
Router# 

The following example shows sample output for the show cable modems counters command for a particular CM, as identified by its IP address:

Router# show cable modem 23.1.1.10 counters 
MAC Address    US Packets   US Bytes   DS Packets   DS Bytes
0002.b970.0027 1811         116174     29           2126      
Router# 

Table 90 describes the fields shown in the show cable modem counters displays:

Table 90 Descriptions for the show cable modem counters Fields 

Field
Description

MAC Address

MAC address for the CM.

US Packets

Number of packets this CM has transmitted on the upstream.

US Bytes

Number of bytes this CM has transmitted on the upstream.

DS Packets

Number of packets this CM has received on the downstream.

DS Bytes

Number of byte this CM has received on the downstream.


Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem qos

Displays quality of service (QoS) and service flow information for a particular CM.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem cpe

To display the customer premise equipment (CPE) devices accessing the cable interface through a particular cable modem (CM), use the show cable modem cpe command in privileged EXEC mode.

show cable modem {ip-address | mac-address | name fqdn} cpe

Syntax Description

ip-address

Displays the CPE devices for the CM with the specified IPv4 or IPv6 address.

mac-address

Displays the CPE devices for the CM with the specified MAC address.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.1(4)CX and 12.2(4)BC1

The command was simplified to display only the IP and MAC addresses for the CPE devices.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.


Usage Guidelines

This command lists the CPE devices that are accessing the cable network through a particular CM. You can identify the CM either by its IP address or by its MAC address.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Examples

The following example shows sample output for the show cable modem cpe command, listing the CPE devices by their MAC and IP addresses:

Router# show cable modem 0019.474a.c14a cpe     
IP address        MAC address      Dual IP
50.3.37.3        0005.0052.2c1d      Y

Table 100 describes the significant fields shown in the display.

Table 91 show cable modem cpe Field Descriptions 

Field
Description

IP Address

IP address acquired by the CPE.

MAC Address

MAC address of the CPE.

Dual IP

Dual IP flag. Identifies whether or not ("Y" or "N") the CPE supports both IPv4 and IPv6 addressing.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem docsis device-class

To display the DOCSIS device-class information for cable modems (CMs) on all or specified cable interfaces and upstreams, use the show cable modem docsis device-class command in privileged EXEC configuration mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem docsis device-class [summary [cable slot/subslot [cable slot/subslot] [upstream port1 port2]]] [total]

show cable modem cable slot/subslot docsis version summary

Cisco uBR10012 Router

show cable modem docsis device-class [summary [cable slot/subslot/port [cable slot/subslot/port] [upstream port1 port2]]] [total]

show cable modem cable slot/subslot/port docsis version summary

Syntax Description

summary

(Optional) Displays a summary of DOCSIS device class information for CMs on all or specified cable interfaces on the CMTS router.

cable slot/subslot [cable slot/subslot]

(Optional) Specifies a single cable interface, or a range of cable interfaces on a Cisco uBR7100 or Cisco uBR7200 series router, whose CMs you want to display information about, where:

slot—Specifies the chassis slot number of the cable interface line card.

subslot—Specifies the downstream port number.

Valid values for these arguments are dependent on your CMTS router and cable interface line card. Refer to the hardware documentation for your router chassis and cable interface line card for supported slot and port numbering.

cable slot/subslot/port [cable slot/subslot/port]

(Optional) Specifies a single cable interface, or a range of cable interfaces on a Cisco uBR10012 router, whose CMs you want to display information about, where:

slotSpecifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8.

subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.

upstream port1 port2

(Optional) Specifies a specific upstream port, or a range of upstream ports on the specified cable interface(s), whose CMs you want to display information about, where:

port1—Specify only port1 if you want to display information about a single upstream. When used with the port2 argument, specifies the beginning of a range of upstream ports, and port1 must be a lower-numbered port than port2.

port2—Specifies the end of a range of upstream ports, and port2 must be a higher-numbered port than port1.

total

(Optional) Displays a total of DOCSIS device-class information for the CMs connected to all interfaces, or to the specified cable interfaces.


Command Default

The default form of the command (show cable modem docsis device-class without any options) provides DOCSIS device class information for all CMs on the CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(21)BC

This command was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.


Usage Guidelines

This command displays a summary of DOCSIS device-class information for all CMs for a single cable interface, or for a range of cable interfaces, and optionally specified upstreams on those cable interfaces.

Examples

The following example shows typical output for the default form of the show cable modem docsis device-class command on a Cisco uBR100012 router:

Router# show cable modem docsis device-class
MAC Address    I/F       MAC            Prim  Reg      Device Class     Reg 
                         State          Sid   Ver  -------------------- Priv
0030.80bc.22b9 C3/0/U0   online(pt)     1     1.0  CM                   BPI 
0000.cadb.04b2 C3/0/U0   online(pt)     2     1.1  eCM eMTA             BPI+
0000.cadb.0512 C3/0/U0   online(pt)     3     1.1  eCM eMTA eSTB        BPI+
0003.e38f.f5c7 C3/0/U1   online(pt)     4     1.0  CM                   BPI 
0000.cadb.0bae C3/0/U1   online(pt)     5     1.1  eCM           ePS    BPI+
0010.7b6b.77ed C3/0/U2   online         6     1.0  CM                       
0000.cadb.0356 C4/0/U0   online(pt)     1     1.1  eCM eMTA             BPI+
0000.cadb.02a6 C4/0/U0   init(d)        2     n/a  <unavailable>                 
0000.cadb.2f7a C4/0/U1   online(pt)     3     2.0  eCM      eSTB        BPI+
0000.cadb.2952 C4/0/U2   online(pt)     4     1.1  eCM      eSTB ePS    BPI+
0000.cadb.0236 C4/0/U2   init(d)        6     n/a  <unavailable>                 
0003.e3a6.850d C4/0/U3   online(pt)     7     1.1  eCM eMTA      ePS    BPI+ 
0003.e3a6.85ad C4/0/U3   online(pt)     8     1.0  CM                   BPI

The following example shows sample output for the show cable modem docsis device-class command for a particular cable interface, in chassis slot 3 and subslot 0:

Router# show cable modem cable3/0 docsis device-class
MAC Address    I/F       MAC            Prim  Reg      Device Class     Reg 
                         State          Sid   Ver  -------------------- Priv
0030.80bc.22b9 C3/0/U0   online(pt)     1     1.0  CM                   BPI 
0000.cadb.04b2 C3/0/U0   online(pt)     2     1.1  eCM eMTA             BPI+
0000.cadb.0512 C3/0/U0   online(pt)     3     1.1  eCM eMTA eSTB        BPI+
0003.e38f.f5c7 C3/0/U1   online(pt)     4     1.0  CM                   BPI 
0000.cadb.0bae C3/0/U1   online(pt)     5     1.1  eCM           ePS    BPI+
0010.7b6b.77ed C3/0/U2   online         6     1.0  CM                       

Table 92 show cable modem docsis device-class Field Descriptions

Field
Description

MAC Address

The MAC address of the CM.

I/F

The cable interface line card providing the upstream for this CM.

MAC State

The current state of the MAC layer.

Prim Sid

The primary SID assigned to this CM.

Reg Ver

Displays the maximum supported version of DOCSIS that the CM supports. The possible values are: DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0, and DOCSIS 3.0. Shows "n/a" if the modem is not online.

Device Class

Displays the device-class information for the PacketCable device. The modem can report its device-class type during registration. The possible values are:

CM or eCM—A standalone cable modem or embedded CM.

ePS—Embedded Portal Services

eMTA—Embedded Multimedia Terminal Adapter

eSTB—Embedded Set Top Box

unavailable—The CM has not reported its device class.

Reg Priv

Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.


Examples for Summary and Total Options

The following example shows the corresponding display for the show cable modem docsis device-class total command:

Router# show cable modem docsis device-class total  
              Online  unrep CM    eCM   eMTA  eSTB  ePS
Total:        13      2     4     7     4     3     3     

The following example shows sample output for the show cable modem docsis device-class summary form of the command on a Cisco CMTS router:

Router# show cable modem docsis device-class summary
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Cable4/0/U0   2       1     0     1     1     0     0     
Cable4/0/U1   1       0     0     1     0     1     0     
Cable4/0/U2   2       1     0     1     0     1     1     
Cable4/0/U3   2       0     1     1     1     0     1     

The following example shows sample output for the show cable modem docsis device-class summary command with the total option on a Cisco CMTS router:

Router# show cable modem docsis device-class summary total
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Cable4/0/U0   2       1     0     1     1     0     0     
Cable4/0/U1   1       0     0     1     0     1     0     
Cable4/0/U2   2       1     0     1     0     1     1     
Cable4/0/U3   2       0     1     1     1     0     1     
Total:        13      2     4     7     4     3     3     

The following example shows sample output for the show cable modem docsis device-class summary total command for all enabled upstreams on a specific cable interface line card on a Cisco CMTS router:

Router# show cable modem docsis device-class summary cable 3/0 total
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Total:        6       0     3     3     2     1     1     

The following example shows sample output for the show cable modem docsis device-class summary total command for a range of interfaces on a Cisco CMTS router:

Router# show cable modem docsis device-class summary cable 3/0 cable 4/0 total
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Cable4/0/U0   2       1     0     1     1     0     0     
Cable4/0/U1   1       0     0     1     0     1     0     
Cable4/0/U2   2       1     0     1     0     1     1     
Cable4/0/U3   2       0     1     1     1     0     1     
Total:        13      2     4     7     4     3     3     

The following example shows sample output for the show cable modem docsis device-class summary total command for a range of interfaces and upstreams on a CMTS router:

Router# show cable modem docsis device-class summary cable 3/0 cable 4/0 upstream 0 2 
total
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Cable4/0/U0   2       1     0     1     1     0     0     
Cable4/0/U1   1       0     0     1     0     1     0     
Cable4/0/U2   2       1     0     1     0     1     1     
Total:        11      2     3     6     3     3     2     

The following example shows sample output for the show cable modem docsis device-class summary total command for a range of upstreams on an interface:

Router# show cable modem docsis device-class summary cable3/0 upstream 0 1 total        
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Total:        5       0     2     3     2     1     1     

The following example shows sample output for the show cable modem docsis device-class summary command for all enabled upstreams on a specific cable interface line card:

Router# show cable modem cable3/0 docsis device-class summary
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Total:        6       0     3     3     2     1     1     

Table 93 show cable modem docsis device-class summary Field Descriptions

Field
Description

Interface

Name of the cable interface and associated upstreams on the Cisco CMTS router.

Online

Total number of CMs currently online on this cable interface.

unrep

Total number of CMs on this interface for which the device-class information is unreported or unavailable.

CM

Total number of CMs on this interface that have a reported device class as a standalone cable modem.

eCM

Total number of CMs on this interface that have reported the device class as an embedded cable modem.

eMTA

Total number of CMs on this interface that have reported the device class as an embedded multimedia terminal adapter.

eSTB

Total number of CMs on this interface that have reported the device class as an embedded set-top box.

ePS

Total number of CMs on this interface that have reported the device class as embedded portal services.

Total

The total number of all CMs reported online and for a given DOCSIS device class across all cable interfaces on the Cisco CMTS router.


Related Commands

Command
Description

show cable modem docsis version

Displays the DOCSIS version information for CMs on one or more cable interfaces and upstreams.


show cable modem docsis version

To display the DOCSIS version information for cable modems (CMs) on one or more cable interfaces and upstreams, use the show cable modem docsis version command in privileged EXEC configuration mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem docsis version [summary [cable {slot/port | slot/cable-interface-index} [cable {slot/port | slot/cable-interface-index}] [upstream port1 port2 [logical-channel-index]]]] [total]

show cable modem cable {slot/port | slot/cable-interface-index} docsis version summary

Cisco uBR10012 Router

show cable modem docsis version [summary [cable {slot/subslot/port | slot/subslot/cable-interface-index} [cable {slot/subslot/port | slot/subslot/cable-interface-index}] [upstream port1 port2 [logical-channel-index]]]] [total]

show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} docsis version summary

Syntax Description

summary

(Optional) Displays a summary of DOCSIS device class information for CMs on all or specified cable interfaces on the CMTS router.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port1 port2

(Optional) Specifies a specific upstream port, or a range of upstream ports on the specified cable interface(s), whose cable modems you want to display information about, where:

port1—Specify only port1 if you want to display information about a single upstream. When used with the port2 argument, specifies the beginning of a range of upstream ports, and port1 must be a lower-numbered port than port2.

port2—Specifies the end of a range of upstream ports, and port2 must be a higher-numbered port than port1.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

total

(Optional) Displays a total of DOCSIS device-class information for the CMs connected to all interfaces, or to the specified cable interfaces.

docsis version summary

Displays the DOCSIS version information for cable modems on one or more cable interfaces and upstreams.


Command Default

The default form of the command (show cable modem docsis version without any options) provides DOCSIS version information for all CMs on the CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC

This command was introduced.

12.2(33)SCB

This command was integrated into Cisco IOS Release 12.2(33)SCB.

12.3(23)BC7

The output for the show cable modem docsis version summary total forms of the command were modified.

12.2(33)SCD2

This command was modified. The command output was modified to display the cable modems that are in upstream and downstream partial service mode.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays a summary of DOCSIS version information for all CMs for a single cable interface or upstream, or for a range of cable interfaces or upstreams.

Examples

Examples: show cable modem docsis version Command

The following example shows typical output for the default form of the show cable modem docsis version command on a Cisco uBR10012 router:

Router# show cable modem docsis version
MAC Address    I/F       MAC            Prim  Reg QoS  US Phy DS Chl
                         State          Sid   Ver Prov Mode   Mode
0018.6852.800a C5/1/0/U3 w-online(pt)   166   2.0 1.1  tdma   WB    
0018.6852.7f92 C5/1/0/U1 w-online(pt)   167   2.0 1.1  tdma   WB    
0014.bfbe.3ea6 C5/1/0/U0 w-online(pt)   168   2.0 1.1  tdma   WB    
0018.6852.8022 C5/1/0/U2 w-online(pt)   169   2.0 1.1  tdma   WB    
0018.6852.7fa0 C5/1/0/U0 w-online(pt)   170   2.0 1.1  tdma   WB    
0018.6852.8016 C5/1/0/U3 w-online(pt)   171   2.0 1.1  tdma   WB    
0018.6852.8008 C5/1/0/U2 w-online(pt)   172   2.0 1.1  tdma   WB    
0018.6852.800e C5/1/0/U1 w-online(pt)   173   2.0 1.1  tdma   WB    
0018.6852.8000 C5/1/0/U1 w-online(pt)   174   2.0 1.1  tdma   WB    
0002.8a8c.ed06 C5/1/1/U0 online(pt)     79    2.0 1.1  tdma   NB    
0018.6852.801c C5/1/1/U0 w-online(pt)   80    2.0 1.1  tdma   WB    
0018.6852.8006 C5/1/1/U0 w-online(pt)   81    2.0 1.1  tdma   WB    
00e0.6f2c.6a4e C5/1/1/U0 online(pt)     82    1.1 1.1  tdma   NB    
0011.ae02.a63c C5/1/3/U0 online(pt)     37    2.0 1.1  tdma   NB    
0011.ae00.c514 C5/1/3/U0 online(pt)     38    2.0 1.1  tdma   NB    

The following example shows sample output for the show cable modem docsis version command for a particular cable interface on a Cisco uBR10012 router:

Router# show cable modem cable 5/1/0 docsis version        
MAC Address    I/F       MAC            Prim  Reg QoS  US Phy DS Chl
                         State          Sid   Ver Prov Mode   Mode
0018.6852.800a C5/1/0/U3 w-online(pt)   166   2.0 1.1  tdma   WB    
0018.6852.7f92 C5/1/0/U1 w-online(pt)   167   2.0 1.1  tdma   WB    
0014.bfbe.3ea6 C5/1/0/U0 w-online(pt)   168   2.0 1.1  tdma   WB    
0018.6852.8022 C5/1/0/U2 w-online(pt)   169   2.0 1.1  tdma   WB    
0018.6852.7fa0 C5/1/0/U0 w-online(pt)   170   2.0 1.1  tdma   WB    
0018.6852.8016 C5/1/0/U3 w-online(pt)   171   2.0 1.1  tdma   WB    
0018.6852.8008 C5/1/0/U2 w-online(pt)   172   2.0 1.1  tdma   WB    
0018.6852.800e C5/1/0/U1 w-online(pt)   173   2.0 1.1  tdma   WB    
0018.6852.8000 C5/1/0/U1 w-online(pt)   174   2.0 1.1  tdma   WB    

Table 94 describes the significant fields shown in the display.

Table 94 show cable modem docsis version Field Descriptions

Field
Description

MAC Address

The MAC address of the CM.

I/F

The cable interface line card providing the upstream for this CM.

MAC State

The current state of the MAC layer.

Prim Sid

The primary SID assigned to this CM.

Reg Ver

Displays the maximum supported version of DOCSIS that the CM supports. The possible values are: 1.0, 1.1, 2.0, and 3.0. Shows "n/a" if the modem is not online.

QoS Prov

Displays the version of DOCSIS that the CM currently is provisioned and registered for. The possible values are: 1.0 or 1.1. Shows "n/a" if the modem is not online.

US Phy Mode

Displays the DOCSIS operating mode for the CM, with the following possible values:

tdma—DOCSIS 1.X, Time Division Multiple Access (TDMA)-only mode

atdma—DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode

scdma—DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode

Note This field is the same as that returned by the docsIfCmtsCmStatusModulationType object in the DOCS-IF-MIB.

DS Chl Mode

Displays the downstream channel mode for the CM, with the following possible values:

NB—Narrowband

WB—Wideband


Examples: show cable modem version docsis version total Command

The following example shows the corresponding display for the show cable modem docsis version total command:

Router# show cable modem docsis version total
Total Registered CMs:   15
Total Unregistered CMs: 0
Total DOCSIS 3.0 Operating/Capable/Registered CMs: 0/0/0
Total DOCSIS 2.0 Operating/Capable/Registered CMs: 0/14/14
Total DOCSIS 1.1 Operating/Capable/Registered CMs: 15/15/1
Total DOCSIS 1.0 Operating/Capable/Registered CMs: 0/15/0
Total v1.1 US QoS operating CMs: 15
Total V1.0 US QoS operating CMs: 0
Total Wide Band US operating CMs: 0
Total scdma US Phy operating CMs: 0
Total atdma US Phy operating CMs: 0
Total tdma US Phy operating CMs:  15
Total Wide Band DS operating CMs:   11
Total Narrow Band DS operating CMs: 4

Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version total command was modified to display the cable modems that are in partial service mode as shown in the following example:

Router# show cable modem docsis version total
Total Registered CMs:   35
Total Unregistered CMs: 1
Total DOCSIS 3.0 Operating/Capable/Registered CMs: 21/22/22
Total DOCSIS 2.0 Operating/Capable/Registered CMs: 0/34/12
Total DOCSIS 1.1 Operating/Capable/Registered CMs: 35/35/1
Total DOCSIS 1.0 Operating/Capable/Registered CMs: 0/35/0
Total v1.1 US QoS operating CMs: 35
Total V1.0 US QoS operating CMs: 0
Total Wide Band US operating CMs: 21
Total Wide Band US partial-mode CMs: 9
Total scdma US Phy operating CMs: 0
Total atdma US Phy operating CMs: 0
Total tdma US Phy operating CMs:  14
Total Wide Band DS operating CMs:   22
Total Wide Band DS partial-mode CMs: 12
Total Narrow Band DS operating CMs: 13

Table 95 describes the fields shown in the show cable modem docsis version total command display.

Table 95 show cable modem docsis version total Field Descriptions

Field
Description

Total Registered CMs

Total number of cable modems currently online in a CMTS router.

Total Unregistered CMs

Total number of cable modems that are either offline and not currently communicating with the CMTS router, or that are attempting to come online but are not yet registered.

Total DOCSIS x.y Operating/Capable/Registered CMs: a/b/c

Total number of cable modems (in a/b/c format) for the specified DOCSIS version (x.y) that have the following status:

Operating—Total number (a) of CMs currently operating in the specified DOCSIS version.

Capable—Total number (b) of CMs that can operate in the specified DOCSIS version, but might not be operating in that version.

Registered—Total number (c) of CMs that are currently registered in the specified DOCSIS version.

Total Vx.y US QoS operating CMs

Total number of cable modems whose upstreams are currently operating in a specified DOCSIS version (x.y) quality of service (QoS).

Total Wide Band US operating CMs

Total number of cable modems with upstreams currently operating in wideband channel mode.

Total Wide Band US partial-mode CMs

Total number of cable modems with upstreams currently operating in partial wideband channel mode.

Total mode US Phy operating CMs

Total number of cable modems with upstreams currently operating in a particular wideband channel mode, where mode is:

scdma—DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode

atdma—DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode

tdma—DOCSIS 1.X, Time Division Multiple Access (TDMA) mode

Total Wide Band DS operating CMs

Total number of cable modems with downstreams operating in wideband channel mode.

Total Wide Band DS partial-mode CMs

Total number of cable modems with downstreams operating in partial wideband channel mode.

Total Narrow Band DS operating CMs

Total number of cable modems with downstreams operating in narrowband channel mode.


Examples: show cable modem docsis version summary Command

The following example shows typical output for the default form of the show cable modem docsis version summary command on a Cisco uBR10012 router:

Router# show cable modem docsis version summary
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    

Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version summary command was modified to display the cable modems that are in full or partial service mode as shown in the following example:

Router# show cable modem docsis version summary
                                Cable Modem DOCSIS Version Summary
                  DOCSIS Registered   US QoS     US Phy Mode    DOCSIS Mode
                 ------------------- --------- -------------- ----------------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 scdm atdm tdma UP  WB   WP  NB
C7/0/0/UB 12     12   0    0    0    12   0    0    0    0    9   12   12  0
C7/0/0/U0 2      0    2    0    0    2    0    0    0    2    0   0    0   2
C7/0/0/U1 1      0    1    0    0    1    0    0    0    1    0   0    0   1
C7/0/0/U3 4      0    4    0    0    4    0    0    0    4    0   0    0   4
C8/0/0/UB 9      9    0    0    0    9    0    0    0    0    0   9    0   0
C8/0/0/U0 1      1    0    0    0    1    0    0    0    1    0   1    0   0
C8/0/0/U1 5      0    4    1    0    5    0    0    0    5    0   0    0   5
C8/0/0/U3 1      0    1    0    0    1    0    0    0    1    0   0    0   1

The following example shows typical output for the show cable modem docsis version summary command with the total option on a Cisco uBR10012 router:

Router# show cable modem docsis version summary total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
Total:    15     0    14   1    0     15   0     0    0    0    15    11   4    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary total command was modified as shown in the following example:

Router# show cable modem docsis version summary total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
-----------------------------------------------------------------------------
Total:    15     v3.0: 0              v1.1: 15     WB  : 0            WB: 11
                 v2.0: 14             v1.0: 0      scdm: 0            NB: 4
                 v1.1: 1                           atdm: 0
                 v1.0: 0                           tdma: 15
-----------------------------------------------------------------------------

Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version summary total command was modified to display the cable modems that are in full or partial service mode as shown in the following example:

Router# show cable modem docsis version summary total
                                Cable Modem DOCSIS Version Summary
                  DOCSIS Registered   US QoS     US Phy Mode    DOCSIS Mode
                 ------------------- --------- -------------- ----------------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 scdm atdm tdma UP  WB   WP  NB
C7/0/0/UB 12     12   0    0    0    12   0    0    0    0    9   12   12  0
C7/0/0/U0 2      0    2    0    0    2    0    0    0    2    0   0    0   2
C7/0/0/U1 1      0    1    0    0    1    0    0    0    1    0   0    0   1
C7/0/0/U3 4      0    4    0    0    4    0    0    0    4    0   0    0   4
C8/0/0/UB 9      9    0    0    0    9    0    0    0    0    0   9    0   0
C8/0/0/U0 1      1    0    0    0    1    0    0    0    1    0   1    0   0
C8/0/0/U1 5      0    4    1    0    5    0    0    0    5    0   0    0   5
C8/0/0/U3 1      0    1    0    0    1    0    0    0    1    0   0    0   1
-----------------------------------------------------------------------------
Total:    35     v3.0: 22             v1.1: 35     UB  : 21           WB: 22
                                                   UP  : 9            WP: 12
                 v2.0: 12             v1.0: 0      scdm: 0            NB: 13
                 v1.1: 1                           atdm: 0
                 v1.0: 0                           tdma: 14
-----------------------------------------------------------------------------

Examples: show cable modem docsis version summary cable total Command

The following example shows sample output for the show cable modem docsis version summary cable total command for all enabled upstreams on a specific cable interface line card on a Cisco uBR10012 router:

Router# show cable modem docsis version summary cable 5/1/0 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
Total:    9      0    9    0    0     9    0     0    0    0    9     9    0    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable total command was modified as shown in the following example:

Router# show cable modem docsis version summary cable 5/1/0 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
-----------------------------------------------------------------------------
Total:    9      v3.0: 0              v1.1: 9      WB  : 0            WB: 9
                 v2.0: 9              v1.0: 0      scdm: 0            NB: 0
                 v1.1: 0                           atdm: 0 
                 v1.0: 0                           tdma: 9
-----------------------------------------------------------------------------

The following example shows sample output for the show cable modem docsis version summary cable total command for a range of interfaces on the Cisco uBR10012 router:

Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
Total:    15     0    14   1    0     15   0     0    0    0    15    11   4    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable total command for a range of interfaces was modified as shown in the following example:

Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
-----------------------------------------------------------------------------
Total:    15     v3.0: 0              v1.1: 15     WB  : 0            WB: 11
                 v2.0: 14             v1.0: 0      scdm: 0            NB: 4
                 v1.1: 1                           atdm: 0
                 v1.0: 0                           tdma: 15
-----------------------------------------------------------------------------

The following example shows sample output for the show cable modem docsis version summary cable upstream total command for a range of interfaces and upstreams on the Cisco uBR10012 router:

Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 upstream 0 3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
Total:    15     0    14   1    0     15   0     0    0    0    15    11   4    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable upstream total command for a range of interfaces and upstreams was modified as shown in the following example:

Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 upstream 0 3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
-----------------------------------------------------------------------------
Total:    15     v3.0: 0              v1.1: 15     WB  : 0            WB: 11
                 v2.0: 14             v1.0: 0      scdm: 0            NB: 4
                 v1.1: 1                           atdm: 0
                 v1.0: 0                           tdma: 15
-----------------------------------------------------------------------------

The following example shows sample output for the show cable modem docsis version summary cable upstream total command for a range of upstreams in an interface on the Cisco uBR10012 router:

Router# show cable modem docsis version summary cable 5/1/0 upstream 0 3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
Total:    9      0    9    0    0     9    0     0    0    0    9     9    0    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable upstream total command for a range of upstreams was modified as shown in the following example:

Router# show cable modem docsis version summary cable 5/1/0 upstream 0 3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0   
-----------------------------------------------------------------------------
Total:    9      v3.0: 0              v1.1: 9      WB  : 0            WB: 9
                 v2.0: 9              v1.0: 0      scdm: 0            NB: 0
                 v1.1: 0                           atdm: 0
                 v1.0: 0                           tdma: 9
----------------------------------------------------------------------------- 

The following example shows sample output for the show cable modem cable docsis version summary command for all enabled upstreams on a specific cable interface line card on a Cisco uBR10012 router:

Router# show cable modem cable 8/0/1 docsis version summary
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C8/0/1/U0 4      0    2    1    1     0    4     0    0    0    4     0    4

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem cable docsis version summary command for a range of upstreams was modified as shown in the following example:

Router# show cable modem cable 8/0/1 docsis version summary
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C8/0/1/U0 4      0    2    1    1     0    4     0    0    0    4     0    4

Table 96 describes the significant fields shown in the display.

Table 96 show cable modem docsis version summary Field Descriptions

Field
Description

Interface

The cable interface line card providing the upstream for this cable modem.

Online

Total number of cable modems currently online on this cable interface.

DOCSIS Registered

Total number of cable modems registered on this cable interface with the specified DOCSIS version (x.y) capabilities.

US QoS

Total number of cable modems whose upstreams are currently operating in a specified DOCSIS version (x.y) quality of service (QoS).

US Phy Mode

Total number of cable modems on this cable interface with upstreams currently operating in a particular wideband channel mode, where:

WB—Total number of upstreams on this cable interface operating in any wideband channel mode.

scdma—Total number of upstreams on this cable interface operating in DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode.

atdma—Total number of upstreams on this cable interface operating in DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode.

tdma—Total number of upstreams on this cable interface operating in DOCSIS 1.X, Time Division Multiple Access (TDMA) mode.

DS Mode

Total number of cable modems on this cable interface whose downstreams are operating in the following modes:

WB—Total number of downstreams on this cable interface operating in wideband channel mode.

NB—Total number of downstreams on this cable interface operating in narrowband channel mode.

DOCSIS Mode

UP—Total number of cable modems in upstream bonding partial service mode (p).

WB—Total number of cable modems in downstream bonding fully-operational mode (w-online).

WP—Total number of cable modems in downstream bonding partial service mode (p-online).

NB—Total number of cable modems in narrowband online mode (online).


Related Commands

Command
Description

show cable modem docsis device-class

Displays the DOCSIS device-class information for cable modems (CMs) on all or specified cable interfaces and upstreams.

show cable modem partial-mode

Displays information about the cable modems that are in upstream and downstream partial service mode.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.


show cable modem domain-name

To update the cable-specific Domain Name System (DNS) cache and display the domain name for specified cable modems (CMs) and customer premise equipment (CPE) behind a CM on a Cisco CMTS router, use the show cable modem domain-name command in privileged EXEC mode.

Cisco uBR7246VXR Router and Cisco uBR7225VXR Router

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] domain-name

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] domain-name

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCA

This command was introduced.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Use the show cable modem domain-name command without any options to initiate an update to the cable-specific DNS cache on the CMTS router and to enable use of domain names in other CMTS router cable modem commands that support a name option.


Note In Cisco IOS Release 12.2(33)SCA, although the show cable modem domain-name command accepts an IPv4 address format for a CM, DNS for IPv4-managed cable devices is not supported.


Examples

The following example shows sample output for all CMs and CPE behind a CM for the show cable modem domain-name command, listing the devices by their MAC and IP addresses and displaying the associated domain name:

Router# show cable modem domain-name
MAC Address    IP Address                              Domain Name
0018.6835.27b3 10.3.37.76
0019.474a.c14a 2001:0DB8:3800:809:A896:1431:75EA:5EA1  cisco-test-cm1.cisco.com
0007.0e03.6851 10.3.37.36
0007.0e01.b085 10.3.37.34
0018.6835.27aa 2001:0DB8:3800:809:E97D:2986:9F37:FFE   cisco-test-cm2.cisco.com

Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem errors

To display packet header error statistics for one or more CMs, use the show cable modem errors command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] errors

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] errors

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

errors

Displays packet header error statistics for one or more CMs.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX, 12.2(1)XF, and 12.2(4)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 router.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays packet header error information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, as identified by its IP address or MAC address.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.2(15)BC1 and later releases, use the clear cable modem flap-counters command to clear these counters.



Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Examples

The following example shows sample output for the show cable modem errors command for all CMs on a particular cable interface.

Router# show cable modem c8/1/0 errors 
MAC Address    I/F          CRC        HCS
0050.7366.1243 C8/1/0/U1    0          1 
0002.b970.0027 C8/1/0/U4    0          0 
0006.5314.858d C8/1/0/U4    8          3 
Router# 

Table 97 describes the fields shown in the show cable modem errors displays:

Table 97 Descriptions for the show cable modem errors Fields 

Field
Description

MAC Address

The MAC address for the CM.

I/F

The cable interface line card, including the upstream, for this CM.

CRC

Number of times the CMTS upstream receiver flagged a packet with a cyclic redundancy check (CRC) error from this CM. CRC errors usually indicate downstream signal interruption or interference noise on a plant. Occasional CRC errors can always be expected, but a high number of CRC errors could indicate plant problems such as intermittent upstream problems, laster clipping, common-path distortion, or impulsive noise or interference.

HCS

Number of times the CMTS upstream receiver flagged a packet with a header checksum (HCS) error from this CM. HCS errors could indicate the same sort of plant problems as CRC errors.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.


show cable modem extended-power

To display the list of cable modems that are transmitting upstream data at extended power level, use the show cable modem extended-power command in privilege EXEC mode.

show cable modem extended-power

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCF2

This command was introduced.


Examples

The following is a sample output of the show cable modem extended-power command that displays all the cable modems that are transmitting upstream data at extended power level:

Router# show cable modem extended-power
MAC Address    IP Address      I/F           MAC           Prim  Report  ECN
                                             State         Sid   Power
001e.6bfb.3382 5.50.0.3        C7/0/0/UB     w-online      3     57.00   Y
0022.cea5.0214 5.50.1.102      C7/0/0/UB     w-online      5     54.00   Y
001e.6bfb.1378 5.50.6.83       C7/0/0/UB     w-online      6     54.00   Y

Table 1 describes significant fields shown in the display.

Table 98 show cable modem extended-power Field Descriptions 

Field
Description

MAC Address

MAC address of the cable modem.

IP Address

IP address that the DHCP server has assigned to the cable modem.

I/F

Cable interface line card providing the upstream for the cable modem.

MAC State

Current state of the MAC layer.

Prim Sid

Primary Service ID (SID) assigned to the cable modem.

Report Power

Power (in dB) at which cable modems are transmitting upstream data.

ECN

Extended high power at which the CM is operating.


Related Commands

Command
Description

cable upstream ext-power

Enables or disables the DOCSIS extended transmit power support on the Cisco CMTS.


show cable modem flap

To display flap list statistics for one or more cable modems, use the show cable modem flap command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] flap

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] flap

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific cable modem to be displayed. If you specify the IP address for a CPE device behind a cable modem, information for that cable modem is displayed.

mac-address

(Optional) MAC address of a specific cable modem to be displayed. If you specify the MAC address for a CPE device behind a cable modem, information for that cable modem is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all cable modems using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

flap mtc

Displays aggregate data across all upstream channels for each flap detector for cable modems in MTC mode. Displays per channel flap information for a single cable modem in MTC mode.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX, 12.2(1)XF, and 12.2(4)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a cable modem or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a cable modem.

12.2(33)SCC

A new keyword, mtc, was added to provide multiple transmit channel (MTC) information for cable modems in the MTC mode.

The mtc keyword displays aggregate data across all upstream channels for each flap detector for cable modems in the MTC mode.

The show cable modem flap command remains unchanged for non-MTC mode cable modems.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays information about the flap list activity for one or more cable modems. Unlike the show cable flap-list command, the show cable modem flap command displays flap counters of a cable modem irrespective of the plant condition.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


For cable modems in MTC mode, the show cable modem flap command will display aggregate data across all upstream channels for each flap detector. However, for a single MTC cable modem, the show cable modem flap command will display per channel flap information.


Note The output of the show cable modem flap command will remain unchanged for non-MTC mode cable modems.


Examples

The following example shows sample output for the show cable modem flap command on a Cisco CMTS router:

Router# show cable modem flap 
MAC Address    I/F           Ins   Hit   Miss  CRC   P-Adj   Flap  Time
0025.2e34.4386 C6/0/0/U0     0     46657 3974  0      0      0     (14212 msec)
0025.2e2f.d4b6 C6/0/0/U0     0     47868 1896  0      0      0     (18000 msec)
0025.2e2f.d4de C6/0/0/U0     0     47960 1883  0      0      0     (19552 msec)
0023.bee1.e96b C6/0/0/U0     0     46537 4333  0      0      0     (22432 msec)
0025.2e2f.d4d8 C6/0/0/U0     0     21891 780   0      0      0     ( -- )
0025.2e2f.d48c C6/0/0/U0     0     47918 1828  0      0      0     ( -- )
0025.2e2f.d490 C6/0/0/U0     0     47900 1812  0      0      0     ( -- )
0019.474e.e46a C8/0/0/U0     0     33424 0     0      0      0     (6372 msec)
0019.474e.e266 C8/0/0/U0     0     33418 0     0      0      0     (8352 msec)
0022.ce89.96f2 C8/0/0/U0     0     33427 0     0      0      0     (11112 msec)
0025.2e2f.d58a C8/0/0/U0     0     33423 0     0     !33420  33420 Oct 5  16:02:16(15252 
msec)
001a.c30c.7ef6 C8/0/0/U0     0     33424 2     0      0      0     (17592 msec)
0022.ce89.96b0 C8/0/0/U0     0     33414 0     0      0      0     ( -- )
0025.2e2f.d6de C8/0/0/U0     0     33414 0     0     !33411  33411 Oct 5  16:02:
21( -- )
0025.2e34.43c8 C8/0/0/U0     0     33411 0     0      0      0     ( -- )
0023.bee1.e974 C8/0/0/U0     0     33406 0     0      0      0     ( -- )
0019.474e.e3a7 C8/0/0/U0     0     33324 0     0      0      0     ( -- )

The following example shows sample output for the show cable modem flap command for all cable modems on a specific cable interface:

Router# show cable modem c6/0/0 flap 
MAC Address    I/F           Ins   Hit   Miss  CRC   P-Adj   Flap  Time
0025.2e34.4386 C6/0/0/U0     0     46778 3980  0      0      0     (14212 msec)
0025.2e2f.d4b6 C6/0/0/U0     0     48002 1899  0      0      0     (18000 msec)
0025.2e2f.d4de C6/0/0/U0     0     48098 1889  0      0      0     (19552 msec)
0023.bee1.e96b C6/0/0/U0     0     46658 4351  0      0      0     (22432 msec)
0025.2e2f.d4d8 C6/0/0/U0     0     21979 781   0      0      0     ( -- )
0025.2e2f.d48c C6/0/0/U0     0     48048 1835  0      0      0     ( -- )
0025.2e2f.d490 C6/0/0/U0     0     48029 1819  0      0      0     ( -- )

The following example shows sample output for the show cable modem flap command for a particular cable modem:

Router# show cable modem 0010.7bb3.fcd1 flap 
MAC Address    I/F       Ins   Hit   Miss  CRC   P-Adj   Flap  Time
0010.7bb3.fcd1 C5/0/U5   0     36278 92    0     369     372   Jun 1 13:05:23 (14212 msec)

The following example shows sample output of the show cable modem flap command for all cable modems in the MTC mode on a specific cable interface:

Router# show cable modem c5/0/0 flap 
MAC Address    I/F       Ins   Hit   Miss  CRC   P-Adj   Flap  Time
000e.5c44.d2f0 C5/0/0/U0 0     3040  0     0     0       0 	( -- )
0019.474a.d542 C5/0/0/U3 0     2930  214   0     0       1     May 27 05:21:26(19552 msec)
001a.c3ff.d578 C5/0/0/UB 0     12195 60    0     0       4     May 25 10:01:03(22432 msec)

Table 99 describes the significant fields shown in the display:

Table 99 show cable modem flap Field Descriptions   

Field
Description

MAC Address

The MAC address for the CM.

I/F

The cable interface line card, including upstream, for this cable modem.

Ins

The number of times the cable modem comes up and inserts itself into the network. It can indicate intermittent downstream sync loss or DHCP or modem registration problems.

Hit

The number of times the cable modem responds to MAC layer keepalive messages. (The minimum hit rate is once per 30 seconds. It can indicate intermittent upstream, laser clipping, or common-path distortion.

Miss

The number of times the cable modem misses the MAC layer keepalive message. An 8 percent miss rate is normal for the Cisco cable interface line cards. It can indicate intermittent upstream, laser clipping, or common-path distortion.

CRC

The number of cyclic redundancy check (CRC) errors from this cable modem. It can indicate intermittent upstream, laser clipping, or common-path distortion.

P-Adj

The number of times the headend instructed the cable modem to adjust transmit (TX) power more than 3 dB. It can indicate amplifier degradation, poor connections, or thermal sensitivity.

Flap

The sum of P-Adj and Ins values. cable modems with high flap counts have high SIDs and might not register.

Time

The most recent time that the cable modem dropped the connection. The value displayed in the brackets indicates the duration (milliseconds) between the cable interface to become active and the first ranging success after a line card switchover (cable modem recovery time).


Related Commands

Command
Description

cable flap-list aging

Specifies the number of days to keep a cable modem in the flap-list table before aging it out of the table.

cable flap-list insertion-time

Sets the insertion time interval that determines whether a cable modem is placed in the flap list.

cable flap-list miss-threshold

Configures the threshold for recording a flap-list event, in terms of missed Station Maintenance messages.

cable flap-list power-adjust threshold

Specifies the power-adjust threshold for recording a cable modem flap-list event.

cable flap-list size

Specifies the maximum number of cable modems that can be listed in the flap-list table.

clear cable flap-list

Clears all the entries in the flap-list table.

show cable flap-list

Displays the current contents of the flap list.

show cable modem

Displays information for the registered and unregistered cable modems.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show interface cable modem

Displays information about the cable modems connected to a particular cable interface.


show cable modem ipv6

To display IPv6 information for specified cable modems (CMs) and customer premise equipment (CPE) behind a CM on a Cisco CMTS router, use the show cable modem ipv6 command in privileged EXEC mode.

Cisco uBR7246VXR Router and Cisco uBR7225VXR Router

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] ipv6 [cpe | prefix | registered | unregistered]

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] ipv6 [cpe | prefix | registered | unregistered]

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

cable

Identifies the cable interface on the Cisco router.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

cpe

(Optional) Displays IPv6 information for the CPE devices behind the CM with the specified IPv4 or IPv6 address.

prefix

(Optional) Displays the IPv6 prefix of the network.

registered

(Optional) Displays IPv6 information for registered CMs.

unregistered

(Optional) Displays IPv6 information for unregistered CMs.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCA

This command was introduced.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.

12.2(33)SCG1

The output for the show cable modem mac-address ipv6 cpe has been modified.


Usage Guidelines

Use the show cable modem ipv6 command without any options to display IPv6 information for all CMs on the CMTS router.

Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain name of a CM.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the Cisco CMTS router before any domain name can be used as part of a cable command.


To display the number of CPEs behind a CM, use the show cable modem ipv6 registered command.

To display CPE information behind a specific CM, use the show cable modem mac-address ipv6 cpe command.

Examples

IPv6 Information for all CMs

The following example shows sample output for the show cable modem ipv6 command for all CMs on the Cisco CMTS routers, listing the devices by their MAC and IP addresses and displaying the associated domain name:

Router# show cable modem ipv6
MAC Address    Type Interface  Mac State    D/IP IP Address
0004.27a5.b761 B/D  C6/0/2/U1   online        N  ---
0007.0e01.d9a1 B/D  C6/0/2/U0   online        N  ---
0006.2854.7275 R/D  C6/0/2/U1   online        Y  2001:0DB8:3800:80B:7565:5B87:1D7D:5AD5

IPv6 prefix information for all CMs

The following example shows sample output for the show cable modem ipv6 prefix command for all CMs on the Cisco CMTS routers:

Router# show cable modem ipv6 prefix
Device Type: B - CM Bridge, R - CM Router
IP Assignment Method: D - DHCP
MAC Address    Type D/IP IPv6 prefix
0006.2854.7275 R/D  Y    2001:ODB8:3800:80C::/64

Starting with Cisco IOS Release12.2(33)SCG1, the output for the show cable modem ipv6 prefix command displays multiple IPv6 prefix assigned. The D/IP field is not supported. The following example shows the sample output for the show cable modem ipv6 prefix command for all CMs on the Cisco CMTS router:

Router# show cable modem ipv6 prefix
Load for five secs: 1%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *06:36:53.075 UTC Thu Aug 2 2012
Device Type: B - CM Bridge, R - CM Router
IP Assignment Method: D - DHCP
MAC Address    Type IPv6 prefix
0023.bed9.4c91 R/D  2001:40:1012::/64
               R/D  2001:40:2012:1::/64
0000.002e.074c R/D  2001:40:1012:8::/64
               R/D  2001:40:2012:1D::/64
0000.002e.074b R/D  2001:40:1012:23::/64
               R/D  2001:40:2012:1C::/64
0000.002e.074a R/D  2001:40:1012:22::/64
               R/D  2001:40:2012:1B::/64

Starting with Cisco IOS Release12.2(33)SCG1, the following example shows sample output for the show cable modem mac-address ipv6 prefix command for multiple IPv6 prefixes assigned to CPEs behind a CM with a specific MAC address on the Cisco CMTS router:

Router# show cable modem 0023.bed9.4c8e ipv6 prefix
Load for five secs: 0%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *06:37:22.335 UTC Thu Aug 2 2012
Device Type: B - CM Bridge, R - CM Router
IP Assignment Method: D - DHCP
MAC Address    Type IPv6 prefix
0023.bed9.4c91 R/D  2001:40:1012::/64
               R/D  2001:40:2012:1::/64

Example of the show cable modem ipv6 Command for all Registered CMs

The following example shows sample output for the show cable modem ipv6 registered command for all registered CMs on the Cisco CMTS router:

Router# show cable modem ipv6 registered
Interface Prim Online     CPE IP Address                              MAC Address
          Sid  State
C4/0/U2   1    online     0   ---                                     0018.6835.27b3
C4/0/U2   2    online     0   2001:0DB8:3800:809:A896:1431:75EA:5EA1  0019.474a.c14a
C4/1/U1   2    online     0   ---                                     0007.0e03.6851
C4/1/U1   3    online     0   ---                                     0007.0e01.b085
C4/1/U1   4    online     0   2001:0DB8:3800:809:E97D:2986:9F37:FFE   0018.6835.27aa

Example of the show cable modem ipv6 cpe Command for all CMs

The following example shows sample output for the show cable modem ipv6 cpe command for all CMs on the Cisco CMTS router:

Router# show cable modem 0019.474a.c14a ipv6 cpe
MAC Address    IP Address                              Domain Name

0005.0052.2c1d 2001:420:3800:809:48F7:3C33:B774:9185

Starting with Cisco IOS Release12.2(33)SCG1, the following example shows sample output for the show cable modem mac-address ipv6 cpe command for registered CMs on the Cisco CMTS router:

Router# show cable modem 0023.bed9.4c8e ipv6 cpe
Load for five secs: 0%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *06:37:20.439 UTC Thu Aug 2 2012
MAC Address    IP Address
0023.bed9.4c91 2001:40:3:4:200:5EB7:BB6:C759
               2001:40:3:4:210:D73B:7A50:2D05

Table 100 describes the significant fields shown in the display.

Table 100 show cable modem ipv6 Field Descriptions 

Field
Description

MAC Address

MAC address of this CM.

Type

Type of device that this CM is functioning as, with the following possible values:

B/D—CM as bridge using DHCP address assignment.

G/D—CPE router using DHCP address assignment.

C/A—CPE using Stateless Address Auto-Configuration (SLAAC) address assignment.

Note In Cisco IOS Release 12.2(33)SCA, the Cisco CMTS router does not support SLAAC.

Interface

Cable line card interface and upstream associated with this CM.

Mac State

The current state of the MAC layer for this CM (See Table 101 for descriptions of the possible states).

D/IP

Dual IP flag. Identifies whether or not ("Y" or "N") the CM or CPE supports both IPv4 and IPv6 addressing.

Starting from Cisco IOS Release 12.2(33)SCG1, D/IP field is not supported.

IP Address

IP address acquired by the CM. Prior to acquisition of the IP address, or if the CM fails registration, the following output is shown:

IPv4 address not yet acquired—"0.0.0.0"

IPv6 address not yet acquired—"::"

CM fails IPv6 registration, but online with IPv4 address or CM fails IPv4 registration, but online with IPv6 address: "---"

IPv6 address of IPv4-only CM, or IPv4 address of an IPv6-only CM: "---"

Domain Name

Domain name for the CM.


Table 101 shows the possible values for the MAC state field:

Table 101 Descriptions for the MAC State Field 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

resetting

The CM is being reset and will shortly restart the registration process.

 

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.


show cable modem mac

To display MAC layer information for one or more CMs, use the show cable modem mac command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] mac[summary [total]]

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] mac[summary [total]]

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

summary [total]

(Optional) Displays a summary of MAC layer information for each cable interface. If you add the optional total keyword, the display includes a total of CMs that are included in each of the displayed fields.


Defaults

Displays MAC layer information for all CMs.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX and 12.2(4)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.

12.2(8)BC2

This command was enhanced to show whether a CM is capable of operating in DOCSIS 1.0 or DOCSIS 1.1 mode, and the version for which it is currently provisioned.

12.2(11)BC1

The mac option was enhanced to support the summary and summary total options.

12.2(15)CX

This command was enhanced to support DOCSIS 2.0 CMs using Advanced Time Division Multiple Access (A-TDMA) modulation profiles.

12.3(17a)BC

Introduced revised information that is displayed for the following two versions of the show cable modem mac command:

show cable modem mac summary

Refer to "Usage Guidelines."

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—CMTS router has seen SOLICIT message.

init6(a)—CMTS router has seen ADVERTISE message.

init6(r)—CMTS router has seen REQUEST message.

init6(i)—CMTS router has seen REPLY message.

init6(o)—CMTS router has seen version 6 TFTP request.

init6(t)—CMTS router has seen version 6 TOD request.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Cisco IOS Release 12.3(17a)BC introduces changes for two versions of the show cable modem mac command.

show cable modem mac summary

The information displayed with this command is revised. The DOCSIS 2.0 column in the Quality of Service (QoS) Provision Mode field has been removed, as this field is not applicable to QoS provisioning in DOCSIS 2.0.

Command Output in Cisco IOS Release 12.3(17a)BC and Later Releases

Router# show cable modem mac summary 
                            Cable Modem Summary
                            -------------------
                         Mac Version                 QoS Provision Mode
Interface       Total   DOC2.0  DOC1.1  DOC1.0   Reg/Online   DOC1.1  DOC1.0
Cable5/1/0/U0   10      0       2       8        10           0       10

Command Output in Cisco IOS Release 12.3(13a)BC and Earlier Releases

Router# scm mac sum
                            Cable Modem Summary
                            -------------------
                         Mac Version                 QoS Provision Mode
Interface       Total   DOC2.0  DOC1.1  DOC1.0   Reg/Online   DOC2.0  DOC1.1  DOC1.0
Cable8/0/0/U0   8       0       5       3        5            0       5       0

Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Examples

This section contains examples for the different forms of the show cable modem mac command.

Default Displays

The following example shows typical output for the default form of the show cable modem mac command:

Router# show cable modem mac 
MAC Address    MAC         Prim  Ver    QoS     Frag Concat PHS Priv  DS    US
               State       Sid          Prov                          Saids Sids
0050.7366.1243 online      1     DOC1.0 DOC1.0  no   no     no  BPI   0     0   
0002.b970.0027 online      2     DOC1.1 DOC1.0  no   yes    yes BPI+  0     4   
0006.5314.858d online      3     DOC1.1 DOC1.1  yes  yes    yes BPI+  0     4   
0010.64ff.e4ad online      1     DOC1.1 DOC1.0  yes  yes    yes BPI+  0     4
0010.f025.1bd9 init(rc)    2     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0010.9659.4447 online(pt)  3     DOC1.0 DOC1.0  no   yes    no  BPI   0     0
0010.9659.4461 online(pt)  4     DOC1.0 DOC1.0  no   yes    no  BPI   0     0
0010.64ff.e459 online      5     DOC1.0 DOC1.0  no   yes    no  BPI   0     0
0020.4089.7ed6 online      6     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0090.9607.3831 online(pt)  7     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0090.9607.3830 online(pt)  1     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0050.7366.12fb init(i)     2     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0010.fdfa.0a35 online(pt)  3     DOC1.1 DOC1.1  yes  yes    yes BPI+  0     4

The following example shows sample output for the show cable modem mac command for a particular cable interface:

Router# show cable modem c3/0 mac 
MAC Address    MAC         Prim  Ver    QoS     Frag Concat PHS Priv  DS    US
               State       Sid          Prov                          Saids Sids
0050.7366.1243 online      1     DOC1.0 DOC1.0  no   no     no  BPI   0     0   
0002.b970.0027 online      2     DOC1.1 DOC1.0  no   yes    yes BPI+  0     4   
0006.5314.858d online      3     DOC1.1 DOC1.1  yes  yes    yes BPI+  0     4   

The following example shows sample output for the show cable modem mac command for a particular CM, as identified by its MAC address:

Router# show cable modem 0010.7bb3.fcd1 mac 
MAC Address    MAC         Prim  Ver    QoS     Frag Concat PHS Priv  DS    US
               State       Sid          Prov                          Saids Sids
0010.7bb3.fcd1 online      91    DOC1.1 DOC1.1  yes  yes    yes BPI+  1     4 

The following example shows a sample output for the show cable modem mac command for a CM, as identified by its MAC address:

Router# show cable modem xxxx.xxxx.xxxx mac
                                                                                 D
MAC Address    IP Address     I/F           MAC           Prim RxPwr  Timing Num I
                                            State         Sid  (dBmv) Offset CPE P
xxxx.xxxx.xxxx x.x.x.x  C6/0/2/U0          *online        3087 0.50   1037   0   N

Note The * in front of the MAC state indicates that the CM did not satisfy the bpi-plus-policy and the data traffic is blocked. The cable privacy bpi-plus-policy command enforces this requirement.



Note The ! in front of the MAC state indicates that the CM has attempted to register with a modified cm configuration file. This is possibly a non-compliant CM trying to modify the service it is receiving.


The following example shows sample output for the show cable modem mac command for a particular CM, as identified by its IP address:

Router# show cable modem 10.1.1.10 mac 
MAC Address    MAC         Prim  Ver    QoS     Frag Concat PHS Priv  DS    US
               State       Sid          Prov                          Saids Sids
0002.b970.0027 online      2     DOC1.1 DOC1.0  no   yes    yes BPI+  0     4   

Table 102 describes the fields shown in the default forms of the show cable modem mac displays:

Table 102 Descriptions for the Default show cable modem mac Fields 

Field
Description

MAC Address

The MAC address for the CM.

MAC State

The current state of the MAC layer (see Table 101).

Prim SID

The primary SID assigned to this CM.

Ver

Displays the maximum supported version of DOCSIS that the CM supports (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).

QoS Prov

Displays the version of DOCSIS that the CM currently is provisioned and registered for (DOCSIS 1.0 and DOCSIS 1.1).

Frag

Indicates whether DOCSIS 1.1 or 2.0 MAC-layer fragmentation is enabled for this CM.

Concat

Indicates whether DOCSIS 1.1 or 2.0 MAC-layer concatenation is enabled for this CM.

PHS

Indicates whether DOCSIS 1.1 or 2.0 packet header suppression (PHS) is enabled for this CM.

Priv

Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.

DS Saids

Number of downstream security association IDs (Saids) used by this CM.

US Sids

Number of upstream service IDs (SIDs) used by this CM.


Table 101 shows the possible values for the MAC state field:

Table 103 Descriptions for the MAC State Field 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

resetting

The CM is being reset and will shortly restart the registration process.

 

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Summary and Total Options

The following example shows the same display for the show cable modem mac summary command:

Router# show cable modem mac summary 
                             Cable Modem Summary
                             -------------------
                             Mac Version                      QoS Provision Mode
Interface       Total   DOC2.0  DOC1.1  DOC1.0   Reg/Online   DOC2.0  DOC1.1  DOC1.0
Cable8/1/0/U1   1       1       0       0        1            0       0       1
Cable8/1/0/U4   2       2       0       2        2            1       1       0 
Router# 

The following example shows the summary display when the total option is added:

Router# show cable modem mac summary total 
                             Cable Modem Summary
                             -------------------
                             Mac Version                      QoS Provision Mode
Interface       Total   DOC2.0  DOC1.1  DOC1.0   Reg/Online   DOC2.0  DOC1.1  DOC1.0
Cable5/1/0/U5   1       0       0       1        1            0       0       1
Cable6/1/0/U0   11      0       0       11       8            0       0       8
Cable6/1/1/U2   17      0       1       16       15           0       0       15
Cable7/0/0/U0   2       0       0       2        1            0       0       1
Cable7/0/0/U5   1       0       0       1        0            0       0       0
Total:          32      0       1       31       25           0       0       25
Router# 

Table 104 describes the fields shown in the show cable modem mac summary displays:

Table 104 Descriptions for the show cable modem mac summary Fields 

Field
Description

I/F

The cable interface line card providing the upstream for this CM.

Total

Total number of CMs currently active on this cable interface.

MAC Version
DOC 2.0

Total number of CMs on this interface that reported in their registration request as having DOCSIS 2.0 capabilities.

MAC Version
DOC 1.1

Total number of CMs on this interface that reported in their registration request as having DOCSIS 1.1 capabilities.

MAC Version
DOC 1.0

Total number of CMs on this interface that reported in their registration request as having DOCSIS 1.0 capabilities.

Reg/Online

Total number of CMs on this interface that have completed registration and are currently online.

QoS Provisioned Mode
DOC 2.0

Total number of CMs on this interface that have been provisioned and registered for DOCSIS 2.0 operations.

QoS Provisioned Mode
DOC 1.1

Total number of CMs on this interface that have been provisioned and registered for DOCSIS 1.1 operations.

QoS Provisioned Mode
DOC 1.0

Total number of CMs on this interface that have been provisioned and registered for DOCSIS 1.0 operations.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more CMs.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more CMs.

show cable modem phy

Displays the DOCSIS PHY layer information for one or more CMs.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem maintenance

To display station maintenance (SM) error statistics for one or more cable modems, use the show cable modem maintenance command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] maintenance

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] maintenance

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays information about the number of times that a CM has exhausted its maximum retry attempts to respond to a Station Maintenance (SM) request, as well as the number of times that the CMTS has aborted ranging with a CM during a Station Maintenance interval. This information can be used to determine whether a particular cable modem or interface is experiencing plant or network difficulties.

You can display this information for all online cable modems, all online cable modems for a specific cable interface, or for one particular cable modem.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Examples

The following example shows sample output for the show cable modem maintenance command for all online cable modems:

Router# show cable modem maintenance 
MAC Address    I/F         Prim  SM Exhausted          SM Aborted
                           Sid   Count Time            Count Time
0010.9507.01db C5/1/0/U5   1     0     --- -- 00:00:00 0     --- -- 00:00:00
0002.b96f.fdbb C6/1/0/U0   5     1     Jun 20 13:23:03 0     --- -- 00:00:00
0002.fdfa.129d C6/1/0/U0   6     0     --- -- 00:00:00 0     --- -- 00:00:00
0002.fdfa.137d C6/1/0/U0   7     0     --- -- 00:00:00 0     --- -- 00:00:00
0050.7302.3d73 C6/1/0/U0   8     0     --- -- 00:00:00 0     --- -- 00:00:00
0002.fdfa.12d5 C6/1/0/U0   9     0     --- -- 00:00:00 0     --- -- 00:00:00
0002.fdfa.1163 C6/1/0/U0   10    0     --- -- 00:00:00 0     --- -- 00:00:00
0006.28f9.8bbd C6/1/0/U0   11    0     --- -- 00:00:00 0     --- -- 00:00:00
00d0.bad3.c0cf C6/1/0/U0   12    0     --- -- 00:00:00 0     --- -- 00:00:00
0003.e38f.e85b C6/1/0/U0   14    149   Jun 21 14:24:03 0     --- -- 00:00:00
0001.9659.519f C6/1/0/U0   18    53    Jun 21 14:25:32 0     --- -- 00:00:00
0003.e3a6.8195 C6/1/0/U0   19    10    Jun 21 05:37:54 0     --- -- 00:00:00
0003.e3a6.8173 C6/1/1/U2   15    2     Jun 20 13:41:27 0     --- -- 00:00:00
0002.fdfa.12ef C6/1/1/U2   16    1     Jun 20 13:16:30 0     --- -- 00:00:00
0002.fdfa.12e9 C6/1/1/U2   17    1     Jun 20 13:16:30 0     --- -- 00:00:00
0003.e3a6.7f69 C6/1/1/U2   18    2     Jun 20 13:43:10 0     --- -- 00:00:00
0030.80bc.3095 C6/1/1/U2   19    2     Jun 20 13:45:00 0     --- -- 00:00:00
0003.e38f.e9ab C6/1/1/U2   20    1     Jun 20 13:43:47 0     --- -- 00:00:00
0006.28f9.9d19 C6/1/1/U2   22    0     --- -- 00:00:00 0     --- -- 00:00:00
0003.e3a6.7fe3 C6/1/1/U2   23    0     --- -- 00:00:00 0     --- -- 00:00:00
0020.4005.3f06 C6/1/1/U2   24    0     --- -- 00:00:00 0     --- -- 00:00:00
Router# 

The following example shows sample output for the show cable modem maintenance command for all cable modems on a specific cable interface:

Router# show cable modem c8/1/0 maintenance 
MAC Address    I/F         Prim  SM Exhausted          SM Aborted
                           Sid   Count Time            Count Time
0050.7366.1243 C8/1/0/U1   1     1     Apr 28 13:06:11 0     --- -- 00:00:00
0002.b970.0027 C8/1/0/U4   2     0     --- -- 00:00:00 0     --- -- 00:00:00
0006.5314.858d C8/1/0/U4   3     2     Apr 28 13:07:28 0     --- -- 00:00:00
Router# 

The following example shows sample output for the show cable modem maintenance command for a particular CM:

Router# show cable modem 0010.7bb3.fcd1 maintenance 
MAC Address    I/F         Prim  SM Exhausted          SM Aborted
                           Sid   Count Time            Count Time
0010.7bb3.fcd1 C5/0/U5     1     3     Jun 1  10:24:52 0     Jan 1  00:00:00
Router# 

Table 105 describes the fields shown in the show cable modem maintenance displays:

Table 105 Descriptions for the show cable modem maintenance Fields 

Field
Description

MAC Address

The MAC address for the CM.

I/F

The cable interface line card, including upstream, for this CM.

Prim SID

The primary SID assigned to this CM.

SM Exhausted
Count

Number of times this CM has repeatedly timed out and exhausted the maximum allowable retry attempts when it was sent a Station Maintenance request. The CMTS responds by taking the CM offline, forcing the CM to reinitialize and reregister.

SM Exhausted
Time

The last time that this CM repeatedly timed out and exhausted the maximum allowable retry attempts when it was sent a Station Maintenance request.

SM Aborted
Count

Number of times the CMTS has aborted ranging for a CM during a Station Maintenance period, typically because the CM has been reset.

SM Aborted
Time

The last time the CMTS aborted ranging for a CM during a Station Maintenance period, typically because the CM has been reset.


Related Commands

Command
Description

cable flap-list miss-threshold

Configures the threshold for recording a flap-list event, in terms of missed Station Maintenance messages.

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem domain-name

Updates the cable-specific DNS cache and display the domain name for specified CMs and CPE behind a CM on a Cisco CMTS router.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem offline

To display a list of the cable modems (CMs) that are marked as offline with the Cisco CMTS router, use the show cable modem offline command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] offline

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] offline

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

offline

Displays a list of the cable modems that are marked as offline.


Defaults

Displays a list of all offline CMs known by the Cisco CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.0(7)XR and 12.1(1a)T1

This command was introduced.

12.2(4)BC1

Support for the Cisco uBR10012 router was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—CMTS router has seen SOLICIT message.

init6(a)—CMTS router has seen ADVERTISE message.

init6(r)—CMTS router has seen REQUEST message.

init6(i)—CMTS router has seen REPLY message.

init6(o)—CMTS router has seen version 6 TFTP request.

init6(t)—CMTS router has seen version 6 TOD request.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays a list of CMs that had either been online previously or had attempted to register with the CMTS, but that are now considered offline. Offline cable modems remain in the CMTS databases for 24 hours and then are deleted.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Examples

The following example shows sample output for the default form of the show cable modem offline command.

Router# show cable modem offline 
Interface   MAC address    Prim Previous  Offline          Rx     Rx    SM
                           Sid  State     Time             Power  SNR   Exhaust
                                                                        Count
Cable5/0/U0 0030.946a.5d61 1    init(i)   Jun 14 21:31:57   0.00  31.86 162  
Cable5/0/U0 0030.946a.5d85 2    init(i)   Jun 14 22:47:39  -0.25  31.26 156  
Cable5/0/U0 0030.946a.5b6d 3    init(i)   Jun 14 14:20:11   1.00  30.56 166 

The following example shows sample output for the show cable modem offline command for a particular upstream on a cable interface:

Router# show cable modem c3/0 upstream 0 offline 
Interface MAC address    Prim Previous    Offline          Rx     Rx    SM
                         Sid  State       Time             Power  SNR   Exhaust
                                                                        Count
C3/0/U0   0050.7366.1c69 58   init(rc)    Jan 7  16:46:49   4.50  26.72 2    
C3/0/U0   0050.7366.1c53 59   init(rc)    Jan 7  16:47:09   5.25  25.10 1    
C3/0/U0   0050.7366.1ca7 60   init(rc)    Jan 7  16:47:11   5.00  25.57 1    
C3/0/U0   0050.7366.1c45 61   init(rc)    Jan 7  16:49:27   5.00  26.74 2    
C3/0/U0   0050.7366.1c95 62   init(rc)    Jan 7  16:51:29   5.50  31.82 1    
C3/0/U0   0050.7366.1c99 64   init(rc)    Jan 7  16:52:55   5.25  26.76 2 

The following example shows sample output for the show cable modem offline command for a single CM, as identified by its IP address:

Router# show cable modem 22.1.1.10 offline 
Interface   MAC address    Prim Previous  Offline          Rx     Rx    SM
                           Sid  State     Time             Power  SNR   Exhaust
                                                                        Count
Cable5/0/U0 0030.946a.5b6d 3    init(i)   Jun 14 14:20:11   1.00  30.56 166 

The following example shows sample output for the show cable modem offline command for a single CM, as identified by its MAC address:

Router# show cable modem 0030.946a.5d61 offline 
Interface   MAC address    Prim Previous  Offline          Rx     Rx    SM
                           Sid  State     Time             Power  SNR   Exhaust
                                                                        Count
Cable5/0/U0 0030.946a.5d61 1    init(i)   Jun 14 21:31:57   0.00  31.86 162  

Table 106 describes the major fields shown in the show cable modem offline displays:

Table 106 Descriptions for the show cable modem offline Fields 

Field
Description

Interface

The cable interface line card that this CM last used when it was online.

MAC address

Hardware MAC address for this CM.

Prim SID

The primary SID that had been last assigned to this CM before it went offline.

Previous State

The last known state of the MAC layer for this CM before it went offline (see Table 101).

Note A pound sign (#) in the Previous State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).

Offline Time

The time and date that this CM last went offline.

Rx Power

The last known received power level (in dB) for the CM before it went offline.

Note An asterisk (*) in the Rx Power column indicates that a power adjustment was made for that CM. An exclamation point (!) indicates that the CM had reached its maximum power transmit level and could not increase its power level further.

Rx SNR

The last known signal-to-noise ratio (SNR) value for this CM before it went offline.

SM Exhaust Count

Number of times that this CM has exhausted the maximum allowable retries for not responding to the regular Station Maintenance (SM) messages sent to it by the CMTS.

Note Using the clear counters command to reset a cable interface's counters also resets the SM Exhaust Count field for all offline CMs to zero and resets the Offline Time field for all offline CMs to the current time.


Table 101 shows the possible values for the Previous State field:

Table 107 Descriptions for the Previous State Field 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

resetting

The CM is being reset and will shortly restart the registration process.

 

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

clear counters

Clears counters for one or all interfaces.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.

show cable modem vendor

Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem partial-mode

To display information about cable modems that are in upstream and downstream partial service mode, use the show cable modem partial-mode command in privileged EXEC mode.

show cable modem partial-mode

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCD2

This command was introduced.


Usage Guidelines

If all cable modems are in full service mode (all downstream and upstream channels of the cable modems are online and operational), then the show cable modem partial-mode command does not provide any output. This command provides output only when the cable modems register in partial service mode (one or more downstream or upstream channels of the downstream or upstream bonded cable modems are not operational).

Examples

The following is a sample output of the show cable modem partial-mode command that displays all the cable modems in partial service mode:

Router# show cable modem partial-mode
MAC Address    IP Address      I/F         MAC           Prim  RCC  UP-reason/
                                           State         Sid   ID   Failed-tcs
001e.6bfb.33a0 2.99.81.14      C7/0/0/p    p-online(pt)  3     2     0x1 / 0x4
0022.cef4.3d9a 2.99.81.23      C7/0/0/p    p-online(pt)  4     2     0x1 / 0x4
001e.6bfb.194e 2.99.81.32      C7/0/0/p    p-online(pt)  6     2     0x1 / 0x4
001e.6bfb.1538 2.99.81.38      C7/0/0/p    p-online(pt)  8     2     0x1 / 0x4
001e.6bfb.0d22 2.99.81.29      C7/0/0/p    p-online(pt)  9     1     0x1 / 0x4
001e.6bfb.1a7e 2.99.81.30      C7/0/0/p    p-online(pt)  10    1     0x1 / 0x4
001e.6bfa.f58a 2.99.81.9       C7/0/0/p    p-online(pt)  12    1     0x1 / 0x4
0022.cef4.3fa2 2.99.81.24      C7/0/0/p    p-online(pt)  13    2     0x1 / 0x4
001e.6bfb.1b72 2.99.81.10      C7/0/0/p    p-online(pt)  14    2     0x1 / 0x4
0023.be50.e578 2.99.81.17      C7/0/0/UB   p-online(pt)  16    2     N/A
0025.2e2d.784a 2.99.81.28      C7/0/0/UB   p-online(pt)  17    2     N/A
0025.2e2d.748c 2.99.81.26      C7/0/0/UB   p-online(pt)  18    2     N/A

Table 108 describes the significant fields shown in the display.

Table 108 show cable modem partial-mode Field Descriptions 

Field
Description

MAC Address

MAC address of the cable modem.

IP Address

IP address that the DHCP server has assigned to the cable modem.

I/F

Cable interface line card providing the upstream for the cable modem.

MAC State

Current state of the MAC layer.

Prim Sid

Primary Service ID (SID) assigned to the cable modem.

RCC ID

Receive channel configuration (RCC) ID of the cable modem.

UP-reason/Failed-tcs

UP-reason—Upstream partial service reason. This is a bitmap defined in upstream resiliency.

Failed-tcs—Transmit channel set (TCS) bitmap of the cable modem, which is not available.


Related Commands

Command
Description

show cable modem

Displays information about the registered and unregistered cable modems.

show cable modem docsis-version

Displays information about the DOCSIS version of cable modems on one or more cable interfaces.


show cable modem partial-service

To display the impaired state of the cable modems on the Cisco CMTS router, use the show cable modem partial-service command in privileged EXEC mode.

show cable modem partial-service

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCG

This command was introduced.


Examples

The following is a sample output of the show cable modem partial-service command:

Router# show cable modem partial-service

MAC Address IP Address I/F MAC DSxUS Impaired Impaired

State State DS US

54d4.6ffb.2f6b 40.4.58.16 C7/0/0/p w-online(pt) 3x3 1

54d4.6ffb.30fd 40.4.58.14 C7/0/0/p w-online(pt) 3x3 1

4458.2945.2ade 40.4.58.18 C7/0/0/p w-online(pt) 3x3 1

001e.6bfc.d1ea 40.4.58.26 C7/0/0/p w-online 3x3 1

54d4.6ffb.2e21 40.4.58.5 C7/0/0/p w-online(pt) 3x3 1

54d4.6ffb.2e1b 40.4.58.23 C7/0/0/p w-online(pt) 3x3 1

4458.2945.2a78 40.4.58.21 C7/0/0/p w-online(pt) 3x3 1

4458.2945.4604 40.4.58.19 C7/0/0/p w-online(pt) 3x3 1

54d4.6ffb.2e66 --- C8/0/0/p w-online(pt) 3x3 1

Table 83 describes the significant fields shown in the display:

Table 109 show cable modem partial-service Field Descriptions 

Field
Description

MAC Address

MAC address of the cable modem.

IP Address

IP address of the cable modem.

I/F

Interface on the cable modem.

MAC State

State of the cable modem.

DSxUS State

State of the downstream and upstream channels on the cable modem.

Impaired DS

Name of the impaired downstream RF channel.

Impaired US

Port number of the impaired upstream RF channel.


Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered cable modems.

show interface cable modem

Displays information about the cable modems connected to a particular cable interface.


show cable modem phy

To display DOCSIS PHY layer information for one or more cable modems (CMs), use the show cable modem phy command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] phy

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] phy

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

phy

Displays DOCSIS PHY layer information for one or more cable modems.


Defaults

Displays PHY information for all CMs.

Command Modes

Privileged EXEC (#)

Command History

This table includes the following release-specific history entries:

CX and BC Releases

SC Release

CX and BC Releases
Modification

12.1(4)CX and 12.2(4)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and CIsco uBR10012 routers.

12.2(15)BC2

The service ID (SID) and Mode fields were added to the default display.

12.3(17a)BC

Enhanced the show cable modem phy command. The MicroReflec column (MicroReflections) has been removed, and the DOCSIS Prov (DOCSIS Provider) column has been added in its place. This new column contains DOCSIS version information. See updated examples.

SC Release
Modification

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCC

For DOCSIS 3.0-certified cable modems with multiple upstream channels, the command output was modified to display PHY layer details of each upstream channel. In this case, the output may contain multiple results for the same MAC address. The asterix (*) that appears beside the DOCSIS operating mode under the Mode column identifies that the CM is operating in the MTC mode.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays information about the DOCSIS PHY layer for one or more CMs. You can display information for all CMs, for all CMs on a particular cable interface, or for a particular CM, as identified by its IP or MAC address.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.


Examples

Example from Cisco IOS Release 12.3(17a)BC and Later Releases

Cisco IOS Release 12.3(17a)BC introduces revised output for the show cable modem phy command. The MicroReflec column (MicroReflections) has been removed, and the DOCSIS Prov (DOCSIS Provider) column has been added in its place. This new column contains DOCSIS version information.

Router# show cable modem phy 
MAC Address    I/F         Sid  USPwr  USSNR  Timing  DSPwr  DSSNR  Mode  DOCSIS
                                (dBmV) (dB)   Offset  (dBmV) (dB)         Prov 
0003.e350.9a3f C5/1/0/U0   1    0.00   30.23  2811    0.00   -----  tdma  1.0
0050.734e.c1a1 C5/1/0/U0   2    0.00   30.47  2811    0.00   -----  tdma  1.0
0007.0e01.1749 C5/1/0/U0   3    0.00   30.65  2808    0.00   -----  tdma  1.0
0007.0e00.90dd C5/1/0/U0   4    0.00   30.66  2806    0.00   -----  tdma  1.0
0003.e350.9ad3 C5/1/0/U0   5    0.00   30.47  2810    0.00   -----  tdma  1.0
0003.e38f.f4e5 C5/1/0/U0   6    0.00   30.36  2813    0.00   -----  tdma  1.0
0003.e350.9b97 C5/1/0/U0   7    0.00   30.44  2812    0.00   -----  tdma  1.0
0003.e350.9bed C5/1/0/U0   8    0.00   30.16  2814    0.00   -----  tdma  1.0
0003.e308.455d C5/1/0/U0   9    0.00   30.79  2811    0.00   -----  tdma  1.0
0003.6bd6.bfaf C5/1/0/U0   10   0.00   30.40  2813    0.00   -----  tdma  1.0

Examples from Cisco IOS Release 12.3(13a)BC and Earlier Releases

Router# show cable modem phy
MAC Address    I/F         Sid  USPwr  USSNR  Timing MicroReflec DSPwr  DSSNR  Mode
                                (dBmV)  (dB)   Offset (dBc)      (dBmV)   (dB)     
0008.0e06.7b14 C8/0/0/U0   1    0.00   30.36  1938   0            0.00  -----  tdma 
0050.f112.5977 C8/0/0/U0   2    0.00   30.36  1695   0            0.00  -----  tdma 
0090.837b.b0b9 C8/0/0/U0   3    0.00   30.64  1187   0            0.00  -----  tdma 
0007.0e03.6e99 C8/0/0/U0   5    0.00   30.36  2747   0            0.00  -----  tdma 
0007.0e04.5091 C8/0/0/U0   6    0.00   30.94  2746   0            0.00  -----  tdma 
0006.5314.81d9 C8/0/0/U0   7    0.00   30.36  2745   0            0.00  -----  tdma 
0003.6b1b.ee63 C8/0/0/U0   8    0.00   31.26  2745   0            0.00  -----  tdma 
0030.eb15.84e7 C8/0/0/U0   12   0.00   30.36  1157   0            0.00  -----  tdma 

The following example shows sample output for the show cable modem phy command for all CMs on the Cisco CMTS router:

Router# show cable modem phy 
MAC Address    I/F         Sid  USPwr  USSNR  Timing  MicroReflec DSPwr  DSSNR  Mode
                                (dBmV) (dBmV) Offset  (dBc)       (dBmV) (dBmV) 
0008.0e09.81f8 C3/0        1    50.00  28.40  1705     26          -3.4   36.02 tdma 
0003.6b3c.1aa7 C3/0        2     0.00  28.27  3643      0           0.00  ----- tdma 
0008.0e09.7fe2 C4/0        3    35.00  28.44  1760     27          12.00  35.03 tdma 

The following example shows sample output for the show cable modem phy command for all CMs on a particular cable interface:

Router# show cable modem cable 3/0 phy 
MAC Address    I/F         Sid  USPwr  USSNR  Timing  MicroReflec DSPwr  DSSNR  Mode
                                (dBmV) (dBmV) Offset  (dBc)       (dBmV) (dBmV) 
0008.0e09.81f8 C3/0        1    50.00  28.40  1705     26          -3.4   36.02 tdma
0003.6b3c.1aa7 C3/0        2     0.00  28.27  3643      0           0.00  ----- tdma 

The following example shows sample output for the show cable modem phy command for a particular CM:

Router# show cable modem 0050.7366.1243 phy 
MAC Address    I/F         Sid  USPwr  USSNR  Timing  MicroReflec DSPwr  DSSNR  Mode
                                (dBmV) (dBmV) Offset  (dBc)       (dBmV) (dBmV)  
0050.6736.4124 C3/0        14   38.00  24.58  1651     0           8.00  35.41  tdma

Example from Cisco IOS Release 12.2(33)SCD

The following example shows a sample output of the show cable modem phy command for all CMs on the Cisco CMTS router:

Router# show cable modem phy
MAC Address    I/F           Sid   USPwr  USMER Timing DSPwr  DSMER  Mode   DOCSIS
                                   (dBmV) (SNR) Offset (dBmV) (SNR)         Prov
                                          (dB)                (dB)
001c.ea37.9b5c C3/0/U2.0     27     0.00  36.12 5394    0.00  -----  tdma   1.1
001c.ea37.9b78 C3/0/U2.0     29     0.00  36.12 5396    0.00  -----  tdma   1.1
001c.ea37.9b5a C3/0/U3.0     31     0.00  36.12 5394    0.00  -----  tdma   1.1
001c.ea37.9ba4 C3/0/U2.0     32     0.00  36.12 5393    0.00  -----  tdma   1.1
001c.ea37.9aac C3/1/U2.1     28     0.00  36.12 5620    0.00  -----  tdma   1.1
001a.c3ff.d1a4 C3/1/U0.0     29    43.50  36.12 6020    0.00  -----  tdma*  1.1
001a.c3ff.d1a4 C3/1/U1.0     29    43.50  36.12 6020    0.00  -----  tdma*  1.1
001a.c3ff.d1a4 C3/1/U2.0     29    43.50  36.12 6019    0.00  -----  tdma*  1.1
001a.c3ff.d1a4 C3/1/U3.0     29    43.50  36.12 6021    0.00  -----  tdma*  1.1

Table 110 describes the fields shown in the show cable modem phy displays:

Table 110 Descriptions for the show cable modem phy Fields 

Field
Description

MAC Address

The MAC address for the CM.

I/F

The cable interface on the CMTS that is providing services for this CM.

SID

Service ID that this CM is using.

USPwr (dBmV)

Displays the CM transmit level in dBmV, as measured by the CMTS.

USSNR (dBmV)

Upstream signal-to-noise ratio (SNR) or carrier-to-noise ratio (CNR), in dB, as measured by the CMTS. This field shows the CNR value for cable interfaces that support onboard hardware-based spectrum management, such as the Cisco uBR-MC16S card, and shows the SNR value for other cable interfaces.

Note Although the field name shows the value as being given in dBmV, the actual value should be interpreted in dB.

Timing Offset

The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.

Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).

Microreflec (dBc)

The approximate value of microreflections on the downstream, measured in dBc below the signal level, as seen by the CM. Microreflections are a type of impairment that is caused by impedance mismatches between amplifiers, couples, cables, and other equipment in the cable plant. Microreflections create copies of a signal that arrive at the receiver with different amounts of delay and attenuation, generating intersymbol interference (ISI) that can cause the receiver to improperly detect the amplitude and phase of the incoming signal.

Note This value is not exact but provides an approximate indication of the microreflections that have been received.

DSPwr (dBmV)

Downstream receive power level, in dBmV, as reported by the CM.

DSSNR (dBmV)

Downstream signal-to-noise ratio (SNR), in dB, as reported by the CM.

Note This command displays values for the downstream power and SNR values only if you have configured the cable modem remote-query command on the CMTS, and if the CM supports providing those options.

Mode

DOCSIS operating mode for the CM:

tdma=DOCSIS 1.X, TDMA-only mode

atdma=DOCSIS 2.0 A-TDMA mode

A hyphen (-) indicates the mode is unknown or the CM has not yet registered.

For DOCSIS 3.0-certified cable modems with multiple upstream channels, the output may contain multiple results for the same MAC address. In Cisco IOS Release 12.2(33)SCC, the asterix (*) that appears beside the DOCSIS operating mode under the Mode column identifies that the CM is operating in the MTC mode.

Note This field is the same as that returned by the docsIfCmtsCmStatusModulationType object in the DOCS-IF-MIB.


Related Commands

Command
Description

cable modem remote-query

Enables and configures the remote-query feature to gather CM performance statistics on the CMTS.

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem mac

Displays MAC layer information for one or more CMs.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem primary-channel

To display the primary-channel and host interface for all modems or for modems on a MAC domain host interface, use the show cable modem primary-channel command.

show cable modem [cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]]] primary-channel [non-bonding-capable [legacy-ranging]] [wideband [registered-traditional-docsis]]

Syntax Description

slot

Slot where the line card resides. The valid range is from 5 to 8.

subslot

Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number. The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

non-bonding-capable

Displays the cable modems and primary downstreams of the cable modems that are not capable of bonding.

legacy-initial-ranging

Displays modems that access with legacy INIT-RNG-REQ.

wideband

Displays wideband online modems.

registered-traditional-docsis

Displays wideband cable modems registered in traditional pre-DOCSIS3.0 mode.


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Use this command to display the primary downstream channel information of modems for different modem categories in terms of bonding capability, such as, non-bonding-capable modems accessed with legacy initial ranging or wideband cable modems registered via traditional DOCSIS.

Examples

The following show cable modem primary-channel non-bonding-capable command shows the individual cable modems displays and the primary downstream channel for each cable modem.

Router# show cable modem primary-channel non-bonding-capable

MAC Address IP Address Host MAC Prim Num Primary DS

Interface State Sid CPE Downstream RfId

000f.66f9.aa73 80.17.1.3 C6/0/0/U0 online(pt) 1 0 C6/0/0 255

0007.0e02.d7e9 80.17.1.7 C6/0/0/U0 online(pt) 5 0 Mo3/0/0:1 1

0013.10bb.22f9 80.17.1.2 C6/0/0/U0 online(pt) 2 0 Mo3/0/0:1 1

000f.66f9.b193 80.17.1.6 C6/0/0/U0 online(pt) 22 0 C6/0/0 255

0012.17ea.f3fb 80.17.1.4 C6/0/0/U0 online(pt) 23 0 C6/0/0 255

0013.10bb.23d1 80.17.1.5 C6/0/1/U1 online(pt) 5 0 C6/0/1 255

Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem voice

Displays detected voice-enabled modems.

show cable service-voice downstream type

Shows the current enforced downstream type on the uBR10-MC5x20 line card.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.


show cable modem primary-channel summary total

To display the number of cable modems grouped by primary downstream channels information under a Channel Grouping Domain (CGD), use the show cable modem primary-channel summary total command in privileged EXEC mode.

show cable modem primary-channel [cable slot/subslot/port] summary total

Syntax Description

slot

The slot used for the cable interface line card. Valid values are 5 to 8.

subslot

The subslot used for the cable interface line card. Valid values are 0 to 1.

port

The downstream port used as a MAC domain host interface port. Valid values are 0 to 4.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.


Usage Guidelines

Use the show cable modem primary-channel summary total command to display the number of cable modems grouped by primary downstream channels. You can also use this command to display information for narrowband and wideband modems and group the information based on a SPA or a uBR10-MC 5x20 primary downstream. You can also display information on modems based on a specific cable MAC domain.

Examples

The following example shows attributes of the primary channels to which the various modems are hosted under the CGD domain c6/0/0.

Router#show cable modem primary-channel
MAC Address    IP Address      Host      MAC          Prim  Num  Primary    DS
                               Interface State        Sid   CPE  Downstream RfId
000f.66f9.aa73 80.17.1.2       C6/0/0/U0 online       13    0    C6/0/0     255
000f.66f9.b193 80.17.1.3       C6/0/0/U0 online       14    0    C6/0/0     255
0012.17ea.f3fb 80.17.1.5       C6/0/0/U0 online       15    0    C6/0/0     255
0019.474a.d4f8 80.17.1.13      C6/0/0/U0 online       16    0    C6/0/0     255
0000.cab7.7f1c 80.17.1.8       C6/0/0/U0 online       17    1    C6/0/0     255
0019.474a.d3d4 80.17.1.11      C6/0/0/U0 online       18    0    C6/0/0     255
0007.0e02.d7e9 80.17.1.10      C6/0/0/U0 online       19    0    C6/0/0     255
0019.474a.cd82 80.17.1.20      C6/0/0/U0 online       20    0    C6/0/0     255
0019.474a.d3fa 80.17.1.7       C6/0/0/U0 online       22    0    C6/0/0     255
0018.6852.82ea 80.17.1.6       C6/0/0/U0 online       24    0    C6/0/0     255
0013.10bb.23d1 80.17.1.12      C6/0/0/U0 online       23    1    Mo3/0/0:0  0

The following example shows modems grouped according to their capability, indicating whether they are wideband or narrowband modems. The command also displays the local of the primary downstreams of the modem, indicating whether the primary downstream is a SPA downstream (Remote) or a uBR10-MC 5x20 downstream (Local). The Wideband column indicates if the status of the modem is online or wideband-online.

Router#show cable modem primary-channel summary total
                                Cable Modem
            Total Reg   Oper  Unreg Offline Wideband initRC initD initIO initO 0-Blaze
Local Primary Narrowband:
C6/0/0      5     5     5     0     0       0        0      0     0      0     0
C6/0/1      0     0     0     0     0       0        0      0     0      0     0
Subtotal:   5     5     5     0     0       0        0      0     0      0     0
Local Primary Wideband:
C6/0/0      5     5     5     0     0       0        0      0     0      0     0
C6/0/1      0     0     0     0     0       0        0      0     0      0     0
Subtotal:   5     5     5     0     0       0        0      0     0      0     0
Remote Primary Narrowband:
Mo3/0/0:0   1     1     1     0     0       0        0      0     0      0     0
Subtotal:   1     1     1     0     0       0        0      0     0      0     0
Remote Primary Wideband:
Subtotal:   0     0     0     0     0       0        0      0     0      0     0
Total:      11    11    11    0     0       0        0      0     0      0     0

The example below shows the modems grouped by primary downstream channels for the cable MAC domain c6/0/0.

Router#show cable modem primary-channel summary c6/0/0 total
                                Cable Modem
            Total Reg   Oper  Unreg Offline Wideband initRC initD initIO initO 0-Blaze
Local Primary Narrowband:
C6/0/0      5     5     5     0     0       0        0      0     0      0     0
Local Primary Wideband:
C6/0/0      5     5     5     0     0       0        0      0     0      0     0
Remote Primary Narrowband:
Mo3/0/0:0   1     1     1     0     0       0        0      0     0      0     0
Subtotal:   1     1     1     0     0       0        0      0     0      0     0
Remote Primary Wideband:
Subtotal:   0     0     0     0     0       0        0      0     0      0     0
Total:      11    11    11    0     0       0        0      0     0      0     0

Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered cable modems.


show cable modem privacy

To display the privacy information for the registered and unregistered CMs, use the show cable modem privacy command in privileged EXEC mode.

Cisco uBR7200 Series Routers

show cable modem {ip-address | mac-address} privacy [verbose]

Cisco uBR10012 Router

show cable modem {ip-address | mac-address} privacy [verbose]

Syntax Description

ip-address

IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

privacy

Displays the privacy information for the CMs.

verbose

Displays detailed information for the CMs.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCC

This command was introduced.


Usage Guidelines

This command displays privacy information of a particular CM, identified by its IP address or MAC address.

Examples

The following sample output from the show cable modem privacy command shows the privacy information for a particular CM using a specified MAC address.

Router# show cable modem 0018.6835.2987 privacy 
MAC Address             : 0018.6835.2987
Primary SID             : 10
BPI Mode                : BPI+
BPI State               : assign(tek)
Security Capabilities   :
 Encryption             : DES-56 
 EAE                    : Unsupported 
Latest Key Sequence     : 2
 Key Status             : Active
 Remaining Lifetime     : 294 sec
 Key Gracetime          : 60 sec
Current Key Sequence    : 2
CA Certificate Details   :
 Certificate Serial       : 57BF2DF60E9FFBECF8E69709DE34BC26
 Certificate Self-Signed  : False
 Certificate State        : Chained
CM Certificate Details   :
 CM Certificate Serial    : 010244AF1A135202
 CM Certificate State     : Chained
KEK Reject Code         : None
KEK Reject Reason       : No Information
KEK Invalid Code        : None
KEK Invalid Reason      : No Information
Primary SID Information   :
SID                     : 10   
Encryption Algorithm    : 56-bit DES
Latest Sequence Number  : 5
 Key Status             : Active
 Remaining Lifetime     : 144 sec
 Key Gracetime          : 60 sec
Current Sequence Number : 4
 Key Status             : Active
 Remaining Lifetime     : 54 sec
 Key Gracetime          : 60 sec
TEK Reject Code         : None
TEK Reject Reason       : No Information
TEK Invalid Code        : None
TEK Invalid Reason      : No Information

Example of show cable modem privacy verbose Command Output for a Specified MAC Address

The following example shows sample output for the verbose option for a particular CM:

Router# show cable modem 0018.6835.2987 privacy verbose 
MAC Address             : 0018.6835.2987
Primary SID             : 10
BPI Mode                : BPI+
BPI State               : assign(tek)
Security Capabilities   :
 Encryption             : DES-56 
 EAE                    : Unsupported 
Latest Key Sequence     : 2
 Key Status             : Active
 Remaining Lifetime     : 256 sec
 Key Gracetime          : 60 sec
 Authorization Key      : 2004065504831967119C16051FD722C5209E165F
 Key Encryption Key     : F14EFC15118B6B06
 Upstream HMAC Key      : 150E3F56451F6E033DEB79BCF819A9D8EAF6B95D
 Downstream HMAC Key    : 9AA3EC8869D64927560589692CCE4C21F3DA9029
Current Key Sequence    : 2
Authorization Counters  :
 Authorization Infos     : 4
 Authorization Requests  : 2
 Authorization Replies   : 2
 Authorization Rejects   : 0
 Authorization Invalids  : 0
Traffic Key Counters     :
 Traffic Key Requests    : 4
 Traffic Key Replies     : 4
 Traffic Key Rejects     : 0
 Traffic Key Invalids    : 0
Certificate Counters      :
 Untrusted Manufacturer   : 0
 Untrusted CM Certificate : 0
 Issuer Not Found         : 0
 Invalid Signature        : 0
 Expired Certificate      : 0
 Certificate Not Activated: 0
 Certificate in Hotlist   : 0
 Public Key Mismatch      : 0
 Invalid MAC              : 0
 Invalid CM Certificate   : 0
CA Certificate Details   :
 Certificate Serial       : 57BF2DF60E9FFBECF8E69709DE34BC26
 Certificate Self-Signed  : False
 Certificate State        : Chained
CM Certificate Details   :
 CM Certificate Serial    : 010244AF1A135202
 CM Certificate State     : Chained
KEK Reject Code         : None
KEK Reject Reason       : No Information
KEK Invalid Code        : None
KEK Invalid Reason      : No Information
Primary SID Information   :
SID                     : 10   
Encryption Algorithm    : 56-bit DES
Latest Sequence Number  : 5
 Key Status             : Active
 Remaining Lifetime     : 106 sec
 Key Gracetime          : 60 sec
 Hardware Keys Match    : True
 DES Key                : 156819BF016E139B
 DES IV                 : 07291CAE15AD0845
Current Sequence Number : 4
 Key Status             : Active
 Remaining Lifetime     : 16 sec
 Key Gracetime          : 60 sec
 Hardware Keys Match    : True
 DES Key                : 23EF1C9801F40EE3
 DES IV                 : 163D19831AFB25DC
TEK Requests            : 4
TEK Replies             : 4
TEK Rejects             : 0
TEK Invalids            : 0
TEK Receive Errors      : 0
TEK Reject Code         : None
TEK Reject Reason       : No Information
TEK Invalid Code        : None
TEK Invalid Reason      : No Information

Table 111 describes the major fields shown in the show cable modem privacy command display:

Table 111 show cable modem privacy Field Descriptions 

Field
Description

MAC Address

MAC address for the CM.

Prim SID

Primary SID assigned to the CM.

BPI Mode

Baseline Privacy Interface (BPI) mode used.

BPI State

Displays the BPI state.

Security Capabilities

Security capabilities of the modem like encryption algorithm and Early Authentication and Encryption (EAE).

Encryption

Encryption method used.

EAE

EAE support.

Latest Key Sequence

Latest key sequence number.

Key Status

Status of the key; whether active or not.

Remaining Lifetime

Remaining lifetime of the key in seconds.

Key Gracetime

Grace time available for the key in seconds.

Authorization Key

Authorization key code.

Key Encryption Key

Key used to encrypt the traffic key.

Upstream HMAC Key

Upstream Hashed Message Authentication Code (HMAC) key.

Downstream HMAC Key

Downstream Hashed Message Authentication Code (HMAC) key.

Current Key Sequence

Current key sequence number.

Authorization Counters

Authorization counter information.

Authorization Infos

Authorization information.

Authorization Requests

Number of authorized requests.

Authorization Replies

Number of authorized replies.

Authorization Rejects

Rejected authorization.

Authorization Invalids

Invalid authorization.

Traffic Key Counters

Traffic key counter informayion.

Traffic Key Requests

Number of traffic key requests.

Traffic Key Replies

Number of traffic key replies.

Traffic Key Rejects

Number of traffic key rejects.

Traffic Key Invalids

Number of invalid traffic keys.

Certificate Counters

Certificate counter information.

Untrusted Manufacturer

Count of untrusted manufacturers.

Untrusted CM Certificate

Count of untrusted CM certificates.

Issuer Not Found

Count of certificate issuers not found in the database.

Invalid Signature

Count of invalid signatures.

Expired Certificate

Number of expired certificates.

Certificate Not Activated

Count of certificates not activated.

Certificate in Hotlist

Number of certificates in hotlist.

Public Key Mismatch

Number of public key mismatch.

Invalid MAC

Number of invalid MACs.

Invalid CM Certificate

Number of invalid CM certificates.

CA Certificate Details

CA certificate information.

Certificate Serial

CA certificate serial number.

Certificate Self-Signed

Self-signed CA certificate.

Certificate State

Current state of the CA certificate.

CM Certificate Details

CM certificate information.

CM Certificate Serial

CM certificate serial number.

CM Certificate State

Current state of the CM certificate.

KEK Reject Code

Key Encryption Key (KEK) reject code.

KEK Reject Reason

KEK reject reason.

KEK Invalid Code

KEK invalid code.

KEK Invalid Reason

Reason for the invalid KEK.

Primary SID Information

Primary SID assigned to this CM.

SID

SID used by the CM.

Encryption Algorithm

Encryption algorithm used.

Latest Sequence Number

Latest sequence number.

Current Sequence Number

Current sequence number.

Hardware Keys Match

Hardware key match.

DES Key

Data Encryption Standard (DES) key number.

DES IV

Initialization vector. This can be AES or DES.

TEK Requests

Displays the number of Traffic Exchange Key (TEK) requests.

TEK Replies

Number of TEK requests.

TEK Rejects

Number of TEK rejects.

TEK Invalids

Number of invalid TEKs.

TEK Receive Errors

Number of TEK receive errors.

TEK Reject Code

TEK reject code.

TEK Reject Reason

TEK reject reason.

TEK Invalid Code

TEK invalid code.

TEK Invalid Reason

TEK invalid reason.


Related Commands

Command
Description

cable privacy

Enables and configures BPI+ encryption on a cable interface.

cable privacy kek

Sets KEK and timeout periods.

cable privacy tek

Sets TEK and timeout periods.

show cable privacy

Displays information about BPI status and operation.


show cable modem qos

To display the quality of service (QoS) and service flow information for a particular cable modem (CM), use the show cable modem qos command in privileged EXEC mode.

show cable modem {ip-address | mac-address | name fqdn} qos [service-class | verbose]

Syntax Description

ip-address

IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

service-class

(Optional) Displays the service class names associated with each service flow for a specific cable modem.

verbose

(Optional) Displays detailed information for each service flow ID (SFID) for the CM.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCC

The command output was modified to display the traffic peak rate value for a specific service flow.

12.2(33)SCF

This command was modified. The service-class keyword was added to display the service class names for each service flow for a specific cable modem.

12.2(33)SCG

The command output was modified to display the scheduling type as "N/A" for all downstream service flows.


Usage Guidelines

This command displays the service flows currently in use by a CM. The default form of the display shows one service flow per line, while the verbose form displays complete information for each flow.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.



Note Starting with Cisco IOS Release 12.2(33)SCG, the output of the show cable modem qos command displays the scheduling type of all downstream service flows (DS-SF) as "N/A" to indicate that the DS-SFs do not have any scheduling type.


Examples

Example of the show cable modem qos Command for a Cable Modem Specified by MAC Address

The following example is a sample output of the show cable modem qos command for a specific CM identified by its MAC address:

Router# show cable modem 0010.7bb3.fcd1 qos 
Sfid  Dir Curr  Sid   Sched  Prio MaxSusRate  MaxBrst   MinRsvRate  Throughput 
          State       Type
3     US  act   1     BE     7    2000000     1522      100000      0          
4     DS  act   N/A   BE     0    4000000     1522      0           0          

Example of the show cable modem qos Command for a Cable Modem Specified by IP Address

The following example is a sample output of the show cable modem qos command for a specific CM identified by its IP address:

Router# show cable modem 22.1.1.10 qos 
Sfid  Dir Curr  Sid   Sched  Prio MaxSusRate  MaxBrst   MinRsvRate  Throughput 
          State       Type
7     US  act   3     BE     0    0           3044      0           0          
9     US  act   4     BE     0    1000000     65224     0           0          
10    US  act   5     BE     0    1000000     65224     0           0          
8     DS  act   N/A   BE     0    0           3044      0           0          

Example of the show cable modem qos verbose Command for a Cable Modem Specified by IP Address

The following example is a sample output for the verbose form of the show cable modem qos command for a specific CM identified by its IP address:

Router# show cable modem 22.1.1.10 qos verbose 
Sfid                                    : 7
Current State                           : Active
Sid                                     : 3
Traffic Priority                        : 0
Maximum Sustained rate                  : 0 bits/sec
Maximum Burst                           : 3044 bytes
Mimimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 64 bytes
Admitted QoS Timeout                    : 200 seconds
Active QoS Timeout                      : 0 seconds
Maximum Concatenated Burst              : 1522 bytes
Scheduling Type                         : Best Effort
Request/Transmission policy             : 0x0
IP ToS Overwrite[AND-mask, OR-mask]     : 0xFF, 0x0
Current Throughput                      : 0 bits/sec, 0 packets/sec
Sfid                                    : 9
Current State                           : Active
Sid                                     : 4
Traffic Priority                        : 0
Maximum Sustained rate                  : 1000000 bits/sec
Maximum Burst                           : 65224 bytes
Mimimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 64 bytes
Admitted QoS Timeout                    : 0 seconds
Active QoS Timeout                      : 0 seconds
Maximum Concatenated Burst              : 1522 bytes
Scheduling Type                         : Best Effort
Request/Transmission policy             : 0x0
IP ToS Overwrite[AND-mask, OR-mask]     : 0xFF, 0x0
Current Throughput                      : 0 bits/sec, 0 packets/sec
Sfid                                    : 10
Current State                           : Active
Sid                                     : 5
Traffic Priority                        : 0
Maximum Sustained rate                  : 1000000 bits/sec
Maximum Burst                           : 65224 bytes
Mimimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 64 bytes
Admitted QoS Timeout                    : 0 seconds
Active QoS Timeout                      : 0 seconds
Maximum Concatenated Burst              : 1522 bytes
Scheduling Type                         : Best Effort
Request/Transmission policy             : 0x0
IP ToS Overwrite[AND-mask, OR-mask]     : 0xFF, 0x0
Current Throughput                      : 0 bits/sec, 0 packets/sec
Sfid                                    : 8
Current State                           : Active
Sid                                     : N/A
Traffic Priority                        : 0
Maximum Sustained rate                  : 0 bits/sec
Maximum Burst                           : 3044 bytes
Mimimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 64 bytes
Admitted QoS Timeout                    : 200 seconds
Active QoS Timeout                      : 0 seconds
Maximum Latency                         : 0 usecs
Current Throughput                      : 0 bits/sec, 0 packets/sec

The following example is a sample output for the verbose form of the show cable modem qos command indicating the traffic peak rate value for a specific service flow.

Router# show cable modem 22.1.1.10 qos verbose 
Sfid                                    : 40
Current State                           : Active
Sid                                     : 35
Traffic Priority                        : 4
Maximum Sustained rate                  : 20000000 bits/sec
Maximum Burst                           : 20000000 bytes
Minimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 0 bytes
Admitted QoS Timeout                    : 200 seconds
Active QoS Timeout                      : 0 seconds
Maximum Concatenated Burst              : 65535 bytes
Scheduling Type                         : Best Effort
Request/Transmission policy             : 0x0
IP ToS Overwrite[AND-mask, OR-mask]     : 0xFF, 0x0
Peak Rate                               : 50000000 bits/sec
Current Throughput                      : 0 bits/sec, 0 packets/sec 

Example of the show cable modem qos service-class Command for a Cable Modem in Cisco IOS Release 12.2(33)SCF

The following example is a sample output of the service-class option of the show cable modem qos command for a specific CM identified by its IP address:

Router# show cable modem 22.1.1.10 qos service-class
Sfid  Dir Sched  MaxSusRate  MaxBrst     MinRsvRate  SrvClassName
          Type
33    US  BE     0           3044        0           us_srvclass_ts1
35    US  BE     0           3044        0           us_srvclass_ts2
34    DS  BE     0           3044        0           ds_srvclass_ts1
36    DS  BE     0           3044        0           ds_srvclass_ts2

Table 112 describes the major fields shown in the show cable modem qos displays:

Table 112 Descriptions for the show cable modem qos Fields 

Field
Description

Sfid

Identifies the Service Flow ID (SFID) for this service flow.

Dir

Identifies whether the service flow applies to the downstream (DS) or upstream (US) direction.

Curr State

Current State—Identifies the current state of the service flow: Active or Inactive.

Sid

Identifies the Service ID (SID) associated with this SFID.

Sched Type

Identifies this service flow's scheduling type:

BE—Best-Effort

NRTPS—Non-Real-Time Polling Service

N/A—Scheduling type is not applicable to a service flow.

RTPS—Real-Time Polling Service

RSVD—Reserved but not yet in use

UGS_AD—Unsolicited Grant Service with Activity Detection

UGS—Unsolicited Grant Service

UNDEF—Not yet defined.

Prio

Traffic priority (0 to 7) given to this service flow.

MaxSusRate

Maximum sustained rate value, in bits per second.

MaxBrst

Maximum burst value, in bytes.

MinRsvRate

Minimum reserved rate, in bits per second.

Throughput

Current Throughput for this service flow, in packets per second.

SrvClassName

Service class name associated with this service flow.

Minimum Packet Size

Assumed minimum reserved rate packet size on this service flow, in bytes.

Admitted QoS Timeout

Timeout for admitted QoS parameters, in seconds, which specifies the length of time that the CMTS must reserve resources for a service flow's admitted Qos parameter set, when they exceed the resources allowed by the active QoS parameter set.

Active QoS Timeout

Timeout for active Qos parameters, in seconds, which specifies the maximum amount of time that resources can remained unused on an active service flow.

Maximum Latency

Maximum downstream latency allowed for packets using this service flow, in microseconds.


Related Commands

Command
Description

cable qos permission

Specifies permission for updating the cable router QoS table.

cable qos profile

Configures a QoS profiles.

cable service-flow inactivity-timeout

Sets the amount of time a dynamic service flow can be present in the system without any activity.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS router.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS router.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable qos paramset

Displays the DOCSIS 1.1 QoS parameter sets.

show interface cable sid

Displays cable interface information.

show cable qos profile

Displays quality-of-service (QoS) profiles for a Cisco CMTS router.


show cable modem registered

To display a list of the cable modems (CMs) that have registered with the Cisco CMTS, use the show cable modem registered command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] registered

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] registered

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Displays the logical channel index. Valid values are 0 and 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

registered

Displays a list of the cable modems that have registered with the Cisco CMTS.


Defaults

Displays a list of all registered CMs on the Cisco CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3 NA

This command was introduced.

12.2(4)BC1

Support for the Cisco uBR10012 router was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The alignment of output fields has been changed.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address co