DOCS-IF31-MIB

MIB Reference — IPNetwork Monitor · Updated October 05, 2026

All MIBs › DOCS-IF31-MIB

Organization: Cable Television Laboratories, Inc.

Last Updated: 2017-05-25

Category: Domain: CATV/Cable, Standard: DOCSIS

Description: Manages DOCSIS 3.1 cable interface objects including OFDM channel configuration and OFDMA upstream management.

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 DOCS-IF31-MIB?

DOCS-IF31-MIB is a CableLabs standards-track MIB module that defines management objects for DOCSIS 3.1 features, primarily the new OFDM downstream and OFDMA upstream channel technologies used by cable modems (CMs) and CMTS/CCAP platforms. It exposes objects such as docsIf31RxChStatusTable (CM primary/backup OFDM profile indication via docsIf31RxChStatusPrimaryDsIndicator), docsIf31CmtsCmRegStatusTable (CMTS-side registration extensions like docsIf31CmtsCmRegStatusDsProfileIdList and docsIf31CmtsCmRegStatusUsProfileIucList), and channel/profile status tables including docsIf31CmDsOfdmChanTable, docsIf31CmUsOfdmaChanTable, docsIf31CmtsDsOfdmProfileStatsTable, and docsIf31CmtsUsOfdmaChanTable. This data is central to monitoring OFDM/OFDMA channel health, profile assignment, and Energy Management DLS state (docsIf31CmStatusEmDlsOperStatus) on modern DOCSIS 3.1 access networks. It builds on and extends DOCS-IF-MIB and DOCS-IF3-MIB, and is deployed alongside those modules on CMTS/CCAP head-end equipment and DOCSIS 3.1 cable modems. Cable operators and equipment vendors implementing OFDM/OFDMA plant rely on the DOCS-IF31-MIB MIB to expose this channel and profile-level telemetry to SNMP-based monitoring systems.

IPNetwork Monitor allows you to monitor SNMP objects defined in DOCS-IF31-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

  • CableLabs-certified DOCSIS 3.1 cable modems (CMs)
  • CMTS / CCAP head-end platforms

Monitoring Examples

An operator polls docsIf31CmtsCmUsOfdmaChannelStatusTable and docsIf31CmtsCmDsOfdmChannelStatusTable to check per-modem OFDM/OFDMA channel assignment and profile usage across a CCAP, cross-referencing docsIf31CmDsOfdmProfileStatsTable counters for correctable/uncorrectable codeword rates; a rising uncorrectable count alongside an unexpected docsIf31RxChStatusPrimaryDsIndicator value would flag a modem falling back off its primary OFDM profile due to plant impairment.

What Can Be Monitored

  • OFDM downstream channel status and profile assignment
  • OFDMA upstream channel status and minislot configuration
  • CM registration profile/IUC lists
  • downstream/upstream profile statistics (codeword error counts)
  • Energy Management DLS operating status
  • downstream channel power per subcarrier
Imported Objects

From CLAB-DEF-MIB

clabProjDocsisOBJECT-IDENTITY

From DOCS-IF-MIB

TenthdBmV
docsIfUpstreamChannelEntryOBJECT-TYPE

From DOCS-IF3-MIB

AttributeMask
IfDirection
RangingState
docsIf3CmtsCmRegStatusEntryOBJECT-TYPE
docsIf3CmtsCmRegStatusIdOBJECT-TYPE

From HCNUM-TC

CounterBasedGauge64

From IF-MIB

ifIndexOBJECT-TYPE

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Counter64
Integer32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

DateAndTime
TEXTUAL-CONVENTION
TimeStamp
TruthValue

How to Use in IPNetwork Monitor

Example using docsIf31CmtsCmUsOfdmaChannelNumPartialSvcIncidents OID:

Select a DOCSIS 3.1 cable modem/CMTS-CCAP (OFDM/OFDMA channels, vendor-neutral CableLabs standard) 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 docsIf31CmtsCmUsOfdmaChannelNumPartialSvcIncidents 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. This attribute returns the number of Partial Service incidents the MAC layer has reported for this CM on this upstream OFDMA channel. 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 Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.
OIDs

RFC description

CableLabs MIB module that defines management objects for DOCSIS 3.1 OFDM/OFDMA channels, enabling remote monitoring and management of cable modems and cable modem termination systems.

Start monitoring DOCSIS 3.1 cable modem/CMTS-CCAP (OFDM/OFDMA channels, vendor-neutral CableLabs standard) 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 DOCS-IF31-MIB