Initial commitHEADmain

1 files changed, 587 insertions, 0 deletions

diff --git a/MIBS/cisco/CISCO-OPTICAL-PATCH-MIB b/MIBS/cisco/CISCO-OPTICAL-PATCH-MIB
new file mode 100644
index 0000000..d27871e
--- /dev/null
+++ b/MIBS/cisco/CISCO-OPTICAL-PATCH-MIB
@@ -0,0 +1,587 @@
+-- *****************************************************************
+-- CISCO-OPTICAL-PATCH-MIB.my: Cisco optical patch MIB file
+--
+-- March 2002, Suresh Basavarajappa, Mickey Spiegel and Sameer Merchant
+--
+-- Copyright (c) 2001-2002, 2004 by cisco Systems, Inc.
+-- All rights reserved.
+--
+-- *****************************************************************
+
+CISCO-OPTICAL-PATCH-MIB DEFINITIONS ::= BEGIN
+
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE, Integer32,
+    NOTIFICATION-TYPE                                   FROM SNMPv2-SMI
+    RowStatus, TimeStamp, TruthValue                    FROM SNMPv2-TC
+    NOTIFICATION-GROUP, MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF
+    ciscoExperiment                                     FROM CISCO-SMI
+    InterfaceIndex, ifIndex                             FROM IF-MIB;
+
+
+ciscoOpticalPatchMIB MODULE-IDENTITY
+    LAST-UPDATED   "200203180000Z" -- 03/18/2002
+    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 is used to configure and monitor the network
+        element view of optical patches between two ports or 
+        fibers on the same network element.
+
+        It is up to the user to keep the provisioned information that
+        is reflected in this MIB module in sync with the actual patches
+        present between ports or fibers on the network element.
+        Provisioning of a patch does not cause a patch to be inserted;
+        it only informs the network element that a patch has been, or
+        is soon to be, added or removed."
+
+    REVISION  "200203180000Z" -- 03/18/2002
+    DESCRIPTION
+        "This revision adds support for patching one interface to two
+         different interfaces in the receive and transmit directions.
+
+         This revision deprecates the cOPatchInterfaceTable and 
+         replaces it with the new cOPatchIntfTable. This new table
+         includes the cOPatchIntfDirection object along with ifIndex
+         as part of the table index. The cOPatchIntfDirection object
+         identifies whether this interface is patched to another
+         interface within a network element in the receive, transmit
+         or both directions.
+
+         A new object cOPatchDirOnLowIf is added to the cOPatchTable
+         in order to identify the patch direction relative to the
+         interface with low ifIndex."
+
+    REVISION  "200109050000Z"
+    DESCRIPTION
+         "Initial version of this MIB module." 
+
+    ::= { ciscoExperiment 67 }
+
+
+cOPatchMIBObjects     OBJECT IDENTIFIER ::= { ciscoOpticalPatchMIB 1 }
+
+-- MIB Object Definitions
+
+-- Patch Interface Group
+ 
+cOPatchInterfaceTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF COPatchInterfaceEntry
+    MAX-ACCESS  not-accessible
+    STATUS      deprecated
+    DESCRIPTION
+        "This table lists all interfaces that are provisioned to
+        indicate that they are patched to other interfaces on the same
+        network element.  The table is used to find patches that
+        include a particular interface.
+
+        This table is deprecated since it only includes bidirectional
+        patches. The new cOPatchIntfTable includes both unidirectional
+        patches (in the transmit or receive direction) and
+        bidirectional patches."
+    ::= { cOPatchMIBObjects 1 }
+ 
+cOPatchInterfaceEntry OBJECT-TYPE
+    SYNTAX      COPatchInterfaceEntry
+    MAX-ACCESS  not-accessible
+    STATUS      deprecated
+    DESCRIPTION
+        "An entry is created only when an interface is provisioned
+        to indicate that it is patched to another interface on the same
+        network element (i.e. when the associated entry in the
+        cOPatchTable has been created).
+ 
+        An entry is deleted when the interface is removed from a patch,
+        or when the patch is deleted from the cOPatchTable."
+    INDEX       { ifIndex }
+    ::= { cOPatchInterfaceTable 1 }
+ 
+COPatchInterfaceEntry ::=
+    SEQUENCE  {
+        cOPatchIdentifier                Integer32
+    }
+ 
+cOPatchIdentifier OBJECT-TYPE
+    SYNTAX      Integer32 (1..2147483547)
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+        "The value of cOPatchIndex used in the cOPatchTable to identify
+        a patch that includes this interface.  The other interface
+        included in that patch has an entry in this table with the same
+        value of this object, in addition to the entry in the
+        cOPatchTable with this value of cOPatchIndex."
+    ::= { cOPatchInterfaceEntry 1 }
+ 
+ 
+
+-- Patch Group
+
+
+cOPatchIndexNext OBJECT-TYPE
+    SYNTAX      Integer32 (0..2147483647)
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "This object contains an appropriate value to be used for
+        cOPatchIndex when creating entries in the cOPatchTable.  The
+        value 0 indicates that no unassigned entries are available.
+        To obtain the cOPatchIndex value for a new entry, the manager
+        issues a management protocol retrieval operation to obtain the
+        current value of this object.
+        The agent will modify the value to the next unassigned index,
+        when a new row is created in cOPatchTable with the current
+        value of this object. After deletion of a row in cOPatchTable
+        the agent will determine through its local policy when its
+        index value will be made available for reuse."
+    ::= { cOPatchMIBObjects 2 }
+
+cOPatchLastChange  OBJECT-TYPE
+    SYNTAX      TimeStamp
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "The value of sysUpTime at the time of the last
+        creation, deletion or modification of an entry
+        in the cOPatchTable. If the cOPatchTable entries has been
+        unchanged since the last re-initialization of the local
+        network management subsystem, then this object contains a
+        zero value."
+    ::= { cOPatchMIBObjects 3 }
+ 
+cOPatchEventType OBJECT-TYPE
+    SYNTAX      INTEGER {
+                    create(1),
+                    delete(2),
+                    modify(3)
+                 }
+    MAX-ACCESS  accessible-for-notify
+--  MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "The event type of the patch.  The use is as follows:
+            create(1)
+                The value of this object when cOPatchEvent is generated
+                 upon creation of a patch.
+            delete(2)
+                The value of this object when cOPatchEvent is generated
+                 upon deletion of a patch.
+            modify(3)
+                The value of this object when cOPatchEvent is generated
+                 upon modification of a patch."
+    ::= { cOPatchMIBObjects 4 }
+
+cOPatchTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF COPatchEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "This table contains the network element view of optical patches
+        between two interfaces on the same network element.
+
+        It is up to the user to keep the provisioned information that
+        is reflected in this table in sync with the actual patches
+        present between interfaces on the network element.
+        Provisioning of a patch in this table does not cause a patch to
+        be inserted; it only informs the network element that a patch
+        has been, or is soon to be, added or removed.
+
+        Each entry in the table models a unidirectional or
+        bidirectional patch between two interfaces on the same
+        network element. When one interface is patched to two
+        different interfaces, one in the receive direction and
+        the other in the transmit direction, the interface will
+        appear in two different entries in the table.
+
+        The terms low and high are chosen to represent numerical
+        ordering of the two interfaces associated with a patch.  That
+        is, the interface with the lower value of ifIndex is termed
+        'low', while the other interface associated with the patch is
+        termed 'high'."
+    ::= { cOPatchMIBObjects 5 }
+
+cOPatchEntry OBJECT-TYPE
+    SYNTAX      COPatchEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "This entry is used to model a unidirectional or
+        bidirectional patch between two interfaces on the same
+        network element. 
+
+        An entry is created when the network element is provisioned to
+        indicate that two interfaces on the network element have been
+        patched together using an optical patch cord.
+
+        Prior to creating an entry in the table, the manager should
+        obtain a unique value of cOPatchIndex by reading the
+        cOPatchIndexNext object.  When an entry in the table is
+        created, the cOPatchIntfPatchId values in the corresponding
+        cOPatchIntfTable rows are filled in by the agent."
+    INDEX       { cOPatchIndex }
+    ::= { cOPatchTable 1 }
+
+COPatchEntry ::=
+    SEQUENCE  {
+        cOPatchIndex            Integer32,
+        cOPatchLowIfIndex       InterfaceIndex,
+        cOPatchHighIfIndex      InterfaceIndex,
+        cOPatchType             INTEGER,
+        cOPatchStatus           INTEGER,
+        cOPatchCreationTime     TimeStamp,
+        cOPatchRowStatus        RowStatus,
+        cOPatchDirOnLowIf       INTEGER
+    }
+
+cOPatchIndex OBJECT-TYPE
+    SYNTAX      Integer32 (1..2147483647)
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A unique value used to identify this patch.  For each
+        interface associated with this patch, the agent reports this
+        patch index value in the cOPatchIntfPatchId object of the
+        corresponding cOPatchIntfTable entries.
+        When the value of this index is equal to the current value
+        of cOPatchIndexNext, the agent will modify the value of
+        cOPatchIndexNext to the next unassigned index."
+    ::= { cOPatchEntry 1 }
+
+cOPatchLowIfIndex OBJECT-TYPE
+    SYNTAX      InterfaceIndex
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The value of this object is equal to MIB II's ifIndex value of
+        the interface for this patch.  The term low implies that this
+        interface has the numerically lower ifIndex value than the
+        other interface identified in the same cOPatchEntry.
+        The value of this object is specified during row creation,
+        and can never be changed."
+    ::= { cOPatchEntry 2 }
+
+cOPatchHighIfIndex OBJECT-TYPE
+    SYNTAX      InterfaceIndex
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The value of this object is equal to MIB II's ifIndex value of
+        the interface for this patch.  The term high implies that this
+        interface has the numerically higher ifIndex value than the
+        other interface identified in the same cOPatchEntry.
+        The value of this object is specified during row creation,
+        and can never be changed."
+    ::= { cOPatchEntry 3 }
+
+cOPatchType OBJECT-TYPE
+    SYNTAX      INTEGER {
+                    provisioned(1),
+                    automatic(2),
+                    other(3)
+                }
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "The creation type of the patch.  The use is as follows:
+            provisioned(1)
+                Provisioned by the user or by a management system
+                using the Command Line Interface, SNMP, or other
+                means of management access to the network element.
+            automatic(2)
+                Created automatically by the network element, without
+                user or management intervention.  In particular, this
+                is used to represent fixed patches due to the presence
+                of entities such as optical backplanes."
+    ::= { cOPatchEntry 4 }
+
+cOPatchStatus OBJECT-TYPE
+    SYNTAX      INTEGER {
+                    noError(1),
+                    otherError(2),
+                    interfaceError(3),
+                    interfaceChannelError(4)
+                }
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "This object indicates the error status of the patch.
+        The use is as follows:
+            noError(1)
+                This value indicates a patch with no error.
+            otherError(2)
+                This value indicates an unknown patch error.
+            interfaceError(3)
+                This value indicates one or both interfaces are of
+                the wrong type for a patch or the two interfaces
+                are not supposed to be patched together.
+            interfaceChannelError(4)
+                This value indicates the frequency channel of the
+                two interfaces in this patch entry do not match."
+    ::= { cOPatchEntry 5 }
+
+cOPatchCreationTime OBJECT-TYPE
+    SYNTAX      TimeStamp
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "The value of MIB II's sysUpTime object at the time this
+        patch was created.  If the current state was
+        entered prior to the last re-initialization of the agent then
+        this object contains a zero value."
+    ::= { cOPatchEntry 6 }
+
+cOPatchRowStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The status of this entry in the cOPatchTable.  This object is
+        used to create an entry indicating that two interfaces on the
+        network element have been patched together, or to modify or
+        delete an existing entry."
+    ::= { cOPatchEntry 7 }
+
+cOPatchDirOnLowIf OBJECT-TYPE
+    SYNTAX      INTEGER { 
+                    lowIfDirReceive(1), 
+                    lowIfDirTransmit(2), 
+                    lowIfDirBoth(3) 
+                } 
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "In case of an optical interface where the transmitted
+        and received signals travel on two different strands of
+        fiber, it is possible that each fiber is patched to a
+        different interface.  This object identifies the patch
+        direction for this entry relative to the interface with
+        low ifIndex.
+
+        The direction in which the interface with high ifIndex
+        is patched can be deduced based on this object value.
+        If the interface with low ifIndex is patched in the
+        receive direction, the associated high interface has to
+        be patched in the transmit direction and vice versa. If
+        the low interface is patched in both directions, the
+        same should hold true on the interface with high
+        ifIndex.
+        "
+    DEFVAL { lowIfDirBoth }
+    ::= { cOPatchEntry 8 }
+
+cOPatchEventEnabled OBJECT-TYPE
+        SYNTAX        TruthValue
+        MAX-ACCESS    read-write
+        STATUS        current
+        DESCRIPTION
+            "Notifications that a patch between two interfaces is
+            created, modified or deleted are enabled if this value
+            is set to 'true'."
+        DEFVAL { false }
+        ::= { cOPatchMIBObjects 6 }
+
+-- End of cOPatchTable
+
+-- New Patch Interface Group
+
+cOPatchIntfTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF COPatchIntfEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "This table lists all interfaces that are provisioned to
+        indicate that they are patched to other interfaces on the same
+        network element.  The table is used to find patches that
+        include a particular interface. 
+
+        An interface can be patched to another interface in the
+        receive direction, the transmit direction or both
+        directions. The cOPatchIntfDirection object identifies
+        the direction."
+    ::= { cOPatchMIBObjects 7 }
+ 
+cOPatchIntfEntry OBJECT-TYPE
+    SYNTAX      COPatchIntfEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "An entry is created only when an interface is provisioned
+        to indicate that it is patched to another interface on the same
+        network element (i.e. when the associated entry in the
+        cOPatchTable has been created).
+ 
+        An entry is deleted when the interface is removed from a patch,
+        or when the patch is deleted from the cOPatchTable."
+    INDEX    { ifIndex, cOPatchIntfDirection }
+    ::= { cOPatchIntfTable 1 }
+ 
+COPatchIntfEntry ::=
+    SEQUENCE  {
+        cOPatchIntfDirection             INTEGER,
+        cOPatchIntfPatchId              Integer32
+    }
+ 
+cOPatchIntfDirection OBJECT-TYPE
+    SYNTAX      INTEGER { receive(1), 
+                          transmit(2), 
+                          both(3) 
+                } 
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "In case of an optical interface where the transmitted
+        and received signals travel on two different strands of
+        fiber, it is possible that each fiber is patched to a
+        different interface.  For example, the transmit and
+        receive fibers of this interface may have unidirectional
+        connections to different optical amplifiers.
+
+        This object indicates whether this entry describes a
+        patch in the receive direction, the transmit direction
+        or both directions. If both the transmit and receive
+        fibers of this interface are patched to the same
+        interface, then this object is set to 'both'. Individual
+        entries for 'transmit' and 'receive' should not be
+        created in this case."
+    ::= { cOPatchIntfEntry 1 }
+
+cOPatchIntfPatchId  OBJECT-TYPE
+    SYNTAX      Integer32 (1..2147483547)
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "The value of cOPatchIndex used in the cOPatchTable to identify
+         a patch that includes this interface.  The other interface
+         included in that patch has an entry in this table with the same
+         value of this object, in addition to the entry in the
+         cOPatchTable with this value of cOPatchIndex."
+    ::= { cOPatchIntfEntry 2 }
+
+-- End of New Patch Interface Group
+
+-- Notifications
+
+cOPatchMIBNotifications OBJECT IDENTIFIER ::= { ciscoOpticalPatchMIB 2 }
+
+cOPatchEvent NOTIFICATION-TYPE
+   OBJECTS { cOPatchLowIfIndex,
+             cOPatchHighIfIndex,
+             cOPatchType,
+             cOPatchStatus,
+             cOPatchEventType }
+   STATUS   current
+   DESCRIPTION
+       "This notification is generated when ever a patch
+       is created, modified or deleted."
+   ::= { cOPatchMIBNotifications 1 }
+
+
+-- End of notifications
+
+-- Conformance
+
+cOPatchMIBConformance OBJECT IDENTIFIER ::= { ciscoOpticalPatchMIB 3 }
+
+cOPatchMIBCompliances OBJECT IDENTIFIER ::= { cOPatchMIBConformance 1 }
+cOPatchMIBGroups      OBJECT IDENTIFIER ::= { cOPatchMIBConformance 2 }
+
+
+-- Compliance
+
+cOPatchMIBCompliance MODULE-COMPLIANCE
+        STATUS deprecated
+        DESCRIPTION
+                "The compliance statement for entities which implement
+                the Cisco Patch MIB"
+        MODULE        -- this module
+                MANDATORY-GROUPS { cOPatchInterfaceGroup,
+                                   cOPatchGroup,
+                                   cOPatchNotifyGroup }
+        ::= { cOPatchMIBCompliances 1 }
+
+cOPatchMIBCompliance1 MODULE-COMPLIANCE
+        STATUS current
+        DESCRIPTION
+                "The compliance statement for entities which implement
+                the Cisco Patch MIB"
+        MODULE        -- this module
+                MANDATORY-GROUPS { cOPatchIntfGroup,
+                                   cOPatchGroup1,
+                                   cOPatchNotifyGroup }
+        ::= { cOPatchMIBCompliances 2 }
+
+-- Units of Conformance
+
+cOPatchInterfaceGroup OBJECT-GROUP
+        OBJECTS { cOPatchIdentifier
+        }
+        STATUS deprecated
+        DESCRIPTION
+                "Object needed to implement Interfaces with
+                 Patches."
+        ::= { cOPatchMIBGroups 1 }
+ 
+cOPatchGroup  OBJECT-GROUP
+        OBJECTS { cOPatchIndexNext,
+                  cOPatchLastChange,
+                  cOPatchEventType,
+                  cOPatchEventEnabled,
+                  cOPatchLowIfIndex,
+                  cOPatchHighIfIndex,
+                  cOPatchType,
+                  cOPatchStatus,
+                  cOPatchCreationTime,
+                  cOPatchRowStatus
+        }
+        STATUS deprecated
+        DESCRIPTION
+            "Collection of objects needed to implement
+             Patches."
+        ::= { cOPatchMIBGroups 2 }
+
+cOPatchNotifyGroup NOTIFICATION-GROUP
+         NOTIFICATIONS { cOPatchEvent }
+         STATUS current
+         DESCRIPTION
+             "Patch error notifications."
+         ::= { cOPatchMIBGroups 3 }
+
+cOPatchIntfGroup OBJECT-GROUP
+        OBJECTS { cOPatchIntfPatchId
+        }
+        STATUS current
+        DESCRIPTION
+                "Object needed to implement Interfaces with
+                 Patches."
+        ::= { cOPatchMIBGroups 4 }
+ 
+cOPatchGroup1  OBJECT-GROUP
+        OBJECTS { cOPatchIndexNext,
+                  cOPatchLastChange,
+                  cOPatchEventType,
+                  cOPatchEventEnabled,
+                  cOPatchLowIfIndex,
+                  cOPatchHighIfIndex,
+                  cOPatchType,
+                  cOPatchStatus,
+                  cOPatchCreationTime,
+                  cOPatchRowStatus,
+                  cOPatchDirOnLowIf
+        }
+        STATUS current
+        DESCRIPTION
+            "Collection of objects needed to implement
+             Patches in transmit, receive or both directions."
+        ::= { cOPatchMIBGroups 5 }
+
+-- End of CISCO-PATCH-MIB
+END