diff options
Diffstat (limited to 'MIBS/cisco/CISCO-OPTICAL-MONITOR-MIB')
| -rw-r--r-- | MIBS/cisco/CISCO-OPTICAL-MONITOR-MIB | 1351 |
1 files changed, 1351 insertions, 0 deletions
diff --git a/MIBS/cisco/CISCO-OPTICAL-MONITOR-MIB b/MIBS/cisco/CISCO-OPTICAL-MONITOR-MIB new file mode 100644 index 0000000..ca7d952 --- /dev/null +++ b/MIBS/cisco/CISCO-OPTICAL-MONITOR-MIB @@ -0,0 +1,1351 @@ +-- ***************************************************************** +-- CISCO-OPTICAL-MONITOR-MIB.my +-- +-- May 2002, Sonal Maheshwari, Mickey Spiegel +-- +-- Copyright (c) 2002,-2007 by Cisco Systems, Inc. +-- +-- All rights reserved. +-- **************************************************************** + +CISCO-OPTICAL-MONITOR-MIB DEFINITIONS ::= BEGIN + +IMPORTS + Integer32, + Unsigned32, + MODULE-IDENTITY, + NOTIFICATION-TYPE, + OBJECT-TYPE + FROM SNMPv2-SMI + MODULE-COMPLIANCE, + NOTIFICATION-GROUP, + OBJECT-GROUP + FROM SNMPv2-CONF + TEXTUAL-CONVENTION, + TimeStamp + FROM SNMPv2-TC + ifIndex + FROM IF-MIB + ciscoMgmt + FROM CISCO-SMI; + + +ciscoOpticalMonitorMIB MODULE-IDENTITY + LAST-UPDATED "200701020000Z" + ORGANIZATION "Cisco Systems, Inc." + CONTACT-INFO + "Cisco Systems + Customer Service + + Postal: 170 W Tasman Drive + San Jose, CA 95134 + + Tel: +1 800 553-NETS + + E-mail: cs-dwdm@cisco.com" + DESCRIPTION + "This MIB module defines objects to monitor optical + characteristics and set corresponding thresholds on the + optical interfaces in a network element. + " + REVISION "200701020000Z" + DESCRIPTION + "Add cOpticalMonIfTimeGroup, + cOpticalMIBEnableConfigGroup, + cOpticalMIBIntervalConfigGroup, + cOpticalMonThreshSourceGroup." + REVISION "200205100000Z" + DESCRIPTION + "The initial revision of this MIB." + ::= { ciscoMgmt 264 } + + +-- Textual Conventions + +OpticalParameterType ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "This value indicates the optical parameter that is + being monitored. Valid values are - + + power (1) : Optical Power (AC + DC) in 1/10ths of dBm + acPower (2) : Optical AC Power in 1/10ths of dBm + ambientTemp (3) : Ambient Temperature in 1/10ths of degrees + centigrade + laserTemp (4) : Laser Temperature in 1/10ths of degrees + centigrade + biasCurrent (5) : Laser bias current in 100s of microamperes + peltierCurrent (6) : Laser peltier current in milliamperes + xcvrVoltage (7) : Transceiver voltage in millivolts + " + SYNTAX INTEGER { + power(1), + acPower(2), + ambientTemp(3), + laserTemp(4), + biasCurrent(5), + peltierCurrent(6), + xcvrVoltage(7) + } + +OpticalParameterValue ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The value of the optical parameter that is being monitored. + + The range of values varies depending on the type of optical + parameter being monitored, as identified by a corresponding + object with syntax OpticalParameterType. + + When the optical parameter being monitored is 'power' or + 'acPower', the supported range is from -400 to 250, in + 1/10ths of dBm. + Example: A value of -300 represents a power level of -30.0 dBm. + + When the optical parameter being monitored is 'laserTemp' or + 'ambientTemp', the supported range is from -500 to 850, in + 1/10ths of degrees centigrade. + Example: A value of 235 represents a temperature reading of + 23.5 degrees C. + + When the optical parameter being monitored is 'biasCurrent', + the supported range is from 0 to 10000, in 100s of + microamperes. + Example: A value of 500 represents a bias current reading of + 50,000 microamperes. + + When the optical parameter being monitored is 'peltierCurrent', + the supported range is from -10000 to 10000, in milliamperes. + + When the optical parameter being monitored is 'xcvrVoltage', + the supported range is from 0 to 10000, in millivolts. + + The distinguished value of '-1000000' indicates that the object + has not yet been initialized or does not apply. + " + SYNTAX Integer32 (-1000000..1000000 ) + +OpticalIfDirection ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "This value indicates the direction being monitored at + the optical interface. + " + SYNTAX INTEGER { + receive(1), + transmit(2), + notApplicable(3) + } + +OpticalIfMonLocation ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "This value applies when there are multiple points + at which optical characteristics can be measured, in the + given direction, at an interface. It indicates whether the + optical characteristics are measured before or after + adjustment (e.g. optical amplification or attenuation). + + The codepoint 'notApplicable' should be used if no + amplifier/attenuator exists at an interface. + " + SYNTAX INTEGER { + beforeAdjustment(1), + afterAdjustment(2), + notApplicable(3) + } + +OpticalAlarmStatus ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "A bitmap that indicates the current status of thresholds + on an interface. The bit is set to 1 if the threshold is + currently being exceeded on the interface and will be set to 0 + otherwise. + + (MSB) (LSB) + 7 6 5 4 3 2 1 0 + +----------------------+ + | | + +----------------------+ + | | | | + | | | +-- High alarm threshold + | | +----- High warning threshold + | +-------- Low alarm threshold + +----------- Low warning threshold + + To minimize the probability of prematurely reacting to + momentary signal variations, a soak time may be incorporated + into the status indications in the following manner. + The indication is set when the threshold violation persists + for a period of time that exceeds the set soak interval. + The indication is cleared when no threshold violation occurs + for a period of time which exceeds the clear soak interval. + In GR-2918-CORE, the recommended set soak interval is 2.5 + seconds (plus/minus 0.5 seconds), and the recommended clear + soak interval is 10 seconds (plus/minus 0.5 seconds). + " + + REFERENCE + "Telcordia Technologies Generic Requirements + GR-2918-CORE, Issue 4, December 1999, Section 8.11" + SYNTAX OCTET STRING (SIZE (1)) + +OpticalAlarmSeverity ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The severity of a trouble condition. A smaller enumerated + integer value indicates that the condition is more severe. + + The severities are defined as follows: + + 'critical' An alarm used to indicate a severe, + service-affecting condition has occurred and that + immediate corrective action is imperative, + regardless of the time of day or day of the week. + + 'major' An alarm used for hardware or software conditions + that indicate a serious disruption of service or + malfunctioning or failure of important hardware. + These troubles require the immediate attention and + response of a technician to restore or maintain + system capability. The urgency is less than in + critical situations because of a lesser immediate + or impending effect on service or system + performance. + + 'minor' An alarm used for troubles that do not have a + serious effect on service to customers or for + troubles in hardware that are not essential to + the operation of the system. + + 'notAlarmed' An event used for troubles that do not require + action, for troubles that are reported as a + result of manually initiated diagnostics, or for + transient events such as crossing warning + thresholds. This event can also be used to + raise attention to a condition that could + possibly be an impending problem. + + 'notReported' An event used for troubles similar to those + described under 'notAlarmed', and that + do not cause notifications to be generated. The + information for these events is retrievable from + the network element. + + 'cleared' This value indicates that a previously + occuring alarm condition has been cleared, or + that no trouble condition is present. + + " + + REFERENCE + "Telcordia Technologies Generic Requirements + GR-474-CORE, Issue 1, December 1997, Section 2.2" + SYNTAX INTEGER { + critical(1), + major(2), + minor(3), + notAlarmed(4), + notReported(5), + cleared(6) + } + +OpticalAlarmSeverityOrZero ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "A value of either '0' or a valid optical alarm severity." + SYNTAX INTEGER (0..6) + +OpticalPMPeriod ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "This value indicates the time period over which performance + monitoring data has been collected." + SYNTAX INTEGER { + fifteenMin(1), + twentyFourHour(2) + } +-- MIB Object Definitions +cOpticalMonitorMIBObjects OBJECT IDENTIFIER + ::= { ciscoOpticalMonitorMIB 1 } + +-- groups in this MIB module +cOpticalMonGroup OBJECT IDENTIFIER + ::= { cOpticalMonitorMIBObjects 1 } + +cOpticalPMGroup OBJECT IDENTIFIER + ::= { cOpticalMonitorMIBObjects 2 } + +-- cOpticalMonTable + +cOpticalMonTable OBJECT-TYPE + SYNTAX SEQUENCE OF COpticalMonEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This table provides objects to monitor optical + parameters in a network element. It also provides + objects for setting high and low threshold levels, with + configurable severities, on these monitored parameters." + ::= { cOpticalMonGroup 1 } + +cOpticalMonEntry OBJECT-TYPE + SYNTAX COpticalMonEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "An entry in the cOpticalMonTable provides objects to + monitor an optical parameter and set threshold levels + on that parameter, at an optical interface. + + Note that the set of monitored optical parameters may vary + based on interface type, direction, and monitoring location. + + Examples of interfaces that can have an entry in this table + include optical transceivers, interfaces before and after + optical amplifiers, and interfaces before and after optical + attenuators." + INDEX { + ifIndex, + cOpticalMonDirection, + cOpticalMonLocation, + cOpticalMonParameterType + } + ::= { cOpticalMonTable 1 } + +COpticalMonEntry ::= SEQUENCE { + cOpticalMonDirection OpticalIfDirection, + cOpticalMonLocation OpticalIfMonLocation, + cOpticalMonParameterType OpticalParameterType, + cOpticalParameterValue OpticalParameterValue, + cOpticalParamHighAlarmThresh OpticalParameterValue, + cOpticalParamHighAlarmSev OpticalAlarmSeverity, + cOpticalParamHighWarningThresh OpticalParameterValue, + cOpticalParamHighWarningSev OpticalAlarmSeverity, + cOpticalParamLowAlarmThresh OpticalParameterValue, + cOpticalParamLowAlarmSev OpticalAlarmSeverity, + cOpticalParamLowWarningThresh OpticalParameterValue, + cOpticalParamLowWarningSev OpticalAlarmSeverity, + cOpticalParamAlarmStatus OpticalAlarmStatus, + cOpticalParamAlarmCurMaxThresh OpticalParameterValue, + cOpticalParamAlarmCurMaxSev OpticalAlarmSeverity, + cOpticalParamAlarmLastChange TimeStamp, + cOpticalMon15MinValidIntervals Unsigned32, + cOpticalMon24HrValidIntervals Unsigned32, + cOpticalParamThreshSource BITS +} + +cOpticalMonDirection OBJECT-TYPE + SYNTAX OpticalIfDirection + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object indicates the direction monitored for the + optical interface, in this entry." + ::= { cOpticalMonEntry 1 } + +cOpticalMonLocation OBJECT-TYPE + SYNTAX OpticalIfMonLocation + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object indicates whether the optical characteristics are + measured before or after adjustment (e.g. optical amplification + or attenuation), at this interface." + ::= { cOpticalMonEntry 2 } + +cOpticalMonParameterType OBJECT-TYPE + SYNTAX OpticalParameterType + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object specifies the optical parameter that is being + monitored in this entry." + ::= { cOpticalMonEntry 3 } + +cOpticalParameterValue OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the value measured for the particular + optical parameter specified by the cOpticalMonParameterType + object." + ::= { cOpticalMonEntry 4 } + +cOpticalParamHighAlarmThresh OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object is used to set a high alarm threshold on the + optical parameter being monitored. + + An alarm condition will be raised if the value given by + cOpticalParameterValue goes from below the value configured in + this object to above the value configured in this object, or if + the initial value of cOpticalParameterValue exceeds the value + configured in this object. For network elements that + incorporate a soak time in the status indications, this alarm + will be indicated in the cOpticalParamAlarmStatus object only + after it persists for a period of time that equals the set soak + interval. + + The severity level of the alarm is specified by the + cOpticalParamHighAlarmSev object. + + When the cOpticalMonParameterType object is set to 'power' + for the receive direction at a transceiver, this object + specifies the receiver saturation level." + ::= { cOpticalMonEntry 5 } + +cOpticalParamHighAlarmSev OBJECT-TYPE + SYNTAX OpticalAlarmSeverity + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object is used to specify a severity level associated + with the high alarm threshold given by the + cOpticalParamHighAlarmThresh object. The values 'notAlarmed', + 'notReported', and 'cleared' do not apply. + + The severity level configured in this object must be higher + than the level configured in the cOpticalParamHighWarningSev + object." + ::= { cOpticalMonEntry 6 } + +cOpticalParamHighWarningThresh OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object is used to set a high warning threshold on + the optical parameter being monitored. + + A threshold crossing condition will be indicated if the value + given by cOpticalParameterValue goes from below the value + configured in this object to above the value configured in this + object, or if the initial value of cOpticalParameterValue + exceeds the value configured in this object. For network + elements that incorporate a soak time in the status + indications, this threshold violation will be indicated in the + cOpticalParamAlarmStatus object only after it persists for + a period of time that equals the set soak interval. + + This threshold crossing may or may not be alarmed or + reported, based on the severity level specified by the + cOpticalParamHighWarningSev object." + ::= { cOpticalMonEntry 7 } + +cOpticalParamHighWarningSev OBJECT-TYPE + SYNTAX OpticalAlarmSeverity + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object is used to specify a severity level associated + with the high warning threshold given by the + cOpticalParamHighWarningThresh object. The values 'critical', + 'major', and 'cleared' do not apply. + + The severity level configured in this object must be lower + than the level configured in the cOpticalParamHighAlarmSev + object. + + If this object is set to 'notReported', no notifications will + be generated when this threshold is exceeded, irrespective + of the value configured in the cOpticalNotifyEnable object." + ::= { cOpticalMonEntry 8 } + +cOpticalParamLowAlarmThresh OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object is used to set a low alarm threshold on the + optical parameter being monitored. + + An alarm condition will be raised if the value given by + cOpticalParameterValue goes from above the value configured in + this object to below the value configured in this object, or if + the initial value of cOpticalParameterValue is lower than the + value configured in this object. For network elements that + incorporate a soak time in the status indications, this alarm + will be indicated in the cOpticalParamAlarmStatus object only + after it persists for a period of time that equals the set soak + interval. + + The severity level of this alarm is specified by the + cOpticalParamLowAlarmSev object. + + When the cOpticalMonParameterType object is set to 'power' + for the receive direction and when the interface supports + alarms based on loss of light, this object specifies the + optical power threshold for declaring loss of light. Also, + when optical amplifiers are present in the network, in the + receive direction, this value may need to be configured, + since the noise floor may be higher than the minimum + sensitivity of the receiver." + ::= { cOpticalMonEntry 9 } + +cOpticalParamLowAlarmSev OBJECT-TYPE + SYNTAX OpticalAlarmSeverity + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object is used to specify a severity level associated + with the low alarm threshold given by the + cOpticalParamLowAlarmThresh object. The values 'notAlarmed', + 'notReported', and 'cleared' do not apply. + + The severity level configured in this object must be higher + than the level configured in the cOpticalParamLowWarningSev + object." + ::= { cOpticalMonEntry 10 } + +cOpticalParamLowWarningThresh OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object is used to set a low warning threshold on + the optical parameter being monitored. + + A threshold crossing condition will be indicated if the value + given by cOpticalParameterValue goes from above the value + configured in this object to below the value configured in this + object, or if the initial value of cOpticalParameterValue + object is lower than the value configured in this object. For + network elements that incorporate a soak time in the status + indications, this threshold violation will be indicated in the + cOpticalParamAlarmStatus object only after it persists for + a period of time that equals the set soak interval. + + This threshold crossing may or may not be alarmed or + reported, based on the severity level specified by the + cOpticalParamLowWarningSev object." + ::= { cOpticalMonEntry 11 } + +cOpticalParamLowWarningSev OBJECT-TYPE + SYNTAX OpticalAlarmSeverity + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object is used to specify a severity level associated + with the low warning threshold given by the + cOpticalParamLowWarningThresh object. The values 'critical', + 'major', and 'cleared' do not apply. + + The severity level configured in this object must be lower + than the level configured in the cOpticalParamLowAlarmSev + object. + + If this object is set to 'notReported', no notifications will + be generated when this threshold is exceeded, irrespective + of the value configured in the cOpticalNotifyEnable object." + ::= { cOpticalMonEntry 12 } + +cOpticalParamAlarmStatus OBJECT-TYPE + SYNTAX OpticalAlarmStatus + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object is used to indicate the current status of + the thresholds for the monitored optical parameter + on the interface. + + If a threshold is currently being exceeded on the + interface, the corresponding bit in this object will be set + to 1. Otherwise, the bit will be set to 0." + ::= { cOpticalMonEntry 13 } + +cOpticalParamAlarmCurMaxThresh OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object indicates the threshold value of the highest + severity threshold that is currently being exceeded + on the interface, for the optical parameter. + If no threshold value is currently being + exceeded, then the value '-1000000' is returned." + ::= { cOpticalMonEntry 14 } + +cOpticalParamAlarmCurMaxSev OBJECT-TYPE + SYNTAX OpticalAlarmSeverity + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object indicates the maximum severity of any thresholds + that are currently being exceeded on the interface, for the + optical parameter." + ::= { cOpticalMonEntry 15 } + +cOpticalParamAlarmLastChange OBJECT-TYPE + SYNTAX TimeStamp + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object specifies the value of sysUpTime at the last time + a threshold related to a particular optical parameter was + exceeded or cleared on the interface." + ::= { cOpticalMonEntry 16 } + +cOpticalMon15MinValidIntervals OBJECT-TYPE + SYNTAX Unsigned32 (0..96 ) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the number of previous 15 minute + intervals for which valid performance monitoring data + has been stored on the interface. + + The value of this object will be n (where n is the maximum + number of 15 minute intervals supported at this interface), + unless the measurement was (re-)started within the last + (nx15) minutes, in which case the value will be the + number of previous 15 minute intervals for which the agent + has some data." + ::= { cOpticalMonEntry 17 } + +cOpticalMon24HrValidIntervals OBJECT-TYPE + SYNTAX Unsigned32 (0..1 ) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the number of previous 24 hour + intervals for which valid performance monitoring data + has been stored on the interface. + + The value of this object will be 0 if the measurement + was (re-)started within the last 24 hours, or 1 otherwise." + ::= { cOpticalMonEntry 18 } + +cOpticalParamThreshSource OBJECT-TYPE + SYNTAX BITS { + highAlarmDefThresh(0), + highWarnDefThresh(1), + lowAlarmDefThresh(2), + lowWarnDefThresh(3) + } + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object indicates if the current value of a particular + threshold in this entry is user configured value or it is + a system default value. It also allows user to specify + the list of thresholds for this entry which should + be restored to their system default values. + + The bit 'highAlarmThresh' corresponds to the object + cOpticalParamHighAlarmThresh. + + The bit 'highWarnThresh' corresponds to the object + cOpticalParamHighWarningThresh. + + The bit 'lowAlarmThresh' corresponds to the object + cOpticalParamLowAlarmThresh. + + The bit 'lowWarnThresh' corresponds to the object + cOpticalParamLowWarningThresh. + + A value of 0 for a bit indicates that corresponding + object has system default value of threshold. + + A value of 1 for a bit indicates that corresponding + object has user configured threshold value. + + A user may only change value of each of the bits to zero. + + Setting a bit to 0 will reset the corresponding + threshold to its default value. + + System will change a bit from 0 to 1 when its corresponding + threshold is changed by user from its default to any + other value." + ::= { cOpticalMonEntry 19 } + + + +-- Notification related objects +cOpticalNotifyEnable OBJECT-TYPE + SYNTAX OpticalAlarmSeverityOrZero + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object specifies the minimum severity threshold governing + the generation of cOpticalMonParameterStatus notifications. + + For example, if the value of this object is + set to 'major', then the agent generates these notifications + if and only if the severity of the alarm being indicated is + 'major' or 'critical'. + + The values of 'notReported', and 'cleared' do not apply. + The value of '0' disables the generation of notifications." + DEFVAL { 0 } + ::= { cOpticalMonGroup 2 } + +-- Scalar object(s) for optical monitoring configuration. +cOpticalMonEnable OBJECT-TYPE + SYNTAX BITS { + all(0) + } + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object specifies the types of transceivers for which + optical monitoring is enabled. + + A value of 1 for the bit 'all', specifies that optical + monitoring functionality is enabled for all the types of + transceivers which are supported by system and have + optical monitoring capability." + ::= { cOpticalMonGroup 3 } + +cOpticalMonPollInterval OBJECT-TYPE + SYNTAX Unsigned32 + UNITS "minutes" + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object specifies the interval in minutes after which + optical transceiver data will be polled by system + repeatedly and updated in cOpticalMonTable when one or + more bits in cOpticalMonEnable is set." + ::= { cOpticalMonGroup 4 } +-- cOpticalMonTransceiverTable + +cOpticalMonIfTable OBJECT-TYPE + SYNTAX SEQUENCE OF COpticalMonIfEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This table contains the list of optical interfaces + populated in cOpticalMonTable." + ::= { cOpticalMonGroup 5 } + +cOpticalMonIfEntry OBJECT-TYPE + SYNTAX COpticalMonIfEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "An entry containing the information for a particular optical interface." + INDEX { ifIndex } + ::= { cOpticalMonIfTable 1 } + +COpticalMonIfEntry ::= SEQUENCE { + cOpticalMonIfTimeInSlot Unsigned32 +} + +cOpticalMonIfTimeInSlot OBJECT-TYPE + SYNTAX Unsigned32 + UNITS "seconds" + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object indicates when this optical transceiver was detected by the + system." + ::= { cOpticalMonIfEntry 1 } + + +-- cOpticalPMCurrent Table + +cOpticalPMCurrentTable OBJECT-TYPE + SYNTAX SEQUENCE OF COpticalPMCurrentEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This table contains performance monitoring data for the + various optical parameters, collected over the current 15 + minute or the current 24 hour interval." + ::= { cOpticalPMGroup 1 } + +cOpticalPMCurrentEntry OBJECT-TYPE + SYNTAX COpticalPMCurrentEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "An entry in the cOpticalPMCurrentTable. It contains + performance monitoring data for a monitored optical + parameter at an interface, collected over the current 15 + minute or the current 24 hour interval. + + Note that the set of monitored optical parameters may vary + based on interface type, direction, and monitoring location. + + Examples of interfaces that can have an entry in this table + include optical transceivers, interfaces before and after + optical amplifiers, and interfaces before and after optical + attenuators." + INDEX { + cOpticalPMCurrentPeriod, + ifIndex, + cOpticalPMCurrentDirection, + cOpticalPMCurrentLocation, + cOpticalPMCurrentParamType + } + ::= { cOpticalPMCurrentTable 1 } + +COpticalPMCurrentEntry ::= SEQUENCE { + cOpticalPMCurrentPeriod OpticalPMPeriod, + cOpticalPMCurrentDirection OpticalIfDirection, + cOpticalPMCurrentLocation OpticalIfMonLocation, + cOpticalPMCurrentParamType OpticalParameterType, + cOpticalPMCurrentMaxParam OpticalParameterValue, + cOpticalPMCurrentMinParam OpticalParameterValue, + cOpticalPMCurrentMeanParam OpticalParameterValue, + cOpticalPMCurrentUnavailSecs Integer32 +} + +cOpticalPMCurrentPeriod OBJECT-TYPE + SYNTAX OpticalPMPeriod + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object indicates whether the optical parameter values + given in this entry are collected over the current 15 minute or + the current 24 hour interval." + ::= { cOpticalPMCurrentEntry 1 } + +cOpticalPMCurrentDirection OBJECT-TYPE + SYNTAX OpticalIfDirection + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object indicates the direction monitored for the optical + interface, in this entry." + ::= { cOpticalPMCurrentEntry 2 } + +cOpticalPMCurrentLocation OBJECT-TYPE + SYNTAX OpticalIfMonLocation + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object indicates whether the optical characteristics are + measured before or after adjustment (e.g. optical amplification + or attenuation), at this interface." + ::= { cOpticalPMCurrentEntry 3 } + +cOpticalPMCurrentParamType OBJECT-TYPE + SYNTAX OpticalParameterType + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object specifies the optical parameter that is being + monitored, in this entry." + ::= { cOpticalPMCurrentEntry 4 } + +cOpticalPMCurrentMaxParam OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the maximum value measured for the monitored + optical parameter, in the current 15 minute or the current + 24 hour interval." + ::= { cOpticalPMCurrentEntry 5 } + +cOpticalPMCurrentMinParam OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the minimum value measured for the monitored + optical parameter, in the current 15 minute or the current + 24 hour interval." + ::= { cOpticalPMCurrentEntry 6 } + +cOpticalPMCurrentMeanParam OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the average value of the monitored + optical parameter, in the current 15 minute or the current + 24 hour interval." + ::= { cOpticalPMCurrentEntry 7 } + +cOpticalPMCurrentUnavailSecs OBJECT-TYPE + SYNTAX Integer32 (0..86400 ) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object is used to indicate the number of seconds, + in the current 15 minute or the current 24 hour interval, for + which the optical performance data is not accounted for. + + In the receive direction, the performance data could be + unavailable during these periods for multiple reasons + like the interface being administratively down or if there + is a Loss of Light alarm on the interface. In the transmit + direction, performance data could be unavailable when + the laser is shutdown." + ::= { cOpticalPMCurrentEntry 8 } + + +-- cOpticalPMInterval Table + +cOpticalPMIntervalTable OBJECT-TYPE + SYNTAX SEQUENCE OF COpticalPMIntervalEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This table stores performance monitoring data for the + various optical parameters, collected over previous + intervals. + + This table can have entries for one complete 24 hour + interval and up to 96 complete 15 minute + intervals. A system is required to store at least + 4 completed 15 minute intervals. The number of valid + 15 minute intervals in this table is indicated by the + cOpticalMon15MinValidIntervals object and the number of + valid 24 hour intervals is indicated by the + cOpticalMon24HrValidIntervals object." + ::= { cOpticalPMGroup 2 } + +cOpticalPMIntervalEntry OBJECT-TYPE + SYNTAX COpticalPMIntervalEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "An entry in the cOpticalPMIntervalTable. It contains + performance monitoring data for an optical parameter, + collected over a previous interval. + + Note that the set of monitored optical parameters may vary + based on interface type, direction, and monitoring location. + + Examples of interfaces that can have an entry in this table + include optical transceivers, interfaces before and after + optical amplifiers, and interfaces before and after optical + attenuators." + INDEX { + cOpticalPMIntervalPeriod, + cOpticalPMIntervalNumber, + ifIndex, + cOpticalPMIntervalDirection, + cOpticalPMIntervalLocation, + cOpticalPMIntervalParamType + } + ::= { cOpticalPMIntervalTable 1 } + +COpticalPMIntervalEntry ::= SEQUENCE { + cOpticalPMIntervalPeriod OpticalPMPeriod, + cOpticalPMIntervalNumber Integer32, + cOpticalPMIntervalDirection OpticalIfDirection, + cOpticalPMIntervalLocation OpticalIfMonLocation, + cOpticalPMIntervalParamType OpticalParameterType, + cOpticalPMIntervalMaxParam OpticalParameterValue, + cOpticalPMIntervalMinParam OpticalParameterValue, + cOpticalPMIntervalMeanParam OpticalParameterValue, + cOpticalPMIntervalUnavailSecs Integer32 +} + +cOpticalPMIntervalPeriod OBJECT-TYPE + SYNTAX OpticalPMPeriod + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object indicates whether the optical parameter values, + given in this entry, are collected over a period of 15 minutes + or 24 hours." + ::= { cOpticalPMIntervalEntry 1 } + +cOpticalPMIntervalNumber OBJECT-TYPE + SYNTAX Integer32 (1..96 ) + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A number between 1 and 96, which identifies the + interval for which the set of optical parameter values is + available. The interval identified by 1 is the most recently + completed 15 minute or 24 hour interval, and the interval + identified by N is the interval immediately preceding the one + identified by N-1." + ::= { cOpticalPMIntervalEntry 2 } + +cOpticalPMIntervalDirection OBJECT-TYPE + SYNTAX OpticalIfDirection + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object indicates the direction monitored for the optical + interface, in this entry." + ::= { cOpticalPMIntervalEntry 3 } + +cOpticalPMIntervalLocation OBJECT-TYPE + SYNTAX OpticalIfMonLocation + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object indicates whether the optical characteristics + are measured before or after adjustment (e.g. + optical amplification or attenuation), at this interface." + ::= { cOpticalPMIntervalEntry 4 } + +cOpticalPMIntervalParamType OBJECT-TYPE + SYNTAX OpticalParameterType + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This object specifies the optical parameter that is being + monitored, in this entry." + ::= { cOpticalPMIntervalEntry 5 } + +cOpticalPMIntervalMaxParam OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the maximum value measured for the optical + parameter, in a particular 15 minute or 24 hour interval." + ::= { cOpticalPMIntervalEntry 6 } + +cOpticalPMIntervalMinParam OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the minimum value measured for the optical + parameter, in a particular 15 minute or 24 hour interval." + ::= { cOpticalPMIntervalEntry 7 } + +cOpticalPMIntervalMeanParam OBJECT-TYPE + SYNTAX OpticalParameterValue + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object gives the average value of the measured optical + parameter, in a particular 15 minute or 24 hour interval." + ::= { cOpticalPMIntervalEntry 8 } + +cOpticalPMIntervalUnavailSecs OBJECT-TYPE + SYNTAX Integer32 (0..86400 ) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This object is used to indicate the number of seconds, + in the particular 15 minute or 24 hour interval, for which the + optical performance data is not accounted for. + + In the receive direction, the performance data could be + unavailable during these periods for multiple reasons + like the interface being administratively down or if there + is a Loss of Light alarm on the interface. In the transmit + direction, performance data could be unavailable when + the laser is shutdown." + ::= { cOpticalPMIntervalEntry 9 } + + +-- Notifications +cOpticalMonitorMIBNotifications OBJECT IDENTIFIER + ::= { ciscoOpticalMonitorMIB 2 } + +cOpticalMonNotificationPrefix OBJECT IDENTIFIER + ::= { cOpticalMonitorMIBNotifications 0 } + + + +cOpticalMonParameterStatus NOTIFICATION-TYPE + OBJECTS { + cOpticalParameterValue, + cOpticalParamAlarmStatus, + cOpticalParamAlarmCurMaxThresh, + cOpticalParamAlarmCurMaxSev, + cOpticalParamAlarmLastChange + } + STATUS current + DESCRIPTION + "This notification is sent when any threshold related to an + optical parameter is exceeded or cleared on an interface. + + This notification may be suppressed under the following + conditions: + - depending on the value of the cOpticalNotifyEnable object, + or + - if the severity of the threshold as specified by + the cOpticalParamHighWarningSev or + cOpticalParamLowWarningSev object is 'notReported'. + " + ::= { cOpticalMonNotificationPrefix 1 } +-- MIB Conformance Statements +cOpticalMonitorMIBConformance OBJECT IDENTIFIER + ::= { ciscoOpticalMonitorMIB 3 } + +cOpticalMonitorMIBCompliances OBJECT IDENTIFIER + ::= { cOpticalMonitorMIBConformance 1 } + +cOpticalMonitorMIBGroups OBJECT IDENTIFIER + ::= { cOpticalMonitorMIBConformance 2 } + + +cOpticalMonitorMIBCompliance MODULE-COMPLIANCE + STATUS deprecated + DESCRIPTION + "The compliance statement for network elements that + monitor optical characteristics and set thresholds on the + optical interfaces in a network element." + MODULE -- this module + MANDATORY-GROUPS { cOpticalMIBMonGroup } + + GROUP cOpticalMIBThresholdGroup + DESCRIPTION + "This group is required for network elements that support + thresholds on optical parameters." + + GROUP cOpticalMIBSeverityGroup + DESCRIPTION + "This group is required for network elements that support + severities for thresholds on optical parameters." + + GROUP cOpticalMIBPMGroup + DESCRIPTION + "This group is required for network elements that + support collection of optical performance monitoring + data for 15 minute or 24 hour intervals." + + GROUP cOpticalMIBNotifyEnableGroup + DESCRIPTION + "This group is required for network elements that + support the cOpticalMIBNotifGroup." + + GROUP cOpticalMIBNotifGroup + DESCRIPTION + "This group is required for network elements that + generate notifications when a threshold is exceeded or + cleared on an interface." + + OBJECT cOpticalParamHighAlarmThresh + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamHighWarningThresh + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamLowAlarmThresh + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamLowWarningThresh + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamHighAlarmSev + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamHighWarningSev + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamLowAlarmSev + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamLowWarningSev + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + ::= { cOpticalMonitorMIBCompliances 1 } + +cOpticalMonitorMIBComplianceRev MODULE-COMPLIANCE + STATUS current + DESCRIPTION + "The compliance statement for network elements that + monitor optical characteristics and set thresholds on the + optical interfaces in a network element." + MODULE -- this module + MANDATORY-GROUPS { cOpticalMIBMonGroup } + + GROUP cOpticalMIBThresholdGroup + DESCRIPTION + "This group is required for network elements that support + thresholds on optical parameters." + + GROUP cOpticalMIBSeverityGroup + DESCRIPTION + "This group is required for network elements that support + severities for thresholds on optical parameters." + + GROUP cOpticalMIBPMGroup + DESCRIPTION + "This group is required for network elements that + support collection of optical performance monitoring + data for 15 minute or 24 hour intervals." + + GROUP cOpticalMonIfTimeGroup + DESCRIPTION + "This group is required for network elements that maintain + time related information for optical transceivers." + + GROUP cOpticalMIBNotifyEnableGroup + DESCRIPTION + "This group is required for network elements that + support the cOpticalMIBNotifGroup." + + GROUP cOpticalMIBNotifGroup + DESCRIPTION + "This group is required for network elements that + generate notifications when a threshold is exceeded or + cleared on an interface." + + GROUP cOpticalMIBEnableConfigGroup + DESCRIPTION + "This group is required for network elements that + are capable of enabling/disabling optical monitoring + functionality." + + GROUP cOpticalMIBIntervalConfigGroup + DESCRIPTION + "This group is mandatory for network elements that + support optical monitoring polling interval + configuration." + + GROUP cOpticalMonThreshSourceGroup + DESCRIPTION + "This group is mandatory for the network elements that + support restoring the optical monitoring threshold + to the default value." + + OBJECT cOpticalParamHighAlarmThresh + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamHighWarningThresh + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamLowAlarmThresh + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamLowWarningThresh + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamHighAlarmSev + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamHighWarningSev + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamLowAlarmSev + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + + OBJECT cOpticalParamLowWarningSev + MIN-ACCESS read-only + DESCRIPTION "Write access is not required." + ::= { cOpticalMonitorMIBCompliances 2 } + +-- Units of Conformance +cOpticalMIBMonGroup OBJECT-GROUP + OBJECTS { cOpticalParameterValue } + STATUS current + DESCRIPTION + "A mandatory object that provides monitoring of optical + characteristics." + ::= { cOpticalMonitorMIBGroups 1 } + +cOpticalMIBThresholdGroup OBJECT-GROUP + OBJECTS { + cOpticalParamHighAlarmThresh, + cOpticalParamHighWarningThresh, + cOpticalParamLowAlarmThresh, + cOpticalParamLowWarningThresh, + cOpticalParamAlarmStatus, + cOpticalParamAlarmCurMaxThresh, + cOpticalParamAlarmLastChange + } + STATUS current + DESCRIPTION + "A collection of objects that support thresholds on optical + parameters and provide status information when the thresholds + are exceeded or cleared." + ::= { cOpticalMonitorMIBGroups 2 } + +cOpticalMIBSeverityGroup OBJECT-GROUP + OBJECTS { + cOpticalParamHighAlarmSev, + cOpticalParamHighWarningSev, + cOpticalParamLowAlarmSev, + cOpticalParamLowWarningSev, + cOpticalParamAlarmCurMaxSev + } + STATUS current + DESCRIPTION + "A collection of objects that support severities for thresholds + on optical parameters." + ::= { cOpticalMonitorMIBGroups 3 } + +cOpticalMIBPMGroup OBJECT-GROUP + OBJECTS { + cOpticalMon15MinValidIntervals, + cOpticalMon24HrValidIntervals, + cOpticalPMCurrentMaxParam, + cOpticalPMCurrentMinParam, + cOpticalPMCurrentMeanParam, + cOpticalPMCurrentUnavailSecs, + cOpticalPMIntervalMaxParam, + cOpticalPMIntervalMinParam, + cOpticalPMIntervalMeanParam, + cOpticalPMIntervalUnavailSecs + } + STATUS current + DESCRIPTION + "A collection of objects that provide optical performance + monitoring data for 15 minute and 24 hour intervals." + ::= { cOpticalMonitorMIBGroups 4 } + +cOpticalMIBNotifyEnableGroup OBJECT-GROUP + OBJECTS { cOpticalNotifyEnable } + STATUS current + DESCRIPTION + "An object to control the generation of notifications." + ::= { cOpticalMonitorMIBGroups 5 } + +cOpticalMIBNotifGroup NOTIFICATION-GROUP + NOTIFICATIONS { cOpticalMonParameterStatus } + STATUS current + DESCRIPTION + "A notification generated when a threshold on an optical + parameter is exceeded or cleared." + ::= { cOpticalMonitorMIBGroups 6 } + +cOpticalMonIfTimeGroup OBJECT-GROUP + OBJECTS { cOpticalMonIfTimeInSlot } + STATUS current + DESCRIPTION + "A collection of object(s) that provide time related information + for transceivers in the system." + ::= { cOpticalMonitorMIBGroups 7 } + +cOpticalMIBEnableConfigGroup OBJECT-GROUP + OBJECTS { cOpticalMonEnable } + STATUS current + DESCRIPTION + "A collection of object(s) to enable/disable optical + monitoring." + ::= { cOpticalMonitorMIBGroups 8 } + +cOpticalMIBIntervalConfigGroup OBJECT-GROUP + OBJECTS { cOpticalMonPollInterval } + STATUS current + DESCRIPTION + "A collection of object(s) to specify polling interval for + monitoring optical transceivers." + ::= { cOpticalMonitorMIBGroups 9 } + +cOpticalMonThreshSourceGroup OBJECT-GROUP + OBJECTS { cOpticalParamThreshSource } + STATUS current + DESCRIPTION + "A collection of object(s) to restore a given threshold + to its default value." + ::= { cOpticalMonitorMIBGroups 10 } + +END |