-- extracted from draft-ietf-hubmib-efm-mib-00.txt -- at Tue Feb 3 06:16:35 2004 EFM-COMMON-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, mib-2, OBJECT-TYPE, Counter32, Unsigned32, Integer32 FROM SNMPv2-SMI TEXTUAL-CONVENTION, RowStatus, MacAddress FROM SNMPv2-TC ifIndex FROM IF-MIB MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF; efmCommonMIB MODULE-IDENTITY LAST-UPDATED "200402010000Z" -- February 1, 2004" ORGANIZATION "IETF Ethernet Interfaces and Hub MIB Working Group" CONTACT-INFO " WG Charter: http://www.ietf.org/html.charters/hubmib-charter.html Mailing lists: General Discussion: hubmib@ietf.org To Subscribe: hubmib-requests@ietf.org In Body: subscribe your_email_address Chair: Dan Romascanu Avaya Tel: +972-3-645-8414 Email: dromasca@avaya.com Editor: Matt Squire Hatteras Networks Tel: +1-919-991-5460 Fax: +1-919-991-0743 E-mail: msquire@hatterasnetworks.com " DESCRIPTION "The MIB module for managing the new common Ethernet features introduced by the Ethernet in the First Mile task force (IEEE P802.3ah). The functionality presented here is based on IEEE P802.3ah/D3.0 [802.3ah], released in December 2003. In particular, this MIB focused on the changes to Clause 30 of the draft that are not specific to any physical layer. These changes are primarily reflected in the new OAM features developed under this project, that can be applied to any Ethernet like interface. The OAM features are described in Clause 57 of [802.3ah]. The following reference is used throughout this MIB module: [802.3ah] refers to: IEEE Draft P802.3ah/D3.0: 'Draft amendment to - Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks - Specific requirements - Part 3: Carrier sense multiple access with collision detection (CSMA/CD) access method and physical layer specifications - Media Access Control Parameters, Physical Layers and Management Parameters for subscriber access networks', 05 December 2003. -- Editor's note - update this to normative -- reference when finalized Copyright (c) The Internet Society (2004). This version of this MIB module is part of RFC XXXX; See the RFC itself for full legal notices. " -- RFC Editor: Update XXXX to appropriate RFC number -- RFC Editor: Remote these notes REVISION "200402010000Z" -- February 3, 2004" DESCRIPTION "Initial version, published as RFC XXXX." -- RFC Editor: Update XXXX to appropriate RFC number -- RFC Editor: Remote these notes ::= { mib-2 XXX } -- RFC Editor: Replace value with IANA assigned number -- RFC Editor: Remove these notes -- -- Sections of the EFM Common MIB -- dot3OamMIB OBJECT IDENTIFIER ::= { efmCommonMIB 1} -- Editor's Note: If only OAM content in this MIB, it -- may be worthwhile to eliminate the Common -- nomenclature and make this OAM only. dot3OamConformance OBJECT IDENTIFIER ::= { efmCommonMIB 2 } -- -- Textual conventions -- Dot3Oui ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "24-bit Organizationally Unique Identifier. Information on OUIs can be found in IEEE 802-2001 [802-2001] Clause 9." -- Editors Note - Include reference for [802-2001] SYNTAX OCTET STRING(SIZE(3)) -- -- Ethernet OAM Control group -- dot3OamTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot3OamEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Primary controls and status for the OAM capabilities of an Ethernet like interface. There will be one row in this table for each Ethernet-like interface in the system that supports the Ethernet OAM functions defined in [802.3ah]." ::= { dot3OamMIB 1 } dot3OamEntry OBJECT-TYPE SYNTAX Dot3OamEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the table, containing information on the Ethernet OAM function for a single Ethernet-like interface." INDEX { ifIndex } ::= { dot3OamTable 1 } Dot3OamEntry ::= SEQUENCE { dot3OamRowStatus RowStatus, dot3OamAdminState INTEGER, dot3OamOperStatus INTEGER, dot3OamMode INTEGER, dot3OamMaxOamPduSize Integer32, dot3OamConfigRevision Unsigned32, dot3OamFunctionsSupported BITS } dot3OamRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "Row creation is automatic for each Ethernet- like interface that supports OAM functionality as defined in [802.3ah]. Note that implementation of OAM is not required for any Ethernet like interface. " REFERENCE "[802.3ah], 57.1.2 point d.1" ::= { dot3OamEntry 1} dot3OamAdminState OBJECT-TYPE SYNTAX INTEGER { disabled(1), enabled(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "This object is used to configure the default administrative OAM mode for this interface. This object represents the administratively configured OAM state for this interface." REFERENCE "[802.3ah], 30.11.1.1.2" ::= { dot3OamEntry 2 } dot3OamOperStatus OBJECT-TYPE SYNTAX INTEGER { disabled(1), passiveWait(2), activeSendLocal(3), sendLocalAndRemote1(4), sendLocalAndRemote2(5), oamPeeringLocallyRejected(6), oamPeeringRemotelyRejected(7), operational(8) } MAX-ACCESS read-only STATUS current DESCRIPTION "At initialization and failure conditions, OAM entities on the same Ethernet link begin a discovery phase to determine what OAM capabilities maybe used on that link. The progress of this initialization is controlled by the OAM sublayer. This value is always 'disabled' if OAM is disabled via the dot3OamAdminState. The 'passiveWait' state is returned only by OAM entities in passive mode (dot3OamMode) and reflects the state in which the OAM entity is waiting to see if the peer device is OAM capable. The 'activeSendLocal' is used by active mode devices (dot3OamMode) and reflects the OAM entity actively trying to discover whether the peer has OAM ability but has not yet made that determination. The state 'sendLocalAndRemote1' reflects that the local OAM entity has discovered the peer but has not yet accepted or rejected the configuration of the peer. The local device can, for whatever reason, decide that the peer device is unacceptable and decline OAM peering. If the local OAM entity rejects the peer OAM entity, the state becomes 'oamPeeringLocallyRejected'. If the OAM peering is allowed by the local device, the state moves to 'sendLocalAndRemote2'. Note that both the 'sendLocalAndRemote1' and 'oamPeeringLocallyRejected' states fall within the state SEND_LOCAL_REMOTE_1 of the Discovery state diagram [802.3ah, Figure 57-5], with the difference being whether the local OAM client has rejected the peering or just not decided yet. If the remote OAM entity rejects the peering, the state becomes 'oamPeeringRemotelyRejected'. Note that both the 'sendLocalAndRemote2' and 'oamPeeringRemotelyRejected' states fall within the state SEND_LOCAL_REMOTE_2 of the Discovery state diagram [802.3ah, Figure 57-5], with the difference being whether the remote OAM client has rejected the peering or has just not yet decided. When the local OAM entity learns that both it and the remote OAM entity have accepted the peering, the state moves to 'operational'. " REFERENCE "[802.3ah], REFERENCE TBD" ::= { dot3OamEntry 3 } -- Editor's Note: No C30 attribute in D3.0, should appear in D3.1 dot3OamMode OBJECT-TYPE SYNTAX INTEGER { active(1), passive(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "This object configures the mode of OAM operation for this Ethernet like interface. OAM on Ethernet interfaces may be in 'active' mode or 'passive' mode. These two modes differ in that active mode provides additional capabilities to initiate monitoring activities with the remote OAM peer entity, while passive mode generally waits for the peer to initiate OAM actions with it. As an example, an active OAM entity can put the remote OAM entity in a loopback state, where a passive OAM entity cannot. " REFERENCE "[802.3ah], 30.11.1.1.3" ::= { dot3OamEntry 4 } dot3OamMaxOamPduSize OBJECT-TYPE SYNTAX Integer32 (64..1522) MAX-ACCESS read-only STATUS current DESCRIPTION "The largest OAMPDU that the OAM entity supports. OAM entities exchange maximum OAMPDU sizes and negotiate to use the smaller of the two maximum OAMPDU sizes between the peers. " REFERENCE "[802.3ah], REFERENCE TBD" ::= { dot3OamEntry 5 } -- Editor's Note: No C30 attribute in D3.0, should appear in D3.1 dot3OamConfigRevision OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The configuration revision of the OAM entity as reflected in the latest OAMPDU sent by the OAM entity. The config revision is used by OAM entities to indicate configuration changes have occured which might require the peer OAM entity to re-evaluate whether the peering is allowed. See local_satisfied in [802.3ah, 57.3.1.2]. " REFERENCE "[802.3ah], REFERENCE TBD" ::= { dot3OamEntry 6 } -- Editor's Note: No C30 attribute in D3.0, should appear in D3.1 dot3OamFunctionsSupported OBJECT-TYPE SYNTAX BITS { unidirectionalSupport (0), loopbackSupport(1), eventSupport(2), variableSupport(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "The OAM functions supported on this Ethernet- like interface. OAM consists of separate functionality sets above the basic discovery process. These functional groups can be supported independently, and each is an optional cability above the basic discovery function. " REFERENCE "[802.3ah], REFERENCE TBD" ::= { dot3OamEntry 7 } -- Editor's Note: No C30 attribute in D3.0, should appear in D3.1 -- -- Ethernet OAM Statistics group -- dot3OamStatsTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot3OamStatsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Statistics for the OAM function on a particular Ethernet like interface." ::= { dot3OamMIB 2 } dot3OamStatsEntry OBJECT-TYPE SYNTAX Dot3OamStatsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the table, containing statistics information on the Ethernet OAM function for a single Ethernet-like interface." INDEX { ifIndex } ::= { dot3OamStatsTable 1 } Dot3OamStatsEntry ::= SEQUENCE { dot3OamPduTx Counter32, dot3OamPduRx Counter32, dot3OamInformationTx Counter32, dot3OamInformationRx Counter32, dot3OamEventNotificationTx Counter32, -- Editor's Note - This may change in D3.1 dot3OamUniqueEventNotificationRx Counter32, dot3OamDuplicateEventNotificationRx Counter32, dot3OamLoopbackControlTx Counter32, dot3OamLoopbackControlRx Counter32, dot3OamVariableRequestTx Counter32, dot3OamVariableRequestRx Counter32, dot3OamVariableResponseTx Counter32, dot3OamVariableResponseRx Counter32, dot3OamOrgSpecificTx Counter32, dot3OamOrgSpecificRx Counter32, dot3OamUnsupportedCodesRx Counter32 } dot3OamPduTx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Ethernet OAM frames transmitted on this interface." REFERENCE "[802.3ah], 30.11.1.1.14." ::= { dot3OamStatsEntry 1 } dot3OamPduRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Ethernet OAM frames received on this interface." REFERENCE "[802.3ah], 30.11.1.1.15." ::= { dot3OamStatsEntry 2 } dot3OamInformationTx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Information OAMPDUs transmitted on this interface." REFERENCE "[802.3ah], 30.11.1.1.17." ::= { dot3OamStatsEntry 3 } dot3OamInformationRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Information OAMPDUs received on this interface." REFERENCE "[802.3ah], 30.11.1.1.18." ::= { dot3OamStatsEntry 4 } dot3OamEventNotificationTx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Event OAMPDUs transmitted on this interface." REFERENCE "[802.3ah], 30.11.1.1.19." ::= { dot3OamStatsEntry 5 } dot3OamUniqueEventNotificationRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of unique Event OAMPDUs received on this interface." REFERENCE "[802.3ah], 30.11.1.1.20." ::= { dot3OamStatsEntry 6 } dot3OamDuplicateEventNotificationRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of duplicate Event OAMPDUs received on this interface." REFERENCE "[802.3ah], 30.11.1.1.21." ::= { dot3OamStatsEntry 7 } dot3OamLoopbackControlTx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Loopback OAMPDUs transmitted on this interface." REFERENCE "[802.3ah], 30.11.1.1.22." ::= { dot3OamStatsEntry 8 } dot3OamLoopbackControlRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Loopback OAMPDUs received on this interface." REFERENCE "[802.3ah], 30.11.1.1.23." ::= { dot3OamStatsEntry 9 } dot3OamVariableRequestTx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Variable Request OAMPDUs transmitted on this interface." REFERENCE "[802.3ah], 30.11.1.1.24." ::= { dot3OamStatsEntry 10 } dot3OamVariableRequestRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Variable Request OAMPDUs received on this interface." REFERENCE "[802.3ah], 30.11.1.1.25." ::= { dot3OamStatsEntry 11 } dot3OamVariableResponseTx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Variable Response OAMPDUs transmitted on this interface." REFERENCE "[802.3ah], 30.11.1.1.26." ::= { dot3OamStatsEntry 12 } dot3OamVariableResponseRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Variable Response OAMPDUs received on this interface." REFERENCE "[802.3ah], 30.11.1.1.27." ::= { dot3OamStatsEntry 13 } dot3OamOrgSpecificTx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Organizational Specific OAMPDUs transmitted on this interface." REFERENCE "[802.3ah], 30.11.1.1.28." ::= { dot3OamStatsEntry 14 } dot3OamOrgSpecificRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of Organizational Specific OAMPDUs received on this interface." REFERENCE "[802.3ah], 30.11.1.1.29." ::= { dot3OamStatsEntry 15 } dot3OamUnsupportedCodesRx OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A count of the number of OAMPDUs with an unrecognized type received on this interface." REFERENCE "[802.3ah], 30.11.1.1.16." ::= { dot3OamStatsEntry 16 } -- -- Ethernet OAM Peer group -- dot3OamPeerTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot3OamPeerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information about the OAM peer for a particular Ethernet like interface." ::= { dot3OamMIB 3 } dot3OamPeerEntry OBJECT-TYPE SYNTAX Dot3OamPeerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the table, containing information on the peer OAM entity for a single Ethernet like interface. " INDEX { ifIndex } ::= { dot3OamPeerTable 1 } Dot3OamPeerEntry ::= SEQUENCE { dot3OamPeerRowStatus RowStatus, dot3OamPeerMacAddress MacAddress, dot3OamPeerVendorOui Dot3Oui, dot3OamPeerVendorInfo Unsigned32, dot3OamPeerMode INTEGER, dot3OamPeerMaxOamPduSize Integer32, dot3OamPeerConfigRevision Unsigned32, dot3OamPeerFunctionsSupported BITS, dot3OamPeerMultiplexorState INTEGER, dot3OamPeerParserState INTEGER } dot3OamPeerRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The peer row is automatically created when the dot3OamOperStatus of this particular Ethernet interface is not 'disabled', 'passiveWait' or 'activeSendLocal'. In such cases, the remote OAM entity has been identified and its information and status can be made available. This row is automatically deleted if the dot3OamOperStatus changes to 'disabled', 'passiveWait', or 'activeSendLocal'. " REFERENCE "N/A" ::= { dot3OamPeerEntry 1} dot3OamPeerMacAddress OBJECT-TYPE SYNTAX MacAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The MAC address of the peer OAM entity. " REFERENCE "[802.3ah], 30.11.1.1.4." ::= { dot3OamPeerEntry 2 } dot3OamPeerVendorOui OBJECT-TYPE SYNTAX Dot3Oui MAX-ACCESS read-only STATUS current DESCRIPTION "The OUI of the OAM peer as reflected in the latest information OAMPDU. " REFERENCE "[802.3ah], 30.11.1.1.11." ::= { dot3OamPeerEntry 3 } dot3OamPeerVendorInfo OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The Vendor Info of the OAM peer as reflected in the latest information OAMPDU. " REFERENCE "[802.3ah], 30.11.1.1.12, 30.11.1.1.13" ::= { dot3OamPeerEntry 4 } dot3OamPeerMode OBJECT-TYPE SYNTAX INTEGER { active(1), passive(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The mode of the OAM peer as reflected in the latest OAMPDU. " REFERENCE "[802.3ah], 30.11.1.1.5." ::= { dot3OamPeerEntry 5 } dot3OamPeerMaxOamPduSize OBJECT-TYPE SYNTAX Integer32 (64..1522) MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum size of OAMPDU supported by the peer as reflected in the latest OAMPDU. Ethernet OAM on this interface must not use OAMPDUs that exceed this size. " REFERENCE "[802.3ah], 30.11.1.1.6." ::= { dot3OamPeerEntry 6 } dot3OamPeerConfigRevision OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The configuration revision of the OAM peer as reflected in the latest OAMPDU. This attribute is changed by the peer whenever it has a local configuration change for Ethernet OAM this interface. " REFERENCE "[802.3ah], 30.11.1.1.9." ::= { dot3OamPeerEntry 7 } dot3OamPeerFunctionsSupported OBJECT-TYPE SYNTAX BITS { unidirectionalSupport (0), loopbackSupport(1), eventSupport(2), variableSupport(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "The OAM functions supported on this Ethernet like interface. OAM consists of separate functionality sets above the basic discovery process. " REFERENCE "[802.3ah], REFERENCE 30.11.1.1.5" ::= { dot3OamPeerEntry 8 } dot3OamPeerMultiplexorState OBJECT-TYPE SYNTAX INTEGER { forward(1), discard(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The state of the multiplexor function in the OAM peer as reflected in the latest OAMPDU. This value is changed based on loopback actions by either the local or remote device. The normal value for this attribute is 'forward'. When transitioning into or out of a loopback state, the value goes to discard. " REFERENCE "[802.3ah], 30.11.1.1.10." ::= { dot3OamPeerEntry 9 } dot3OamPeerParserState OBJECT-TYPE SYNTAX INTEGER { forward(1), loopback(2), discard(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "The state of the parser function in the OAM peer as reflected in the latest OAMPDU. This value is changed based on loopback actions by either the local or remote device. The normal value for this attribute is forward. When the remote OAM entity is performing loopback operations with the local OAM entity, the value goes to discard (when traffic is looped back at the peer) or loopback (when traffic is looped back locally). " REFERENCE "[802.3ah], 30.11.1.1.10." ::= { dot3OamPeerEntry 10 } -- -- Ethernet OAM Loopback group -- dot3OamLoopbackTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot3OamLoopbackEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains methods to control the loopback state of the local link as well as indicating the status of the loopback function. " ::= { dot3OamMIB 4 } dot3OamLoopbackEntry OBJECT-TYPE SYNTAX Dot3OamLoopbackEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the table, containing information on the loopback status for a single Ethernet like interface. " INDEX { ifIndex } ::= { dot3OamLoopbackTable 1 } Dot3OamLoopbackEntry ::= SEQUENCE { dot3OamLoopbackCommand INTEGER, dot3OamLoopbackStatus INTEGER } dot3OamLoopbackCommand OBJECT-TYPE SYNTAX INTEGER { noLoopback (1), startRemoteLoopback (2), endRemoteLoopback (3) } MAX-ACCESS read-write STATUS current DESCRIPTION "This attribute initiates or terminates remote loopback with an OAM peer. Writing 'startRemoteLoopback' to this attribute cause the local OAM client to send a loopback OAMPDU to the OAM peer with the loopback enable flags set. Writing 'endRemoteLoopback' to this attribute will cause the local OAM client to send a loopback OAMPDU to the OAM peer with the loopback enable flags cleared. Writing noLoopback to this attribute has no effect. The attribute always returns noLoopback on a read. To determine the loopback status, use the attribute dot3OamLoopbackStatus. " REFERENCE "[802.3ah], REFERENCE 57.2.11" ::= { dot3OamLoopbackEntry 1 } dot3OamLoopbackStatus OBJECT-TYPE SYNTAX INTEGER { noLoopback (1), initiatingLoopback (2), remoteLoopback (3), terminatingLoopback (4), localLoopback (5) } MAX-ACCESS read-only STATUS current DESCRIPTION "The loopback status of the link. This status is determined by a combination of the local parser and multiplexer states, as well as by the actions of the local OAM client. When operating in normal mode with no loopback in progress, the status is 'noLoopback'. If the OAM client has sent an OAM loopback PDU and is waiting for a response, where the local parser and multiplexer states are DISCARD (see [802.3ah, 57.2.11.1]), the status is 'initiatingLoopback'. If the local OAM client knows that the remote OAM entity is in loopback mode (via the remote state information as described in [802.3ah, 57.2.11.1]), the status is 'remoteLoopback'. If the local OAM client is in the process of terminating the remote loopback [802.3ah, 57.2.11.3], with its local multiplexer and parser states in DISCARD, the status is 'terminatingLoopback'. If the remote OAM client has put the local OAM entity in loopback mode as indicated by its local parser state, the status is 'localLoopback'. " REFERENCE "[802.3ah], REFERENCE 57.2.11" ::= { dot3OamLoopbackEntry 2 } -- Editor's Note: No C30 attribute in D3.0, should appear in D3.1 -- -- Ethernet OAM Event group -- dot3OamEventConfigTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot3OamEventConfigEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Ethernet OAM includes the ability to generate and receive event notifications to indicate various link problems. This table contains the mechanisms to configure the thresholds to generate the standard Ethernet OAM events. These events are: - Errored Symbol Period Event. Generated when the number of symbol errors exceeds a threshold within a given window defined by a number of symbols (e.g. 1,000 symbols out of 1,000,000 had errors). - Errored Frame Period Event. Generated when the number of frame errors exceeds a threshold within a given window defined by a number of frames (e.g. 10 frames out of 1000 had errors). - Errored Frame Event. Generated when the number of frame errors exceeds a threshold within a given window defined by a period of time (e.g. 10 frames in 1 second had errors). - Errored Frame Seconds Summary Event. GeneratedGenerated when the number of frame errors exceeds a threshold within a given window defined by a period of time (e.g. 10 frames in 1 second had errors). - Errored Frame Seconds Summary Event. Generated when the number of errored frame seconds exceeds a threshold within a given time period (e.g. 10 errored frame seconds within the last 100 seconds). An errored frame second is defined as a 1 second interval which had >0 frame errors. " ::= { dot3OamMIB 5 } dot3OamEventConfigEntry OBJECT-TYPE SYNTAX Dot3OamEventConfigEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION " " INDEX { ifIndex } ::= { dot3OamEventConfigTable 1 } Dot3OamEventConfigEntry ::= SEQUENCE { dot3OamErrSymPeriodWindow Unsigned32, dot3OamErrSymPeriodThreshold Unsigned32, dot3OamErrFramePeriodWindow Unsigned32, dot3OamErrFramePeriodThreshold Unsigned32, dot3OamErrFrameWindow Integer32, dot3OamErrFrameThreshold Unsigned32, dot3OamErrFrameSecsSummaryWindow Integer32, dot3OamErrFrameSecsSummaryThreshold Integer32 } dot3OamErrSymPeriodWindow OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "The number of symbols over which the threshold is defined. If dot3OamErrSymPeriodThreshold symbol errors occur within a window of dot3OamErrSymPeriodWindow symbols, an Event Notification OAMPDU should be generated with an Errored Symbol Period Event TLV indicating the threshold has been crossed in this window " REFERENCE "[802.3ah], 30.11.1.1.29" ::= { dot3OamEventConfigEntry 1 } dot3OamErrSymPeriodThreshold OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "The number of symbols errors that must occur for this event to be triggered. If dot3OamErrSymPeriodThreshold symbol errors occur within a window of dot3OamErrSymPeriodWindow symbols, an Event Notification OAMPDU should be generated with an Errored Symbol Period Event TLV indicating the threshold has been crossed in this window. " REFERENCE "[802.3ah], 30.11.1.1.29" ::= { dot3OamEventConfigEntry 2 } dot3OamErrFramePeriodWindow OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "The number of frames over which the threshold is defined. If dot3OamErrFramePeriodThreshold frame errors occur within a window of dot3OamErrFramePeriodWindow frames, an Event Notification OAMPDU should be generated with an Errored Frame Period Event TLV indicating the threshold has been crossed in this window. " REFERENCE "[802.3ah], 30.11.1.1.33" ::= { dot3OamEventConfigEntry 3 } dot3OamErrFramePeriodThreshold OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "The number of frame errors that must occur for this event to be triggered. If dot3OamErrFramePeriodThreshold frame errors occur within a window of dot3OamErrFramePeriodWindow frames, an Event Notification OAMPDU should be generated with an Errored Frame Period Event TLV indicating the threshold has been crossed in this window. " REFERENCE "[802.3ah], 30.11.1.1.33" ::= { dot3OamEventConfigEntry 4 } dot3OamErrFrameWindow OBJECT-TYPE SYNTAX Integer32 (10..600) MAX-ACCESS read-write STATUS current DESCRIPTION "The amount of time over which the threshold is defined. If dot3OamErrFrameThreshold frame errors occur within a window of dot3OamErrFrameWindow (in tenths of seconds), an Event Notification OAMPDU should be generated with an Errored Frame Event TLV indicating the threshold has been crossed in this window. " REFERENCE "[802.3ah], 30.11.1.1.31" ::= { dot3OamEventConfigEntry 5 } dot3OamErrFrameThreshold OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-write STATUS current DESCRIPTION "The number of frame errors that must occur for this event to be triggered. If dot3OamErrFrameThreshold frame errors occur within a window of dot3OamErrFrameWindow (in tenths of seconds), an Event Notification OAMPDU should be generated with an Errored Frame Event TLV indicating the threshold has been crossed in this window. " REFERENCE "[802.3ah], 30.11.1.1.31" ::= { dot3OamEventConfigEntry 6 } dot3OamErrFrameSecsSummaryWindow OBJECT-TYPE SYNTAX Integer32 (100..9000) MAX-ACCESS read-write STATUS current DESCRIPTION "The amount of time over which the threshold is defined. If dot3OamErrFrameSecsSummaryThreshold frame errors occur within a window of dot3OamErrFrameSecsSummaryWindow (in tenths of seconds), an Event Notification OAMPDU should be generated with an Errored Frame Seconds Summary Event TLV indicating the threshold has been crossed in this window. " REFERENCE "[802.3ah], 30.11.1.1.35" ::= { dot3OamEventConfigEntry 7 } dot3OamErrFrameSecsSummaryThreshold OBJECT-TYPE SYNTAX Integer32 (1..900) MAX-ACCESS read-write STATUS current DESCRIPTION "The number of errored frame seconds that must occur for this event to be triggered. If dot3OamErrFrameSecsSummaryThreshold erroed seconds occur within a window of dot3OamErrFrameSecsSummaryWindow (in tenths of seconds), an Event Notification OAMPDU should be generated with an Errored Frame Seconds Summary Event TLV indicating the threshold has been crossed in this window. " REFERENCE "[802.3ah], 30.11.1.1.35" ::= { dot3OamEventConfigEntry 8 } -- -- Ethernet OAM Compliance group -- dot3OamGroups OBJECT IDENTIFIER ::= { dot3OamConformance 1 } dot3OamCompliances OBJECT IDENTIFIER ::= { dot3OamConformance 2 } -- Compliance statements dot3OamCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for managed entities supporting OAM on Ethernet like interfaces. " MODULE -- this module MANDATORY-GROUPS { dot3OamControlGroup, dot3OamPeerGroup, dot3OamStatsBaseGroup } GROUP dot3OamLoopbackGroup DESCRIPTION "This group is mandatory for all IEEE 802.3 OAM implementations that support loopback functionality. " GROUP dot3OamErrSymbolPeriodEventGroup DESCRIPTION "This group is mandatory for all IEEE 802.3 OAM implementations that support event functionality. " GROUP dot3OamErrFramePeriodEventGroup DESCRIPTION "This group is mandatory for all IEEE 802.3 OAM implementations that support event functionality. " GROUP dot3OamErrFrameEventGroup DESCRIPTION "This group is mandatory for all IEEE 802.3 OAM implementations that support event functionality. " GROUP dot3OamErrFrameSecsSummaryEventGroup DESCRIPTION "This group is mandatory for all IEEE 802.3 OAM implementations that support event functionality. " --GROUP dot3OamVariableGroup --DESCRIPTION "This group is mandatory for all IEEE 802.3 OAM -- implementations that support variable retrieval -- functionality. -- " ::= { dot3OamCompliances 1} dot3OamControlGroup OBJECT-GROUP OBJECTS { dot3OamRowStatus, dot3OamAdminState, dot3OamOperStatus, dot3OamMode, dot3OamMaxOamPduSize, dot3OamConfigRevision, dot3OamFunctionsSupported } STATUS current DESCRIPTION "A collection of objects providing the abilities, configuration, and status of an Ethernet OAM entity. " ::= { dot3OamGroups 1 } dot3OamPeerGroup OBJECT-GROUP OBJECTS { dot3OamPeerRowStatus, dot3OamPeerMacAddress, dot3OamPeerVendorOui, dot3OamPeerVendorInfo, dot3OamPeerMode, dot3OamPeerFunctionsSupported, dot3OamPeerMaxOamPduSize, dot3OamPeerConfigRevision, dot3OamPeerMultiplexorState, dot3OamPeerParserState } STATUS current DESCRIPTION "A collection of objects providing the abilities, configuration, and status of a peer Ethernet OAM entity. " ::= { dot3OamGroups 2 } dot3OamStatsBaseGroup OBJECT-GROUP OBJECTS { dot3OamPduTx, dot3OamPduRx, dot3OamInformationTx, dot3OamInformationRx, dot3OamEventNotificationTx, dot3OamUniqueEventNotificationRx, dot3OamDuplicateEventNotificationRx, dot3OamLoopbackControlTx, dot3OamLoopbackControlRx, dot3OamVariableRequestTx, dot3OamVariableRequestRx, dot3OamVariableResponseTx, dot3OamVariableResponseRx, dot3OamOrgSpecificTx, dot3OamOrgSpecificRx, dot3OamUnsupportedCodesRx } STATUS current DESCRIPTION "A collection of objects providing the statistics for the number of various OAMPDUs sent and received on an Ethernet like interface. " ::= { dot3OamGroups 3 } dot3OamLoopbackGroup OBJECT-GROUP OBJECTS { dot3OamLoopbackCommand, dot3OamLoopbackStatus } STATUS current DESCRIPTION "A collection of objects for controlling the OAM remote loopback function. " ::= { dot3OamGroups 4 } dot3OamErrSymbolPeriodEventGroup OBJECT-GROUP OBJECTS { dot3OamErrSymPeriodWindow, dot3OamErrSymPeriodThreshold } STATUS current DESCRIPTION "A collection of objects for configuring the thresholds for an Errored Symbol Period Event. " ::= { dot3OamGroups 5 } dot3OamErrFramePeriodEventGroup OBJECT-GROUP OBJECTS { dot3OamErrFramePeriodWindow, dot3OamErrFramePeriodThreshold } STATUS current DESCRIPTION "A collection of objects for configuring the thresholds for an Errored Frame Period Event. " ::= { dot3OamGroups 6 } dot3OamErrFrameEventGroup OBJECT-GROUP OBJECTS { dot3OamErrFrameWindow, dot3OamErrFrameThreshold } STATUS current DESCRIPTION "A collection of objects for configuring the thresholds for an Errored Frame Event. " ::= { dot3OamGroups 7 } dot3OamErrFrameSecsSummaryEventGroup OBJECT-GROUP OBJECTS { dot3OamErrFrameSecsSummaryWindow, dot3OamErrFrameSecsSummaryThreshold } STATUS current DESCRIPTION "A collection of objects for configuring the thresholds for an Errored Frame Seconds Summary Event. " ::= { dot3OamGroups 8 } END -- -- Copyright (C) The Internet Society (2003). All Rights Reserved. This -- document and translations of it may be copied and furnished to -- others, and derivative works that comment on or otherwise explain it -- or assist in its implementation may be prepared, copied, published -- and distributed, in whole or in part, without restriction of any -- kind, provided that the above copyright notice and this paragraph are -- included on all such copies and derivative works. However, this -- document itself may not be modified in any way, such as by removing -- the copyright notice or references to the Internet Society or other -- Internet organizations, except as needed for the purpose of -- developing Internet standards in which case the procedures for -- copyrights defined in the Internet Standards process must be -- followed, or as required to translate it into languages other than -- English. -- -- The limited permissions granted above are perpetual and will not be -- revoked by the Internet Society or its successors or assignees. -- -- This document and the information contained herein is provided on an -- "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING -- TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING -- BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION -- HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF -- MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. -- -- -- 12 Acknowledgments -- 13 Author's Addresses -- -- Matt Squire -- Hatteras Networks -- 639 Davis Drive -- Suite 200 -- Research Triangle Park, NC 27709 -- Email: msquire@hatterasnetworks.com