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_
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 OID | Name | Module |
|---|---|---|
| 1 | iso | LANART-AGENT |
| 1.3 | org | AirPair-MIB |
| 1.3.6 | dod | AirPair-MIB |
| 1.3.6.1 | internet | AirPair-MIB |
| 1.3.6.1.4 | private | AirPair-MIB |
| 1.3.6.1.4.1 | enterprises | AirPair-MIB |
| 1.3.6.1.4.1.4491 | cableLabs | CLAB-DEF-MIB |
| 1.3.6.1.4.1.4491.2 | clabProject | CLAB-DEF-MIB |
| 1.3.6.1.4.1.4491.2.1 | clabProjDocsis | CLAB-DEF-MIB |
| 1.3.6.1.4.1.4491.2.1.20 | docsIf3Mib | CLAB-DEF-MIB |
| 1.3.6.1.4.1.4491.2.1.20.1 | docsIf3MibObjects | DOCS-IF3-MIB |
| 1.3.6.1.4.1.4491.2.1.20.1.34 | docsIf3CmSpectrumAnalysisCtrlCmd | DOCS-IF3-MIB |
| Numeric OID | Name | Module |
|---|---|---|
| 1.3.6.1.4.1.4491.2.1.20.1.34.12 | docsIf3CmSpectrumAnalysisCtrlCmdFileName | DOCS-PNM-MIB |