Initial commitHEADmain

1 files changed, 240 insertions, 0 deletions

diff --git a/MIBS/cisco/CISCO-VOA-MIB b/MIBS/cisco/CISCO-VOA-MIB
new file mode 100644
index 0000000..6a49fc3
--- /dev/null
+++ b/MIBS/cisco/CISCO-VOA-MIB
@@ -0,0 +1,240 @@
+-- *****************************************************************
+-- CISCO-VOA-MIB.my
+--
+-- May 2002, Sonal Maheshwari, Mickey Spiegel
+--
+-- Copyright (c) 2002 by cisco Systems, Inc.
+-- All rights reserved.
+-- *****************************************************************
+
+CISCO-VOA-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE, 
+    Integer32                           FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION,             
+    TimeStamp                           FROM SNMPv2-TC
+    MODULE-COMPLIANCE,
+    OBJECT-GROUP                        FROM SNMPv2-CONF
+    ifIndex                             FROM IF-MIB
+    OpticalIfDirection                  FROM CISCO-OPTICAL-MONITOR-MIB
+    ciscoMgmt                           FROM CISCO-SMI
+;
+
+ciscoVoaMIB MODULE-IDENTITY
+    LAST-UPDATED   "200205070000Z"
+    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 configure and manage the
+        Variable Optical Attenuator (VOA) modules.
+
+        VOA modules are typically used to attenuate channels added
+        by a network element, in order to equalize the input power of
+        each wavelength before the multiplexed signal consisting of
+        all wavelengths is sent through an EDFA.  There may be
+        a separate VOA per channel, one VOA per band of wavelengths,
+        or one VOA for the pass through wavelengths.
+
+        VOA modules are also often used before terminating optical
+        wavelengths at optical receivers, in order to avoid receiver
+        saturation.
+
+        The VOAs may be present on various modules within the network
+        element, for example, on an Optical Add/Drop Multiplexer
+        (OADM) module, on the same module as an optical transceiver,
+        or on a separate module of its own.
+        "
+        REVISION   "200205070000Z"
+        DESCRIPTION
+            "The initial revision of this MIB."
+    ::= { ciscoMgmt 262 }
+
+
+-- Textual Conventions
+
+OpticalPowerInDbm ::= TEXTUAL-CONVENTION
+    STATUS    current
+    DESCRIPTION
+        "An integer value that gives the optical power level in 1/10ths
+        of dBm.
+        Example: The value -300 represents a power level of -30.0 dBm.
+
+        The distinguished value of '-1000' indicates that the object
+        has not yet been initialized.
+        "
+    SYNTAX    Integer32 ( -400..250 | -1000 )
+
+
+OpticalAttenInDb ::= TEXTUAL-CONVENTION
+    STATUS    current
+    DESCRIPTION
+        "An integer value that gives the attenuation level in
+        1/10ths of dB. 
+        Example: The value 80 represents an attenuation
+        level of 8.0 dB.
+        "
+    SYNTAX    Integer32 (0..400)
+
+
+-- MIB Object Definitions
+
+cVoaMIBObjects    OBJECT IDENTIFIER ::= { ciscoVoaMIB 1 }
+
+-- groups in this MIB module
+
+cVoaBaseGroup           OBJECT IDENTIFIER ::= { cVoaMIBObjects 1 }
+
+-- VOA basic objects
+
+cVoaTable OBJECT-TYPE
+    SYNTAX        SEQUENCE OF CVoaEntry
+    MAX-ACCESS    not-accessible
+    STATUS        current
+    DESCRIPTION
+        "This table provides objects to configure and control the 
+        attenuation on VOAs."
+    ::={ cVoaBaseGroup 1 }
+
+cVoaEntry OBJECT-TYPE
+    SYNTAX        CVoaEntry
+    MAX-ACCESS    not-accessible
+    STATUS        current
+    DESCRIPTION
+        "An entry in the cVoaTable provides objects to configure and
+        control the attenuation level of a VOA at an interface, for
+        a given direction."
+    INDEX    { ifIndex, cVoaDirection } 
+    ::={ cVoaTable 1 }
+
+CVoaEntry ::= SEQUENCE {
+    cVoaDirection                 OpticalIfDirection,
+    cVoaAttenuationControlMode    INTEGER,
+    cVoaAttenuation               OpticalAttenInDb,
+    cVoaAttenuationLastChange     TimeStamp,
+    cVoaDesiredPower              OpticalPowerInDbm
+}
+
+cVoaDirection OBJECT-TYPE
+    SYNTAX        OpticalIfDirection 
+    MAX-ACCESS    not-accessible
+    STATUS        current
+    DESCRIPTION
+        "This is the second index into the cVoaTable and indicates
+        the direction for which the attenuation level at this
+        interface is being controlled, in this entry."
+    ::={ cVoaEntry 1 }
+
+cVoaAttenuationControlMode OBJECT-TYPE
+    SYNTAX        INTEGER {
+                      manual(1),
+                      automatic(2)
+                  }
+    MAX-ACCESS    read-write
+    STATUS        current
+    DESCRIPTION
+        "This object is used to set the mode of controlling the
+        attenuation level of a VOA at an interface.
+
+        When the mode is set to 'manual', the attenuation level is
+        configured manually, by setting the desired attenuation
+        level in the cVoaAttenuation object. The cVoaDesiredPower
+        object does not apply in this case.
+
+        When the mode is set to 'automatic', the attenuation level
+        is continuously adjusted to maintain a desired power level,
+        after attenuation. The desired optical power level after
+        attenuation is configured using the cVoaDesiredPower object.
+        The cVoaAttenuation object cannot be configured in this case,
+        but it indicates the attenuation level derived from the
+        desired power level.
+
+        The automatic mode of controlling attenuation should not be
+        used when the monitored power level includes multiple
+        wavelengths, since the power level monitor cannot distinguish
+        between a decrease in power across all wavelengths, versus a
+        loss of power of some but not all wavelengths. If some but not
+        all wavelengths go down, this would cause the attenuation level
+        to be automatically decreased, leading to an increase in the
+        power level of the remaining wavelengths."
+    ::={ cVoaEntry 2 }
+
+cVoaAttenuation OBJECT-TYPE
+    SYNTAX        OpticalAttenInDb
+    MAX-ACCESS    read-write
+    STATUS        current
+    DESCRIPTION
+        "This object indicates the attenuation level applied at the
+        interface.
+
+        When the cVoaAttenuationControlMode object is set to 'manual', 
+        the attenuation level may be specified by setting this object."
+    ::={ cVoaEntry 3 }
+
+cVoaAttenuationLastChange OBJECT-TYPE
+    SYNTAX        TimeStamp
+    MAX-ACCESS    read-only
+    STATUS        current
+    DESCRIPTION
+        "This object indicates the value of sysUpTime at the last
+        time the attenuation level was adjusted at this interface,
+        in the given direction."
+    ::={ cVoaEntry 4 }
+
+cVoaDesiredPower OBJECT-TYPE
+    SYNTAX        OpticalPowerInDbm
+    MAX-ACCESS    read-write
+    STATUS        current
+    DESCRIPTION
+        "This object indicates the desired optical power level,
+        after attenuation, at the interface. 
+
+        This object applies only when the cVoaAttenuationControlMode
+        object is set to 'automatic'. In this mode, the attenuation
+        level is continuously adjusted to maintain the desired 
+        power level, after attenuation, as specified by this object."
+    ::={ cVoaEntry 5 }
+
+
+-- MIB Conformance Statements
+
+cVoaMIBConformance    OBJECT IDENTIFIER ::= { ciscoVoaMIB 3 }
+
+cVoaMIBCompliances    OBJECT IDENTIFIER ::= { cVoaMIBConformance 1 }
+
+cVoaMIBGroups         OBJECT IDENTIFIER ::= { cVoaMIBConformance 2 }
+
+cVoaMIBCompliance MODULE-COMPLIANCE
+    STATUS    current
+    DESCRIPTION
+        "The compliance statement for platforms that provide
+        configuration and control of VOA modules."
+    MODULE    -- this module
+    MANDATORY-GROUPS { cVoaMIBBaseGroup }
+
+    ::={ cVoaMIBCompliances 1 }
+
+-- Units of Conformance
+
+cVoaMIBBaseGroup OBJECT-GROUP
+    OBJECTS {
+        cVoaAttenuationControlMode,
+        cVoaAttenuation,
+        cVoaAttenuationLastChange,
+        cVoaDesiredPower          
+    }
+    STATUS  current
+    DESCRIPTION
+        "A collection of mandatory managed objects that provide basic
+        configuration and control of the VOA modules."
+    ::={ cVoaMIBGroups 1 }
+
+END