DOCS-PNM-MIB :: docsPnmCmtsUsSpecAnFileName

MIB Reference — IPNetwork Monitor · Updated October 05, 2026

All MIBs › DOCS-PNM-MIB › docsPnmCmtsUsSpecAnFileName

docsPnmCmtsUsSpecAnFileName

Module: DOCS-PNM-MIB

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

OID (numeric): 1.3.6.1.4.1.4491.2.1.27.1.3.8.1.11

Node type: OBJECT-TYPE

Type: SnmpAdminString

Access: read-write

Description: This attribute is the name of the file with the Spectrum Analysis data at the CMTS that is to be downloaded using TFTP to the PNM server. This value can only be changed while a test is not in progress. An attempt to set this value while the value of 'docsPnmCmtsUsSpecAnMeasStatus' 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 a unique CCAP identifier (either a loopback address (IPv4 or IPv6) or FQDN), 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: PNMCcapSpecAn__ For example: PNMCcapSpecAn_ccap1.boulder.cablelabs_1403405123 The data file is comprised of a header plus the Spectrum Analyzer 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 '504E4D6A' (without the quotes) 4 bytes Capture Time 4 bytes ifIndex 4 bytes Unique CCAP ID 256 bytes Center Frequency in Hz 4 bytes Frequency Span in Hz 4 bytes Number of Bins 2 bytes Length in bytes of Spectrum Analysis data 4 bytes Spectrum Analysis Bin Amplitude Data BinAmplitudeData

What is docsPnmCmtsUsSpecAnFileName?

A deprecated object holding the filename of the captured legacy spectrum-analysis data at the CMTS, defaulting to an auto-generated 'PNMCcapSpecAn_<CCAP ID>_<epoch>' name if left empty. STATUS is 'deprecated'; replaced by the file-name object in the newer Upstream Triggered Spectrum Capture (Utsc) table.

Examples

Walk all instances (SNMPv2c):

snmpwalk -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.27.1.3.8.1.11
snmpwalk -v2c -c public <target> DOCS-PNM-MIB::docsPnmCmtsUsSpecAnFileName

Get a specific instance (index 1):

snmpget -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.27.1.3.8.1.11.1
snmpget -v2c -c public <target> DOCS-PNM-MIB::docsPnmCmtsUsSpecAnFileName.1

Set instance 1 (SNMPv2c):

snmpset -v2c -c private <target> 1.3.6.1.4.1.4491.2.1.27.1.3.8.1.11.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::docsPnmCmtsUsSpecAnFileName 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.3docsPnmCmtsObjectsDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.3.8docsPnmCmtsUsSpecAnTableDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.3.8.1docsPnmCmtsUsSpecAnEntryDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.3.8.1.11docsPnmCmtsUsSpecAnFileNameDOCS-PNM-MIB