All MIBs › DOCS-IF-MIB › docsIfUpChannelStatus
docsIfUpChannelStatus
Module: DOCS-IF-MIB
OID (symbolic): DOCS-IF-MIB::docsIfUpChannelStatus
OID (numeric): 1.3.6.1.2.1.10.127.1.1.2.1.18
Node type: OBJECT-TYPE
Type: RowStatus
Access: read-create
Description: This object is only used for the creation of a temporary upstream row with the purpose of updating the parameters of a physical upstream channel entry.
The following restrictions apply to this object: 1. This object is not writable for physical interfaces. 2. Temporary interface entries are only created by a SET of this object to createandWait(5). 3. ifAdminStatus from the Interface MIB RFC 2863 is used to take a physical upstream channel offline, to be consistent with DOCSIS 1.x operation, as indicated in RFC 2670. In addition, o ifAdminStatus 'down' is reflected in this object as 'notInService'. o ifOperStatus 'down' while ifAdminStatus 'up' is reflected in this object as 'notInservice'. 4. Temporary created rows MUST be set to 'active' with the purpose of validating upstream parameter consistency prior to transferring the parameters to the physical interface.
Below is a mandatory procedure for adjusting the values of a physical interface: 1. Create a temporary interface entry through an SNMP SET using 'createAndWait'. At this point, the RowStatus reports 'notReady'. The Manager entity uses an ifIndex value outside the operational range of the physical interfaces for the creation of a temporary interface. 2. Set the docsIfUpChannelCloneFrom object to the ifIndex value of the physical row to update. Now docsIfUpChannelStatus reports 'notInService'. 3. Change the upstream parameters to the desired values in the temporary row. 4. Validate that all parameters are consistent by setting docsIfUpChannelStatus to 'active'. A failure to set the RowStatus to 'active' returns the error 'commitFailed', which means the parameters are not compatible with the target physical interface. 5. With docsIfUpChannelStatus 'active', transfer the parameters to the target physical interface by setting the object docsIfUpChannelUpdate to 'true'. 6. Delete the temporary row by setting docsIfUpChannelStatus to 'destroy'.
What is docsIfUpChannelStatus?
Controls the lifecycle of a temporary upstream channel row used to stage parameter changes before applying them to a physical channel; it is not writable on physical interface rows themselves. An admin creates a row with createAndWait, points it at a target channel via docsIfUpChannelCloneFrom, edits the parameters, then sets this to active to validate consistency before triggering the copy with docsIfUpChannelUpdate. A failed transition to active returns commitFailed, meaning the staged values are not compatible with the target interface.
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.2 | mgmt | APERTUS-NPG-MIB |
| 1.3.6.1.2.1 | mib_2 | AXON-MIB |
| 1.3.6.1.2.1.10 | transmission | CHECKPOINT-MIB-2 |
| 1.3.6.1.2.1.10.127 | docsIfMib | DOCS-IETF-RFI-MIB |
| 1.3.6.1.2.1.10.127.1 | docsIfMibObjects | DOCS-IETF-RFI-MIB |
| 1.3.6.1.2.1.10.127.1.1 | docsIfBaseObjects | DOCS-IETF-RFI-MIB |
| 1.3.6.1.2.1.10.127.1.1.2 | docsIfUpstreamChannelTable | DOCS-IETF-RFI-MIB |
| 1.3.6.1.2.1.10.127.1.1.2.1 | docsIfUpstreamChannelEntry | DOCS-IETF-RFI-MIB |
| Numeric OID | Name | Module |
|---|---|---|
| 1.3.6.1.2.1.10.127.1.1.2.1.18 | docsIfUpChannelStatus | DOCS-IF-MIB |