Table Of Contents

Cable Commands: show a through show cable l

show application-buckets

show bridge cable-modem

show cable admission-control

show cable arp-filter

show cable bundle

show cable bundle multicast

show cable burst-profile

show cable calls

show cable clock

show cable clock dti counters

show cable clock dti status

show cable device access-group

show cable dsg

show cable dsg tunnel

show cable fiber-node

show cable filter

show cable flap-list

show cable flap-list wb-rf

show cable hop

show cable host access-group

show cable ib-ipc

show cable ipc-stats

show cable l2-vpn dot1q-vc-map

show cable l2-vpn xconnect

show cable leasequery-filter

show cable load-balance

show cable load-balance docsis-group

show cable logging

Cable Commands: show a through show cable l

---

Revised: November 13, 2009, OL-15510-10

New Commands

Command	Cisco IOS Software Release
show cable clock dti counters	12.3(23)BC
show cable clock dti status,	12.3(23)BC
show cable ib-ipc	12.3(23)BC
show cable flap-list wb-rf	12.2(33)SCB
show cable fiber-node	12.2(33)SCC
show cable ipc-stats	12.2(33)SCC
show cable load-balance docsis-group	12.2(33)SCC
show cable l2-vpn xconnect	12.2(33)SCC

Modified Commands

Command	Cisco IOS Software Release
show cable admission-control	12.3(23)BC
show cable clock	12.3(23)BC
show cable filter	12.2(33)SCA
show cable l2-vpn dot1q-vc-map	12.2(33)SCA
show cable logging	12.3(23)BC5
show cable logging	12.2(33)SCB
show cable hop	12.3(23)BC7
show cable admission-control	12.2(33)SCC
show cable flap-list	12.2(33)SCC
show cable load-balance	12.2(33)SCC
show cable hop	12.2(33)SCC

Replaced Commands

Command	Replacement Command	Effective Cisco IOS Release
show cable dsg	show cable dsg tunnel	12.3(13a)BC

show application-buckets

To displays rules for any or all buckets supporting Service Flow Admission Control on the Cisco CMTS, use the show application-buckets command in privileged EXEC mode. The configured rules for any given bucket are displayed in order of precedence in the Rule field.

show application-buckets [ bucket-no n ]

Syntax Description

bucket-no n

You may specify a specific bucket number on the Cisco CMTS to display parameters for that bucket and no others. Valid range is 1 to 8, or all buckets if no specific bucket is designated.

Command Default

No default behavior or values for this command. However, Cisco IOS Release 12.3(21)BC supports default operation and non-default configuration for feature on the Cisco CMTS.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(21)BC	This command was introduced for the Cisco uBR10012 router and the Cisco uBR7246VXR router.

Usage Guidelines

For additional information for Service Flow Admission Control, commencing in Cisco IOS Release 12.3(21)BC, refer to the following document on Cisco.com:

•Service Flow Admission Control for the Cisco Cable Modem Termination System

Examples

The following example illustrates sample output of the show application-buckets command.

Router# show cable application-type 

For bucket 1, Name PktCable 

     Packetcable normal priority gates

     Packetcable high priority gates

For bucket 2, Name PCMM-Vid 

     PCMM gate app-id = 30

For bucket 3, Name Gaming 

     PCMM gate app-id = 40

For bucket 4, Name  

For bucket 5, Name  

For bucket 6, Name  

For bucket 7, Name  

For bucket 8, Name HSD 

     Best-effort (CIR) flows

Related Commands

Command	Description
cable admission-control ds-bandwidth	Sets minor, major and exclusive thresholds for downstream voice or data bandwidth for each or all interfaces on the Cisco CMTS
cable admission-control preempt priority-voice	Changes the default PacketCable Emergency 911 call preemption functions on the Cisco CMTS, supporting throughput and bandwidth requirements for Emergency 911 calls above all other buckets on the Cisco CMTS.
cable admission-control us-bandwidth	Configures global or interface-level upstream bandwidth thresholds and exclusive or non-exclusive resources on the Cisco CMTS.
cable application-type include	Associates an application type with a specific and prioritized bucket on the Cisco CMTS.
cable application-type name	Assigns an alpha-numeric name for the specified bucket.
debug cable admission-control flow-categorization	Displays service flow categorization results, enabled when a service flow is classified.
show application-buckets	Displays rules for any or all buckets supporting Service Flow Admission Control on the Cisco CMTS.
show interface cable admission-control reservation	Displays service flows, categorizations, and bandwidth consumption on the Cisco CMTS, for the specified interface, and the specified service flow direction.

show bridge cable-modem

To display bridging information for the router's cable interface, use the show bridge cable-modem command in privileged EXEC mode.

Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter

show bridge cable-modem number

Syntax Description

number

Identifies the cable interface (always 0).

Command Default

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3(4)NA	This command was introduced for the Cisco uBR904 cable access router.
12.0(4)XI1	Support was added for the Cisco uBR924 cable access router.
12.1(3)XL	Support was added for the Cisco uBR905 cable access router.
12.1(5)XU1	Support was added for the Cisco CVA122 Cable Voice Adapter.
12.2(2)XA	Support was added for the Cisco uBR925 cable access router.

Examples

The following example shows sample output for this show bridge cable-modem command:

Router# show bridge cable-modem 0 

Total of 300 station blocks, 298 free

Codes: P - permanent, S - self

Bridge Group 59:

Table 0-32 describes the significant fields shown in the display.

Table 0-32 show bridge cable-modem Field Descriptions

Field	Description
Total of 300 station blocks	Total number of forwarding database elements in the system. The memory to hold bridge entries is allocated in blocks of memory sufficient to hold 300 individual entries. When the number of free entries falls below 25, another block of memory sufficient to hold another 300 entries is allocated. Thus, the total number of forwarding elements in the system is expanded dynamically, as needed, limited by the amount of free memory in the router.
Bridge Group	The number of the bridge group to which this interface is assigned.

---

Tip In Cisco IOS Release 12.2(8)T 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
show dhcp	Displays the current DHCP settings on point-to-point interfaces.
show interfaces cable-modem	Displays information about the cable interface.

show cable admission-control

To display the current admission control configuration and status on a Cisco CMTS router, or on a specified interface, use the show cable admission-control command in privileged EXEC mode.

show cable admission-control [global] [interface slot/port | slot/subslot/port] [all]

Syntax Description

global	(Optional) Displays the following information: •Parameters that have been configured for admission control •Number of requests that have crossed minor, major, and critical levels for each resource
interface slot/port | slot/subslot/port	(Optional) Allows you to display admission control information for the specified interface or port. This includes the following: •Values for US throughput resources •Values for DS throughput resources The Cisco universal broadband routers differ in slot selection as follows: •slot/subslot/port—For the Cisco uBR10012 router, slot can range from 5 to 8, subslot can be 0 or 1, and port can be 0 to 4 (depending on the cable interface) •slot/port—On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
all	(Optional) Displays information for all interfaces configured for Admission Control on the Cisco CMTS.

Defaults

There are no default behaviors or values.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.3(13a)BC	This command was introduced on the Cisco uBR10012 router and the Cisco uBR7246VXR router.
12.3(23)BC	This command was modified; new fields were added to the output.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
12.2(33)SCC	This command was modified to display DS threshold values and reservations per bucket on a modular cable or interface cable or DS channel bonding.

Usage Guidelines

This command offers flexible syntax that enables display of Admission Control as specifically configured on the Cisco CMTS. Refer to examples for additional information.

Examples

The following example illustrates upstream and downstream Admission Control information for the specified cable interface:

Router# show cable admission-control interface 7/0/0

Interface  Cable7/0/0

 Resource - Upstream Bandwidth 

 ----------------------------- 

Thresholds applicable to upstream ports with no interface level

 configurations in place

Bucket                  Minor          Major         Exclusive         Non-Excls

No                      Level          Level         Level             Level    

1                         0              0              0                 0

2                         0              0              0                 0

3                         0              0              0                 0

4                         0              0              0                 0

5                         0              0              0                 0

6                         0              0              0                 0

7                         0              0              0                 0

8                         0              0              0                 0

Downstream Bit Rate (bits per second) = 24273316

 Resource - Downstream Bandwidth

 ------------------------------- 

Bkt    Name   Minor # of  Major # of  Excls # of  Non-Ex Curr. Curr. Conf  # of

No            Level Times Level Times Level Times Level  Resv  Ovrsb Level Rej

1             0     0     0     0     0     0     100*    0.0   0.0  G       0

2             0     0     0     0     0     0     100*    0.0   0.0  G       0

3             0     0     0     0     0     0     100*    0.0   0.0  G       0

4             0     0     0     0     0     0     100*    0.0   0.0  G       0

5             0     0     0     0     0     0     100*    0.0   0.0  G       0

6             0     0     0     0     0     0     100*    0.0   0.0  G       0

7             0     0     0     0     0     0     100*    0.0   0.0  G       0

8             0     0     0     0     0     0     100*   12.3   0.0  G       0

 Note: * indicates that the thresholds are implicit

 Resource - Modular Downstream Bandwidth

 ------------------------------- 

Interface       Total(Kbps)       Reservable(Kbps)       Allocated(Kbps)

Mo1/0/0:0            19405                  12424                   3100

Table 33 describes the significant fields in the display above.

Table 33 show cable admission-control Field Descriptions for Upstream and Downstream Throughput 

Field	Description
Sched Type	Available for upstream only. This field displays the following information: •UGS—UGS thresholds configured and traffic rates. •RTPS—RTPS thresholds configured and traffic rates. •BE—Best Effort thresholds configured and traffic rates.
Flow Type	Available for Downstream only. This field displays voice and data information: •voice—Voice thresholds configured and traffic rates. •data—Data thresholds configured and traffic rates.
Class Name	Available for upstream only,
Minor Level	Minor threshold as currently defined in a percentage on the Cisco CMTS.
# of Times	Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Major Level	Major threshold as currently defined in a percentage on the Cisco CMTS.
# of Times	Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Exclusive Level	Percentage of exclusive throughput that is reserved for the corresponding traffic type on the Cisco CMTS. Applies to downstream or upstream traffic.
# of Times	Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Non-Excls Level	Percentage of non-exclusive throughput configured on the Cisco CMTS. Commonly used with Best Effort (lowest priority) traffic.
Curr Reserv	Percentage of throughput reserved exclusively for the corresponding flow type.
Conf Level	Configuration level that indicates the scope of configuration is actually applied for that US/ DS (whether the global, interface, or the upstream level is applied). Values in this field can be as follows: •U—Upstream •I—Interface •G—Global

The following example illustrates all Admission Control information for the specified upstream port:

Router# show cable admission-control interface c8/0/1 upstream all

US   Sched  Class  Minor  # of    Major  # of   Excls  # of   Non-Ex  Curr.   Conf

Port type   Name   Level  Times   Level  Times  Level  Times  Level   Reserv  Level

0    UGS    -      23     0       27     0      30     0      5       22      U

0    RTPS   -      12     0       15     0      20     0      7       10      U

1    UGS    name1  30     10      35     10     40     9      5       34      I

The following example illustrates upstream and downstream Admission Control information for the specified interface:

Router# show cable admission-control interface c8/0/1

Interface c8/0/1:

Resource - Upstream Bandwidth

-------------------------------

Sched   Class   Minor   # of    Major   # of   Exclusive # of    Non-Excls

Type    Name    Level   Times   Level   Times  Level     Times   Level

UGS     -       25      5       30      4      40        2       5

RTPS    -       14      0       18      0      25        0       5

BE      -       16      21      18      20     20        100     5

Resource - Downstream Bandwidth

----------------------------------------

Flow   Minor   # of    Major   # of    Excls   # of    Non-Excls   Curr.    Conf

Type   Level   Times   Level   Times   Level   Times   Level       Reserv   Level

voice  35      10      40      8       45      6       0           38       I

The following example illustrates all Admission Control information for the specified upstream port:

Router# show cable admission-control interface w1/0/0:5 

Configured AC Max Reservable Bandwidth = 14000000 bps

Resource - Downstream Bandwidth 

----------------------------- 

Bucket Names  Minor # of  Major # of  Excls # of  Non-Ex Curr. Curr. Conf  # of

No            Level Times Level Times Level Times Level  Resv  Ovrsb Level Rejec

1             5     1312  7     1262  45    0     0      31    0     I    36

2             0     0     0     0     0     0     6*     0     0     I     0

3             0     0     0     0     0     0     6*     0     0     I     0

4             0     0     0     0     0     0     6*     0     0     I     0

5             0     0     0     0     0     0     6*     0     0     I     0

6             0     0     0     0     0     0     6*     0     0     I     0

7             0     0     0     0     0     0     6*     0     0     I     0

8             5     31    7     29    49    11    5      79    25    I     0

Table 34 describes the significant fields in the display above.

Table 34 show cable admission-control Field Descriptions for Upstream and Downstream Throughput 

Field	Description
Bucket No	Specific bucket number.
Names	Bucket name.
Minor Level	Minor threshold as currently defined in a percentage on the Cisco CMTS.
# of Times	Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Major Level	Major threshold as currently defined in a percentage on the Cisco CMTS.
# of Times	Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Excls Level	Percentage of exclusive throughput that is reserved for the corresponding traffic type on the Cisco CMTS. Applies to downstream or upstream traffic.
# of Times	Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Non-Ex Level	Percentage of non-exclusive throughput configured on the Cisco CMTS. Commonly used with Best Effort (lowest priority) traffic.
Curr Resv	Percentage of throughput reserved exclusively for the corresponding flow type.
Conf Level	Configuration Level that indicates the scope of configuration is actually applied for that US/ DS (whether the global, interface, or the upstream level is applied). Values in this field can be as follows: •U—Upstream •I—Interface •G—Global
# of Rejec	Number of rejections.

The following example illustrates upstream and downstream Admission Control information with the global keyword:

Router# show cable admission-control global

Resource    Minor   # times    Major   # times   Critical   # times   Current

cpu-5sec    50%     0         70%      0         90%        0         0

proc-mem    50%     0         70%      0         90%        0         0

io-mem      50%     1         60%      1         70%        1         75

total-mem   50%     0         70%      0         90%        0         0

Number of Packetcable voice calls = 80/100 (maximum)

Resource - Upstream Bandwidth

----------------------------------------

Sched   Class   Minor   # of    Major   # of    Exclusive   # of    Non-Excls

Type    Name    Level   Times   Level   Times   Level       Times   Level

UGS     -       25      5       30      4       40          2       5

UGS     name1   7       2       10      2       15          0       4

UGS     name2   10      1       15      1       20          1       4

RTPS    -       14      0       18      0       25          0       5

Resource - Downstream Bandwidth

----------------------------------------

Flow    Minor    # of    Major    # of     Exclusive   # of    Non-Excls

Type    Level    Times   Level    Times    Level       Times   Level

voice   35       10      40       8        45          6       0

Table 35 describes the significant fields for the global keyword used in the example above.

Table 35 show cable admission-control Field Descriptions with global Keyword

Field	Description
CM-Registration event	Counter increments once for every cable modem that crosses a threshold during its registration. For example, if the minor, major, and critical thresholds on the Cisco CMTS are 60%, 70%, and 80% respectively, and a cable modem tries to register when the current value is 80%, then the cable modem is allowed to register, but the counters for minor, major and critical thresholds are each incremented by one.
Voice-Call event	Counter increments if the resource check fails when a voice-call is made. For example, assume both the MTAs are on the same Cisco CMTS, and minor, major, and critical thresholds for I/O memory are 50%, 60%, and 70%, respectively. Then assume the current I/O memory value is 75%. In this scenario, before the gate creation, Admission Control performs an I/O memory check. This results in the counters for minor, major, and critical thresholds each being incremented by one, and the voice call fails. No packetcable gates are created because the voice calls fail.

Related Commands

Command	Description
cable admission-control	Configures the CPU and memory thresholds for the Cisco CMTS and supporting broadband processing engines (BPEs)
cable admission-control event	Configures and enables Admission Control event types on the Cisco CMTS.
cable admission-control ds-bandwidth	Configures Admission Control downstream bandwidth thresholds on the Cisco CMTS.
cable admission-control max-reserved-bandwidth	Defines the maximum reserved bandwidth per bonding group for all service flows that are allowed by the Cisco CMTS.
cable admission-control us-bandwidth	Configures Admission Control upstream bandwidth thresholds on the Cisco CMTS.
clear cable admission control counters	Clears all Admission Control resource counters on the Cisco CMTS.
debug cable admission-control	Enables automatic Admission Control troubleshooting processes on the Cisco CMTS.

show cable arp-filter

To display the total number of Address Resolution Protocol (ARP) replies and requests that have been sent and received, including the number of requests that have been filtered, use the show cable arp-filter command in privileged EXEC mode.

show cable arp-filter cable slot/port [ip-requests-filtered number] [requests-filtered number | replies-filtered number]

show cable arp-filter cable slot/subslot/port [ip-requests-filtered number] [requests-filtered number | replies-filtered number]

Syntax Description

cable slot/port	Displays information for all CMs on the specified cable interface and downstream port on the Cisco uBR7246VXR router. On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
cable slot/subslot/port	Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router. The following are the valid values: •slot = 5 to 8 •subslot = 0 or 1 •port = 0 to 4 (depending on the cable interface)
[ip-requests-filtered number]	(Optional) Displays the Service IDs (SIDs) that are generating or forwarding more filtered ARP requests for IP packets than the specified minimum number of packets. The valid range for number is 1 to 65535, with no default. Note This field shows the modems that are forwarding IP traffic that could be an part of an attack, such as TCP SYN floods, ping scans, and so forth.
[requests-filtered number]	(Optional) Displays the Service IDs (SIDs) that are generating or forwarding more filtered ARP requests than the specified minimum number of packets. The valid range for number is 1 to 65535, with no default.
[replies-filtered number]	(Optional) Displays the Service IDs (SIDs) that are generating or filtering more filtered ARP replies than the specified minimum number of packets. The valid range for number is 1 to 65535, with no default.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(15)BC2	This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers.
12.2(15)BC2b	The ip-requests-filtered option was added to display the specific Service IDs (SIDs) that are generating or forwarding a minimum number of ARP packets.

Usage Guidelines

The cable arp filter command enables the filtering of ARP request and reply packets on a cable interface. ARP packets might need to be filtered when a user on the cable network generates a large volume of ARP traffic as part of a theft-of-service or denial-of-service attack, or when a virus is using ARP requests to find other computers that it might infect.

The show cable arp-filter command displays the total number of ARP reply packets that have been received and the number of ARP request packets that have been sent on the cable interface, as well as the number of such packets that have been filtered.

---

Tip To clear the counters on all interfaces, use the clear counters command. To clear the counters on a specific interface, use the clear counters cable interface command.

---

Examples

The following example shows the typical output from the show cable arp-filter command on a Cisco uBR10012 router. The displays for other Cisco CMTS platforms are similar.

Router# show cable arp-filter Cable5/0/0 

ARP Filter statistics for Cable5/0/0:

  Replies Rcvd: 177387 total, 1869 unfiltered, 8824 filtered 

  Requests Sent For IP: 68625 total, 964 unfiltered, 36062 filtered 

  Requests Forwarded: 7969175 total, 7213 unfiltered, 366167 filtered 

Router# 

Table 0-36 describes the fields shown in the display.

Table 0-36 show cable arp-filter Field Descriptions 

Field	Description
Replies Rcvd
Total	Total number of ARP reply packets received on the cable interface since power-on.
Unfiltered	Number of ARP reply packets that the cable interface received and accepted while filtering was enabled using the cable arp filter reply-accept command.
Filtered	Number of ARP reply packets that the cable interface dropped while filtering was enabled, because they would have otherwise exceeded the allowable threshold value that was configured for the interface using the cable arp filter reply-accept command.
Requests Sent For IP
Total	Total number of ARP request packets that the cable interface was asked to forward since power-on.
Unfiltered	Number of ARP request packets that the cable interface sent while filtering was enabled using the cable arp filter request-send command.
Filtered	Number of ARP request packets that the cable interface dropped, because they would have otherwise exceeded the allowable threshold value that was configured for the interface using the cable arp filter request-send command.
Requests Forwarded
Total	Total number of ARP request packets that the cable interface was asked to forward to the ARP proxy since power-on.
Unfiltered	Number of ARP request packets that the cable interface sent to the ARP proxy while filtering was enabled using the cable arp filter request-send command.
Filtered	Number of ARP request packets for the ARP proxy that the cable interface dropped, because they would have otherwise exceeded the allowable threshold value that was configured for the interface using the cable arp filter request-send command.
Note All counters are 16-bit counters, with a maximum value of 65,535 packets. If the number of packets exceeds this amount, the counter wraps back to zero and begins incrementing again.

---

Note The Total counts in the show cable arp-filter command continue to increment, regardless of whether ARP filtering has been enabled. The Unfiltered and Filtered counts increment only when ARP filtering has been enabled using the cable arp filter command. When cable ARP filtering is disabled, these counters retain their current values until manually reset, using the clear counters command.

---

The following example shows how to display the devices that are generating or filtering more than 100 ARP requests per reporting period. Repeat the command to see how quickly the device is generating ARP packets.

Router# show cable arp-filter c7/0/0 requests-filtered 100 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

1    0006.2854.72d7 50.3.81.4       12407          0                    0  

Router# show cable arp-filter c7/0/0 requests-filtered 100 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

1    0006.2854.72d7 50.3.81.4       14597          0                    0  

Router# 

The following example shows how to display the devices that are generating or filtering more than 200 ARP replies per reporting period. Repeat the command to see how quickly the device is generating ARP packets.

Router# show cable arp-filter c5/0/0 replies-filtered 200 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

2    0006.53b6.562f 50.3.81.6       0              0                    2358  

Router# show cable arp-filter c5/0/0 replies-filtered 200 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

2    0006.53b6.562f 50.3.81.6       0              0                    4016 

Router# 

The following example shows how to display the devices that are generating or filtering more than 10 ARP requests for IP packets per reporting period. Repeat the command to see how quickly the device is generating ARP packets.

Router# show cable arp-filter c3/0 ip-requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

2    0006.2854.71e7 50.3.72.4       0              1926                 0

Router# 

Table 0-37 describes the fields shown in the display.

Table 0-37 show cable arp-filter Detail Field Descriptions 

Field	Description
SID	Service ID (SID) of the device.
MAC Address	Hardware (MAC-layer) address of the cable modem or CPE device.
IP Address	IP address of the cable modem or CPE device.
Req-Filtered	Total number of ARP requests that the device has generated or forwarded.
Req-For-IP-Filtered	Total number of ARP requests that the device has generated or forwarded for IP packets.
Rep-Filtered	Total number of ARP replies that the device has generated or forwarded.
Note The Req-Filter and Rep-Filtered counters are 16-bit counters, with a maximum value of 65,535 packets. If the number of packets exceeds this amount, the counter wraps back to zero and begins incrementing again.

Clearing the ARP Packet Counters

The following example shows the cable ARP counters being cleared by the clear counters cable interface command. This can be useful because the ARP counters are 16-bit counters that can wrap around to zero relatively quickly when large amounts of ARP traffic is being generated. Also, the ARP packet counters could include SIDs that had forwarded large amounts of ARP traffic in the past, but that are not currently forwarding such traffic. Clearing the counters allows you to clearly see the SIDS that are currently forwarding the ARP traffic that is triggering the ARP filters.

Router# show cable arp cable 3/0 

ARP Filter statistics for Cable3/0:

  Replies Rcvd: 3278 total. 84 unfiltered, 3194 filtered

  Requests Sent For IP: 941 total. 30 unfiltered, 911 filtered

  Requests Forwarded: 941 total. 37 unfiltered, 904 filtered

Router# show cable arp-filter cable 5/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

1    0006.2854.72d7 10.3.81.4       8              0                    0

23   0007.0e02.b747 10.3.81.31      32             0                    0

57   0007.0e03.2c51 10.3.81.31      12407          0                    0

...

81   00C0.c726.6b14 10.3.81.31      23             0                    0

Router# clear counter cable 5/1/0 

Clear "show interface" counters on this interface [confirm] y 

08:17:53.968: %CLEAR-5-COUNTERS: Clear counter on interface Cable5/1/0 by console 

Router# show cable arp cable 5/1/0 

ARP Filter statistics for Cable3/0:

  Replies Rcvd: 0 total. 0 unfiltered, 0 filtered

  Requests Sent For IP: 0 total. 0 unfiltered, 0 filtered

  Requests Forwarded: 0 total. 0 unfiltered, 0 filtered

Router# show cable arp-filter cable 5/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

Router# show cable arp-filter cable 5/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

57   0007.0e03.2c51 10.3.81.31      20             0                    0 

81   00C0.c726.6b14 10.3.81.31      12             0                    0 

Router# show cable arp-filter cable 5/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

57   0007.0e03.2c51 10.3.81.31      31             0                    0 

81   00C0.c726.6b14 10.3.81.31      18             0                    0 

Router# 

---

Note The clear counters command clears all of the packet counters on an interface, not just the ARP packet counters.

---

Related Commands

Command	Description
cable arp	Activates cable Address Resolution Protocol (ARP).
cable arp filter	Controls the number of ARP packets that are allowable for each Service ID (SID) on a cable interface.
cable proxy-arp	Activates cable proxy ARP on the cable interface.
clear arp	Clears the ARP table on the router.
clear counters	Clears the packet counters on all interfaces or on a specific interface.
debug cable arp filter	Displays debugging messages about the filtering of ARP broadcasts.

show cable bundle

To display the forwarding table for the specified interface, use the show cable bundle in user EXEC or privileged EXEC mode.

show cable bundle n forwarding-table

Syntax Description

n	Specifies the bundle identifier. Valid range is from 1 to 255.
forwarding-table	Displays the forwarding table for the specified interface.

Command Modes

User EXEC or Privileged EXEC

Command History

Release	Modification
12.0(7)XR2	This command was introduced.
12.0(8) SC	This command was supported.
12.1(2) EC1	This command was supported.
12.2(4)BC1	Support was added to the Release 12.2 BC train.
12.1(13)EC, 12.2(11)BC1	The Flags, Location, link, and sublink fields were added to the display to aid in debugging.
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.

Usage Guidelines

•Beginning with Cisco IOS Release 12.3(21)BC, all cable bundles are automatically converted and configured to be in a virtual bundle after loading the software image.

•In releases prior to Cisco IOS Release 12.3(21)BC, if you delete the virtual bundle interface, the virtual bundle disappears.

•Beginning with Cisco IOS Release 12.3(21)BC, standalone cable interfaces must be manually configured to be in a virtual bundle to operate properly.

•The virtual bundle interface accumulates the counters from members; counters on member links are not cleared when they are added to the bundle. If a bundle-only counter is desired, clear the bundle counter on the members before adding them to the bundle, or before loading the image (for Cisco IOS Release 12.3(21)BC and later).

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

Examples

The following is a typical example of the show cable bundle command:

Router# show cable bundle 1 forwarding-table 

MAC address       Interface    Flags Location   link     sublink

00c0.5e01.0203    Cable8/0/0     3   64E5BF60   0        64E5BE00

00c0.5e01.0203    Cable7/0/0     3   64E5BE00   0        0 

00c0.5e01.0101    Cable8/0/0     3   64E5BEE0   0        64E5BE40

00c0.5e01.0101    Cable7/0/0     3   64E5BE40   0        0 

00c0.a375.cc1c    Cable8/0/0     1   64E5BEC0   0        0 

00c0.0e01.a835    Cable8/0/0     1   64E5BEA0   0        0 

00c0.0e01.a799    Cable8/0/0     1   64E5BDE0   0        0 

00c0.0e01.a405    Cable8/0/0     1   64E5BF00   0        0 

00c0.0e01.a5d1    Cable7/0/0     1   64E5BE20   0        0 

00c0.0e01.a5d9    Cable8/0/0     1   64E5BE60   0        0 

00c0.0e01.a5e1    Cable7/0/0     1   64E5BF40   0        0 

00c0.0e01.a5f1    Cable7/0/0     1   64E5BE80   0        0 

00c0.0eb4.0a41    Cable5/0/0     1   63704D1C   0        0

00c0.f03b.ed59    Cable6/1/0     1   6370427C   0        0

00c0.f03b.ed97    Cable6/1/0     1   63703F3C   0        0

00c0.0eb4.1373    Cable5/0/0     1   6370479C   0        0

00c0.f03b.edd3    Cable6/1/0     1   637042BC   0        0

00c0.7371.6df6    Cable5/0/0     1   63703DFC   0        0

Table 0-38 describes the fields shown in the show cable bundle command display.

Table 0-38 show cable bundle Command Field Descriptions 

Field	Description
MAC address	Identifies the MAC (hardware) address for each interface in the bundle.
Interface	Identifies the cable interface slot and port number.
Flag	The current value of the flag byte for this bundle entry. The following bits can be set: •Bit 0 (0x01) = Bundle is active. •Bit 1 (0x02) = Bundle is a static multicast group. Note If more than one bit is set, add the values together. For example, 3 indicates an active, static multicast group.
Location	The location in the router's memory for the flags byte for this bundle entry. This value is useful only to TAC engineers during debugging.
link	The value of the link pointer for this bundle entry. This value is useful only to TAC engineers during debugging.
sublink	The value of the sublink pointer for this bundle entry. This value is useful only to TAC engineers during debugging.

---

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.

---

The following example shows typical output for the show cable bundle fowarding-table command, supporting virtual interface bundling on the Cisco CMTS in later 12.3 BC Cisco IOS releases:

Router# show cable bundle 1 forwarding-table

MAC address       Interface    Flags Location   link     sublink

00c0.5e01.0203    Cable8/0/0     3   64E5BF60   0        64E5BE00

00c0.5e01.0203    Cable7/0/0     3   64E5BE00   0        0 

00c0.5e01.0101    Cable8/0/0     3   64E5BEE0   0        64E5BE40

00c0.5e01.0101    Cable7/0/0     3   64E5BE40   0        0 

00c0.a375.cc1c    Cable8/0/0     1   64E5BEC0   0        0 

00c0.0e01.a835    Cable8/0/0     1   64E5BEA0   0        0 

00c0.0e01.a799    Cable8/0/0     1   64E5BDE0   0        0 

00c0.0e01.a405    Cable8/0/0     1   64E5BF00   0        0 

00c0.0e01.a5d1    Cable7/0/0     1   64E5BE20   0        0 

00c0.0e01.a5d9    Cable8/0/0     1   64E5BE60   0        0 

00c0.0e01.a5e1    Cable7/0/0     1   64E5BF40   0        0 

00c0.0e01.a5f1    Cable7/0/0     1   64E5BE80   0        0 

00c0.0eb4.0a41    Cable5/0/0     1   63704D1C   0        0

00c0.f03b.ed59    Cable6/1/0     1   6370427C   0        0

00c0.f03b.ed97    Cable6/1/0     1   63703F3C   0        0

00c0.0eb4.1373    Cable5/0/0     1   6370479C   0        0

00c0.f03b.edd3    Cable6/1/0     1   637042BC   0        0

00c0.7371.6df6    Cable5/0/0     1   63703DFC   0        0

Total = 18, sublink total = 2 

Free = 1016, low_mark = 1016

Related Commands

Command	Description
cable bundle	Creates an interface bundle.
show ip interface brief	Displays a brief summary of an interface's IP information and status, to include virtual interface bundle information.
show pxf cable	Displays multicast echo, packet intercept, or source-verify features for one or all cable interfaces, to include information for virtual interface bundles.

show cable bundle multicast

To display Multicast information for the specified virtual interface bundle, based on IGMPv3, use the show cable bundle multicast command in privileged EXEC mode:

show cable bundle bundle# multicast group

show cable bundle bundle# multicast [ MAC addr | IP addr ]

Syntax Description

bundle#	The alphanumeric identifier for the virtual interface bundle.
group	Multicast group membership identifier.
MAC addr	Optional parameter specifies the MAC address for which to return information.
IP addr	Optional parameter specifies the IP address for which to return information.

Command Modes

User EXEC or Privileged EXEC

Command History

Release

Modification

12.3(21)BC

This command was introduced to support virtual interface bundling on the Cisco CMTS. 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.

Usage Guidelines

•Beginning with Cisco IOS Release 12.3(21)BC, all cable bundles are automatically converted and configured to be in a virtual bundle after loading the software image.

•In releases prior to Cisco IOS Release 12.3(21)BC, if you delete the virtual bundle interface, the virtual bundle disappears.

•Beginning with Cisco IOS Release 12.3(21)BC, standalone cable interfaces must be manually configured to be in a virtual bundle to operate properly.

•The virtual bundle interface accumulates the counters from members; counters on member links are not cleared when they are added to the bundle. If a bundle-only counter is desired, clear the bundle counter on the members before adding them to the bundle, or before loading the image (for Cisco IOS Release 12.3(21)BC and later).

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

Examples

The following example illustrates this new command. This command translates the bundle's multicast MAC address to Multicast IP address information, including the associated multicast source.

Router# show cable bundle bundle1.1 multicast

CableBundle  Interface   Source IP        Multicast IP     MAC Address

1            Bundle1.1   *                230.1.1.1        0100.5e00.0001

The following example illustrates multicast information for the specified virtual bundle:

Router# sh cable bundle 1 multicast 

CableBundle  Interface   Source IP        Multicast IP     MAC Address

1            Bundle1     *                239.0.0.100      0100.5e00.0001

To translate a MAC address back to Multicast IP address, use the following optional syntax:

show cable bundle bundle# multicast [ <MAC addr | IP addr >]

The following example illustrates this enhanced show command:

Router# show cable bundle bundleID multicast 0100.5e00.0001

MAC address       Interface    Flags Location   link     sublink

0100.5e00.0001    Bundle1        1   646FE4D8   0        646FE4EC

0100.5e00.0001    Cable6/0/0     1   646FE4EC   0        0

^^^^^^^^^^^^^^

Related Commands

Command	Description
cable bundle	Creates an interface bundle.
show ip interface brief	Displays a brief summary of an interface's IP information and status, to include virtual interface bundle information.
show pxf cable	Displays multicast echo, packet intercept, or source-verify features for one or all cable interfaces, to include information for virtual interface bundles.

show cable burst-profile

To display the upstream data burst profiles used to configure the upstream PHY, use the show cable burst-profile command in privileged EXEC mode.

show cable burst-profile

---

Note This command has been deprecated and removed in the current versions of the Cisco IOS software for all Cisco CMTS routers.

---

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3 NA	This command was introduced.
11.3(5)NA, 12.0(5)T1, 12.0(6)SC, 12.1(2)EC1	This command was removed and replaced with the show cable modulation-profile command.

Usage Guidelines

This command displayed configuration of the cable burst profiles, which were what DOCSIS initially used to control the data, ranging, and station maintenance bursts. The Cisco CMTS routers now support a more comprehensive set of modulation profiles, which are displayed by the show cable modulation-profilecommand.

---

Note The show cable burst-profile command displayed fields and values that were supported only in the initial versions of the DOCSIS specification. The current DOCSIS 1.0 and 1.1 specifications use different parameters and values, as shown by the show cable modulation-profile command.

---

Examples

The following example shows typical output from the show cable burst-profile command:

Router# show cable burst-profile 

Burst   Type Preamb Diff   FEC err FEC      Scrambl Max   Guard Last     Scrambl profile

number                             length           size  size  shortened

1       1    48     no     0x0     0x6      0x152   1     16    1         yes

2       1    48     no     0x0     0x6      0x152   1     12    1         no

3       1    48     no     0x5     0x2C     0x152   0     48    1         yes

4       1    48     no     0x5     0x2C     0x152   0     48    1         yes

5       1    48     no     0x5     0x32     0x152   0     20    1         yes

6       1    48     no     0x0     0x32     0x152   0     20    1         no

Router# 

Table 0-39 describes the fields shown in the show cable burst-profile command display.

Table 0-39 show cable burst-profile Field Descriptions

Field	Description
Burst profile number	The number of the burst profile.
Type	Type of burst profile.
Preamb length	Length of the preamble.
Diff encode	Shows if there is a diff encode.
FEC err correct	Shows the forward error correction.
FEC codeword length	Shows the length of the forward error correction codeword.
Scrambl seed	Shows the seed of the scrambler.
Max size	Designates the maximum burst size.
Guard size	Indicates the guard time size.
Last codeword shortened	Shows the last codeword shortened.
Scrambl	Indicates whether scramble is enabled (yes) or not (no).

---

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 upstream modulation-profile	Configures a spectrum group to use a specified frequency.
show cable hop	Displays CM configuration settings.
show cable modulation-profile	Displays the currently defined modulation profiles.
show interface cable sid	Displays cable interface information.

show cable calls

To display voice call history information and status for PacketCable Emergency 911 Services Listing and History, use the show cable calls command in privileged EXEC mode. This command displays voice call history information that is enabled with the cable high-priority-call-window command in global configuration mode.

show cable calls show cable calls [ interface cslot | slot/subslot ]

Syntax Description

interface	Selects the interface for which to enable PacketCable E911 call history.
slot | slot/subslot	Designates the slot or slot and port for a particular cable interface on the Cisco  router. The following are the valid values for the Cisco uBR7246VXR router: •slot can range from 3 to 6 The following are the valid values for the Cisco uBR10012 router: •slot = 5 to 8 •subslot = 0 or 1

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(13a)BC	This command was introduced supporting PacketCable Emergency 911 Services Listing and History on the Cisco CMTS: •Cisco uBR7246VXR router •Cisco uBR10012 router

Usage Guidelines

This command supports the PacketCable Emergency 911 Services Listing and History feature on the Cisco CMTS. Cisco IOS release 12.3(13a)BC introduces enhanced informational support for PacketCable Emergency 911 calls on the Cisco CMTS, to include the following information and related history:

•active Emergency 911 calls

•recent Emergency 911 calls

•regular voice calls

•voice calls made after recent Emergency 911 calls

To set the call window (in minutes) during which the Cisco CMTS maintains records of Emergency 911 calls, use the cable high-priority-call-window command in global configuration mode. To remove the call window configuration from the Cisco CMTS, use the no form of this command:

cable high-priority-call-window minutes

no cable high-priority-call-window

The following command example configures the call window on the Cisco uBR10012 router to be one minute in length:

Router(config)# cable high-priority-call-window 1

Additional information for voice call support with PacketCable and PacketCable MultiMedia (PCMM) is available in the following document on Cisco.com:

•PacketCable and PacketCable Multimedia for the Cisco CMTS

Examples

The following example illustrates call status on the Cisco CMTS:

Router# show cable calls

Interface   ActiveHiPriCalls  ActiveAllCalls  PostHiPriCallCMs  RecentHiPriCMs

Cable3/0    0                 0               0                 1              

Cable3/1    0                 0               0                 0              

Cable4/0    0                 0               0                 1              

Cable4/1    0                 0               0                 0              

Total       0                 0               0                 2              

Router #

The following command example illustrates that one Emergency 911 call was made on the Cable8/1/1 interface on the Cisco uBR10012 router during the window set for high priority calls:

Router# show cable calls

Interface   ActiveHiPriCalls  ActiveAllCalls  PostHiPriCallCMs  RecentHiPriCMs

Cable5/0/0  0                 0               0                 0              

Cable5/0/1  0                 0               0                 0              

Cable5/1/0  0                 0               0                 0              

Cable5/1/1  0                 0               0                 0              

Cable5/1/2  0                 0               0                 0              

Cable5/1/3  0                 0               0                 0              

Cable5/1/4  0                 0               0                 0              

Cable6/0/0  0                 0               0                 0              

Cable6/0/1  0                 0               0                 0              

Cable7/0/0  0                 0               0                 0              

Cable7/0/1  0                 0               0                 0              

Cable8/1/0  0                 0               0                 0              

Cable8/1/1  1                 1               0                 0              

Cable8/1/2  0                 0               0                 0              

Cable8/1/3  0                 0               0                 0              

Cable8/1/4  0                 0               0                 0              

Total       1                 1               0                 0 

Related Commands

Command	Description
cable high-priority-call-window	Sets the call window (in minutes) during which the Cisco CMTS maintains records of Emergency 911 calls.
show cable modem calls	Displays voice call information for a particular cable modem.

show cable clock

To display clock reference status information for the clock card and to display information about displaying Timing, Communicaton and Control (TCC) card DOCSIS Timimg Interface (DTI) client and server statistic counts, use the show cable clock command in user EXEC or privileged EXEC mode.

show cable clock [slot] {client port id | server port id | counters}

Syntax Description

slot	(Optional) Identifies a TCC interface on the Cisco RF Gateway 10. Valid TCC slots are 13 and 14.
client port id	Specifies the DTI client port ID. Valid port values are 1 and 2.
server port id	Specifies the DTI server port ID. Valid port values are 1 and 2.
counters	Specifies the DTI client counters.

Command Default

Information on the TCC DTI client and server is displayed. Counters are not displayed.

Command Modes

User EXEC or Privileged EXEC

Command History

Release	Modification
12.1(1a)T1	This command was introduced.
12.1(2)EC1	This command was supported on the EC train.
12.2(1)XF1, 12.2(4)BC1	This command was supported for the Cisco uBR10012 universal broadband router.
12.3(23)BC	This command was supported for DTI mode.
12.2(44)SQ	This command was modified in Cisco IOS Release 12.2(44)SQ to support the Cisco RF Gateway 10. The slot, client, server, and counters options were added.

Usage Guidelines

This command supports the Cisco CMTS clock feature set, which provides a synchronized clock for improved Voice-over-IP (VoIP) operations. The clock feature set requires one of the following configurations:

•A Cisco uBR10012 router with one or two TCC+ cards that are connected to an external national clock source.

---

Note Beginning in Cisco IOS Release 12.3(23)BC, TCC+ is replaced with DOCSIS Timing and Control Card (DTCC).

---

•A Cisco uBR7246 VXR router using a Cisco uBR-MC16S, Cisco uBR-MC16E, Cisco uBR-MC28C, or Cisco uBR-MC28C-BNC cable interface line card. The router must also be equipped with a Cisco cable clock card and be running Cisco IOS 12.1(1a)T1, 12.1(2)EC1, or a later release. The Cisco cable clock card should be connected to an external national clock source.

Only these cable interface cards support the external clock card reference from a clock card to distribute that signal to CMs or set-top boxes (STBs) attached to the specific network segments. You can use other cable interface cards, such as the Cisco uBR-MC16C, with the clock card, but these other cable interfaces will not synchronize their downstream SYNC messages with the external clock source.

Each CM or STB must also support VoIP applications and the clock feature set. For example, the Cisco uBR924, running Cisco IOS Release 12.0(7)T or later, supports clock card feature automatically.

---

Note This command does not appear if a clock card is not installed in the system.

---

Examples

The following sample output from the show cable clock command on a Cisco uBR7246VXR router shows that both external sources are available and the clock card is providing the clock reference:

Router# show cable clock 

Clockcard primary input is present

Clockcard secondary input is present

Cable clock reference is clockcard primary input

Cable3/0 Timestamp clock reference is from Clockcard 

Cable4/0 Timestamp clock reference is from Clockcard 

The following sample output from the show cable clock command on a Cisco uBR10012 router shows that both external sources are available and that the TCC+ card in slot 1/1 is providing the clock reference:

Router# show cable clock 

Number of TCCplus Cards in the Chassis: 2

Active TCCplus Card is in slot: 1 subslot: 1

Backup TCCplus Card is in slot: 2 subslot: 1

Clock reference used by the active card is Primary T1 

External T1 References:

Card: 1/1

Primary T1  : Available

Secondary T1: Available

Card: 2/1

Primary T1  : Available

Secondary T1: Available

The following sample output from the show cable clock command on a Cisco uBR10012 router shows that the TCC+ card in slot 1/1 is in maintenance mode, and that the TCC+ card in slot 2/1 is providing the clock reference:

Router# show cable clock 

Number of TCCplus Cards in the Chassis: 2

TCCplus card in 1/1 under maintenance

Active TCCplus Card is in slot: 2 subslot: 1

Clock reference used by the active card is Primary T1 

External T1 References:

Card: 2/1

Primary T1  : Available 

Secondary T1: Available 

---

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.

---

The following sample output from the show cable clock command on a Cisco uBR10012 router shows that the DTCC card in slot 1/1 is in DTI mode.

Router# show cable clock 

Number of TCC Cards in the Chassis: 1

Active TCC Card is in slot: 1 subslot: 1,(DTCC Eightbells card)

Clock reference used by the active card is DTI

Active TCC card in slot 1/1 

TCC Card 1/1 DTI status: 

------------------------------------------- 

    Active Client port             : 2 

    Active Client status           : normal 

    Active Client Server status    : freerun 

    Active Client frame error rate : < 2% 

    Active Client CRC error count  : 0xAD 

    Standby Client Signal detected : yes 

No card in slot 2/1 

Cisco RF Gateway 10

The following example shows the TCC DTI client and server statistic counts information:

Router# show cable clock

DTI Client status: TCC 13

-----------------

Client status                  : normal

Client clock type              : ITU type 1

Client firmware version        : 7

Client dti version             : 0

Client timestamp               : 657519453

Client phase correction        : 65535

Client normal time             : 65535

Client holdover time           : 0

Client transition t3 count     : 0

Client transition t4 count     : 1

Client transition t6 count     : 0

Client transition t7 count     : 0

Client port switch count       : 1

Client Integral Frequency Term : 64518

Client EFC Value               : 63282

DTI Client Port 1 Status:

-------------------------

   Port Status             : Active

   Signal detected         : yes

   CRC error count         : 2

   Frame error rate        : < 2%

   Cable advance           : 2560

    -- Connected server information ---

    Server status                  : Active free-run

    Root Server clock type         : ITU type 3

    Root Server source             : none

    Server Type                    : Root

    Client Performance Stable      : yes

    Client Cable advance Valid     : yes

DTI Client Port 2 Status:

-------------------------

   Port Status             : Inactive

   Signal detected         : no

   CRC error count         : 66

   Frame error rate        : > 5%

   Cable advance           : 0

DTI Client status: TCC 14

-----------------

Client status                  : normal

Client clock type              : ITU type 1

Client firmware version        : 7

Client dti version             : 0

Client timestamp               : 672169320

Client phase correction        : 65535

Client normal time             : 65535

Client holdover time           : 0

Client transition t3 count     : 0

Client transition t4 count     : 1

Client transition t6 count     : 0

Client transition t7 count     : 0

Client port switch count       : 1

Client Integral Frequency Term : 64760

Client EFC Value               : 63832

DTI Client Port 1 Status:

-------------------------

   Port Status             : Inactive

   Signal detected         : no

   CRC error count         : 26

   Frame error rate        : > 5%

   Cable advance           : 0

DTI Client Port 2 Status:

-------------------------

   Port Status             : Active

   Signal detected         : yes

   CRC error count         : 2

   Frame error rate        : < 2%

   Cable advance           : 1792

    -- Connected server information ---

    Server status                  : Active free-run

    Root Server clock type         : ITU type 3

    Root Server source             : none

    Server Type                    : Root

    Client Performance Stable      : yes

    Client Cable advance Valid     : yes

The following is sample output of a TCC card in slot 13 on a Cisco RF Gateway 10:

Router#show cable clock 13 client 1

DTI Client Port 1 Status:

-------------------------

   Port Status             : Inactive

   Signal detected         : no

   CRC error count         : 63006

   Frame error rate        : > 5%

   Cable advance           : 0x0000

Table 40 describes the significant fields shown in the display.

Table 40 show cable clock client Field Descriptions

Field	Description
Port status	Indicates the current status of the DTI port on the TCC card.
Signal detected	Indicates whether the DTI signal was detected.
CRC error count	The number of cyclic redundancy check (CRC) errors. It can indicate intermittent upstream, laser clipping, or common-path distortion.

The following example shows the server status of the TCC card in slot 13 on a Cisco RFGW-10:

Router#show cable clock 13 server 2

TCC Card 13 port 2 DTI Server status:

--------------------------------------

    Server signal detected         : yes

    Server status                  : free-run

    Root Server clock type         : ITU type 3

    Root Server source             : none

    Server Type                    : Root

    Client Performance Stable      : yes

    Client Cable advance Valid     : yes

    TOD Setting Mode               : Short

    TOD gpssec                     : 902825745

    TOD leap seconds               : 14

Table 41 describes the significant fields shown in the display.

Table 41 show cable clock server Field Descriptions

Field	Description
Server signal detected	Indicates whether the server was detected.
Server status	Indicates the state in which the serer is functioning. The states are warm-up, free-run state, fast mode, normal, holdover, or bridge mode.
Root server source	The server source such as internal, external, GPSor none.
Root server clock type	The clock type. The types are 1, 2, 3 or ITU Stratum 3 or DTI Min. clock.
TOD setting mode	Displays the time (user time, NTP, GPS) mode such as short or long.

The following is a sample output showing the counters on TCC card 13 on Cisco RFGW-10:

Router#show cable clock 13 counters

TCC Card 13 DTI counters:

-------------------------

    Client Normal time             : 0x1EB6

    Client Holdover time           : 0x0000

    Client Phase Correction        : 0

    Client Freq Correction         : 63213

    Client EFC Correction          : 61039

    Client transition count t3     : 0

    Client transition count t4     : 1

    Client transition count t6     : 0

    Client transition count t7     : 0

    Client port switch count       : 1

Related Commands

Command	Description
show controllers clock-reference	Displays hardware information, register values, and current counters for the cable clock card.
show cable clock dti status	Displays information on the DOCSIS Timing Interface (DTI) Client status.
cable clock free-run	Allows the clock to be in free-run mode.
clear cable clock counters	Clears DTI client transition counters of a TCC DTI client and server.

show cable clock dti counters

To display DTI counters for the clock card, use the show cable clock dti counters command in user EXEC or privileged EXEC mode.

show cable clock dti counters slot/subslot

Syntax Description

slot/subslot

Specifies the slot and subslot location of the DTCC ports. Valid values are 1/1 or 2/1.

Command Modes.

User EXEC or Privileged EXEC

Command History

Release	Modification
12.3(23)BC	This command was supported for DTI mode.

Examples

The following is a sample output from the show cable clock dti counters command in user EXEC mode:

Router> show cable clock dti counters 1/1

TCC Card 1/1 DTI counters:

-------------------------------------------

    Client Normal time             : 0xFFFF

    Client Holdover time           : 0x0000

    Client Phase Correction        : 0x0000

    Client Freq Correction         : 0xFBD7

    Client EFC Correction          : 0xF7AD

    Client transition count t3     : 0x00

    Client transition count t4     : 0x01

    Client transition count t6     : 0x00

    Client transition count t7     : 0x00

Related Commands

Command	Description
cable clock dti clear-counters	Resets the counters that are displayed with the show cable clock dti counters command.
show cable clock dti status	Displays information on the DOCSIS Timing Interface (DTI) Client status.

show cable clock dti status

To display information on the DOCSIS Timing Interface (DTI) Client status, use the show cable clock dti status command in privileged EXEC mode.

show cable clock dti status

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(23)BC	This command was introduced for the Cisco uBR10012 router.

Usage Guidelines

Use this command to display information on the DTI Client status.

Examples

The following is a sample output from the show cable clock dti command:

Router# show cable clock dti status

Status of DTI component:

Active TCC card in slot 1/1

TCC Card 1/1 DTI status:

-------------------------------------------

    Active Client port             : 2

    Active Client status           : normal

    Active Client Server status    : freerun

    Active Client frame error rate : < 2%

    Active Client CRC error count  : 0x06

    Standby Client Signal detected : no

No card in slot 2/1

Related Commands

Command	Description
show cable clock	Displays clock reference status information for the clock card.

show cable device access-group

To display a list of CMs and their customer premises equipment (CPE) devices, along with their access groups, use the show cable device access group command in privileged EXEC mode.

show cable device [ip-address] access-group

---

Note The show cable device access-group command is not supported on the Cisco uBR10012 universal broadband router.

---

Syntax Description

ip-addr

(Optional) Specifies the IP address for a particular CM or host.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.NA	This command was introduced.
12.1(3a)EC1	Support was added to the Release 12.1 EC train.
12.2(4)BC1	Support was added to the Release 12.2 BC train for the Cisco uBR7100 series and Cisco uBR7200 series routers. (This command might appear in the CLI for the Cisco uBR10012 router but is not functional.)

Usage Guidelines

This command displays information about both CMs and their associated CPE devices. To display information only for hosts and other CPE devices, use the show cable host access-group command. To display information only for CMs, use the show cable modem 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.

Examples

The following example shows how to display a list of the CMs and their hosts:

Router# show cable device access-group 

MAC address      IP address      Type    Access-group

00d0.ba77.7595   10.20.114.34    modem   resident 

0020.4065.828c   10.27.29.128    modem   resident 

0080.c6f9.b42e   24.168.220.52   host

0020.7806.defe   192.168.28.134  host

0020.4066.5c5c   10.27.33.128    modem   resident 

0050.baa0.5ccd   24.168.223.251  host

0020.4070.56d8   10.27.29.129    modem   resident 

0050.046f.f4cf   192.168.33.25   host

0020.40b4.0c80   10.27.33.129    modem   resident 

0050.bacf.5d89   192.168.37.113  host

0020.4071.698e   10.27.29.130    modem   resident 

0050.1800.a8cb   192.168.33.90   host

0020.407a.c196   10.27.33.130    modem   resident 

0040.d00f.44f0   192.168.34.128  host

0020.407f.0c2c   10.27.33.131    modem   resident 

0050.e456.9641   192.168.39.66   host

0020.4071.65de   10.27.29.131    modem   resident 

0050.badd.2883   192.168.32.230  host

0020.4071.64b4   10.27.29.132    modem   resident 

0050.badd.3b12   192.168.33.246  host

00D0.ba41.41fc   10.27.33.132    modem   resident 

0020.78c7.f887   192.168.32.32   host

00D0.ba3d.871e   10.27.29.133    modem   resident 

00e0.2969.a1a5   192.168.36.246  host

00D0.ba40.fff3   10.27.29.135    modem   resident 

0020.78d5.ddf0   192.168.32.107  host

00001.02c5.9936   192.168.38.233 host

00D0.ba40.fe30   10.27.33.157    modem   resident 

0020.78d0.fb32   192.168.28.45   host

00D0.ba3b.e08d   10.27.33.158    modem   resident 

0050.1800.f458   192.168.36.209  host

0002.e301.df8f   192.168.30.191  host

00D0.ba3e.7b9c   10.27.29.158    modem   resident 

00a0.2451.b7eb   24.168.223.41   host

00D0.ba3c.3ff2   10.27.29.160    modem   resident 

0080.c7db.afba   192.168.33.153  host

00D0.2717.1899   192.168.39.189  host

00D0.ba33.a164   10.27.33.161    modem   resident 

Router# 

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

Table 0-42 Descriptions for the show cable device access-group Fields 

Field	Description
MAC Address	The MAC address for the CM or CPE device.
IP Address	The IP address that the DHCP server has assigned to the CM or CPE device.
Type	Identifies the type of device: •host = CPE device •modem = cable modem
Access-group	Displays the access group name or number in use (if any) for this CM or CPE device.

---

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 device	Configures the access list for a CM device or host.
cable host access-group	Configures the access list for the specified hosts.
clear cable host	Clears the host from the table.
show cable host access-group	Displays the hosts behind the CMs in the network, along with their access groups.
show cable modem access-group	Displays the access groups for the CMs on a particular cable interface.

show cable dsg

To display the current DOCSIS Set-Top Gateway (DSG) tunneling parameters, use the show cable dsg command in privileged EXEC mode.

show cable dsg {stats | tunnel} [vendor CA-vendor-name | tunnel-mac-address]

Syntax Description

stats	Displays configuration and run-time statistics about the currently-defined DSG tunnels.
tunnel	Displays the mapping of DSG tunnels to vendors or well-known MAC addresses.
vendor CA-vendor-name	(Optional) Displays information about a specific Conditional Access (CA) vendor. This parameter can be any arbitrary string up to 8 characters in length.
tunnel-MAC-address	(Optional) Displays information for the specified well-known MAC address for the DSG tunnel. If you specify a MAC address of 0000.0000.0000, the command displays information for all DSG tunnels, which is the default display.

Defaults

Displays information for all DSG tunnels.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(15)BC2	This command was introduced for the Cisco uBR7100 series and Cisco uBR7246VXR routers.
12.3(9a)BC	This command was introduced on the Cisco uBR10012 router.
12.3(13a)BC	This command is obsolete and replaced by the show cable dsg tunnel command.

Examples

The following example shows a typical display for the show cable dsg tunnel form of the command:

Router# show cable dsg tunnel 

Group-ip        Src-ip          Tunnel-MAC      Interface   Packets   CA-vendor  

225.2.2.2       *               0001.0002.0003  Cable3/0    1589      BBB 

230.6.6.6       *               000d.000d.000d  Cable3/0    12868464  abc

230.7.7.7       *               000e.000e.000e  Cable3/0    24330138  abc

230.4.4.4       *               000b.000b.000b  Cable3/0    22008648  cisco

230.5.5.5       *               000c.000c.000c  Cable3/0    6424012   abc

229.1.1.1       *               0009.0009.0009  Cable3/0    12868440  cisco

228.1.1.1       *               0008.0008.0008  Cable3/0    6424012   cisco

230.1.1.1       *               000a.000a.000a  Cable3/0    24370812  cisco

230.8.8.8       *               000f.000f.000f  Cable3/0    23035116  abc

Router# 

The following example shows a typical display for the show cable dsg stats command:

Router# show cable dsg stats 

DSG statistics information

DSG keepalive is set

Vendor: DDD, Tunnel count: 1

Vendor: BBB, Tunnel count: 2

Vendor name is DDD, tunnel MAC is 0001.0002.0003

Group address is 226.2.2.2, source address is * 

  Interface is Cable5/1,   mapping entry is used 1

    Received 5968 packets,  forwarded 5289 packets

    Dropped 679 packets,  last second rate 16878 bits/sec

Vendor name is BBB, tunnel MAC is 0009.0010.0011

Group address is 227.2.2.2, source address is * 

  Interface is Cable3/0,  interface Cable3/0 is bundle master

  mapping entry is used 2

    Received 0 packets,  forwarded 0 packets

    Dropped 0 packets,  last second rate 0 bits/sec

Vendor name is CCC, tunnel MAC is 0005.0006.0007

Group address is 228.3.3.3, source address is * 

  Interface is Cable5/1,   mapping entry is used 2

    Received 5970056 packets,  forwarded 400333 packets

    Dropped 5569723 packets,  last second rate 96768 bits/sec

Router# 

The following example shows a typical display for the show cable dsg stats command for an individual vendor:

Router# show cable dsg stats vendor CCC 

DSG statistics information

DSG keepalive is set

Vendor: CCC, Tunnel count: 1

Vendor name is CCC, tunnel MAC is 0005.0006.0007

Group address is 228.3.3.3, source address is * 

  Interface is Cable5/1,   mapping entry is used 2

    Received 5970056 packets,  forwarded 400333 packets

    Dropped 5569723 packets,  last second rate 96768 bits/sec

Router# 

---

Note The packet counters for both the stats and tunnel options for a particular DSG tunnel continue to increase as long as traffic is received over that tunnel. If the tunnel does not receive any traffic for three minutes or more, the counters are automatically reset to 0.

---

The following example shows a typical display for the show cable dsg stats command for an individual vendor when the associated cable interface is shut down. The Received, Forwarded, and Dropped counters are not displayed when an interface is shut down.

Router(config)# interface c5/1 

Router(config-if)# shutdown 

Router(config-if)# exit 

Router(config)# exit 

Router# show cable dsg stats vendor CCC 

DSG statistics information

DSG keepalive is set

Vendor: CCC, Tunnel count: 1

Vendor name is CCC, tunnel MAC is 0005.0006.0007

Group address is 228.3.3.3, source address is * 

  Interface is Cable5/1,   mapping entry is used 2

Router# 

Table 43 describes the major fields shown in the show cable dsg command:

Table 43 show cable dsg Field Descriptions 

Field	Description
DSG keepalive is set	If keepalive messages have been enabled for an IP multicast group, using the cable dsg keepalive command, this message is displayed.
Dest-ip, Group address	Multicast group IP address for the DSG stream.
Src-ip, Source address	Source IP address for the DSG stream. If an asterisk (*) appears as the source IP address, it indicates that the source IP address is 0.0.0.0, which allows any IP address as the source IP address.
Mapped-MAC, Tunnel-MAC	Well-known MAC address used for the DSG tunnel. If you configured the DSG tunnel with a MAC address of 0000.0000.0000 using the cable dsg command, this field shows the MAC address that the CMTS derived using the MAC to IP multicast addressing mapping that is specified in RFC 1112.
Interface	Cable interface on which this DSG tunnel is configured.
mapping entry is used	Number of times that this particular DSG tunnel mapping has been used to resolve the well-known MAC address from the tunnel's group address. This can be used as a very rough approximation of the number set-top boxes (STBs) that have been mapped to this DSG tunnel since the last time the counter was cleared. Note Use the clear cable dsg command to clear this counter.
Packets	Number of packets transmitted over the DSG tunnel.
CA-vendor	Name for the Conditional Access (CA) vendor that owns this tunnel.
Received	Number of packets received by the multicast group. This counter includes all interfaces that are receiving traffic for the multicast group. The field is not shown when an interface is shut down, but the counter continues to increase as long as the multicast group is receiving traffic. When the interface is reenabled, the counter shows the latest number of packets received.
Forwarded	Number of packets forwarded on the cable interface for the multicast group. This counter is reset to 0 whenever an interface is shut down and reenabled. The field is not shown when an interface is shut down.
Dropped	Number of packets that were dropped that were for the multicast group. This counter includes all interfaces that are receiving traffic for the multicast group. The field is not shown when an interface is shut down, but the counter continues to increase as long as the multicast group is receiving traffic and dropping packets. When the interface is reenabled, the counter shows the latest number of packets dropped.

---

Note The Received and Dropped counters reflect activity for the multicast group and are not affected when a cable interface is shut down and reenabled, as long as the multicast group continues to receive traffic. The Forwarded counter reflects activity for the particular cable interface and is reset to zero whenever the interface is shut down and reenabled. All packet counters are also automatically reset to zero if the DSG tunnel does not receive traffic for three minutes or more.

---

Related Commands

Command	Description
cable dsg	Enables the DOCSIS Set-Top Gateway (DSG) on a cable interface, and configures its tunnel-mapping parameters.
cable dsg keepalive	Enables keepalive messages over DOCSIS Set-Top Gateway (DSG) tunnels on a cable interface.
clear cable dsg	Resets counters related to DOCSIS Set-Top Gateway (DSG) tunnels.
debug cable dsg	Enables the display of debugging messages for the operation of the DOCSIS Set-Top Gateway (DSG) feature.

show cable dsg tunnel

To display information about Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnel configuration on a Cisco CMTS router, use the show cable dsg tunnel command in privileged EXEC mode.

show cable dsg tunnel tunnel-id [cfrs | clients | interfaces | statistics | verbose]

Syntax Description

tunnel-id	(Optional) Alphanumeric identifier for a specified tunnel.
cfrs	Show DSG tunnel classifiers.
clients	Show DSG tunnel clients.
interfaces	Show DSG tunnel interfaces.
statistics	Show DSG tunnel statistics.
verbose	Show DSG tunnel detail information.

Defaults

No default behaviors or values

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.3(13a)BC	This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 router and Cisco uBR7200 series routers.
12.3(17a)BC	The output was modified to support A-DSG 1.2. •The "TG id" field was added to the show cable dsg tunnel and verbose forms of the command. •The "State" and "MAC Addr" fields switched places in the show cable dsg tunnel verbose form of the command. •The "vendor group" field was added to the show cable dsg tunnel clients form of the command.
12.2SB	This command was integrated into Cisco IOS Release 12.2SB. Support for the Cisco uBR7225VXR router was added.
12.2(33)SCC	The command output was modified to display the cable interfaces in the MAC domain, and their SF ID values and dropped packet count for the show cable dsg tunnel statistics form of the command.

Usage Guidelines

This command replaces the show cable dsg form of command available in Cisco IOS Release 12.3(9a)BC.

Examples

The following example displays CLI help for show cable dsg tunnel command syntax.

Router# show cable dsg tunnel 1 ?

cfrs        Show DSG tunnel classifiers

clients     Show DSG tunnel clients

interfaces  Show DSG tunnel interfaces

statistics  Show DSG tunnel statistics

verbose     Show DSG tunnel detail information

|           Output modifiers

<cr>

Examples: Displaying information about all A-DSG Tunnels

The following command displays tunnel MAC address, state, associated classifiers, and state information for Advanced-mode DSG version 1.1 tunnels on a Cisco CMTS router. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).

Router# show cable dsg tunnel

tunnel tunnel tunnel          cfr  cfr   tunnel in  rule rule  client service

id     state  mac-addr        id   state interface  id   state listId class

1      en     0100.5e01.0114  1    en    Cable6/0   1    en    2      SI

                              5    en               7    en    10    

                              11   en               8    en    2     

                              14   en               20   en    2     

                                         Cable6/1   1    en    4     

                                                    3    en    3     

                                                    4    en    4     

                                                    11   en    2     

2      en     0100.5e01.011e  2    en    Cable6/0   2    en    2      NDS-CA

                              10   en   

3      en     0100.5e01.0128  3    en    Cable6/0   3    en    3      NDS-APP

4      en     0100.5e01.0132  4    en    Cable6/0   4    en    4      MOTO-CA

5      en     0100.5e01.013c  9    en    Cable6/0   5    en    5      MOTO-APP

                                         Cable6/1   5    en    5     

6      dis    0100.5e01.0146             Cable6/0   6    en    6      SA-CA

                                         Cable6/1   6    en    6     

7      dis    0100.5e01.0150  7    en    Cable6/1   8    en    7      SA-APP

                              13   dis  

8      en     0100.5e01.0119  8    en                                 NDS-DNLD

9      en     0100.5e01.0133                                          MOTO-DNLD

10     en     0100.5e01.0147                                          SA-DNLD

11     en     2222.2222.2222                                          

12     en     3333.3333.3333  12   en                                 

Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the tunnel group ID ("TG id") field in support of A-DSG version 1.2 as shown below:

Router# show cable dsg tunnel

     tunnel              TG      cfr     tunnel   rule   client service

id  state mac-addr       id    id  state I/F    id state listId class

1      en 0100.5e01.0001 1     1      en C5/0   1     en 1      DSG-Rate1

                               6      en

                               7      en

                               8      en

2      en 0100.5e01.0002 1     2      en C5/0   2     en 2

3      en 0100.5e01.0003 1     3      en C5/0   3     en 3

4      en 0002.0002.0001 2     4      en C5/0   4     en 1

                                         C5/1   1     en 1

5      en 0002.0002.0002 2     5      en C5/0   5     en 2      DSG-Rate2

                                         C5/1   2     en 2

6      en 0002.0002.0003 2     9      en C5/0   6     en 21

                                         C5/1   3     en 21

Examples: Displaying Information for a Specified A-DSG Tunnel

The following example displays the same information as the show cable dsg tunnel command, but for a specified tunnel. The following example shows sample output for A-DSG version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).

Router# show cable dsg tunnel 1

tunnel tunnel tunnel          cfr  cfr   tunnel in  rule rule  client service

id     state  mac-addr        id   state interface  id   state listId class

1      en     0100.5e01.0114  1    en    Cable6/0   1    en    2      SI

                              5    en               7    en    10    

                              11   en               8    en    2     

                              14   en               20   en    2     

                                         Cable6/1   1    en    4     

                                                    3    en    3     

                                                    4    en    4     

                                                    11   en    2     

Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the tunnel group ID ("TG id") field in support of A-DSG version 1.2 as shown below:

Router# show cable dsg tunnel 1

     tunnel              TG      cfr     tunnel   rule   client service

id  state mac-addr       id    id  state I/F    id state listId class

1      en 0100.5e01.0001 1     1      en C5/0   1     en 1      DSG-Rate1

                               6      en

                               7      en

                               8      en

Examples: Displaying Information for A-DSG Tunnel Classifiers

The following example displays detailed information about all A-DSG classifiers associated with the specified tunnel.

Router# show cable dsg tunnel 1 cfrs

tunnel cfr   cfr   cfr destination ip   source ip        srcPre d_port d_port

id     id    state pri address          address          length start  end

1      1     en    1   230.1.1.20       0.0.0.0          32     0      65535 

       5     en    1   230.1.1.60       0.0.0.0          32     0      65535 

       11    en    1   224.25.25.134    0.0.0.0          32     0      65535 

       14    en    0   230.1.1.20       0.0.0.0          32     1000   2000  

Examples: Displaying Information for A-DSG Tunnel Clients

The following example displays detailed information about all the clients associated with the specified tunnel for A-DSG version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).

Router# show cable dsg tunnel 1 clients

tunnel client client client          client

id     listId id     id type         address

1      2      1      CA System ID    0X951         

              3      Broadcast                     

              8      MAC Addr        1111.1111.1111

       3      1      Application ID  0X1           

       4      1      CA System ID    0X701         

       10     1      Application ID  0X6           

Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the "vendor group" field in support of A-DSG version 1.2 as shown below:

Router# show cable dsg tunnel 1 clients

tunnel client client client          client          vendor

id     listId id     id type         address         group

1      1      1      MAC Addr        0100.5e00.0001 

              2      Application ID  0x0951         

              3      Broadcast       Unspecified    

              4      Broadcast       4              

Examples: Displaying Information for A-DSG Tunnel Interfaces

The following example displays all the interfaces and rules associated with a specified tunnel.

Router# show cable dsg tunnel 1 interfaces 

tunnel downstream   rule

id     interface    id

1      Cable6/0     1   7   8   20  

       Cable6/1     1   3   4   11  

Examples: Displaying Information for A-DSG Tunnel Statistics

The following example displays the packets statistics information about the specified tunnel. This output was changed in Cisco IOS Release 12.2(33)SCC (see following example).

Router# show cable dsg tunnel 1 statistics 

tunnel cfr   cfr   destination ip   source ip        total      total

id     id    state address          address          forwarded  received

1      1     en    230.1.1.20       0.0.0.0          0          0         

       5     en    230.1.1.60       0.0.0.0          0          0         

       11    en    224.25.25.134    0.0.0.0          0          0         

       14    en    230.1.1.20       0.0.0.0          0          0         

Beginning in Cisco IOS Release 12.2(33)SCC, this output was modified to display the cable interfaces in the MAC domain, and their SF ID values and dropped packet count.

Router# show cable dsg tunnel 1 statistics 

Load for five secs: 1%/0%; one minute: 2%; five minutes: 1%

Time source is hardware calendar, *20:07:32.543 UTC Wed Sep 14 2009

tunnel cfr   cfr   destination ip  source ip       total          total

id     id    state address         address         forwarded      received

------ ----- ----- --------------- --------------- -------------- --------------

1      1     en    230.1.1.20      0.0.0.0         178025         178033        

       2     en    230.1.2.20      0.0.0.0         0              0             

       service class   interface   SFid   dropped packets

       --------------- ----------- ------ ---------------

       dsg-tunnel1     Mo1/0/0:0   54     64695

                       Mo1/0/0:1   56     64717

                       Mo1/0/0:2   58     64731

                       Mo1/0/0:3   60     64754

                       Mo1/0/0:4   62     64774

                       Mo1/0/0:5   64     64790

                       Mo1/0/0:6   66     64812

                       Mo1/0/0:7   68     64824

                       Mo1/0/0:8   70     64845

                       Mo1/0/0:9   72     64864

                       Mo1/0/0:10  74     64880

                       Mo1/0/0:11  76     64900

                       Mo1/0/0:12  78     64921

                       Mo1/0/0:13  80     64932

                       Mo1/0/0:14  82     78249

                       Mo1/0/0:15  84     78276

                       Mo1/0/0:16  86     78290

                       Mo1/0/0:17  88     78311

                       Mo1/0/0:18  90     78330

Examples: Displaying Detailed Information for a Specified A-DSG Tunnel

The following example shows all the detailed information about a specified tunnel for A-DSG version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).

Router# show cable dsg tunnel 1 verbose

Tunnel ID                     : 1

MAC Addr                      : 0100.5e01.0114

State                         : enable

Cfr Id                        : 1

State                         : enable

Priority                      : 1

Dest IP                       : 230.1.1.20

Src IP                        : 0.0.0.0

Src Prefix Length             : 32

Dest Port Start               : 0

Dest Port End                 : 65535

Forwarded                     : 0

Received                      : 0

Cfr Id                        : 5

State                         : enable

Priority                      : 1

Dest IP                       : 230.1.1.60

Src IP                        : 0.0.0.0

Src Prefix Length             : 32

Dest Port Start               : 0

Dest Port End                 : 65535

Forwarded                     : 0

Received                      : 0

Cfr Id                        : 11

State                         : enable

Priority                      : 1

Dest IP                       : 224.25.25.134

Src IP                        : 0.0.0.0

Src Prefix Length             : 32

Dest Port Start               : 0

Dest Port End                 : 65535

Forwarded                     : 0

Received                      : 0

Cfr Id                        : 14

State                         : enable

Priority                      : 0

Dest IP                       : 230.1.1.20

Src IP                        : 0.0.0.0

Src Prefix Length             : 32

Dest Port Start               : 1000

Dest Port End                 : 2000

Forwarded                     : 0

Received                      : 0

Client List Id                : 2

Client Id                     : 1

Client Id Type                : CA System ID: 0951

Client Id                     : 3

Client Id Type                : Broadcast

Client Id                     : 8

Client Id Type                : MAC Addr: 1111.1111.1111

Client List Id                : 3

Client Id                     : 1

Client Id Type                : Application ID: 0001

Client List Id                : 4

Client Id                     : 1

Client Id Type                : CA System ID: 0701

Client List Id                : 10

Client Id                     : 1

Client Id Type                : Application ID: 0006

Interface                     : Cable6/0

Rule Id                       : 1

Rule Id                       : 7

Rule Id                       : 8

Rule Id                       : 20

Interface                     : Cable6/1

Rule Id                       : 1

Rule Id                       : 3

Rule Id                       : 4

Rule Id                       : 11

Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the "TG id" field in support of A-DSG version 1.2. The "State" and "MAC Addr" fields also switched positions in the output.

Router# show cable dsg tunnel 1 verbose 

Tunnel ID                                       : 1

State                                           : enable

MAC Addr                                        : 0100.5e01.0001

TG Id                                           : 1

Cfr Id                                          : 1

State                                           : enable

Priority                                        : 0

Dest IP                                         : 230.1.0.1

Src IP                                          : 0.0.0.0

Src Prefix Length                               : 32

Dest Port Start                                 : 0

Dest Port End                                   : 65535

Forwarded                                       : 0

Received                                        : 0

Cfr Id                                          : 6

State                                           : enable

Priority                                        : 0

Dest IP                                         : 231.1.1.6

Src IP                                          : 0.0.0.0

Src Prefix Length                               : 32

Dest Port Start                                 : 0

Dest Port End                                   : 65535

Forwarded                                       : 0

Received                                        : 0

Cfr Id                                          : 7

State                                           : enable

Priority                                        : 0

Dest IP                                         : 231.1.1.7

Src IP                                          : 0.0.0.0

Src Prefix Length                               : 32

Dest Port Start                                 : 0

Dest Port End                                   : 65535

Forwarded                                       : 0

Received                                        : 0

Cfr Id                                          : 8

State                                           : enable

Priority                                        : 0

Dest IP                                         : 231.1.1.8

Src IP                                          : 0.0.0.0

Src Prefix Length                               : 32

Dest Port Start                                 : 0

Dest Port End                                   : 65535

Forwarded                                       : 0

Received                                        : 0

Client List Id                                  : 1

Client Id                                       : 1

Client Id Type                                  : MAC Addr        0100.5e00.0001

Client Id                                       : 2

Client Id Type                                  : Application ID  0x0951

Client Id                                       : 3

Client Id Type                                  : Broadcast       Unspecified

Client Id                                       : 4

Client Id Type                                  : Broadcast       4

Interface                                       : Cable5/0

Rule Id                                         : 1

Related Commands

Command	Description
debug cable dsg	Enables general, DCD or packet-related debugging.
show cable dsg tg	Displays information about A-DSG tunnel groups on a Cisco CMTS router.
show interface	Displays general interface information for the specified or all interfaces.
show interface cable dsg downstream	Displays A-DSG configuration and status information for downstream interfaces.

show cable fiber-node

To display information about a fiber node, use the show cable fiber-node command in privileged EXEC mode.

show cable fiber-node fiber-node-id [spectrum]

Syntax Description

fiber-node-id	Specifies a fiber node ID. Valid values range from 1 to 256.
spectrum	Displays upstream channel frequency assignment information and the spectrum group number.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.3BC	This command was introduced
12.2(33)SCC	This command was integrated into Cisco IOS Release 12.2(33)SCC.

Usage Guidelines

Use the show cable fiber-node command to display information about a fiber node, such as the fiber node status. If you specify the spectrum parameter, the command displays upstream channel frequency assignment information and the spectrum group number.

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. This traditional DOCSIS downstream channel used for a MAC domain is called the primary downstream channel. The associated traditional DOCSIS upstream channel is used for return data traffic and signaling.

Examples

The following is a sample output of the show cable fiber-node command:

Router# show cable fiber-node 2

Fiber-Node         Config Status

Fiber-Node 2 

       downstream Modular-Cable 1/0/0:  0-3

       downstream Cable 7/1/0

       upstream Cable 7/1:  10-19

    FN Config Status: Configured (status flags = 0x01)

    MDD Status: Valid

Router#

Table 44 describes the fields shown in the show cable fiber-node command display.

Table 44 show cable fiber-node Field Descriptions

Field	Description
Fiber-Node	Displays the fiber nodes configured on the CM.
Config Status	Displays the configuration status of the fiber node. Status flags are as follows: •0x01 - CMTS_FN_CONFIG •0x02 - CMTS_FN_FREQ_INVALID •0x04 - CMTS_FN_CHID_INVALID •0x08 - CMTS_FN_BUNDLE_INVALID •0x10 - CMTS_FN_BOND_CHID_INVALID •0x20 - CMTS_FN_US_FREQ_INVALID •0x40 - CMTS_FN_NO_US_CONFIGURED
MDD Status	Displays the MAC Domain Descriptor (MDD) status. MDD status of a fiber node is set as invalid in the following cases: •Frequency is not unique. •Channel ID is not unique. •Bonding group ID is not unique. •Bundle is mismatched.

Router# show cable fiber-node 2 spectrum 

Fiber            Upstream        Physical     Frequency       Spectrum      

Node No.         Port            Port         (MHz)           Group No.     

2                Cable7/1/0 U0   10           21.939 [1.6]    1

2                Cable7/1/0 U1   11           10.695 [1.6]    1

2                Cable7/1/0 U2   12            5.834 [1.6]    1

2                Cable7/1/0 U3   13            9.055 [1.6]    1

2                Cable7/1/4 U0   16           unassigned      No

2                Cable7/1/4 U1   17           unassigned      No

2                Cable7/1/4 U2   18           unassigned      No

2                Cable7/1/4 U3   19           unassigned      No

Table 45 describes the fields shown in the show cable load-balance command display when the spectrum keyword is used.

Table 45 show cable fiber-node Field Descriptions

Field	Description
Upstream Port	Displays the upstream port associated with the fiber node.
Physical Port	Displays the physical port of the upstream channel.
Frequency	Displays the upstream channel frequency of the CM.
Spectrum Group No.	Displays the spectrum group number of the fiber node. A spectrum group is a list of upstream frequencies and nominal power levels. Spectrum groups ranging from 1 to 32 can be created for each cable modem upstream port.

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 filter

To display the DOCSIS 1.1 filter groups that are currently defined, use the show cable filter command in user EXEC or privileged EXEC mode.

show cable filter [group group-index [index index-num]] [verbose]

Syntax Description

group group-id	(Optional) Specifies the filter group to be displayed. The valid range is 1 to 256.
index index-num	(Optional) Specifies the index of the particular filter within a group to be displayed. The valid range is 1 to 128 on a uBR7200 series router and 1 to 255 on a uBR10012 router.
verbose	(Optional) Displays complete information about the filter groups in a format that is easier to read than the default display.

Command Modes

User EXEC, Privileged EXEC (#)

Command History

Release	Modification
12.1(6)EC1	This command was introduced on the Cisco uBR7100 series and Cisco uBR7200 series routers.
12.2(2)XF, 12.2(4)BC1	This command was supported on the Cisco uBR10012 routers.
12.2(8)BC2	An option was added to the cable filter group command to allow filter groups to be activated and deactivated without removing the filter group's configuration.
12.2(33)SCA	The output was changed to add fields for IPv6 information, including the "v6" field in the show cable filter command, and the "Source IPv6 Address," and "Destination IPv6 Address" fields of the show cable filter verbose command.

Examples

The following example shows a typical display of the show cable filter command:

Router# show cable filter 

 Filter SrcAddr/Mask       DestAddr/Mask      Prot ToS  SPort DPort TCP   Action  Status

Grp Id                                                              Flags

1   1                                         256             137   0,0   drop active

1   2                      10.37.11.151/24    6               23    2,0   drop active

1   3                                         17        68    67    0,0   drop active

1   4                                         256             161   0,0   drop active

1   5                                         256             53    0,0   drop active

1   6                      10.37.11.151/29    256                         accept active

1   7   10.37.11.196/29    10.11.0.98/32      256                         accept active

1   8   10.37.11.195/32    10.11.0.98/32      6                           drop active

1   9   10.37.11.195/32    10.11.0.98/32      256                         accept active

1   10  10.37.11.194/32    10.11.0.98/16      6                           accept active

1   11  10.37.11.193/32    10.11.0.98/8       17                          drop active

1   12  10.37.11.192/32    10.11.0.98/32      6   F,F                     accept active

1   13  10.37.11.191/32    10.11.0.98/32      17  F,F                     accept active

1   14  10.37.11.190/32    10.11.0.98/24      17  8,F                     accept active

1   15  10.37.11.189/32    10.11.0.98/32      256 F,8                     drop active

1   16  10.37.11.189/32    10.11.0.98/32      256 F,8                     accept active

1   17  10.37.11.188/32    10.11.0.98/8       17                          accept active

1   18  10.37.11.188/32    10.11.0.98/32      6                           drop active

1   19  10.37.11.187/32    10.11.0.98/30      256                         accept active

1   20                     10.11.0.98/0       256                         drop active

Router#

The following shows typical output for the verbose form of this command:

Router# show cable filter group 10 index 10 verbose 

Filter Group                                : 1

Filter Index                                : 1

Matches                                     : 0

    Match action                            : accept

    Status                                  : active

Filter Group                                : 10

Filter Index                                : 10

Matches                                     : 0

    Source IP Address                       : 10.7.7.7/16

    Destination IP Address                  : 10.8.8.8/16

    IP Protocol type                        : 256

    IP ToS (Mask, Value)                    : 1, 2

    TCP/UDP Source Port                     : 2000

    TCP/UDP Destination Port                : 3000

    TCP Flags (mask, value)                 : 0, 0

    Match action                            : accept

    Status                                  : active

Router# 

IPv6 Examples

The following examples show examples of output for the show cable filter commands with changes beginning in Cisco IOS Release 12.2(33)SCA in support of IPv6 cable filter groups. Table 46 describes the output fields.

Router# show cable filter 

Filter    SrcAddr/Mask       DestAddr/Mask      Prot ToS  SPort DPort TCP   Action Status

Grp Id v6                                                             Flags

254 128Y  Use Verbose        Use Verbose                                    drop   active

Router# show cable filter group 254

Filter    SrcAddr/Mask       DestAddr/Mask      Prot ToS  SPort DPort TCP   Action Status

Grp Id v6                                                             Flags

254 128Y  Use Verbose        Use Verbose                                    drop   active

Router# show cable filter group 254 index 128

Filter    SrcAddr/Mask       DestAddr/Mask      Prot ToS  SPort DPort TCP   Action Status

Grp Id v6                                                             Flags

254 128Y  Use Verbose        Use Verbose                                    drop   active

Table 46 show cable filter Field Descriptions 

Field	Description
Filter Gp	ID number of the filter group. Defined by the group-id argument of the cable filter group command.
Filter Id	Index number of the filter group. Defined by the index-num argument of the cable filter group command.
v6	IP version 6 filter group type indicator. Defined by the ip-version keyword of the cable filter group command. Possible values are Y or N.
SrcAddr/Mask	•IP version 4—Filter source IP address and mask to be matched by the filter. Defined by the src-ip and src-mask keywords of the cable filter group command.. •IP version 6—"Use Verbose" appears because IPv6 addresses will not fit in the output display area; need to use the show cable filter group verbose command to view IPv6 addresses.
DestAddr/Mask	•IP version 4—Filter destination IP address and mask to be matched by the filter. Defined by the dest-ip and dest-mask keywords of the cable filter group command. •IP version 6—"Use Verbose" appears because IPv6 addresses will not fit in the output display area; need to use the show cable filter group verbose command to view IPv6 addresses.
Prot	IP protocol number(s) to be matched by the filter. Defined by the ip-proto keyword of the cable filter group command.
ToS	Type of Service mask and value to be matched by the filter. Defined by the ip-tos keyword of the cable filter group command.
SPort	TCP/UDP source port number to be matched by the filter. Defined by the src-port keyword of the cable filter group command.
DPort	TCP/UDP destination port number to be matched by the filter. Defined by the dest-port keyword of the cable filter group command.
TCP Flags	TCP flag mask and value to be matched by the filter. Defined by the tcp-flags keyword of the cable filter group command.
Action	Action to be taken on packet (accept or drop) when filter match occurs. Defined by the match-action keyword of the cable filter group command.
Status	Filter group status (active or inactive). Defined by the status keyword of the cable filter group command.

Router# show cable filter group 254 index 128 verbose

Filter Group                         : 254

Filter Index                         : 128

Filter Version                       : IPv6

Matches                              : 0

    Source IPv6 address              : 2001:33::20B:BFFF:FEA9:741F/128

    Destination IPv6 address         : 2001:1::224/128

    Match action                     : drop

    Status                           : active

Table 47 describes the output fields.

Table 47 show cable filter verbose Field Descriptions

Field	Description
Filter Group	ID number of the filter group. Defined by the group-id argument of the cable filter group command.
Filter Index	Index number of the filter group. Defined by the index-num argument of the cable filter group command.
Filter Version	IP version of the filter group. Defined by the ip-version keyword of the cable filter group command. Possible values are IPv4 or IPv6.
Matches: Source IP address or Matches: Source IPv6 address	•Source IP address—IPv4 source IP address and mask to be matched by the filter. Defined by the src-ip and src-mask keywords of the cable filter group command. •Source IPv6 address—IPv6 source IP address and prefix to be matched by the filter. Defined by the v6-src-address and v6-src-pfxlen keywords of the cable filter group command.
Matches: Destination IP address or Matches: Destination IPv6 address	•Destination IP address—IPv4 destination IP address and mask to be matched by the filter. Defined by the dest-ip and dest-mask keywords of the cable filter group command. •Destination IPv6 address—IPv6 destination IP address and prefix to be matched by the filter. Defined by the v6-dest-address and v6-dest-pfxlen keywords of the cable filter group command.
Matches: IP Protocol type	IP protocol number(s) to be matched by the filter. Defined by the ip-proto keyword of the cable filter group command.
Matches: IP ToS (Mask, Value)	Type of Service mask and value to be matched by the filter. Defined by the ip-tos keyword of the cable filter group command.
Matches: TCP/UDP Source Port	TCP/UDP source port number to be matched by the filter. Defined by the src-port keyword of the cable filter group command.
Matches: TCP/UDP Destination Port	TCP/UDP destination port number to be matched by the filter. Defined by the dest-port keyword of the cable filter group command.
Matches: TCP Flags (mask, value)	TCP flag mask and value to be matched by the filter. Defined by the tcp-flags keyword of the cable filter group command.
Matches: Match action	Action to be taken on packet (accept or drop) when filter match occurs. Defined by the match-action keyword of the cable filter group command.
Matches: Status	Filter group status (active or inactive). Defined by the status keyword of the cable filter group command.

Related Commands

Command	Description
cable filter group	Creates, configures, and activates a DOCSIS 1.1 filter group that filters packets on the basis of the TCP/IP and UDP/IP headers.

show cable flap-list

To display the cable flap-list on a Cisco CMTS, use the show cable flap-list command in user EXEC or privileged EXEC mode.

show cable flap-list

show cable flap-list [cable slot/port | cable slot/subslot/port] [upstream port] [sort-flap | sort-time]

show cable flap-list sort-interface [sort-flap | sort-time]

Syntax Description

cable slot/port	(Optional) Displays information for all CMs on the specified cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers: •slot—Chassis slot number of the cable interface line card. •port—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	(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router: •slot—Chassis slot number of the cable interface line card. Valid slots are from 5 to 8. •subslot—Secondary slot number of the cable interface line card. Valid subslots are 0 or 1. •port—Downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.
upstream port	(Optional) Displays the flap list for a particular upstream on the selected cable interface.
sort-interface	(Optional) Displays the flap list for all cable interfaces, sorted by interface.
sort-flap	(Optional) Sorts the list by the number of times the CM has flapped.
sort-time	(Optional) Sorts the list by the most recent time the CM is detected to have flapped.

Command Modes

User EXEC (>), Privileged EXEC (#)

Command History

Release	Modification
11.3 NA	This command was introduced.
12.0(3)T	This command was supported on the Cisco mainline release.
12.0(7)XR and 12.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.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
12.2(33)SCC	The output of this command was modified to show the aggregated data across all upstream channels for each flap detector for CMs in the Multiple Transmit Channel (MTC) mode on a Cisco uBR10012 router.

Usage Guidelines

The sort options operate differently on the different Cisco CMTS routers. On the Cisco uBR7100 series and Cisco uBR7200 series routers, the sort options apply to all cable interface line cards and merge the output into a single display.

On the Cisco uBR10012 router, the sort options apply to individual cable interface line cards. For example, the sort-time option sorts all of the flap entries on the first cable interface line card (c5/0/0), then the entries on the second card (c5/1/0), and so forth.

---

Note Occasionally, the show cable flap-list command might temporarily show duplicate entries for the same cable modem. This can occur after a cable modem has gone offline and before it has completed the registration process and come back online. When the cable modem does reach the online state, the duplicate entries disappear.

---

---

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 the output of the show cable flap-list command:

router# show cable flap-list 

MAC Address     Upstream     Ins   Hit   Miss  CRC   P-Adj Flap  Time

 0010.7bb3.fd19  Cable5/0/U1  0     2792  281   0    *45    58    Jul 27 16:54:50

 0010.7bb3.fcfc  Cable5/0/U1  0     19    4     0    !43    43    Jul 27 16:55:01

 0010.7bb3.fcdd  Cable5/0/U1  0     19    4     0    *3     3     Jul 27 16:55:01

---

Note The asterisk (*) in the P-Adj field indicates that a power adjustment has been made for that CM. The exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.

---

The following example shows the display of flap-list tables sorted by MAC address:

router# show cable flap-list sort-flap 

Mac Addr           CableIF    Ins    Hit   Miss    CRC  P-Adj   Flap    Time

0010.1eab.2c0b     C6/0 U0    108    318     27      0      0    108 Sep 10 15:26:56 

0010.1eb2.bb07     C6/0 U0      0    293     31      1      1      1 Sep 10 15:15:49

0010.7b6b.71cd     C6/0 U0      1    288     32      0      0      1 Sep 10 15:12:13

0010.1eb2.bb8f     C6/0 U0      1    295     30      0      0      1 Sep 10 15:11:44

The following example shows the display of flap-list tables sorted by time:

Router# show cable flap-list sort-time 

Mac Addr       CableIF    Ins    Hit   Miss    CRC  P-Adj   Flap    Time

00e0.2222.2202 C4/0 U0    464   2069    242      0    421    885 Oct 16 22:47:23

0010.7b6b.57e1 C4/0 U0      0   2475     43      0   1041   1041 Oct 16 22:47:04

The following sample output of the show cable flap-list command provides the aggregated data across all upstream channels for CMs in the MTC mode on a uBR10012 router in Cisco IOS Release 12.2(33)SCC:

router# show cable flap-list

MAC Address    Upstream    Ins   Hit   Miss  CRC   P-Adj Flap  Time

001e.6bfb.0f9e C5/0/0/UB   0     62539 0     0     2     2     Apr 18 03:53:00

0050.f110.b277 C5/0/0/UB   0     10965 211   0     0     9     Apr 18 03:53:00

Table 48 describes the significant fields shown in the display.

Table 48 show cable flap-list Command Field Descriptions 

Field	Description
Mac Addr	MAC address for the CM.
CableIF	Cable interface line card, including upstream, for this CM.
Ins	Number of times the CM comes up and inserts itself into the network. It can indicate intermittent downstream sync loss or DHCP or modem registration problems.
Hit	Number of times the CM 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	Number of times the CM 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	Number of cyclic redundancy check (CRC) errors from this CM. It can indicate intermittent upstream, laser clipping, or common-path distortion.
P-Adj	Number of times the headend instructed the CM to adjust transmit (TX) power more than 3 dB. It can indicate amplifier degradation, poor connections, or thermal sensitivity.
Flap	Sum of P-Adj and Ins values. CMs with high flap counts have high SIDs and might not register.
Time	Most recent time that the CM dropped the connection.

Related Commands

Command	Description
cable flap-list aging	Specifies the number of days to keep a CM 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 CM is placed in the flap list.
cable flap-list miss-threshold	Specifies the miss threshold for recording a flap-list event.
cable flap-list power-adjust threshold	Specifies the power-adjust threshold for recording a CM flap-list event.
cable flap-list size	Specifies the maximum number of CMs that can be listed in the flap-list table.
clear cable flap-list	Clears all the entries in the flap-list table.
debug cable flap	Displays information about the operation of the CM flap list that is maintained for the cable interfaces.
ping docsis	Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate.
show cable modem	Displays information about all CMs on an interface or about a particular CM.
show cable modem flap	Displays flap list statistics for one or more cable modems.

show cable flap-list wb-rf

To display the wideband RF related data for all w-online cable modems, use the show cable flap-list wb-rf command in privileged EXEC mode.

show cable flap-list [cable slot/subslot/port] wb-rf [modular-cable slot/bay/port WB RF channel number] [QAM | MDD]

Syntax Description

cable slot/subslot/port	(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router, where: •slot—Specifies 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.
modular-cable slot/bay/port	(Optional) Displays information for all CMs on the specified modular cable interface on a Cisco uBR10012 router, where •slot—The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for SIPs. •bay—The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and 1 (lower bay). •port—Specifies the interface number on the SPA.
WB RF channel number	(Optional) Specifies the wideband RF channel number.
QAM	(Optional) Specifies the number of QAM flaps.
MDD	(Optional) Specifies the number of MDD flaps.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SCB	This command was introduced.

Usage Guidelines

None

Examples

The following is a sample output of the show cable flap-list wb-rf command:

router# show cable flap-list wb-rf

RF       Timeout Recover Failure Recover Flaps CM      Percent

-------- ------- ------- ------- ------- ----- ------- -------

3/0/0 1  1       1       0       0       1     3       33 

      2  0       0       1       0       1     3       33 

Related CommandsR

Command	Description
show cable flap-list	Displays the cable flap-list on a Cisco CMTS.
clear cable flap-list	Clears all the entries in the flap-list table.
debug cable flap	Displays information about the operation of the CM flap list that is maintained for the cable interfaces.
show cable modem flap	Displays flap list statistics for one or more cable modems.

show cable hop

To display cable-hop statistics on a Cisco CMTS, use the show cable hop command in user EXEC or privileged EXEC mode.

show cable hop [cable slot/port] [upstream uport] [history] [threshold]

show cable hop [cable slot/subslot/port ] [upstream uport] [history] [threshold]

Syntax Description

cable slot/port	(Optional) Specifies a cable interface on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
cable slot/subslot/port	(Optional) Specifies a cable interface on the Cisco uBR10012 router. The following are the valid values: •slot = 5 to 8 •subslot = 0 or 1 •port = 0 to 4 (depending on the cable interface)
upstream uport	(Optional) Specifies an upstream port for which to display the frequency hop status.
history	(Optional) Displays changes from one state to another, at any time and for any reason, for frequency, modulation, and channel width.
threshold	(Optional) Displays the user defined thresholds and current carrier-to-noise ratio (CNR), signal-to-noise ratio (SNR), correctable forward error correction (FEC) percentage, uncorrectable FEC percentage, and missed station maintenances percentage values of the upstreams.

Command Modes

User EXEC, Privileged EXEC

Command History

Release	Modification
12.0(4)XI	This command was introduced.
12.3(13a)BC	This command was enhanced with the addition of two new keywords, history and threshold.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
12.3(23)BC7	The output of the show cable hop history command is modified to include more information in the `change from' and `change to' fields of the output. Now, the modulation profile number is displayed when a change occurs, instead of the modulation order.
12.2(33)SCC	This command was integrated into Cisco IOS Release 12.2(33)SCC.

Examples

The following example shows typical output from the show cable hop command:

Router# show cable hop 

Upstream      Port       Poll Missed Min    Missed Hop   Hop     Corr    Uncorr

Port          Status     Rate Poll   Poll   Poll   Thres Period  FEC     FEC

                         (ms) Count  Sample Pcnt   Pcnt  (sec)   Errors  Errors

Cable4/0/U0   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U1   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U2   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U3   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U4   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U5   down       1000 * * *   frequency not set    * * * 0       0

Cable5/0/U0   down       1000 * * *   interface is down    * * * 0       0

Cable5/0/U1   down       1000 * * *   frequency not set    * * * 0       0

Cable5/0/U2   down       1000 * * *   interface is down    * * * 0       0

Cable5/0/U3   down       1000 * * *   interface is down    * * * 0       0

Cable5/0/U4   down       1000 * * *   interface is down    * * * 0       0

Cable5/0/U5   down       1000 * * *   interface is down    * * * 0       0

Cable6/0/U0   down       1000 * * *   interface is down    * * * 0       0

Cable6/0/U1   22.000 Mhz 1000 * * *set to fixed frequency * * *  31375  1912

Cable6/0/U2   26.000 Mhz 1000 * * *set to fixed frequency * * *  0      0

Cable6/0/U3   admindown  1000 * * *   frequency not set   * * *  0      0

The following example shows typical output from the show cable hop upstream command:

Router# show cable hop c2/0 upstream 2 

Upstream    Port       Poll Missed Min    Missed Hop   Hop     Corr    Uncorr

Port        Status     Rate Poll   Poll   Poll   Thres Period  FEC     FEC

                       (ms) Count  Sample Pcnt   Pcnt  (sec)   Errors  Errors

Cable2/0/U2 admindown  1000 * * *   frequency not set    * * * 0       0      

Router# 

Table 49 describes the fields displayed by the show cable hop and show cable hop upstream commands.

Table 49 show cable hop Command Field Descriptions 

Field	Description
Upstream Port	The upstream port for this information line.
Port Status	Lists the status of the port. Valid states are down if frequency is unassigned or admindown if the port is shut down. If the port is up, this column shows the center frequency of the channel.
Poll Rate	The rate that station maintenance polls are generated (in milliseconds).
Missed Poll Count	The number of missing polls, per codeword/FEC block.
Min Poll Sample	The number of polls in the sample, per codeword/FEC block.
Missed PollPcnt	The ratio of missing polls to the number of polls, expressed as a percentage.
Hop Thres Pcnt	The level that the missed poll percentage must exceed to trigger a frequency hop, expressed as a percentage.
Hop Period	The maximum rate that frequency hopping will occur (in seconds).
Corr FEC Errors	The number of correctable forward error corrections (FEC) errors on this upstream port, per codeword/FEC block.
Uncorr FEC Errors	The number of uncorrectable FEC errors on this upstream port, per codeword/FEC block.
Note The show cable hop and show controllers cable commands display FEC errors per codewords, while the show interface cable upstream command displays FEC errors per packets, where a packet could contain multiple codewords.

---

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.

---

The following example shows typical output from the show cable hop threshold command:

Router# show cable hop c6/0/0 threshold

Upstream SNR(dB) CNR(dB) CorrFEC% UncorrFEC% MissedSM% 

Port Val Thre1 Thre2 Val Thre1 Thre2 Pcnt Thre Pcnt Thre Pcnt Thre 

Ca6/0/0/U0 27   25   15    39   35   25    0    3    0    1           75   75 

Ca6/0/0/U1 31   25   15    51   35   25    0    3    0    1           90   75 

Ca6/0/0/U2 --   35   25    --   35   25    0    3    0    1           0    75 

Ca6/0/0/U3 --   35   25    --   35   25    0    3    0    1           0    75 

Table 50 describes the fields displayed by the show cable hop threeshold command.

Table 50 show cable hop threshold Command Field Descriptions 

Field	Description
Upstream Port	The upstream port for this information line.
SNR (dB)	The signal-to-noise ratio (SNR) for a particular cable modem (CM), in decibels (dB).
CNR (dB)	The current upstream carrier-to-noise ratio (CNR) for a particular cable modem (CM), in decibels (dB).
Corr FEC Errors	The number of correctable forward error corrections (FEC) errors on this upstream port, per codeword/FEC block.
Uncorr FEC Errors	The number of uncorrectable FEC errors on this upstream port, per codeword/FEC block.
Missed SM	The number of missing station maintenance polls, per codeword/FEC block.

The following example shows typical output from the show cable hop history command:

Router# show cable hop c8/1/1 upstream 0 history

F = Frequency Hop, M = Modulation Change, C = Channel Width Change

Upstream   Action             Chg    Chg    Action

Port       Time          Code From   To     Reason

C8/1/1 U0  Feb 20 12:21:29 M  142    141    SNR 28>=28 CFEC 0<=3 UnCFEC 0<=1

           Feb 20 12:09:08 F   0.000 24.000 Configuration changed

Table 51 describes the fields displayed by the show cable hop history command.

Table 51 show cable hop history Command Field Descriptions 

Field	Description
Upstream Port	The upstream port for this information line.
Action Time	The time of the spectrum management action.
Code	The code associated with the type of hop.
Chg From	The previous state of the spectrum management action.
Chg To	The current state of the spectrum management action.
Action Reason	The reason for changing the frequency.

Related Commands

Command	Description
cable spectrum-group hop period	Changes the minimum time between frequency hops.
cable spectrum-group hop threshold	Specifies a frequency hop threshold for a spectrum group.
cable upstream hop-priority	Configures the priority of the corrective actions to be taken when a frequency hop is necessary due to ingress noise on the upstream.
cable upstream modulation-profile	Configures up to three modulation profiles to an upstream port to activate Dynamic Upstream Modulation.
cable upstream threshold	Configures the upstream for the CNR and FEC threshold values to be used in determining the allowable noise levels.
cable upstream threshold hysteresis	Configures a hysteresis value to be used in conjunction with the dynamic modulation upgrade thresholds.
clear cable hop	Clears the forward error corrections (FEC) hop counters on one or all cable interfaces on a Cisco CMTS.
show cable host access-group	Displays the statistics for the host behind the CM.
show cable modem	Displays CM configuration settings.

show cable host access-group

To display the hosts and other customer premises equipment (CPE) devices behind the CMs in the network, along with their access groups, use the show cable host access-group command in privileged EXEC mode.

show cable host [ip-address | mac-address] access-group

---

Note The show cable host command is not supported on the Cisco uBR10012 universal broadband router.

---

Syntax Description

mac-addr	(Optional) Specifies the 48-bit hardware address for a particular CM or host.
ip-addr	(Optional) Specifies the IP address for a particular CM or host.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.NA	This command was introduced.
12.1(3a)EC1	Support was added to the Release 12.1 EC train.
12.2(4)BC1	Support was added to the Release 12.2 BC train for the Cisco uBR7100 series and Cisco uBR7200 series routers. (This command also appears in the CLI for the Cisco uBR10012 router but is not functional.)

Usage Guidelines

This command displays information only for hosts and other CPE devices. To display information for CMs and their associated CPE devices, use the show cable device access-group command. To display information only for CMs, use the show cable device 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.

Examples

The following example shows how to display all the hosts behind the CMs in the network:

router# show cable host access-group 

MAC address      IP address      Type    Access-group

0080.c6f9.b42e   24.168.220.52   host

0020.7806.defe   192.168.28.134  host

0050.baa0.5ccd   24.168.223.251  host

0050.046f.f4cf   192.168.33.25   host

0050.bacf.5d89   192.168.37.113  host

0050.1800.a8cb   192.168.33.90   host

0040.d00f.44f0   192.168.34.128  host

0050.e456.9641   192.168.39.66   host

0050.badd.2883   192.168.32.230  host

0050.badd.3b12   192.168.33.246  host

0020.78c7.f887   192.168.32.32   host

00e0.2969.a1a5   192.168.36.246  host

0020.78d5.ddf0   192.168.32.107  host

00001.02c5.9936  192.168.38.233  host

0020.78d0.fb32   192.168.28.45   host

0050.1800.f458   192.168.36.209  host

0002.e301.df8f   192.168.30.191  host

00a0.2451.b7eb   24.168.223.41   host

0080.c7db.afba   192.168.33.153  host

00D0.2717.1899   192.168.39.189  host

Router# 

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

Table 0-52 show cable host access-group Field Descriptions 

Field	Description
MAC Address	The MAC address for the CPE device.
IP Address	The IP address that the DHCP server has assigned to the CPE device.
Type	Identifies the type of device. With this command, this field should always be host to indicate a CPE device. Use the show cable device access-group or show cable modem access-group command to display information for CMs.
Access-group	Displays the access group name or number in use (if any) for this CPE device.

---

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 device	Configures the access list for a CM device or host.
cable host access-group	Configures the access list for the specified hosts.
clear cable host	Clears the host from the table.
show cable device access-group	Displays a list of CMs and their CPE devices, along with their access groups.
show cable modem access-group	Displays the access groups for the CMs on a particular cable interface.

show cable ib-ipc

To display the status of local IB IPC server and information on participating line cards, use the show cable ib-ipc command in privileged EXEC mode.

show cable ib-ipc {status | ports}

Syntax Description

status	Displays status of local IB IPC server.
ports	Displays information on participating line cards.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(23)BC	This command was introduced for the Cisco uBR10012 router.

Examples

The following is sample output from the show cable ib-ipc command. The command show cable ib-ipc ports displays the internal virtual channel identifiers and internal service flows for Ironbus based IPC.

Router# show cable ib-ipc ports

6/0: LCP High Priority VCCI 135, SFID 32891 

LCP Normal Priority VCCI 135, SFID 135 

8/0: LCP High Priority VCCI 153, SFID 32909 

LCP Normal Priority VCCI 153, SFID 153

show cable ipc-stats

To display statistics of all IPC messages on a Cisco CMTS router, use the show cable ipc-stats command in privileged EXEC mode.

show cable ipc-stats

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SCC	This command was introduced in Cisco IOS Release 12.2(33)SCC.

Usage Guidelines

You must enable the Cable IPC Statistics Collection tool using the cable ipc-stats command before using the show cable ipc-stats command. When you use this show command, a separate shadow database buffer is allocated, and the contents of the active database are copied into the shadow database to display the IPC statistics. This ensures that all the statistics are frozen at the same time for easy comparison and analysis.

Examples

The following is a sample output of the show cable ipc-stats command that shows statistics of all IPC messages on a Cisco CMTS router:

Router# show cable ipc-stats

ubr10k2apatil#show cable ipc-stats

--- TIME ---

Start: 03:27:29 PDT Fri Oct 9 2009

End  : 03:28:22 PDT Fri Oct 9 2009

Total: 0 days 00 hrs 00 mins 53 secs (53 seconds)

size : 1407648 bytes

--- CR10K MSG ---

entity app      io    s/s reqid idx:    pkts      bytes lastEvt totalDur maxDur lastMax

                                                        (sec)   (msec)   (msec) (sec)

rp-lc c10k     TxReq 1/0 10241   1:       1         24      17

 rp-lc c10k     TxReq 1/0    10  14:      11        704       0

 rp-lc c10k     TxReq 2/1    10  14:      10        640       4

 rp-lc c10k     TxReq 3/0    10  14:      10        640       4

 rp-lc c10k     TxReq 3/1    10  14:      11        704       0

 rp-lc c10k     TxReq 4/0    10  14:      10        640       3

 rp-lc c10k     TxReq 6/0 10252   2:      10       9376      13

 rp-lc c10k     TxReq 6/0    10  14:      11        704       0

 rp-lc c10k     TxReq 6/1 10252   2:       1         88      53

 rp-lc c10k     TxReq 6/1    10  14:      11        704       0

 rp-lc c10k     TxReq 7/0 10252   2:       7        696       5

 rp-lc c10k     TxReq 7/0    10  14:      11        704       1

 rp-lc c10k     RxRsp 1/0 10241   1:       1          4      17        0      0

     17

 rp-lc c10k     RxReq 1/0 10241   1:      60      21816       0        0      0

      0

 rp-lc c10k     RxReq 1/0    10  14:      11        704       0        0      0

      0

 rp-lc c10k     RxReq 2/1 10241   1:      26      13468       1        0      0

      1

 rp-lc c10k     RxReq 2/1    10  14:      10        640       4        0      0

      4

 rp-lc c10k     RxReq 3/0 10241   1:      20       1340       5        0      0

      5

 rp-lc c10k     RxReq 3/0    10  14:      10        640       4        0      0

      4

 rp-lc c10k     RxReq 3/1    10  14:      11        704       0        0      0

      0

 rp-lc c10k     RxReq 4/0 10241   1:      20       1340       9        0      0

      9

 rp-lc c10k     RxReq 4/0    10  14:      10        640       3        0      0

      3

 rp-lc c10k     RxReq 6/0 10252   2:      13      27080       0        0      0

      0

 rp-lc c10k     RxReq 6/0    10  14:      11        748       0        0      0

      0

 rp-lc c10k     RxReq 6/1 10252   2:       1         68      25        0      0

     25

 rp-lc c10k     RxReq 6/1    10  14:      11        748       0        0      0

      0

 rp-lc c10k     RxReq 7/0 10252   2:      11      24548       3        0      0

      3

 rp-lc c10k     RxReq 7/0    10  14:      11        748       1        0      0

      1

 rp-lc pnego    TxReq 6/0    14   6:       3        363      13

 rp-lc pnego    TxReq 6/1    14   6:       1         30      53

 rp-lc pnego    TxReq 7/0    14   6:       2         62      13

 rp-lc plfm     RxReq 6/0    24  17:       1         12      37        0      0

     37

 rp-lc plfm     RxReq 6/0    27  20:      11       1144       0        0      0

      0

 rp-lc plfm     RxReq 6/0    28  21:     484      19360       0        0      0

      0

 rp-lc plfm     RxReq 6/1    24  17:       1         12      25        0      0

     25

 rp-lc plfm     RxReq 7/0    24  17:       1         12      45        0      0

     45

 rp-lc plfm     RxReq 7/0    27  20:      10       1040       3        0      0

      3

 rp-lc plfm     RxReq 7/0    28  21:     440      17600       3        0      0

      3

 rp-lc docsis   TxReq 7/0   118 110:      10         80       5

 rp-lc hccp     TxReq 6/0     8   8:       8       8416      13

 rp-lc hccp     RxReq 6/0     2   2:       1         28      13        0      0

     13

--- CR10K TXQ ---

 TXQ_6_0

 enQ: 10 pkts  max Q size 9 at 13 sec ago

 deQ: 10 pkts  max delay 24 msec at 13 sec ago

   delay between (  0,  10) msec:        6 pkts

   delay between ( 10,  20) msec:        3 pkts

   delay between ( 20,  30) msec:        1 pkts

   delay between (  0,   1) sec :       10 pkts

 flush: 0 ptks  0 times

 TXQ_6_1

 enQ: 1 pkts  max Q size 1 at 53 sec ago

 deQ: 1 pkts  max delay 0 msec at 53 sec ago

   delay between (  0,  10) msec:        1 pkts

   delay between (  0,   1) sec :        1 pkts

 flush: 0 ptks  0 times

 TXQ_7_0

 enQ: 7 pkts  max Q size 1 at 5 sec ago

 deQ: 7 pkts  max delay 48 msec at 13 sec ago

   delay between (  0,  10) msec:        1 pkts

   delay between ( 10,  20) msec:        5 pkts

   delay between ( 40,  50) msec:        1 pkts

   delay between (  0,   1) sec :        7 pkts

 flush: 0 ptks  0 times

--- CR10K WATERMARK ---

--- CR10K RXQ ---

 c10k rxq

 enQ: 236 pkts  max Q size 3 at 5 sec ago

 deQ: 236 pkts  max delay 4 msec at 35 sec ago

   delay between (  0,  10) msec:      236 pkts

   delay between (  0,   1) sec :      236 pkts

 flush: 0 ptks  0 times

 cr10k LP rxq

 enQ: 25 pkts  max Q size 1 at 0 sec ago

 deQ: 25 pkts  max delay 0 msec at 0 sec ago

   delay between (  0,  10) msec:       25 pkts

   delay between (  0,   1) sec :       25 pkts

 flush: 0 ptks  0 times

Table 48 describes the fields displayed by the show cable ipc-stats command.

Table 53 show cable ipc-stats Command Field Descriptions 

Field	Description
entity	Route processor-to-line card connection or a line card-to-line card connection.
app	Message group.
io	Send request or a send response, or a receiver request or a receiver response.
s/s	Slot/subslot
reqid	Nonsequential message ID for the original request.
idx	Sequential message index for the original request.
pkts	Number of messages.
bytes	Number of bytes.
lastEvt (sec)	Seconds since the last send or receive event.
totalDur (msec)	Total time in milliseconds for the blocked send wait or received request process.
maxDur (msec)	Maximum time in milliseconds for the blocked send wait or received request process.
lastMax (sec)	Seconds since the last maxDur is recorded.

Related Commands

Command	Description
cable ipc-stats	Enables the Cable IPC Statistics Collection tool on a Cisco CMTS router.
clear cable ipc-stats	Clears the active database and resets all IPC statistics in the active database to zero.

show cable l2-vpn dot1q-vc-map

To display the mapping of one or all cable modems to IEEE 802.1Q Virtual Local Area Networks (VLANs) on the router's Ethernet interfaces, use the show cable l2-vpn dot1q-vc-map command in privileged EXEC mode.

show cable l2-vpn dot1q-vc-map [mac-address [vpn vpnid][verbose]] [customer cust-name][vpn vpnid]

Syntax Description

mac-address	(Optional) Displays the mapping for the cable modem with the specified hardware MAC address.
vpn vpnid	(Optional) Displays Layer 2 VPN information on a cable modem with the specified MAC address, or for the specified VPN ID across all cable modems.
verbose	(Optional) Displays additional information about the Layer 2 mapping, including the number of packets and bytes received on the upstream and downstream.
customer cust-name	(Optional) Displays the VLAN mappings for this particular customer name.

Defaults

Displays information for all cable modems that have a defined IEEE 802.1Q VLAN mapping.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(15)BC2	This command was introduced for Cisco uBR7246VXR universal broadband routers.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA on the Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers. Support for the Cisco uBR7225VXR router was added. The vpn keyword was added and the output fields were modified to display L2VPN information.

Usage Guidelines

This command displays the cable modem to VLAN mappings that have been defined using the cable dot1q-vc-map command. It displays the MAC address, service ID (SID), and cable interface being used by the cable modem, and the interface and VLAN ID to which it has been mapped.

---

Tip The customer option displays only those VLAN mappings that have been configured with a particular customer name, using the cable dot1q-vc-map command.

---

The command also displays L2VPN information for cable modem traffic and service flows on CMTS router Ethernet interfaces that have been defined using the cable l2-vpn-service default-nsi command.

Examples

TLS in Cisco IOS Release 12.2BC Examples

The following example shows typical output for the show cable l2-vpn dot1q-vc-map command for all cable modems that are mapped to IEEE 802.1Q VLANs:

Router# show cable l2-vpn dot1q-vc-map 

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID   Priv Bits

0010.7bed.9c95 FE0/0.2                 3         Cable4/0    3     0 

0007.0e03.69f9 FE0/0.1                 4         Cable4/0    1     0 

Router# 

The following example shows typical output for a particular cable modem with the MAC address of 0001.0203.0405:

Router# show cable l2-vpn dot1q-vc-map 0001.0203.0405 

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID   Priv Bits

0010.7bed.9c91 GE2/0                   5         Cable5/0    7     0 

Router# 

The following example shows a typical example for the verbose option:

Router# show cable l2-vpn dot1q-vc-map 0001.0203.0405 verbose 

MAC Address                         : 0010.7bed.9c91 

Prim Sid                            : 7 

Cable Interface                     : Cable5/0 

Ethernet Interface                  : GigabitEthernet2/0 

DOT1Q VLAN ID                       : 5 

Total US pkts                       : 6 

Total US bytes                      : 1402 

Total DS pkts                       : 71 

Total DS bytes                      : 21975 

Table 54 describes the fields shown in the display.

Table 54 show cable l2-vpn dot1q-vc-map Field Descriptions 

Field	Description
MAC Address	Hardware (MAC) address for the CM being mapped.
Ethernet Interface	Destination interface (Ethernet, Fast Ethernet, or Gigabit Ethernet) for the VLAN being used for the mapping.
VLAN ID	Destination VLAN on the Ethernet, Fast Ethernet, or Gigabit Ethernet interface for the traffic coming from the CM.
Cable Intf	Cable interface to which the CM is connected.
SID	Primary service ID (SID) for this cable modem.
Priv Bits	Identifies the current settings of the two privacy bits in the extended header (EH) that is used for BPI-encrypted packets. •First bit = Enable bit. Set to 1 when BPI or BPI+ is enabled. •Second bit = Toggle bit. Matches the least-significant bit (LSB) of the key sequence number (KSN) in the EH. For example, a value of "0" indicates that BPI is not enabled. A value of "10" indicates that BPI is enabled and that the KSN is an even number. A value of "11" indicates that BPI is enabled and that the KSN is an odd number. Note For more information on these bits, see the DOCSIS Baseline Privacy Interface Plus Interface Specification (SP-BPI+-I08-020301 or later).
Total US pkts/bytes	Total number of packets and bytes sent on the upstream to the Layer 2 tunnel by this cable modem.
Total DS pkts/bytes	Total number of packets and bytes received on the downstream from the Layer 2 tunnel by this cable modem.

L2VPN over Cable in Cisco IOS Release 12.2SB Examples

The following example shows sample output of VLAN information for all cable modems configured for L2VPN support:

Router# show cable l2-vpn dot1q-vc-map

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID  Customer Name/VPN ID

0014.f8c1.fd66 GigabitEthernet4/0/0        68    Cable6/0/0  3    0234560001

The following example shows sample output of VLAN information for a VPN with ID 0234560001:

Router# show cable l2 dot1q-vc-map vpn 0234560001               

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID  Customer Name/VPNID

0014.f8c1.fd66 GigabitEthernet4/0/0        68    Cable6/0/0  3    0234560001

The following example shows sample output of VLAN information for a VPN with ID 0234560001 on the cable modem with MAC address 0014.f8c1.fd66:

Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 vpn 0234560001    

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID  Customer Name/VPNID

0014.f8c1.fd66 GigabitEthernet4/0/0        68    Cable6/0/0  3    0234560001

The following example shows sample output of detailed VLAN information for a VPN with ID 0234560001 on the cable modem with MAC address 0014.f8c1.fd66:

Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 vpn 0234560001 verbose

MAC Address                         : 0014.f8c1.fd66

Prim Sid                            : 3

Cable Interface                     : Cable6/0/0

VPN ID                              : 0234560001

L2VPN SAID                          : 12294

Upstream SFID                       : 23

Downstream CFRID[SFID]              : 2[24]

CMIM                                : 0x60

Ethernet Interface                  : GigabitEthernet4/0/0

DOT1Q VLAN ID                       : 68

Total US pkts                       : 1372

Total US bytes                      : 500226

Total US pkt Discards               : 0

Total US byte Discards              : 0

Total DS pkts                       : 1248

Total DS bytes                      : 415584

Total DS pkt Discards               : 0

Total DS byte Discards              : 0

The following example shows sample output of detailed VLAN information for a cable modem with MAC address 0014.f8c1.fd66:

Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 verbose

MAC Address                         : 0014.f8c1.fd66

Prim Sid                            : 3

Cable Interface                     : Cable6/0/0

L2VPNs provisioned                  : 1

DUT Control/CMIM                    : Enable/0xFFFFFFFF

VPN ID                              : 0234560001

L2VPN SAID                          : 12294

Upstream SFID                       : 23

Downstream CFRID[SFID]              : 2[24]

CMIM                                : 0x60

Ethernet Interface                  : GigabitEthernet4/0/0

DOT1Q VLAN ID                       : 68

Total US pkts                       : 1374

Total US bytes                      : 501012

Total US pkt Discards               : 0

Total US byte Discards              : 0

Total DS pkts                       : 1250

Total DS bytes                      : 416250

Total DS pkt Discards               : 0

Total DS byte Discards              : 0

Table 55 describes the fields shown in the display.

Table 55 show cable l2-vpn dot1q-vc-map with L2VPN Field Descriptions 

Field	Description
MAC Address	Hardware (MAC) address for the CM being mapped.
Prim Sid	Primary service ID for the CM.
Cable Interface	Cable interface to which the CM is connected.
L2VPNs provisioned	Number of L2VPNs supported by the CM.
DUT Control/CMIM	State of Downstream Unencrypted Traffic (DUT) filtering and Cable Modem Interface Mask (CMIM).
VPN ID	Identification number of the Layer 2 VPN tunnel.
L2VPN SAID	Layer 2 VPN Security Association Identifier (SAID).
Upstream SFID	Upstream Service Flow Identifier (SFID).
Downstream CFRID [SFID]	Downstream classifiers (classifier identifiers) and corresponding downstream service flows identifiers for this L2VPN.
CMIM	Cable Modem Interface Mask.
Ethernet Interface	Ethernet Network System Interface (NSI).
DOT1Q VLAN ID	Destination VLAN on the Ethernet, Fast Ethernet, or Gigabit Ethernet interface for the traffic coming from the CM.
Total US pkts/bytes	Total number of packets and bytes sent on the upstream to the Layer 2 tunnel by this CM.
Total US pkt/byte Discards	Total number of packets and bytes dropped on the upstream to the Layer 2 tunnel by this CM.
Total DS pkts/bytes	Total number of packets and bytes received on the downstream from the Layer 2 tunnel by this CM.
Total DS pkt/byte Discards	Total number of packets and bytes dropped on the downstream from the Layer 2 tunnel by this CM.

Related Commands

Command	Description
cable l2-vpn-service dot1q	Enables the use of Layer 2 tunnels for the Customer Premises Equipment (CPE) traffic that is behind cable modems so that individual CPE traffic can be routed over a particular Virtual Local Area Network (VLAN).
cable dot1q-vc-map	Maps a cable modem to a particular VLAN on a local outbound Ethernet interface.
cable l2-vpn-service default-nsi	Configures an Ethernet Network System Interface for Layer 2 VPN support over cable.
debug cable l2-vpn	Displays debugging messages for the Layer 2 mapping of cable modems to particular PVCs or VLANs.

show cable l2-vpn xconnect

To display details about the mapping between a Multiprotocol Label Switching (MPLS) pseudowire and its virtual circuits, use the show cable l2-vpn xconnect command in privileged EXEC mode.

show cable l2-vpn xconnect {dot1q-vc-map | mpls-vc-map} [mac-address | customer customer-name | state]

Syntax Description

dot1q-vc-map	Specifies the mapping of one or all cable modems to IEEE 802.1Q Virtual Local Area Networks (VLANs) on the Ethernet interfaces of a router.
mpls-vc-map	Specifies the mapping between an MPLS pseudowire and its virtual circuits.
mac-address	(Optional) Specifies the MAC address for a cable modem.
customer customer-name	(Optional) Specifies the customer name.
state	(Optional) Specifies the state of all virtual circuits.

Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SCC	This command was introduced in Cisco IOS Release 12.2(33)SCC.

Examples

Example of the show cable l2-vpn xconnect Command for the Mapping Between an MPLS Pseudowire and All Virtual Circuits

The following is a sample output of the show cable l2-vpn xconnect command that shows the mapping between an MPLS pseudowire and all virtual circuits on a Cisco uBR10012 router:

Router# show cable l2-vpn xconnect mpls-vc-map

MAC Address    Peer IP Address  VCID       CktID      Cable Intf  SID  Customer

Name/VPNID

0000.396e.6a68  101.1.0.2       221        Bu254:221    Cable7/0/0  1    customer1

0014.f8c1.fd66  10.76.1.1       2004       Bu254:5121   Cable7/0/0  8

0019.474a.d566  10.76.1.1       2001       Bu254:5122   Cable7/0/0  4    0234560002

0019.474a.d42e  10.76.1.1       2002       Bu254:2003   Cable7/0/0  5    0234560003

Example of the show cable l2-vpn xconnect Command for a Particular MAC Address

The following sample output displays the mapping between an MPLS pseudowire and the virtual circuit for a particular MAC address of a cable modem on a Cisco uBR10012 router:

Router# show cable l2-vpn xconnect mpls-vc-map 0000.396e.6a68

MAC Address    Peer IP Address  VCID       CktID      Cable Intf  SID  Customer

Name/VPNID

0000.396e.6a68  101.1.0.2       221        Bu254:221    Cable7/0/0  1    customer1

Example of the show cable l2-vpn xconnect Command for a Particular Customer

The following sample output displays the mapping between an MPLS pseudowire and all virtual circuits configured for a particular customer on a Cisco uBR10012 router:

Router# show cable l2-vpn xconnect mpls-vc-map customer1

MAC Address    Peer IP Address  VCID       CktID      Cable Intf  SID  Customer

Name/VPNID

0000.396e.6a68  101.1.0.2       221        Bu254:221    Cable7/0/0  1    customer1

Example of the show cable l2-vpn xconnect Command that Shows Information About the State of All Virtual 
Circuits

The following sample output displays the state of all virtual circuits associated with an MPLS pseudowire on a Cisco uBR10012 router:

Router# show cable l2-vpn xconnect mpls-vc-map state

Peer IP Address  VCID       STATE MAC Address    Customer Name/VPNID  STATE

101.1.0.2        22         DOWN  0000.396e.6a68  customer1            UP

10.76.1.1        2004       UP    0014.f8c1.fd66                       UP

10.76.1.1        2001       UP    0019.474a.d566  0234560002           UP

10.76.1.1        2002       UP    0019.474a.d42e  0234560003           UP

Table 56 describes the fields shown in the show cable l2-vpn xconnect command display.

Table 56 show cable l2-vpn xconnect Field Descriptions 

Field	Description
MAC Address	MAC address of a cable modem.
Peer IP Address	IP address of the remote provider edge router.
VCID	Virtual circuit ID.
CktID	Circuit ID.
Cable Intf	Cable interface for the MPLS pseudowire.
SID	Service ID.
STATE	State of all virtual circuits.

Related Commands

Command	Description
show xconnect	Displays information about attachment circuits and pseudowires.

show cable leasequery-filter

To display the number of Dynamic Host Configuration Protocol (DHCP) LEASEQUERY request messages that have been filtered for all cable modems (CMs) or for a particular cable interface, use the show cable leasequery-filter command in privileged EXEC mode.

show cable leasequery-filter [cable slot/port [requests-filtered [minimum-requests] ] ]

show cable leasequery-filter [cable slot/subslot/port [requests-filtered [minimum-requests] ] ]

Syntax Description

cable slot/port	(Optional) Displays information for all CMs on the specified cable interface and downstream port on the Cisco uBR7246VXR router. On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
cable slot/subslot/port	(Optional) Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router. The following are the valid values: •slot = 5 to 8 •subslot = 0 or 1 •port = 0 to 4 (depending on the cable interface)
requests-filtered [minimum-requests]	(Optional) Displays the number of DHCP LEASEQUERY requests that have been filtered for each particular cable modem on a cable interface. •minimum-requests—(Optional) Displays only those cable modems for which the router has filtered at least this minimum number of lease queries. The valid range for minimum-requests is 1 to 65535, with a default of 1.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(15)BC1d, 12.2(15)BC2b	This command was introduced for the Cisco uBR7100 series, Cisco uBR7246VXR, and Cisco uBR10012 universal broadband routers.

Usage Guidelines

The show cable leasequery-filter command displays the total number of DHCP LEASEQUERY requests that have been filtered on a Cisco Cable Modem Termination System (CMTS) router and on a particular cable interface. This command can also optionally display details for each particular cable modem on an interface that has had DHCP lease queries filtered.

Examples

The following example shows how to display the total number of DHCP LEASEQUERY requests that have been filtered on the router and on a particular cable interface:

Router# show cable leasequery-filter 

Lease Query Filter statistics for Unknown Sid 

 Requests Sent : 138 total. 41 unfiltered, 97 filtered 

Router# show cable leasequery-filter cable 8/1/0 

Lease Query Filter statistics for Cable8/1/0:

 Requests Sent : 35 total. 25 unfiltered, 10 filtered

The following example shows how to display a list of cable modems on a cable interface and the number of DHCP LEASEQUERY messages that have been filtered for each:

Router# show cable leasequery-filter cable 8/1/0 requests-filtered 

Sid  MAC Address    IP Address      Req-Filtered

1    0050.7366.1243 92.1.1.20       0 

2    0007.0e06.953b 95.1.1.24       0 

3    0007.0e06.97b5 93.1.1.24       2 

4    00d0.ba45.4bd5 91.1.1.35       0 

5    0007.0e06.9773 95.1.1.23       12 

6    0001.42aa.737d 94.1.1.23       645 

7    0001.42aa.738b 95.1.1.22       0 

8    00d0.ba45.4955 92.1.1.23       0 

9    0007.0e06.51ef 94.1.1.25       0 

10   00d0.ba77.743b 91.1.1.36       3 

11   0001.42aa.6e6f 93.1.1.22       2 

12   0007.0e06.512f 91.1.1.23       2 

13   0007.0e06.5137 92.1.1.25       0 

14   0007.0e06.9be7 92.1.1.24       0 

15   0002.b970.0027 92.1.1.22       1 

16   0001.42aa.738d 91.1.1.21       10 

Router# 

The following example shows how to display a list of cable modems on a cable interface that have had 10 or more DHCP LEASEQUERY messages that have been filtered:

Router# show cable leasequery-filter cable 8/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered

5    0007.0e06.9773 95.1.1.23       12 

6    0001.42aa.737d 94.1.1.23       645 

16   0001.42aa.738d 91.1.1.21       10 

Router# 

Related Commands

Command	Description
cable arp	Activates the cable Address Resolution Protocol (ARP).
cable arp filter	Controls the number of ARP requests and replies that are forwarded on a cable interface.
cable source-verify	Enables verification of IP addresses for cable modems (CMs) and customer premises equipment (CPE) devices on the upstream.
cable source-verify leasequery-filter downstream	Controls the number of DHCP lease query messages that are sent for unknown IP addresses on all cable downstream interfaces on the Cisco CMTS router.
cable source-verify leasequery-filter upstream	Controls the number of DHCP lease query messages that are sent for unknown IP addresses per each service ID (SID) on an upstream.

show cable load-balance

To display real-time configuration, statistical and operational information for load balancing operations on the router, use the show cable load-balance command in privileged EXEC mode.

show cable load-balance [[group n] | [all | load | pending | statistics | target | fiber-node-validation]]

Syntax Description

group n	(Optional) Specifies the number of the load balancing group to be displayed. The valid range is from 1 to 336. The range from 1 to 80 is reserved for legacy load balancing group (LBG). The range from 81 to 336 is reserved for DOCSIS LBGs. The default is to display information for all load balancing groups.
all	(Optional) Displays all information about the LBG.
load	(Optional) Displays the current interface load and load balancing group assignments.
pending	(Optional) Displays the list of cable modems that are moved from one downstream or upstream to another.
statistics	(Optional) Displays cumulative statistics for load balancing operations.
target	(Optional) Displays the current and target interfaces (upstreams and downstreams) used for load balancing.
fiber-node-validation	(Optional) Displays DOCSIS LBG and channel information after checking if the channel configuration in load balancing fits in the fiber node configuration

Defaults

Displays information for all load balancing groups for each cable interface and its current load and load balancing status.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(15)BC1	This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 routers.
12.2(33)SCC	The fiber-node-validation parameter was added to the command.

Usage Guidelines

Use the show cable load-balance command to display the current, real-time statistics for load balancing operations.

Examples

The following is a sample output of the show cable load-balance command:

Router# show cable load-balance 

Group  Interval  Method        DCC Init   Threshold

                               Technique  Minimum  Static  Enforce  Ugs   PCMM

1      10        service-flows 1          1        2%      2%       ---   ---

2      10        modems        0          5        10%     ---      ---   ---

DOCSIS LB Enabled: No

The following is a sample output of the all option of the show cable load-balance command. The all option displays information of all options available for this command except the fiber-node-validation option.

Router# show cable load-balance all 

Group  Interval  Method        DCC Init   Threshold

                               Technique  Minimum  Static  Enforce  Ugs   PCMM

1      10        service-flows 1          1        2%      2%       ---   ---

2      10        modems        0          5        10%     ---      ---   ---

DOCSIS LB Enabled: No

Current load:

Interface            State      Group  Utilization  Reserved Modems Flows Weight

                                Index

Cable5/0/3 (459 MHz) up         1      0%(0%/0%)       0%    7      7     37

Cable5/0/3/U0        up         1      0%              0%    2      2     1.2

Cable5/0/3/U1        up         1      0%              0%    3      3     1.2

Cable5/0/3/U2        up         1      0%              0%    1      1     1.2

Cable5/0/3/U3        up         1      0%              0%    1      1     1.2

Cable5/0/4 (465 MHz) up         1      0%(0%/0%)       0%    7      7     37

Cable5/0/4/U0        up         1      0%              0%    2      2     1.2

Cable5/0/4/U1        up         1      0%              0%    2      2     1.2

Cable5/0/4/U2        up         1      0%              0%    1      1     1.2

Cable5/0/4/U3        up         1      0%              0%    2      2     1.2

Mo1/0/0:0 (555 MHz)  down       1      0%(0%/0%)       0%    0      0     0

Target assignments:

Interface            State      Group   Target

                                Index

Cable5/0/3 (459 MHz) up         1       Cable5/0/4 (465 MHz) [enforce]

Cable5/0/3/U0        up         1       Cable5/0/3/U2

Cable5/0/3/U1        up         1       Cable5/0/3/U2 [enforce]

Cable5/0/3/U2        up         1       

Cable5/0/3/U3        up         1       

Cable5/0/4 (465 MHz) up         1       

Cable5/0/4/U0        up         1       Cable5/0/4/U2

Cable5/0/4/U1        up         1       Cable5/0/4/U2 [enforce]

Cable5/0/4/U2        up         1       

Cable5/0/4/U3        up         1       Cable5/0/4/U2

Mo1/0/0:0 (555 MHz)  down       1       

Statistics:

Target interface       State      Transfers

                                  Complete  Pending   Retries   Failures

Cable5/0/3 (459 MHz)   up         3         1         0         0    

Cable5/0/3/U0          up         0         0         0         0    

Cable5/0/3/U1          up         0         0         0         0    

Cable5/0/3/U2          up         0         0         0         0    

Cable5/0/3/U3          up         0         0         0         0    

Cable5/0/4 (465 MHz)   up         0         0         0         0    

Cable5/0/4/U0          up         0         0         0         0    

Cable5/0/4/U1          up         0         1         0         0    

Cable5/0/4/U2          up         0         0         0         0    

Cable5/0/4/U3          up         0         0         0         0    

Mo1/0/0:0 (555 MHz)    down       0         0         0         0    

Pending:

Modem          Grp Idx  Source interface  Target interface     Retries

001a.c30c.7e74 1        Cable5/0/4        Cable5/0/3 (459 MHz) 0

0000.ca45.9886 1        Cable5/0/4/U2     U1                   0

Router#

The following is a sample output of the fiber-node-validation option of the show cable load-balance 
command.

Router# show cable load-balance fiber-node-validation

DOCSIS LBG ID    Match    Channel    Fiber-node list

1                match    Ca5/0/0/U0 {1}

                          Ca5/0/0/U1 {1}

                          Ca5/0/0/U2 {1}

                          Ca5/0/0/U3 {1}

                          Mo1/0/0:0  {1}

2                match    Ca5/0/0/U0 {1}

                          Ca5/0/0/U1 {1}

                          Ca5/0/0/U2 {1}

                          Mo1/0/0:0  {1}

Table 57 describes the fields shown in the show cable load-balance command displays.

Table 57 show cable load-balance Field Descriptions (default display) 

Field	Description
Fields for the Default Displays and load Option
Interface	Cable interface (downstream or upstream) that belongs to a load balancing group.
Group	Number of the load balancing group to which the cable interface has been assigned.
Utilization	This field is a long-term average of the upstream utilization and displays current load usage of the cable interface expressed as a percentage of the total bandwidth. For upstreams, this field shows a single percentage value, which is the average percentage of bandwidth being used on the upstream. For downstreams, this field shows a set of three percentage values: •The percentage shows the load usage for the entire interface. •The first percentage, within the parentheses, shows the load for the downstream. •The second percentage, within the parentheses, shows the average load for all upstreams on the downstream. For example, if this field shows "18%(18%/12%)", it indicates that downstream and upstream channels on the interface are running on an average load of 18 percent. The downstream is running on an average load of 18 percent and all upstreams for this downstream are running on an average load of 12 percent. Note To view the short-term average of the utilization, use the show interface cable mac-scheduler command.
State	Current state of the cable interface. The following states indicate normal operational states, depending on the configuration: •down—Interface is shut down. The CMTS cannot use the interface for load balancing in this state. •initial—Interface is currently in the initialization phase. The CMTS uses the interface for load balancing after the initialization completes. •up—Interface is up and passing traffic. The CMTS actively uses the interface for load balancing. •testing—Interface is currently under a load balancing test. The CMTS is unable to use the interface for normal load balancing operations until the test completes. The following states indicate abnormal states. The CMTS does not use interfaces in these states for load balancing operations, but continues to monitor and update the status every time the CMTS polls the interfaces for their current load usage: •suspicious—Interface is in an unknown state. The interface might be up and passing traffic, but is not consistent enough to support load balancing operations. The CMTS attempts to reinitialize the interface after a timeout period. If the interface has failed initialization more than 10 times, the CMTS moves the interface to the disabled state. •disabled—Interface has been disabled because a load balancing test is in-progress or because the interface reinitialization failed after 10 attempts. •unstable—Interface has failed repeated initialization attempts. The CMTS will attempt to reinitialize the interface after a timeout period. If a load balance test is not in-progress and if reinitialization fails, the CMTS moves it to the unstable state.
Reserved	Percentage of bandwidth that is currently reserved by unsolicited grant service (UGS) service flows.
Modems	Number of cable modems currently online on this cable interface.
Flows	Number of service flows currently active on the cable interface.
Weight	Interface bandwidth, in megabits per second (mbps), for the downstream or upstream. The system uses this value in calculating whether the loads on the interfaces are balanced. Changing a channel parameter, such as modulation profile or channel width, affects the channel bandwidth and weight value.
Additional Fields When Displaying Load Balancing Groups
Interval	Indicates in seconds, the current load on each cable interface in the load balancing group as configured using the cable load-balance group interval command.
Method	Load balancing method used for the load balancing group as configured using the cable load-balance group (global configuration) command.
Threshold	Thresholds configured for this load balancing group: •M = Minimum Minimum difference in the number of cable modems or service flows that can exist on two interfaces in the group before cable modems are moved between the interfaces. If the imbalance between interfaces is below this value, cable modems are not moved. This field contains a value only when the group is configured for the modems or service flows method of load balancing. (This value is configured using the load minimum option of the cable load-balance group threshold command.) •S = Static Minimum difference in the percentage of total load that must exist between interfaces in a load balancing group before the Cisco CMTS performs static load balancing. When the load between interfaces is greater than this value, cable modems that are in the process of registering with the CMTS are moved between interfaces until the load difference is again below this value. (This value is configured using the load option of the cable load-balance group threshold command.) •E = Enforce Minimum difference in the percentage of total load that must exist between interfaces in a load balancing group before the Cisco CMTS performs dynamic load balancing and begins moving cable modems that are currently online. When the difference in load between two interfaces falls below this value, the CMTS stops dynamic load balancing and performs static load balancing. (This value is configured using the enforce option of the cable load-balance group threshold command.) •U = Ugs Percentage of the bandwidth that is allocated for Unsolicited Grant Services (UGS) traffic, such as Voice-over-IP (VoIP), that is in use on an interface because the CMTS moves cable modems that are online with active UGS service flows. (This value is configured using the ugs option of the cable load-balance group threshold command.) •P = PacketCable MultiMedia (PCMM) •Percentage of the reserved bandwidth threshold. Above this level, cable modems with active PCMM service flows participate in load balancing. The default threshold is 70%.
Additional Fields for the target Option
Interface	Source downstream or upstream interface that is part of a cable load balancing group. If the Target field contains a value, it indicates that the source interface is currently oversubscribed. To reduce the cable load, the CMTS moves cable modems from the source interface to the target interface.
Target	Downstream or upstream interface to which cable modems on the source interface are being moved as part of load balancing operations. This field indicates the following: •If it is a downstream interface, the display shows the center frequency of the downstream within parentheses. •If only a frequency is shown, it indicates that the CMTS is moving cable modems to a different center frequency on the same downstream interface. •When the display includes the words "enforce", it indicates that the CMTS is performing dynamic load balancing on the interfaces. •If this field is blank, it indicates that the source interface is not oversubscribed.
Additional Fields for the statistics Option
Target interface	Downstream or upstream interface. If this is a downstream interface, the display shows the center frequency of the downstream within parentheses.
Transfers	The following information is tracked for the indicated target interface: •complete—Number of cable modems successfully moved to the target interface. •pending—Number of cable modems in the process of being moved to the target interface. •retries—Number of times that the CMTS unsuccessfully tried to move the same cable modem to the target interface. This occurs when one or more MAC layer messages to the cable modem are dropped due to radio frequency (RF) noise or because the modem is not DOCSIS-compliant. If the number of retries exceeds five for a particular cable modem, the CMTS counts this as a failure. •failures—Number of times that the CMTS exceeded the maximum number of allowable retries (5) when trying to move a particular cable modem to the target interface. A large number of failures could indicate one or more possible problems: