CISCO-CABLE-DIAG-MIB

All MIBs › CISCO-CABLE-DIAG-MIB

Organization: Cisco Systems Inc.

Last Updated: 2004-09-13

Category: DOCSIS and Cable

Description: Manages cable plant diagnostics including TDR testing on Cisco cable platforms.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-CABLE-DIAG-MIB?

CISCO-CABLE-DIAG-MIB is a Cisco enterprise MIB (under ciscoMgmt) that manages copper-cable diagnostic testing on Cisco LAN switch interfaces — despite "cable" evoking a CATV/cable-plant platform, the objects here (indexed simply by ifIndex from IF-MIB, with no CMTS/DOCSIS-specific typing) describe generic Ethernet copper-cable fault-detection tests, not a cable-television headend. It defines ccdPrbsIfTable for Pseudo Random Binary Sequence (PRBS) bit-error testing — ccdPrbsIfAction (start/stop/errorReset/running/notRunning), ccdPrbsIfActionStatus, and an error-count Gauge32 ccdPrbsIfTestErrors with its ccdPrbsIfTestErrorsResetTime and max-value objects — and ccdTdrIfTable for Time Domain Reflectometry (TDR) tests, which send a signal down the cable pairs and report distance-to-fault-style results (ccdTdrIfAction/ActionStatus/LastTestTime/ResultValid). Monitoring these tables lets an operator confirm a suspect copper link's cable integrity — a nonzero and growing ccdPrbsIfTestErrors count, or a completed TDR test reporting a fault pair status, points to a physical-layer cabling problem rather than a switch or NIC misconfiguration. It depends on IF-MIB for ifIndex and SNMPv2-TC for TimeStamp/TruthValue, and it is deployed on Cisco Catalyst-family LAN switches with cable-diagnostic-capable copper ports; administrators can pull the CISCO-CABLE-DIAG-MIB MIB Browser output to confirm exact object names before scripting cable-health checks.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-CABLE-DIAG-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco Catalyst-family LAN switches with cable-diagnostic-capable copper interfaces

Monitoring Examples

An operator sets ccdTdrIfAction to start on a port reporting intermittent link flaps, then polls ccdTdrIfResultValid and the per-pair TDR result status once ccdTdrIfAction reads notRunning(4); a pair reported as faulted (open or shorted) at a given distance would confirm a physical cabling fault rather than a switch port hardware issue.

What Can Be Monitored

PRBS test action/status per interface
PRBS bit-error count and reset time
TDR test action/status per interface
TDR last-test timestamp and result validity
per-pair TDR fault/distance results

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From IF-MIB

ifIndex

OBJECT-TYPE

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Gauge32
Integer32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

TimeStamp
TruthValue

How to Use in IPNetwork Monitor

Example using ccdPrbsIfTestErrors OID:

Select a Cisco Catalyst-family LAN switch (copper cable diagnostics) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type ccdPrbsIfTestErrors into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. Indicates the number of errors which occurred during the current or most recent running of a test. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Gauge32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases between polls, since a rising count of errors, failures, or discards often points to a real underlying problem. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoCableDiagMIB	1.3.6.1.4.1.9.9.390			This MIB module defines objects for managing cable diagnostic test capabilites supported by the Cisco devices. Cable diagnostic tests are tests intended to exercise the functional integrity of the cable attached to a physical interface. Examples of cable diagnostic test methods are: PRBS (Pesudo Random Binary Sequence), TDR (Time Domain reflectometery), etc..
ciscoCableDiagMIBNotifs	1.3.6.1.4.1.9.9.390.0
ciscoCableDiagMIBObjects	1.3.6.1.4.1.9.9.390.1
ccdPrbsObjects	1.3.6.1.4.1.9.9.390.1.1
ccdPrbsIfTable	1.3.6.1.4.1.9.9.390.1.1.1		not-accessible	A table containing information about PRBS (Pesudo Random Binary Sequence) test on the device's interfaces. An entry appears in this table for each interface which is capable to run PRBS test.
ccdPrbsIfEntry	1.3.6.1.4.1.9.9.390.1.1.1.1		not-accessible	An entry in the ccdPrbsIfTable, containing the information about PRBS test on an interface.
INT ccdPrbsIfAction	1.3.6.1.4.1.9.9.390.1.1.1.1.1	INTEGER	read-write	Indicates the PRBS test action to be executed on the interface and whether the test is currently running or not. 'start' -- start the PRBS test on the interface. 'stop' -- stop the PRBS test on the interface. 'errorReset' -- reset the object value of ccdPrbsIfTestErrors to zero on the interface. 'running' -- the PRBS test is currently running on the interface. This value is a read-only value and can not be set on the interface. 'notRunning' -- the PRBS test is currently not running on the interface. This value is a read-only value and can not be set on the interface.
INT ccdPrbsIfActionStatus	1.3.6.1.4.1.9.9.390.1.1.1.1.2	INTEGER	read-only	Indicates the status of the last PRBS test action set on the interface.
G32 ccdPrbsIfTestErrorsEx	1.3.6.1.4.1.9.9.390.1.1.1.1.3	Gauge32	read-only	Indicates the number of errors which occurred during the current or most recent running of a test. This Gauge is reset to zero each time a test starts (e.g., when ccdPrbsIfAction is set to 'start') or each time ccdPrbsIfAction is set to 'errorReset' on an interface. If and when an instance of ccdPrbsIfTestErrors reaches its maximum value as indicated by the corresponding instance of ccdPrbsIfTestErrorsMaxValue, its value will be less or equal to the actual number of errors.
TIM ccdPrbsIfTestErrorsResetTime	1.3.6.1.4.1.9.9.390.1.1.1.1.4	TimeStamp	read-only	Indicates the most recent time that the corresponding instance of ccdPrbsIfTestErrors is reset to zero. If the the corresponding instance of ccdPrbsIfTestErrors is never reset to zero, then the instance value for ccdPrbsIfTestErrorsResetTime will be zero.
U32 ccdPrbsIfTestErrorsMaxValue	1.3.6.1.4.1.9.9.390.1.1.1.1.5	Unsigned32	read-only	Indicates the maximum value of the corresponding instance of ccdPrbsIfTestErrors.
ccdTdrObjects	1.3.6.1.4.1.9.9.390.1.2
ccdTdrIfTable	1.3.6.1.4.1.9.9.390.1.2.1		not-accessible	A table containing information about TDR (Time Domain Reflectometery) test on the device's interfaces. An entry appears in this table for each interface which is capable to run TDR test.
ccdTdrIfEntry	1.3.6.1.4.1.9.9.390.1.2.1.1		not-accessible	An entry in the ccdTdrIfTable, containing the information about TDR test on an interface.
INT ccdTdrIfAction	1.3.6.1.4.1.9.9.390.1.2.1.1.1	INTEGER	read-write	Indicates the TDR test action to be executed on the interface and whether the test is currently running or not. 'start' -- start the TDR test on the interface. 'clear' -- clear all the TDR test results on the interface. After this action is executed on an interface, the object value of ccdTdrIfResultValid for the corresponding interface will be false(2). 'running' -- the TDR test is currently running on the interface. This value is a read-only value and can not be set on the interface. 'notRunning' -- the TDR test is currently not running on the interface. This value is a read-only value and can not be set on the interface.
INT ccdTdrIfActionStatus	1.3.6.1.4.1.9.9.390.1.2.1.1.2	INTEGER	read-only	Indicates the status of the last TDR test action set on the interface.
TIM ccdTdrIfLastTestTime	1.3.6.1.4.1.9.9.390.1.2.1.1.3	TimeStamp	read-only	Indicates the timestamp when TDR test is last run on the interface. If TDR test is never run on an interface, then this object value will be zero.
T/F ccdTdrIfResultValid	1.3.6.1.4.1.9.9.390.1.2.1.1.4	TruthValue	read-only	Indicates whether the TDR test result on the interface is valid for the user to retrieve or not.
ccdTdrIfResultTable	1.3.6.1.4.1.9.9.390.1.2.2		not-accessible	A table containing information about TDR test result on the device's interfaces. An entry appears in this table for each cable pair on an interface which has valid TDR test result, i.e., the value of ccdTdrIfResultValid for the interface is true(1).
ccdTdrIfResultEntry	1.3.6.1.4.1.9.9.390.1.2.2.1		not-accessible	An entry in the ccdTdrIfResultTable, containing the information about TDR test on an interface.
INT ccdTdrIfResultPairIndex	1.3.6.1.4.1.9.9.390.1.2.2.1.1	INTEGER	not-accessible	The local cable pair index. 'pair1to2' -- the pair with cable connectors 1 and 2. 'pair3to6' -- the pair with cable connectors 3 and 6. 'pair4to5' -- the pair with cable connectors 4 and 5. 'pair7to8' -- the pair with cable connectors 7 and 8.
INT ccdTdrIfResultPairChannel	1.3.6.1.4.1.9.9.390.1.2.2.1.2	INTEGER	read-only	The channels that the cable pair is connected to. 'other' -- none of the following. 'channelA' -- channel A. 'channelB' -- channel B. 'channelC' -- channel C. 'channelD' -- channel D.
I32 ccdTdrIfResultPairLength	1.3.6.1.4.1.9.9.390.1.2.2.1.3	Integer32	read-only	The length of the cable pair. A value of -1 indicates the length value is invalid. The unit of this value is indicated by ccdTdrIfResultPairLengthUnit of the same cable pair.
I32 ccdTdrIfResultPairLenAccuracy	1.3.6.1.4.1.9.9.390.1.2.2.1.4	Integer32	read-only	The length accuracy of the cable pair. This value should be added to and deducted from the value of ccdTdrIfResultPairLength of the same cable pair to form the upper and lower range of the cable pair length. A value of -1 indicates the length accuracy value is invalid. The unit of this value is indicated by ccdTdrIfResultPairLengthUnit of the same cable pair.
I32 ccdTdrIfResultPairDistToFault	1.3.6.1.4.1.9.9.390.1.2.2.1.5	Integer32	read-only	The distance to the fault point of the cable pair. A value of -1 indicates this value is invalid. The unit of this value is indicated by ccdTdrIfResultPairLengthUnit of the same cable pair.
I32 ccdTdrIfResultPairDistAccuracy	1.3.6.1.4.1.9.9.390.1.2.2.1.6	Integer32	read-only	The accuracy of the distance to the fault point for the cable pair. This value should be added to and deducted from the value of ccdTdrIfResultPairDistToFault of the same cable pair to form the upper and lower range of the distance to fault point for the cable pair. A value of -1 indicates this value is invalid. The unit of this value is indicated by ccdTdrIfResultPairLengthUnit of the same cable pair.
INT ccdTdrIfResultPairLengthUnit	1.3.6.1.4.1.9.9.390.1.2.2.1.7	INTEGER	read-only	The measurement unit on the length or the distance to fault point for the cable pair. 'unknown' -- none of the following. 'meter' -- the unit is meter. 'centimeter' -- the unit is centimeter. 'kilometer' -- the unit is kilometer.
INT ccdTdrIfResultPairStatus	1.3.6.1.4.1.9.9.390.1.2.2.1.8	INTEGER	read-only	The status of the cable pair. 'unknown' -- none of the following. 'terminated' -- the pair is properly terminated at the remote end. 'notCompleted' -- the test on this pair is not completed. 'notSupported' -- the test on this pair is not supported. 'open' -- the pair is open. 'shorted' -- the pair is shorted. 'impedanceMismatch' -- the impedance of the pair is mismatched. 'broken' -- the pair is broken. 'indeterminate' -- the status of the pair is indeterminate.
ciscoCableDiagMIBConform	1.3.6.1.4.1.9.9.390.2
ciscoCableDiagMIBCompliances	1.3.6.1.4.1.9.9.390.2.1
ciscoCableDiagMIBComplianceRev1	1.3.6.1.4.1.9.9.390.2.1.1			The compliance statement for SNMP entities that implement the CISCO-CABLE-DIAG-MIB.
ciscoCableDiagMIBGroups	1.3.6.1.4.1.9.9.390.2.2
ccdPrbsGroup	1.3.6.1.4.1.9.9.390.2.2.1			A collection of managed objects to support PRBS cable diagnotic test on the interfaces of the device.
ccdTdrGroup	1.3.6.1.4.1.9.9.390.2.2.2			A collection of managed objects to support TDR cable diagnotic test on the interfaces of the device.

RFC description

Cisco cable diagnostic MIB for testing cable integrity using methods like TDR and PRBS on physical interfaces.

Start monitoring Cisco Catalyst-family LAN switches (copper cable diagnostics) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-CABLE-DIAG-MIB