All MIBs › DOCS-PNM-MIB › docsIf3CmSpectrumAnalysisCtrlCmdFileEnable
docsIf3CmSpectrumAnalysisCtrlCmdFileEnable
Module: DOCS-PNM-MIB
OID (symbolic): DOCS-PNM-MIB::docsIf3CmSpectrumAnalysisCtrlCmdFileEnable
OID (numeric): 1.3.6.1.4.1.4491.2.1.20.1.34.10
Node type: OBJECT-TYPE
Type: TruthValue
Access: read-write
Description: This attribute, when set to 'true', causes the CM to begin a Spectrum Analysis measurement with the parameters defined by the docsIf3CmSpectrumAnalysisCtrlCmd set of attributes. In order to set this object to 'true', the Enable must already be set to 'true'.
When the measurement is completed successfully, a file is generated and is made available for transfer and the MeasStatus attribute is set to 'sampleReady'. The file will contain one complete snapshot of the spectrum data.
Setting this object to a value of 'false' instructs the CM to stop the measurement.
Interaction with other table rows:
- This object is subject to the rules specified by the 'docsPnmCmCtlStatus' object. Therefore this object returns 'inconsistentValue' if set to 'true' while the value of 'docsPnmCmCtlStatus' is any value other than 'ready'.
- This object returns 'inconsistentValue' if set to 'true' while the CM is unable to perform a spectrum measurement for any reason. Examples might include DOCSIS Light Sleep (DLS) mode or battery-backup mode.
- A default value for 'docsIf31CmSpectrumAnalysisCtrlCmdFileName' is defined; thus, this object may be set to 'true' without explicitly setting this value.
- Setting this object to a value of 'true' will change the value of the 'docsIf31CmSpectrumAnalysisCtrlCmdMeasStatus' to 'busy'. After completion, 'docsIf31CmSpectrumAnalysisCtrlCmdMeasStatus' will be changed to reflect the status of the test.
-This object will return a value of 'true' if it is actively taking a measurement; otherwise it returns 'false'.
What is docsIf3CmSpectrumAnalysisCtrlCmdFileEnable?
Setting this 'true' (with Enable already true) starts a downstream spectrum-analysis measurement per the docsIf3CmSpectrumAnalysisCtrlCmd parameters, producing one complete spectrum snapshot file when done. The main trigger admins use to capture a full spectral snapshot of the downstream RF, e.g. to spot ingress or interference not tied to a specific channel's demodulated data.
Examples
Walk all instances (SNMPv2c):
snmpwalk -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.20.1.34.10 snmpwalk -v2c -c public <target> DOCS-PNM-MIB::docsIf3CmSpectrumAnalysisCtrlCmdFileEnable
Get a specific instance (index 1):
snmpget -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.20.1.34.10.1 snmpget -v2c -c public <target> DOCS-PNM-MIB::docsIf3CmSpectrumAnalysisCtrlCmdFileEnable.1
Set instance 1 (SNMPv2c):
snmpset -v2c -c private <target> 1.3.6.1.4.1.4491.2.1.20.1.34.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::docsIf3CmSpectrumAnalysisCtrlCmdFileEnable 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.10 | docsIf3CmSpectrumAnalysisCtrlCmdFileEnable | DOCS-PNM-MIB |