DOCS-PNM-MIB :: docsPnmCmUsPreEqFileName

MIB Reference — IPNetwork Monitor · Updated October 05, 2026

All MIBs › DOCS-PNM-MIB › docsPnmCmUsPreEqFileName

docsPnmCmUsPreEqFileName

Module: DOCS-PNM-MIB

OID (symbolic): DOCS-PNM-MIB::docsPnmCmUsPreEqFileName

OID (numeric): 1.3.6.1.4.1.4491.2.1.27.1.2.10.1.10

Node type: OBJECT-TYPE

Type: SnmpAdminString

Access: read-write

Description: This attribute is the name of the file at the CM which is to be transferred to the PNM server. The data represents the current value of the Pre-Equalization values for all of the active subcarriers and is stored as 16 bit integers for the I and Q data. This object cannot be changed while a file generation is in progress. It will return a value of 'inconsistentValue' if set while the value of 'docsPnmCmUsPreEqMeasStatus' is set to a value of 'busy'. If the value of this object is the DEFVAL (empty string), then a default filename value will be used. Otherwise the value set will be used as the filename. If a default filename is generated, then that value will be returned in this object and will represent the filename that was used for the test. All subsequent tests should set this object to a meaningful value or to an 'empty string' value (to generate a new default filename) before starting a new test. If a default filename value is used, it is generated as the test name plus the CM MAC Address plus the 'epoch time'. The epoch time (also known as 'unix time') is defined as the number of seconds that have elapsed since midnight Coordinated Universal Time (UTC), Thursday, 1 January 1970. Hence, the format would be: PNMUsPreEq__ For example: PNMUsPreEq_0010181A2D11_1403405123 The data file is comprised of a header plus the Pre-EQ Data The header is comprised of ordered fixed-length fields. Unless otherwise specified, the header fields contain hex values that are right-justified within the field. If necessary the field is left-padded with zero values. Syntax of the file is as follows: File Type set to '504E4D06' (without the quotes) 4 bytes Collection Time 4 bytes Upstream Channel Id 1 byte CM MAC Address 6 bytes CMTS MAC Address 6 bytes Subcarrier zero frequency in Hz 4 bytes FirstActiveSubcarrierIndex 2 bytes Subcarrier spacing in Hz 1 bytes Length in bytes of Pre-EQ Data that follows 4 bytes Pre-EQ Coefficient Update Data ComplexData

What is docsPnmCmUsPreEqFileName?

The filename at the CM holding the current full set of upstream pre-equalization coefficients for all active subcarriers (16-bit I/Q data); defaults to an auto-generated 'PNMUsPreEq_<MAC>_<epoch>' name if left empty. This is the complete current equalizer state, as opposed to docsPnmCmUsPreEqLastUpdateFileName which captures only the latest incremental change.

Examples

Walk all instances (SNMPv2c):

snmpwalk -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.27.1.2.10.1.10
snmpwalk -v2c -c public <target> DOCS-PNM-MIB::docsPnmCmUsPreEqFileName

Get a specific instance (index 1):

snmpget -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.27.1.2.10.1.10.1
snmpget -v2c -c public <target> DOCS-PNM-MIB::docsPnmCmUsPreEqFileName.1

Set instance 1 (SNMPv2c):

snmpset -v2c -c private <target> 1.3.6.1.4.1.4491.2.1.27.1.2.10.1.10.1 s <value>

Start monitoring DOCSIS 3.1 cable modem/CMTS (Proactive Network Maintenance, vendor-neutral CableLabs standard) with a free 30-day trial of IPNetwork Monitor. Create custom SNMP monitor using the DOCS-PNM-MIB::docsPnmCmUsPreEqFileName OID value, configure state conditions and alerts, and monitor any DOCSIS 3.1 cable modem/CMTS (Proactive Network Maintenance, vendor-neutral CableLabs standard) from a single console.

OID Breakdown

Upper-level ancestors (9 from the standard OID tree / other modules)
Numeric OIDNameModule
1isoLANART-AGENT
1.3orgAirPair-MIB
1.3.6dodAirPair-MIB
1.3.6.1internetAirPair-MIB
1.3.6.1.4privateAirPair-MIB
1.3.6.1.4.1enterprisesAirPair-MIB
1.3.6.1.4.1.4491cableLabsCLAB-DEF-MIB
1.3.6.1.4.1.4491.2clabProjectCLAB-DEF-MIB
1.3.6.1.4.1.4491.2.1clabProjDocsisCLAB-DEF-MIB
Numeric OIDNameModule
1.3.6.1.4.1.4491.2.1.27docsPnmMIBDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1docsPnmMibObjectsDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.2docsPnmCmObjectsDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.2.10docsPnmCmUsPreEqTableDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.2.10.1docsPnmCmUsPreEqEntryDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.2.10.1.10docsPnmCmUsPreEqFileNameDOCS-PNM-MIB