CISCO-OSCP-MIB

All MIBs › CISCO-OSCP-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2001-05-18

Category: Cisco Devices, Optical and WDM

Description: Manages the Optical Supervisory Channel Protocol (OSCP) for out-of-band control communication on optical transport links.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-OSCP-MIB?

CISCO-OSCP-MIB manages the Cisco Optical Supervisory Channel Protocol (OSCP), used on optical transport (DWDM) network elements to discover and maintain wavelength/fiber connectivity with remote nodes over an out-of-band supervisory channel. It exposes configuration data (protocol version range, switch/node identifiers, hello timers, priority-change mode) and per-link operational data through the coscpLinkTable, including link port identity and link type. It supports monitoring hardware/protocol health of optical links: hello interval and hold-down timers reveal keepalive behavior, and notification objects (coscpNotifiesEnabled) plus the traps group indicate when a supervisory link changes state, which corresponds to a physical fiber/wavelength connectivity fault. It is a Cisco-proprietary protocol MIB with no direct standards-based dependency, though it operates alongside general optical-transport MIBs describing the underlying wavelength/interface hardware. It is deployed on Cisco optical transport platforms (e.g., DWDM/ROADM nodes) that use OSCP to manage wavelength bundles and control-channel selection between adjacent optical nodes. Engineers can download the CISCO-OSCP-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-OSCP-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco optical transport / DWDM network element

Monitoring Examples

coscpLinkTable/coscpLinkEntry rows (indexed by coscpLinkPortId) expose coscpLinkType so an operator can confirm the OSCP relationship type on each optical supervisory link. Polling coscpHelloInterval and coscpHelloInactivityFactor together with coscpHelloHoldDown shows the keepalive timing configured for detecting a lost neighbor; a link whose hello timer expires without response indicates a wavelength/fiber connectivity failure to the remote node. coscpSwitchId and coscpPriorityChangeMode would be checked when diagnosing which node is acting as the supervisory channel's controlling switch.

What Can Be Monitored

OSCP link type per port
hello interval/hold-down/inactivity timers
switch ID and priority-change mode
OSCP notification/trap status

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From IF-MIB

InterfaceIndex

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

RowStatus
TEXTUAL-CONVENTION
TruthValue

How to Use in IPNetwork Monitor

Example using coscpLinkInHellos OID:

Select a Cisco optical transport / DWDM network element as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type coscpLinkInHellos into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. This object contains a count of the number of Hello packets received over this link. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoOscpMIB	1.3.6.1.4.1.9.9.202			The MIB module for managing the Cisco Optical Supervisory Channel Protocol (OSCP). The OSCP is used to determine and maintain wavelength connectivity with remote nodes. OSCP includes support for bundles of wavelengths to a common remote node, including dynamic selection of the message channel on one wavelength to carry control and management traffic for the entire wavelength bundle.
ciscoOscpMIBObjects	1.3.6.1.4.1.9.9.202.1
ciscoOscpBaseGroup	1.3.6.1.4.1.9.9.202.1.1
COS coscpHighestVersion	1.3.6.1.4.1.9.9.202.1.1.1	CoscpVersion	read-only	The highest version of OSCP that the software in this switch is capable of executing. If the version of a received hello packet is greater than coscpHighestVersion, the received hello packet will be discarded.
COS coscpLowestVersion	1.3.6.1.4.1.9.9.202.1.1.2	CoscpVersion	read-only	The lowest version of OSCP that the software in this switch is capable of executing. If the version of a received hello packet is smaller than coscpLowestVersion, the received hello packet will be discarded. The switch supports all OSCP versions between the lowest and the highest versions inclusive.
COS coscpSwitchId	1.3.6.1.4.1.9.9.202.1.1.3	CoscpSwitchId	read-write	The value this switch is using to represent itself as a network node. This should be a globally unique identifier. Typically this value is a MAC address preconfigured in the switch hardware.
INT coscpPriorityChangeMode	1.3.6.1.4.1.9.9.202.1.1.4	INTEGER	read-write	This value defines how OSCP will react to a change in the configured value of coscpLinkSelPriority. If the value is set to 'immediate', the reevaluation of the selected OSC in the bundle occurs immediately. If the value is set to 'delayed', then the OSC reevaluation can happen only when the current OSC goes out of the 'twoWay' state.
U32 coscpHelloHoldDown	1.3.6.1.4.1.9.9.202.1.1.5	Unsigned32	read-write	In OSCP, some hello packets are generated periodically while others are triggered by events. Specifically, event-triggered hellos are sent upon every state change (except 'oneWay' to 'twoWay') and when a change occurs in the bundle identifier. To avoid potential system misbehavior in which hello packets would be triggered in an uncontrolled fashion, a hello hold down timer is introduced that prevents successive event-triggered hellos from being sent in too short a time interval. This object contains the minimum time between (triggered) hellos. This value must be smaller than 75% of the value of coscpHelloInterval.
U32 coscpHelloInterval	1.3.6.1.4.1.9.9.202.1.1.6	Unsigned32	read-write	The average time interval between successive hellos sent by this switch on each link running OSCP, in the absence of triggered hellos.
U32 coscpHelloInactivityFactor	1.3.6.1.4.1.9.9.202.1.1.7	Unsigned32	read-write	The value for the Hello Inactivity factor that this switch will use to determine when a link has gone down. A link will be returned to the 'attempt' state if the switch has not received an OSCP hello packet for an interval of time equal to coscpHelloInactivityFactor multiplied by the remote switch's advertised Hello Interval from the most recent received hello packet.
T/F coscpNotifiesEnabled	1.3.6.1.4.1.9.9.202.1.1.8	TruthValue	read-write	Notifications that OSCP has gone down on a link are enabled if this value is set to 'true'.
coscpLinkTable	1.3.6.1.4.1.9.9.202.1.2		not-accessible	This table contains the objects necessary to describe the operation of OSCP over wavelengths that terminate at this switch. There is one entry for each wavelength that has a message channel for control and management purposes. The table is also used to configure the parameters used to control aggregation of multiple wavelengths that terminate at the same remote switch. Most of the information in this table is discovered by OSCP dynamically.
coscpLinkEntry	1.3.6.1.4.1.9.9.202.1.2.1		not-accessible	An entry in the table, containing information about a link attached to a switch running OSCP.
COS coscpLinkPortId	1.3.6.1.4.1.9.9.202.1.2.1.1	CoscpPortId	not-accessible	The Port Identifier of the link as selected by the local switch. This value has meaning only within the context of the switch to which the port is attached. This value is invariant across system restarts.
INT coscpLinkType	1.3.6.1.4.1.9.9.202.1.2.1.2	INTEGER	read-only	This object indicates the type of link being described. A link type of 'dedicatedWavelength' represents a wavelength that is dedicated to carrying control and network management traffic, rather than user data. A dedicated wavelength should be terminated on the switch that physically connects to the fiber carrying that wavelength, i.e., the remote switch should be a physical neighbor. A link type of 'inBand' represents a message channel used to carry control and management traffic on a wavelength that otherwise carries user data. An 'inBand' link does not need to be terminated on the switch that physically connects to the fiber carrying that wavelength, i.e., the remote switch need not be a physical neighbor.
COS coscpLinkVersion	1.3.6.1.4.1.9.9.202.1.2.1.3	CoscpVersion	read-only	This object indicates the version of OSCP used to exchange information over this link. If communication with the remote switch has not yet been established, then the Version is set to 'unknown'.
INT coscpLinkHelloState	1.3.6.1.4.1.9.9.202.1.2.1.4	INTEGER	read-only	This object indicates the state of the Hello protocol exchange over this link. The 'down' state is the initial state of the OSCP Hello finite state machine. This state is also reached when lower-level protocols declare that the wavelength is not usable. No hello packets are sent or received in this state. The 'attempt' state indicates that either no hellos or hellos with mismatch information have recently been received from the remote switch. In this state, attempts are made to contact the remote switch by periodically sending hellos with period coscpHelloInterval. The 'oneWay' state indicates that Hellos have recently been received from the remote switch, but the remote switch identifier and the remote port identifier in the remote switch's hello packets were set to zero. This means that the remote switch does not know the identity of this switch. The 'twoWay' state indicates that hellos have recently been received from the remote switch including the correct remote switch identifier and remote port identifier fields. This means that bi-directional communication with the remote switch over the message channel on this wavelength has been achieved. The link is now capable of becoming the active OSC for a wavelength bundle. A link that is not in the 'twoWay' state is not capable of becoming the active OSC for a wavelength bundle.
COS coscpLinkRemoteSwitchId	1.3.6.1.4.1.9.9.202.1.2.1.5	CoscpSwitchId	read-only	This object indicates the switch identifier of the remote switch on the other end of the link.
COS coscpLinkRemotePortId	1.3.6.1.4.1.9.9.202.1.2.1.6	CoscpPortId	read-only	This object indicates the port identifier of the port at the remote end of the link as assigned by the remote switch.
COS coscpLinkDerivedBundleId	1.3.6.1.4.1.9.9.202.1.2.1.7	CoscpBundleId	read-only	This object identifies the wavelength bundle to the remote switch that this link belongs to. All links with the same value of coscpLinkRemoteSwitchId and the same value of this object are aggregated and treated as a single logical link with a single control channel. The aggregated logical link that contains this link is shown in coscpBundleTable as the coscpBundleEntry with coscpBundleRemoteSwitchId value equal to the value of coscpLinkRemoteSwitchId and with coscpBundleId value equal to the value of this object. The value of this object is derived from the bundle identifier advertised by this switch in the OSCP (specified in coscpLinkConfigBundleId) and the bundle identifier advertised by the remote switch. The two switches on either end of the link run the same algorithm on the same information to determine common values of the derived bundle identifier. The derivation process is intended for minimal configuration as well as acceptable behavior in the face of misconfiguration. By default all links have the coscpLinkConfigBundleId value zero. Since all links have the same default value, the default behavior is to aggregate all links between two switches into a single logical link with derived bundle identifier value zero. In order to assign a non-default bundle identifier to a link between two switches, only one side needs to be configured with the non-default value. The coscpLinkConfigBundleId value zero indicates that the switch will use as the derived bundle identifier value whatever value the remote switch has. The algorithm for computing the value of the derived bundle identifier is: 1. If the two switches exchange identical values of the configured bundle identifier, that value becomes the derived bundle identifier. 2. If the configured bundle identifier value of one of the switches is zero and that of the other switch is non-zero, the non-zero value becomes the derived bundle identifier value. 3. If the configured bundle identifier values of the two switches are different and both non-zero, the link has been misconfigured and the derived bundle identifier value becomes zero.
COS coscpLinkConfigBundleId	1.3.6.1.4.1.9.9.202.1.2.1.8	CoscpBundleId	read-write	This object specifies the identifier of the wavelength bundle to the remote switch configured for this link. The configured bundle identifier is carried in the OSCP hello packet. At both this switch and the remote switch, the configured bundle identifier is used to derive coscpLinkDerivedBundleId according to the algorithm presented in the description of the coscpLinkDerivedBundleId. By default all links have the value zero. Since all links have the same default value, the default behavior is to aggregate all links between two switches into a single logical link with derived bundle identifier value zero. In order to assign a non-default bundle identifier to a link between two switches, only one side needs to be configured with the non-default value. The distinguished value zero indicates that the switch will use as the derived bundle identifier value whatever value the remote switch has.
NUM coscpLinkIfIndex	1.3.6.1.4.1.9.9.202.1.2.1.9	InterfaceIndex	read-only	The interface index identifying this link.
U32 coscpLinkSelPriority	1.3.6.1.4.1.9.9.202.1.2.1.10	Unsigned32	read-write	This object indicates the priority with which this link gets selected as the active Optical Supervisory Channel (OSC) when multiple links are present in the same wavelength bundle. If selected, this link will be used to transmit all control and network management traffic to the remote switch, for the entire wavelength bundle. The link with the highest value of the selection priority is chosen by this switch to be the active OSC. Only links in the wavelength bundle that have coscpLinkHelloState value 'twoWay' are considered. If there is more than one link with the same highest value of the selection priority, the choice between these links is arbitrary. If it is desired to have one OSC link candidate be picked over another, its priority should be configured to a higher value than other candidate links. The OSCP will react to a reconfiguration of the selection priority according to the rules defined for the configured variable coscpPriorityChangeMode.
C32 coscpLinkInHellosEx	1.3.6.1.4.1.9.9.202.1.2.1.11	Counter32	read-only	This object contains a count of the number of Hello packets received over this link.
C32 coscpLinkInDiscardedHellos	1.3.6.1.4.1.9.9.202.1.2.1.12	Counter32	read-only	This object contains a count of the number of Hello packets received over this link that were discarded since the version of the received Hello packet was outside the range of coscpLowestVersion to coscpHighestVersion.
C32 coscpLinkOutHellos	1.3.6.1.4.1.9.9.202.1.2.1.13	Counter32	read-only	This object contains a count of the number of Hello packets transmitted over this link.
C32 coscpLinkTransDown	1.3.6.1.4.1.9.9.202.1.2.1.14	Counter32	read-only	This object contains a count of the number of times this link transitioned from the 'twoWay' state to a hello state other than 'twoWay'.
coscpBundleTable	1.3.6.1.4.1.9.9.202.1.3		not-accessible	This table contains objects describing the wavelength bundles on this switch.
coscpBundleEntry	1.3.6.1.4.1.9.9.202.1.3.1		not-accessible	Each entry contains information about one wavelength bundle to one remote switch. The wavelength bundle is modeled as a single logical link (identified by coscpBundleIfIndex) with a single control and management channel. This logical link is known as the Optical Supervisory Channel (OSC). At any one time, only one wavelength in the bundle is selected to transmit the OSC control and network management traffic. This link is identified by coscpBundleActivePortId. The wavelength bundle must be created by a manager using the coscpBundleRowStatus object. Once the row has been activated, an interface index is assigned by the agent and shown in coscpBundleIfIndex. This value can then be used by the manager to configure control and management protocols, e.g. to configure the OSC's IP address. Aside from coscpBundleRowStatus, the other objects in the row are read-only, since they reflect the dynamic state of the wavelength bundle as determined by OSCP. The wavelength bundle does not become operational until at least one component link reaches the hello state 'twoWay', i.e., until at least one entry in coscpLinkTable with coscpLinkRemoteSwitchId value equal to the value of coscpBundleRemoteSwitchId and coscpLinkDerivedBundleId value equal to the value of coscpBundleId has coscpLinkHelloState value 'twoWay'. The operational status of the wavelength bundle is indicated by the value of ifOperStatus in the ifEntry with ifIndex value equal to the value of coscpBundleIfIndex.
COS coscpBundleRemoteSwitchId	1.3.6.1.4.1.9.9.202.1.3.1.1	CoscpSwitchId	not-accessible	The switch identifier of the remote switch.
COS coscpBundleId	1.3.6.1.4.1.9.9.202.1.3.1.2	CoscpBundleId	not-accessible	The bundle identifier value used to distinguish this wavelength bundle from other wavelength bundles to the same remote switch. All entries in coscpLinkTable with the value of coscpLinkRemoteSwitchId equal to the value of coscpBundleRemoteSwitchId and with the value of coscpLinkDerivedBundleId equal to the value of this object identify links that are present in this wavelength bundle.
COS coscpBundleActivePortId	1.3.6.1.4.1.9.9.202.1.3.1.3	CoscpPortId	read-only	The port identifier of the link currently selected as the active OSC. This link is used to transmit all OSC control and network management traffic to the remote switch, for the entire wavelength bundle.
NUM coscpBundleIfIndex	1.3.6.1.4.1.9.9.202.1.3.1.4	InterfaceIndex	read-only	The interface index assigned by the agent to represent the OSC for the wavelength bundle.
G32 coscpBundlePortCount	1.3.6.1.4.1.9.9.202.1.3.1.5	Gauge32	read-only	A count of the total number of component links in the wavelength bundle that have coscpLinkHelloState value 'twoWay'.
ROW coscpBundleRowStatus	1.3.6.1.4.1.9.9.202.1.3.1.6	RowStatus	read-create	This object is used to create a new row or to modify or delete an existing row in this table. Each row in the table must be created using this object. Once the row has been activated, an interface index is assigned by the agent and shown in coscpBundleIfIndex. This value can then be used by the manager to configure control and management protocols, e.g. to configure the OSC's IP address. After the row has been activated, this object cannot be set to any value other than 'destroy'. The row status never changes to 'notInService' after reaching the value 'active'.
ciscoOscpMIBNotifications	1.3.6.1.4.1.9.9.202.2
ciscoOscpNotificationsPrefix	1.3.6.1.4.1.9.9.202.2.0
NTF coscpNotifyTransDown	1.3.6.1.4.1.9.9.202.2.0.1			A coscpNotifyTransDown notification is sent when the value of an instance of coscpTransDown increments. This indicates that a link exited the 'twoWay' state and cannot be used to carry control and management traffic for an optical supervisory channel.
ciscoOscpMIBConformance	1.3.6.1.4.1.9.9.202.3
ciscoOscpMIBCompliances	1.3.6.1.4.1.9.9.202.3.1
ciscoOscpMIBCompliance	1.3.6.1.4.1.9.9.202.3.1.1			The compliance statement for entities which implement the Cisco OSCP MIB.
ciscoOscpMIBGroups	1.3.6.1.4.1.9.9.202.3.2
ciscoOscpBasicGroup	1.3.6.1.4.1.9.9.202.3.2.1			A collection of cisco specific MIB objects used for management of OSCP.
ciscoOscpBundleGroup	1.3.6.1.4.1.9.9.202.3.2.2			A collection of cisco specific MIB objects used for management of wavelength bundles to a common remote node that are controlled by OSCP.
ciscoOscpNotificationsGroup	1.3.6.1.4.1.9.9.202.3.2.3			A collection of cisco specific notifications used for management of OSCP.

RFC description

Manages Cisco Optical Supervisory Channel Protocol (OSCP) for determining and maintaining wavelength connectivity and bundling on optical networks.

Start monitoring Cisco optical transport / DWDM network element with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-OSCP-MIB