diff options
Diffstat (limited to 'MIBS/cisco/CISCO-OPTICAL-PATCH-MIB')
| -rw-r--r-- | MIBS/cisco/CISCO-OPTICAL-PATCH-MIB | 587 |
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 |