DOCS-PNM-MIB :: docsIf3CmSpectrumAnalysisCtrlCmdFileName

MIB Reference — IPNetwork Monitor · Updated October 05, 2026

All MIBs › DOCS-PNM-MIB › docsIf3CmSpectrumAnalysisCtrlCmdFileName

docsIf3CmSpectrumAnalysisCtrlCmdFileName

Module: DOCS-PNM-MIB

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

OID (numeric): 1.3.6.1.4.1.4491.2.1.20.1.34.12

Node type: OBJECT-TYPE

Type: SnmpAdminString

Access: read-write

Description: This attribute is the name of the file containing the spectrum analysis data. This value can only be changed while a test is not in progress. An attempt to set this value while the value of MeasStatus is 'busy' will return 'inconsistentValue'. 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: PNMSpecAnData__ For example: PNMSpecAnData_0010181A2D11_1403405123 The data file is comprised of a header plus the Spectrum Analysis 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 '504E4D09' (without the quotes) 4 bytes Capture Time 4 bytes Channel Id (use zero for this test) 1 byte CM MAC Address 6 bytes FirstSegmentCenterFrequency 4 bytes LastSegmentCenterFrequency 4 bytes SegmentFrequencySpan 4 bytes NumBinsPerSegment 2 bytes EquivalentNoiseBandWidth 2 bytes WindowFunction(SpectrumAnalysisWindowFunction enum) 2 bytes Length in bytes of SpecAnData that follows 4 bytes Spectrum Analysis Data BinAmplitudeFileData If the size of the data the CM is commanded to collect would exceed the maximum file-size limit of the data collection mechanism, the CM will limit the file size accordingly and set the 'MeasStatus' attribute to a value of 'sampleTruncated'. If this occurs, the file will contain valid data, from the beginning of the capture, but will represent fewer bins than configured for the measurement.

What is docsIf3CmSpectrumAnalysisCtrlCmdFileName?

The filename at the CM holding the captured spectrum-analysis data (bin amplitude data plus header metadata) awaiting download; defaults to an auto-generated 'PNMSpecAnData_<MAC>_<epoch>' name if left empty. If the requested capture would exceed the file-size limit, the CM truncates it and sets MeasStatus to 'sampleTruncated', so an admin should check status alongside the file.

Examples

Walk all instances (SNMPv2c):

snmpwalk -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.20.1.34.12
snmpwalk -v2c -c public <target> DOCS-PNM-MIB::docsIf3CmSpectrumAnalysisCtrlCmdFileName

Get a specific instance (index 1):

snmpget -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.20.1.34.12.1
snmpget -v2c -c public <target> DOCS-PNM-MIB::docsIf3CmSpectrumAnalysisCtrlCmdFileName.1

Set instance 1 (SNMPv2c):

snmpset -v2c -c private <target> 1.3.6.1.4.1.4491.2.1.20.1.34.12.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::docsIf3CmSpectrumAnalysisCtrlCmdFileName 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 (12 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
1.3.6.1.4.1.4491.2.1.20docsIf3MibCLAB-DEF-MIB
1.3.6.1.4.1.4491.2.1.20.1docsIf3MibObjectsDOCS-IF3-MIB
1.3.6.1.4.1.4491.2.1.20.1.34docsIf3CmSpectrumAnalysisCtrlCmdDOCS-IF3-MIB
Numeric OIDNameModule
1.3.6.1.4.1.4491.2.1.20.1.34.12docsIf3CmSpectrumAnalysisCtrlCmdFileNameDOCS-PNM-MIB