TOKENRING-MIB

All MIBs › TOKENRING-MIB

Organization: IETF Interfaces MIB Working Group

Last Updated: 1994-10-23

Category: Network Interfaces

Description: Defines managed objects for IEEE 802.5 Token Ring interfaces, including interface state, configuration parameters, and ring statistics.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring TOKENRING-MIB with a free 30-day trial of IPNetwork Monitor.

What Is TOKENRING-MIB?

TOKENRING-MIB is the standard IETF Interfaces MIB Working Group MIB (the dot5/802.5 Token Ring MIB) for IEEE Token Ring entities. Its dot5 table, keyed by ifIndex, records ring-management commands, ring status/state/open-status, ring speed, upstream neighbor, active-monitor participation, functional-address mask, and last-beacon-sent time, while a statistics table records line errors, burst errors, AC (Address Recognized/Copied) errors, abort-transmission errors, internal errors, lost-frame errors, receive congestion, frame-copied errors, token errors, and soft-error counts. As a performance/protocol-status MIB it lets an administrator diagnose Token Ring instability by watching soft-error and beacon activity. It is deployed on network devices with IEEE Token Ring (802.5) interfaces. Engineers can download the TOKENRING-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in TOKENRING-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Network devices with IEEE Token Ring (802.5) interfaces

Monitoring Examples

An administrator checks dot5StatsSoftErrors and dot5StatsLostFrameErrors to diagnose a degrading Token Ring segment before it triggers a full ring beacon condition.

What Can Be Monitored

Token Ring soft-error and beacon activity

Imported Objects

From RFC1213-MIB

transmission

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
MODULE-IDENTITY
OBJECT-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

MacAddress
TimeStamp

How to Use in IPNetwork Monitor

Example using dot5StatsLineErrors OID:

Select a Network devices with IEEE Token Ring (802.5) interface (ring status/soft-error statistics) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type dot5StatsLineErrors into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. It reports a count of Token Ring line errors — frames or tokens copied/repeated with a zero E bit and a non-data or invalid framing condition. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases between polls, since a rising count of errors, failures, or discards often points to a real underlying problem. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
dot5	1.3.6.1.2.1.10.9			The MIB module for IEEE Token Ring entities.
dot5Table	1.3.6.1.2.1.10.9.1		not-accessible	This table contains Token Ring interface parameters and state variables, one entry per 802.5 interface.
dot5Entry	1.3.6.1.2.1.10.9.1.1		not-accessible	A list of Token Ring status and parameter values for an 802.5 interface.
I32 dot5IfIndex	1.3.6.1.2.1.10.9.1.1.1	Integer32	read-only	The value of this object identifies the 802.5 interface for which this entry contains management information. The value of this object for a particular interface has the same value as the ifIndex object, defined in MIB-II for the same interface.
INT dot5Commands	1.3.6.1.2.1.10.9.1.1.2	INTEGER	read-write	When this object is set to the value of open(2), the station should go into the open state. The progress and success of the open is given by the values of the objects dot5RingState and dot5RingOpenStatus. When this object is set to the value of reset(3), then the station should do a reset. On a reset, all MIB counters should retain their values, if possible. Other side affects are dependent on the hardware chip set. When this object is set to the value of close(4), the station should go into the stopped state by removing itself from the ring. Setting this object to a value of noop(1) has no effect. When read, this object always has a value of noop(1). The open(2) and close(4) values correspond to the up(1) and down(2) values of MIB-II's ifAdminStatus and ifOperStatus, i.e., the setting of ifAdminStatus and dot5Commands affects the values of both dot5Commands and ifOperStatus.
INT dot5RingStatus	1.3.6.1.2.1.10.9.1.1.3	INTEGER	read-only	The current interface status which can be used to diagnose fluctuating problems that can occur on token rings, after a station has successfully been added to the ring. Before an open is completed, this object has the value for the 'no status' condition. The dot5RingState and dot5RingOpenStatus objects provide for debugging problems when the station can not even enter the ring. The object's value is a sum of values, one for each currently applicable condition. The following values are defined for various conditions: 0 = No Problems detected 32 = Ring Recovery 64 = Single Station 256 = Remove Received 512 = reserved 1024 = Auto-Removal Error 2048 = Lobe Wire Fault 4096 = Transmit Beacon 8192 = Soft Error 16384 = Hard Error 32768 = Signal Loss 131072 = no status, open not completed.
INT dot5RingState	1.3.6.1.2.1.10.9.1.1.4	INTEGER	read-only	The current interface state with respect to entering or leaving the ring.
INT dot5RingOpenStatus	1.3.6.1.2.1.10.9.1.1.5	INTEGER	read-only	This object indicates the success, or the reason for failure, of the station's most recent attempt to enter the ring.
INT dot5RingSpeed	1.3.6.1.2.1.10.9.1.1.6	INTEGER	read-write	The ring-speed at the next insertion into the ring. Note that this may or may not be different to the current ring-speed which is given by MIB-II's ifSpeed. For interfaces which do not support changing ring-speed, dot5RingSpeed can only be set to its current value. When dot5RingSpeed has the value unknown(1), the ring's actual ring-speed is to be used.
MAC dot5UpStream	1.3.6.1.2.1.10.9.1.1.7	MacAddress	read-only	The MAC-address of the up stream neighbor station in the ring.
INT dot5ActMonParticipate	1.3.6.1.2.1.10.9.1.1.8	INTEGER	read-write	If this object has a value of true(1) then this interface will participate in the active monitor selection process. If the value is false(2) then it will not. Setting this object does not take effect until the next Active Monitor election, and might not take effect until the next time the interface is opened.
MAC dot5Functional	1.3.6.1.2.1.10.9.1.1.9	MacAddress	read-write	The bit mask of all Token Ring functional addresses for which this interface will accept frames.
TIM dot5LastBeaconSent	1.3.6.1.2.1.10.9.1.1.10	TimeStamp	read-only	The value of MIB-II's sysUpTime object at which the local system last transmitted a Beacon frame on this interface.
dot5StatsTable	1.3.6.1.2.1.10.9.2		not-accessible	A table containing Token Ring statistics, one entry per 802.5 interface. All the statistics are defined using the syntax Counter32 as 32-bit wrap around counters. Thus, if an interface's hardware maintains these statistics in 16-bit counters, then the agent must read the hardware's counters frequently enough to prevent loss of significance, in order to maintain 32-bit counters in software.
dot5StatsEntry	1.3.6.1.2.1.10.9.2.1		not-accessible	An entry contains the 802.5 statistics for a particular interface.
I32 dot5StatsIfIndex	1.3.6.1.2.1.10.9.2.1.1	Integer32	read-only	The value of this object identifies the 802.5 interface for which this entry contains management information. The value of this object for a particular interface has the same value as MIB-II's ifIndex object for the same interface.
C32 dot5StatsLineErrorsEx	1.3.6.1.2.1.10.9.2.1.2	Counter32	read-only	This counter is incremented when a frame or token is copied or repeated by a station, the E bit is zero in the frame or token and one of the following conditions exists: 1) there is a non-data bit (J or K bit) between the SD and the ED of the frame or token, or 2) there is an FCS error in the frame.
C32 dot5StatsBurstErrors	1.3.6.1.2.1.10.9.2.1.3	Counter32	read-only	This counter is incremented when a station detects the absence of transitions for five half-bit timers (burst-five error).
C32 dot5StatsACErrors	1.3.6.1.2.1.10.9.2.1.4	Counter32	read-only	This counter is incremented when a station receives an AMP or SMP frame in which A is equal to C is equal to 0, and then receives another SMP frame with A is equal to C is equal to 0 without first receiving an AMP frame. It denotes a station that cannot set the AC bits properly.
C32 dot5StatsAbortTransErrors	1.3.6.1.2.1.10.9.2.1.5	Counter32	read-only	This counter is incremented when a station transmits an abort delimiter while transmitting.
C32 dot5StatsInternalErrors	1.3.6.1.2.1.10.9.2.1.6	Counter32	read-only	This counter is incremented when a station recognizes an internal error.
C32 dot5StatsLostFrameErrors	1.3.6.1.2.1.10.9.2.1.7	Counter32	read-only	This counter is incremented when a station is transmitting and its TRR timer expires. This condition denotes a condition where a transmitting station in strip mode does not receive the trailer of the frame before the TRR timer goes off.
C32 dot5StatsReceiveCongestions	1.3.6.1.2.1.10.9.2.1.8	Counter32	read-only	This counter is incremented when a station recognizes a frame addressed to its specific address, but has no available buffer space indicating that the station is congested.
C32 dot5StatsFrameCopiedErrors	1.3.6.1.2.1.10.9.2.1.9	Counter32	read-only	This counter is incremented when a station recognizes a frame addressed to its specific address and detects that the FS field A bits are set to 1 indicating a possible line hit or duplicate address.
C32 dot5StatsTokenErrors	1.3.6.1.2.1.10.9.2.1.10	Counter32	read-only	This counter is incremented when a station acting as the active monitor recognizes an error condition that needs a token transmitted.
C32 dot5StatsSoftErrors	1.3.6.1.2.1.10.9.2.1.11	Counter32	read-only	The number of Soft Errors the interface has detected. It directly corresponds to the number of Report Error MAC frames that this interface has transmitted. Soft Errors are those which are recoverable by the MAC layer protocols.
C32 dot5StatsHardErrors	1.3.6.1.2.1.10.9.2.1.12	Counter32	read-only	The number of times this interface has detected an immediately recoverable fatal error. It denotes the number of times this interface is either transmitting or receiving beacon MAC frames.
C32 dot5StatsSignalLoss	1.3.6.1.2.1.10.9.2.1.13	Counter32	read-only	The number of times this interface has detected the loss of signal condition from the ring.
C32 dot5StatsTransmitBeacons	1.3.6.1.2.1.10.9.2.1.14	Counter32	read-only	The number of times this interface has transmitted a beacon frame.
C32 dot5StatsRecoverys	1.3.6.1.2.1.10.9.2.1.15	Counter32	read-only	The number of Claim Token MAC frames received or transmitted after the interface has received a Ring Purge MAC frame. This counter signifies the number of times the ring has been purged and is being recovered back into a normal operating state.
C32 dot5StatsLobeWires	1.3.6.1.2.1.10.9.2.1.16	Counter32	read-only	The number of times the interface has detected an open or short circuit in the lobe data path. The adapter will be closed and dot5RingState will signify this condition.
C32 dot5StatsRemoves	1.3.6.1.2.1.10.9.2.1.17	Counter32	read-only	The number of times the interface has received a Remove Ring Station MAC frame request. When this frame is received the interface will enter the close state and dot5RingState will signify this condition.
C32 dot5StatsSingles	1.3.6.1.2.1.10.9.2.1.18	Counter32	read-only	The number of times the interface has sensed that it is the only station on the ring. This will happen if the interface is the first one up on a ring, or if there is a hardware problem.
C32 dot5StatsFreqErrors	1.3.6.1.2.1.10.9.2.1.19	Counter32	read-only	The number of times the interface has detected that the frequency of the incoming signal differs from the expected frequency by more than that specified by the IEEE 802.5 standard.
dot5Tests	1.3.6.1.2.1.10.9.3
dot5TestInsertFunc	1.3.6.1.2.1.10.9.3.1			Invoking this test causes the station to test the insert ring logic of the hardware if the station's lobe media cable is connected to a wiring concentrator. Note that this command inserts the station into the network, and thus, could cause problems if the station is connected to a operational network.
dot5TestFullDuplexLoopBack	1.3.6.1.2.1.10.9.3.2			Invoking this test on a 802.5 interface causes the interface to check the path from memory through the chip set's internal logic and back to memory, thus checking the proper functioning of the system's interface to the chip set.
dot5ChipSets	1.3.6.1.2.1.10.9.4
dot5ChipSetIBM16	1.3.6.1.2.1.10.9.4.1			IBM's 16/4 Mbs chip set.
dot5ChipSetTItms380	1.3.6.1.2.1.10.9.4.2			Texas Instruments' TMS 380 4Mbs chip-set
dot5ChipSetTItms380c16	1.3.6.1.2.1.10.9.4.3			Texas Instruments' TMS 380C16 16/4 Mbs chip-set
dot5TimerTable	1.3.6.1.2.1.10.9.5		not-accessible	This table contains Token Ring interface timer values, one entry per 802.5 interface.
dot5TimerEntry	1.3.6.1.2.1.10.9.5.1		not-accessible	A list of Token Ring timer values for an 802.5 interface.
I32 dot5TimerIfIndex	1.3.6.1.2.1.10.9.5.1.1	Integer32	read-only	The value of this object identifies the 802.5 interface for which this entry contains timer values. The value of this object for a particular interface has the same value as MIB-II's ifIndex object for the same interface.
I32 dot5TimerReturnRepeat	1.3.6.1.2.1.10.9.5.1.2	Integer32	read-only	The time-out value used to ensure the interface will return to Repeat State, in units of 100 micro-seconds. The value should be greater than the maximum ring latency.
I32 dot5TimerHolding	1.3.6.1.2.1.10.9.5.1.3	Integer32	read-only	Maximum period of time a station is permitted to transmit frames after capturing a token, in units of 100 micro-seconds.
I32 dot5TimerQueuePDU	1.3.6.1.2.1.10.9.5.1.4	Integer32	read-only	The time-out value for enqueuing of an SMP PDU after reception of an AMP or SMP frame in which the A and C bits were equal to 0, in units of 100 micro-seconds.
I32 dot5TimerValidTransmit	1.3.6.1.2.1.10.9.5.1.5	Integer32	read-only	The time-out value used by the active monitor to detect the absence of valid transmissions, in units of 100 micro-seconds.
I32 dot5TimerNoToken	1.3.6.1.2.1.10.9.5.1.6	Integer32	read-only	The time-out value used to recover from various-related error situations. If N is the maximum number of stations on the ring, the value of this timer is normally: dot5TimerReturnRepeat + N*dot5TimerHolding.
I32 dot5TimerActiveMon	1.3.6.1.2.1.10.9.5.1.7	Integer32	read-only	The time-out value used by the active monitor to stimulate the enqueuing of an AMP PDU for transmission, in units of 100 micro-seconds.
I32 dot5TimerStandbyMon	1.3.6.1.2.1.10.9.5.1.8	Integer32	read-only	The time-out value used by the stand-by monitors to ensure that there is an active monitor on the ring and to detect a continuous stream of tokens, in units of 100 micro-seconds.
I32 dot5TimerErrorReport	1.3.6.1.2.1.10.9.5.1.9	Integer32	read-only	The time-out value which determines how often a station shall send a Report Error MAC frame to report its error counters, in units of 100 micro-seconds.
I32 dot5TimerBeaconTransmit	1.3.6.1.2.1.10.9.5.1.10	Integer32	read-only	The time-out value which determines how long a station shall remain in the state of transmitting Beacon frames before entering the Bypass state, in units of 100 micro-seconds.
I32 dot5TimerBeaconReceive	1.3.6.1.2.1.10.9.5.1.11	Integer32	read-only	The time-out value which determines how long a station shall receive Beacon frames from its downstream neighbor before entering the Bypass state, in units of 100 micro-seconds.
dot5Conformance	1.3.6.1.2.1.10.9.6
dot5Groups	1.3.6.1.2.1.10.9.6.1
dot5StateGroup	1.3.6.1.2.1.10.9.6.1.1			A collection of objects providing state information and parameters for IEEE 802.5 interfaces.
dot5StatsGroup	1.3.6.1.2.1.10.9.6.1.2			A collection of objects providing statistics for IEEE 802.5 interfaces.
dot5Compliances	1.3.6.1.2.1.10.9.6.2
dot5Compliance	1.3.6.1.2.1.10.9.6.2.1			The compliance statement for SNMPv2 entities which implement the IEEE 802.5 MIB.

RFC description

IEEE 802.5 Token Ring interface management, status, and parameter tracking.

Start monitoring Network devices with IEEE Token Ring (802.5) interfaces (ring status/soft-error statistics) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download TOKENRING-MIB