1 TOKENRING-MIB DEFINITIONS ::= BEGIN
4 MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY,
5 Counter32, Integer32 FROM SNMPv2-SMI
6 transmission FROM RFC1213-MIB
7 MacAddress,TimeStamp FROM SNMPv2-TC
8 MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF;
11 LAST-UPDATED "9410231150Z"
12 ORGANIZATION "IETF Interfaces MIB Working Group"
16 Postal: cisco Systems, Inc.
17 170 West Tasman Drive,
18 San Jose, CA 95134-1706
21 Phone: +1 408 526 5260
24 "The MIB module for IEEE Token Ring entities."
25 ::= { transmission 9 }
28 -- The 802.5 Interface Table
30 -- This table contains state and parameter information which
31 -- is specific to 802.5 interfaces. It is mandatory that
32 -- systems having 802.5 interfaces implement this table in
33 -- addition to the ifTable (see RFCs 1213 and 1573).
36 SYNTAX SEQUENCE OF Dot5Entry
37 MAX-ACCESS not-accessible
40 "This table contains Token Ring interface
41 parameters and state variables, one entry
47 MAX-ACCESS not-accessible
50 "A list of Token Ring status and parameter
51 values for an 802.5 interface."
55 Dot5Entry ::= SEQUENCE {
56 dot5IfIndex Integer32,
58 dot5RingStatus INTEGER,
59 dot5RingState INTEGER,
60 dot5RingOpenStatus INTEGER,
61 dot5RingSpeed INTEGER,
62 dot5UpStream MacAddress,
63 dot5ActMonParticipate INTEGER,
64 dot5Functional MacAddress,
65 dot5LastBeaconSent TimeStamp
68 dot5IfIndex OBJECT-TYPE
73 "The value of this object identifies the
74 802.5 interface for which this entry
75 contains management information. The
76 value of this object for a particular
77 interface has the same value as the
78 ifIndex object, defined in MIB-II for
82 dot5Commands OBJECT-TYPE
92 "When this object is set to the value of
93 open(2), the station should go into the
94 open state. The progress and success of
95 the open is given by the values of the
96 objects dot5RingState and
98 When this object is set to the value
99 of reset(3), then the station should do
100 a reset. On a reset, all MIB counters
101 should retain their values, if possible.
102 Other side affects are dependent on the
104 When this object is set to the value
105 of close(4), the station should go into
106 the stopped state by removing itself
108 Setting this object to a value of
109 noop(1) has no effect.
110 When read, this object always has a
112 The open(2) and close(4) values
113 correspond to the up(1) and down(2) values
114 of MIB-II's ifAdminStatus and ifOperStatus,
115 i.e., the setting of ifAdminStatus and
116 dot5Commands affects the values of both
117 dot5Commands and ifOperStatus."
120 dot5RingStatus OBJECT-TYPE
121 SYNTAX INTEGER (0..262143)
125 "The current interface status which can
126 be used to diagnose fluctuating problems
127 that can occur on token rings, after a
128 station has successfully been added to
130 Before an open is completed, this
131 object has the value for the 'no status'
132 condition. The dot5RingState and
133 dot5RingOpenStatus objects provide for
134 debugging problems when the station
135 can not even enter the ring.
136 The object's value is a sum of
137 values, one for each currently applicable
138 condition. The following values are
139 defined for various conditions:
141 0 = No Problems detected
144 256 = Remove Received
146 1024 = Auto-Removal Error
147 2048 = Lobe Wire Fault
148 4096 = Transmit Beacon
152 131072 = no status, open not completed."
155 dot5RingState OBJECT-TYPE
167 "The current interface state with respect
168 to entering or leaving the ring."
171 dot5RingOpenStatus OBJECT-TYPE
173 noOpen(1), -- no open attempted
183 open(11) -- last open successful
188 "This object indicates the success, or the
189 reason for failure, of the station's most
190 recent attempt to enter the ring."
193 dot5RingSpeed OBJECT-TYPE
200 MAX-ACCESS read-write
203 "The ring-speed at the next insertion into
204 the ring. Note that this may or may not be
205 different to the current ring-speed which is
206 given by MIB-II's ifSpeed. For interfaces
207 which do not support changing ring-speed,
208 dot5RingSpeed can only be set to its current
209 value. When dot5RingSpeed has the value
210 unknown(1), the ring's actual ring-speed is
214 dot5UpStream OBJECT-TYPE
219 "The MAC-address of the up stream neighbor
220 station in the ring."
223 dot5ActMonParticipate OBJECT-TYPE
228 MAX-ACCESS read-write
231 "If this object has a value of true(1) then
232 this interface will participate in the
233 active monitor selection process. If the
234 value is false(2) then it will not.
235 Setting this object does not take effect
236 until the next Active Monitor election, and
237 might not take effect until the next time
238 the interface is opened."
241 dot5Functional OBJECT-TYPE
243 MAX-ACCESS read-write
246 "The bit mask of all Token Ring functional
247 addresses for which this interface will
251 dot5LastBeaconSent OBJECT-TYPE
256 "The value of MIB-II's sysUpTime object at which
257 the local system last transmitted a Beacon frame
261 -- The 802.5 Statistics Table
263 -- This table contains statistics and error counter which are
264 -- specific to 802.5 interfaces. It is mandatory that systems
265 -- having 802.5 interfaces implement this table.
267 dot5StatsTable OBJECT-TYPE
268 SYNTAX SEQUENCE OF Dot5StatsEntry
269 MAX-ACCESS not-accessible
272 "A table containing Token Ring statistics,
273 one entry per 802.5 interface.
274 All the statistics are defined using
275 the syntax Counter32 as 32-bit wrap around
276 counters. Thus, if an interface's
277 hardware maintains these statistics in
278 16-bit counters, then the agent must read
279 the hardware's counters frequently enough
280 to prevent loss of significance, in order
281 to maintain 32-bit counters in software."
284 dot5StatsEntry OBJECT-TYPE
285 SYNTAX Dot5StatsEntry
286 MAX-ACCESS not-accessible
289 "An entry contains the 802.5 statistics
290 for a particular interface."
291 INDEX { dot5StatsIfIndex }
292 ::= { dot5StatsTable 1 }
295 Dot5StatsEntry ::= SEQUENCE {
296 dot5StatsIfIndex Integer32,
297 dot5StatsLineErrors Counter32,
298 dot5StatsBurstErrors Counter32,
299 dot5StatsACErrors Counter32,
300 dot5StatsAbortTransErrors Counter32,
301 dot5StatsInternalErrors Counter32,
302 dot5StatsLostFrameErrors Counter32,
303 dot5StatsReceiveCongestions Counter32,
304 dot5StatsFrameCopiedErrors Counter32,
305 dot5StatsTokenErrors Counter32,
306 dot5StatsSoftErrors Counter32,
307 dot5StatsHardErrors Counter32,
308 dot5StatsSignalLoss Counter32,
309 dot5StatsTransmitBeacons Counter32,
310 dot5StatsRecoverys Counter32,
311 dot5StatsLobeWires Counter32,
312 dot5StatsRemoves Counter32,
313 dot5StatsSingles Counter32,
314 dot5StatsFreqErrors Counter32
318 dot5StatsIfIndex OBJECT-TYPE
323 "The value of this object identifies the
324 802.5 interface for which this entry
325 contains management information. The
326 value of this object for a particular
327 interface has the same value as MIB-II's
328 ifIndex object for the same interface."
329 ::= { dot5StatsEntry 1 }
331 dot5StatsLineErrors OBJECT-TYPE
336 "This counter is incremented when a frame
337 or token is copied or repeated by a
338 station, the E bit is zero in the frame
339 or token and one of the following
340 conditions exists: 1) there is a
341 non-data bit (J or K bit) between the SD
342 and the ED of the frame or token, or
343 2) there is an FCS error in the frame."
344 ::= { dot5StatsEntry 2 }
346 dot5StatsBurstErrors OBJECT-TYPE
351 "This counter is incremented when a station
352 detects the absence of transitions for five
353 half-bit timers (burst-five error)."
354 ::= { dot5StatsEntry 3 }
356 dot5StatsACErrors OBJECT-TYPE
361 "This counter is incremented when a station
362 receives an AMP or SMP frame in which A is
363 equal to C is equal to 0, and then receives
364 another SMP frame with A is equal to C is
365 equal to 0 without first receiving an AMP
366 frame. It denotes a station that cannot set
367 the AC bits properly."
368 ::= { dot5StatsEntry 4 }
370 dot5StatsAbortTransErrors OBJECT-TYPE
375 "This counter is incremented when a station
376 transmits an abort delimiter while
378 ::= { dot5StatsEntry 5 }
380 dot5StatsInternalErrors OBJECT-TYPE
385 "This counter is incremented when a station
386 recognizes an internal error."
387 ::= { dot5StatsEntry 6 }
389 dot5StatsLostFrameErrors OBJECT-TYPE
394 "This counter is incremented when a station
395 is transmitting and its TRR timer expires.
396 This condition denotes a condition where a
397 transmitting station in strip mode does not
398 receive the trailer of the frame before the
400 ::= { dot5StatsEntry 7 }
402 dot5StatsReceiveCongestions OBJECT-TYPE
407 "This counter is incremented when a station
408 recognizes a frame addressed to its
409 specific address, but has no available
410 buffer space indicating that the station
412 ::= { dot5StatsEntry 8 }
414 dot5StatsFrameCopiedErrors OBJECT-TYPE
419 "This counter is incremented when a station
420 recognizes a frame addressed to its
421 specific address and detects that the FS
422 field A bits are set to 1 indicating a
423 possible line hit or duplicate address."
424 ::= { dot5StatsEntry 9 }
426 dot5StatsTokenErrors OBJECT-TYPE
431 "This counter is incremented when a station
432 acting as the active monitor recognizes an
433 error condition that needs a token
435 ::= { dot5StatsEntry 10 }
437 dot5StatsSoftErrors OBJECT-TYPE
442 "The number of Soft Errors the interface
443 has detected. It directly corresponds to
444 the number of Report Error MAC frames
445 that this interface has transmitted.
446 Soft Errors are those which are
447 recoverable by the MAC layer protocols."
448 ::= { dot5StatsEntry 11 }
450 dot5StatsHardErrors OBJECT-TYPE
455 "The number of times this interface has
456 detected an immediately recoverable
457 fatal error. It denotes the number of
458 times this interface is either
459 transmitting or receiving beacon MAC
461 ::= { dot5StatsEntry 12 }
463 dot5StatsSignalLoss OBJECT-TYPE
468 "The number of times this interface has
469 detected the loss of signal condition from
471 ::= { dot5StatsEntry 13 }
473 dot5StatsTransmitBeacons OBJECT-TYPE
478 "The number of times this interface has
479 transmitted a beacon frame."
480 ::= { dot5StatsEntry 14 }
482 dot5StatsRecoverys OBJECT-TYPE
487 "The number of Claim Token MAC frames
488 received or transmitted after the interface
489 has received a Ring Purge MAC frame. This
490 counter signifies the number of times the
491 ring has been purged and is being recovered
492 back into a normal operating state."
493 ::= { dot5StatsEntry 15 }
495 dot5StatsLobeWires OBJECT-TYPE
500 "The number of times the interface has
501 detected an open or short circuit in the
502 lobe data path. The adapter will be closed
503 and dot5RingState will signify this
505 ::= { dot5StatsEntry 16 }
507 dot5StatsRemoves OBJECT-TYPE
512 "The number of times the interface has
513 received a Remove Ring Station MAC frame
514 request. When this frame is received
515 the interface will enter the close state
516 and dot5RingState will signify this
518 ::= { dot5StatsEntry 17 }
520 dot5StatsSingles OBJECT-TYPE
525 "The number of times the interface has
526 sensed that it is the only station on the
527 ring. This will happen if the interface
528 is the first one up on a ring, or if
529 there is a hardware problem."
530 ::= { dot5StatsEntry 18 }
532 dot5StatsFreqErrors OBJECT-TYPE
537 "The number of times the interface has
538 detected that the frequency of the
539 incoming signal differs from the expected
540 frequency by more than that specified by
541 the IEEE 802.5 standard."
542 ::= { dot5StatsEntry 19 }
546 -- This group contains the values of timers for 802.5
547 -- interfaces. This table is obsolete, but its definition
548 -- is retained here for backwards compatibility.
550 dot5TimerTable OBJECT-TYPE
551 SYNTAX SEQUENCE OF Dot5TimerEntry
552 MAX-ACCESS not-accessible
555 "This table contains Token Ring interface
556 timer values, one entry per 802.5
560 dot5TimerEntry OBJECT-TYPE
561 SYNTAX Dot5TimerEntry
562 MAX-ACCESS not-accessible
565 "A list of Token Ring timer values for an
567 INDEX { dot5TimerIfIndex }
568 ::= { dot5TimerTable 1 }
570 Dot5TimerEntry ::= SEQUENCE {
571 dot5TimerIfIndex Integer32,
572 dot5TimerReturnRepeat Integer32,
573 dot5TimerHolding Integer32,
574 dot5TimerQueuePDU Integer32,
575 dot5TimerValidTransmit Integer32,
576 dot5TimerNoToken Integer32,
577 dot5TimerActiveMon Integer32,
578 dot5TimerStandbyMon Integer32,
579 dot5TimerErrorReport Integer32,
580 dot5TimerBeaconTransmit Integer32,
581 dot5TimerBeaconReceive Integer32
584 dot5TimerIfIndex OBJECT-TYPE
589 "The value of this object identifies the
590 802.5 interface for which this entry
591 contains timer values. The value of
592 this object for a particular interface
593 has the same value as MIB-II's ifIndex
594 object for the same interface."
595 ::= { dot5TimerEntry 1 }
597 dot5TimerReturnRepeat OBJECT-TYPE
602 "The time-out value used to ensure the
603 interface will return to Repeat State, in
604 units of 100 micro-seconds. The value
605 should be greater than the maximum ring
607 ::= { dot5TimerEntry 2 }
609 dot5TimerHolding OBJECT-TYPE
614 "Maximum period of time a station is
615 permitted to transmit frames after capturing
616 a token, in units of 100 micro-seconds."
617 ::= { dot5TimerEntry 3 }
619 dot5TimerQueuePDU OBJECT-TYPE
624 "The time-out value for enqueuing of an SMP
625 PDU after reception of an AMP or SMP
626 frame in which the A and C bits were
627 equal to 0, in units of 100
629 ::= { dot5TimerEntry 4 }
631 dot5TimerValidTransmit OBJECT-TYPE
636 "The time-out value used by the active
637 monitor to detect the absence of valid
638 transmissions, in units of 100
640 ::= { dot5TimerEntry 5 }
642 dot5TimerNoToken OBJECT-TYPE
647 "The time-out value used to recover from
648 various-related error situations.
649 If N is the maximum number of stations on
650 the ring, the value of this timer is
652 dot5TimerReturnRepeat + N*dot5TimerHolding."
653 ::= { dot5TimerEntry 6 }
655 dot5TimerActiveMon OBJECT-TYPE
660 "The time-out value used by the active
661 monitor to stimulate the enqueuing of an
662 AMP PDU for transmission, in units of
664 ::= { dot5TimerEntry 7 }
666 dot5TimerStandbyMon OBJECT-TYPE
671 "The time-out value used by the stand-by
672 monitors to ensure that there is an active
673 monitor on the ring and to detect a
674 continuous stream of tokens, in units of
676 ::= { dot5TimerEntry 8 }
678 dot5TimerErrorReport OBJECT-TYPE
683 "The time-out value which determines how
684 often a station shall send a Report Error
685 MAC frame to report its error counters,
686 in units of 100 micro-seconds."
687 ::= { dot5TimerEntry 9 }
689 dot5TimerBeaconTransmit OBJECT-TYPE
694 "The time-out value which determines how
695 long a station shall remain in the state
696 of transmitting Beacon frames before
697 entering the Bypass state, in units of
699 ::= { dot5TimerEntry 10 }
701 dot5TimerBeaconReceive OBJECT-TYPE
706 "The time-out value which determines how
707 long a station shall receive Beacon
708 frames from its downstream neighbor
709 before entering the Bypass state, in
710 units of 100 micro-seconds."
711 ::= { dot5TimerEntry 11 }
714 -- 802.5 Interface Tests
716 dot5Tests OBJECT IDENTIFIER ::= { dot5 3 }
718 -- RFC 1573 defines the ifTestTable, through which a
719 -- network manager can instruct an agent to test an interface
720 -- for various faults. A test to be performed is identified
721 -- as an OBJECT IDENTIFIER.
723 -- The Insert Function test
725 dot5TestInsertFunc OBJECT-IDENTITY
728 "Invoking this test causes the station to test the insert
729 ring logic of the hardware if the station's lobe media
730 cable is connected to a wiring concentrator. Note that
731 this command inserts the station into the network, and
732 thus, could cause problems if the station is connected
733 to a operational network."
736 -- The Full-Duplex Loop Back test
738 dot5TestFullDuplexLoopBack OBJECT-IDENTITY
741 "Invoking this test on a 802.5 interface causes the
742 interface to check the path from memory through the
743 chip set's internal logic and back to memory, thus
744 checking the proper functioning of the system's
745 interface to the chip set."
749 -- 802.5 Hardware Chip Sets
751 -- RFC 1229 specified an object, ifExtnsChipSet, with the
752 -- syntax of OBJECT IDENTIFIER, to identify the hardware
753 -- chip set in use by an interface. RFC 1573 obsoletes
754 -- the use of ifExtnsChipSet. However, the following
755 -- definitions are retained for backwards compatibility.
757 dot5ChipSets OBJECT IDENTIFIER ::= { dot5 4 }
759 dot5ChipSetIBM16 OBJECT-IDENTITY
762 "IBM's 16/4 Mbs chip set."
763 ::= { dot5ChipSets 1 }
765 dot5ChipSetTItms380 OBJECT-IDENTITY
768 "Texas Instruments' TMS 380 4Mbs chip-set"
769 ::= { dot5ChipSets 2 }
771 dot5ChipSetTItms380c16 OBJECT-IDENTITY
774 "Texas Instruments' TMS 380C16 16/4 Mbs chip-set"
775 ::= { dot5ChipSets 3 }
777 -- conformance information
779 dot5Conformance OBJECT IDENTIFIER ::= { dot5 6 }
781 dot5Groups OBJECT IDENTIFIER ::= { dot5Conformance 1 }
782 dot5Compliances OBJECT IDENTIFIER ::= { dot5Conformance 2 }
785 -- compliance statements
787 dot5Compliance MODULE-COMPLIANCE
790 "The compliance statement for SNMPv2 entities
791 which implement the IEEE 802.5 MIB."
793 MODULE -- this module
794 MANDATORY-GROUPS { dot5StateGroup, dot5StatsGroup }
796 OBJECT dot5ActMonParticipate
799 "Write access is not required."
801 OBJECT dot5Functional
804 "Write access is not required."
806 ::= { dot5Compliances 1 }
809 -- units of conformance
811 dot5StateGroup OBJECT-GROUP
812 OBJECTS { dot5Commands, dot5RingStatus, dot5RingState,
813 dot5RingOpenStatus, dot5RingSpeed, dot5UpStream,
814 dot5ActMonParticipate, dot5Functional,
819 "A collection of objects providing state information
820 and parameters for IEEE 802.5 interfaces."
823 dot5StatsGroup OBJECT-GROUP
824 OBJECTS { dot5StatsLineErrors, dot5StatsBurstErrors,
825 dot5StatsACErrors, dot5StatsAbortTransErrors,
826 dot5StatsInternalErrors, dot5StatsLostFrameErrors,
827 dot5StatsReceiveCongestions,
828 dot5StatsFrameCopiedErrors, dot5StatsTokenErrors,
829 dot5StatsSoftErrors, dot5StatsHardErrors,
830 dot5StatsSignalLoss, dot5StatsTransmitBeacons,
831 dot5StatsRecoverys, dot5StatsLobeWires,
832 dot5StatsRemoves, dot5StatsSingles,
837 "A collection of objects providing statistics for
838 IEEE 802.5 interfaces."