All MIBs › DOCS-PNM-MIB › docsPnmCmCtlStatus
docsPnmCmCtlStatus
Module: DOCS-PNM-MIB
OID (symbolic): DOCS-PNM-MIB::docsPnmCmCtlStatus
OID (numeric): 1.3.6.1.4.1.4491.2.1.27.1.2.1.3
Node type: OBJECT-TYPE
Type: INTEGER
Access: read-only
Description: This attribute represents the overall status of the PNM test platform. Individual tests, within the PNM test suite, have their own specific objects to start and stop. For each test defined by the data-type enumeration for 'PnmCmCtlTest', the CM must first check the status of this object before starting. If this object is set to any value other than 'ready', the CM must not start the test. If the CM was not able to start the test and the test has a 'MeasStatusType' object, the CM must set the 'MeasStatusType' to a value of 'resourceUnavailable'.
If the test is allowed to start, the CM must change the value of this object to 'testInProgress'. When the test is no longer in progress, the CM must change the value of this object to a value other than 'testInProgress'.
This mechanism serves to allow only one instance of only one test to run at a time. There may be some tests that are not included by this control object. That is, if any test is not defined by the data-type enumeration for 'PnmCmCtlTest', then it is not included (unless otherwise stated by the test definition) and is not required to check or to change this object. If a test is not included or covered by this set of objects, then it is allowed to run regardless of any other tests in progress.
The possible values for this object are: 'other' - Any condition not otherwise defined 'ready' - The PNM platform is capable and ready to support a test. A test can be initiated 'testInProgress' - A PNM test is currently in progress 'tempReject' - A temporary condition exists that prohibits a test from starting, e.g., DBC
What is docsPnmCmCtlStatus?
The overall PNM test-platform gate for the CM: ready, testInProgress, tempReject (temporarily blocked, e.g. by a DBC exchange), or other; only one PNM test may run at a time system-wide. An admin/automation script must check this is 'ready' before triggering a new PNM test, since the CM will refuse to start one otherwise.
Examples
Walk all instances (SNMPv2c):
snmpwalk -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.27.1.2.1.3 snmpwalk -v2c -c public <target> DOCS-PNM-MIB::docsPnmCmCtlStatus
Get a specific instance (index 1):
snmpget -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.27.1.2.1.3.1 snmpget -v2c -c public <target> DOCS-PNM-MIB::docsPnmCmCtlStatus.1
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::docsPnmCmCtlStatus 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 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 |
| Numeric OID | Name | Module |
|---|---|---|
| 1.3.6.1.4.1.4491.2.1.27 | docsPnmMIB | DOCS-PNM-MIB |
| 1.3.6.1.4.1.4491.2.1.27.1 | docsPnmMibObjects | DOCS-PNM-MIB |
| 1.3.6.1.4.1.4491.2.1.27.1.2 | docsPnmCmObjects | DOCS-PNM-MIB |
| 1.3.6.1.4.1.4491.2.1.27.1.2.1 | docsPnmCmControlObjects | DOCS-PNM-MIB |
| 1.3.6.1.4.1.4491.2.1.27.1.2.1.3 | docsPnmCmCtlStatus | DOCS-PNM-MIB |