TN3270E-RT-MIB

All MIBs › TN3270E-RT-MIB

Organization: TN3270E Working Group

Last Updated: 1998-07-27

Category: SNA and Legacy Protocols

Description: Defines managed objects for collecting response time data on TN3270 and TN3270E sessions for service level agreement validation.

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

What Is TN3270E-RT-MIB?

TN3270E-RT-MIB is an IETF standards-based SNMP module defining managed objects for collecting response-time data on TN3270 and TN3270E terminal emulation sessions, used to validate service level agreements for mainframe-access gateways. It exposes a response time collection control table letting a management application configure which types of response-time data are gathered, for which client groups, along with sampling period, threshold high/low values, and statistical bucket boundaries for distribution analysis. Its monitoring purpose is squarely software/service performance oriented: it tracks session response-time distributions and threshold crossings to detect degraded terminal emulation performance experienced by end users, rather than hardware health. It explicitly depends on the companion TN3270E-MIB, importing tn3270eSrvrConfIndex and client group naming conventions from that base module to identify which server and client group a collection entry applies to. It is deployed on TN3270E server gateways in enterprise environments where mainframe terminal access performance must be measured against SLA commitments. Engineers implementing or auditing this functionality typically reference the TN3270E-RT-MIB RFC/standard documentation for the authoritative specification.

IPNetwork Monitor allows you to monitor SNMP objects defined in TN3270E-RT-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

vendor-neutral, standards-based MIB, not tied to a specific manufacturer
TN3270E server/gateway

Monitoring Examples

An administrator would poll tn3270eRtCollCtlTable, keyed by tn3270eSrvrConfIndex and tn3270eRtCollCtlClientGroupName, to review tn3270eRtCollCtlType and tn3270eRtCollCtlSPeriod for an active response-time collection, and compare tn3270eRtCollCtlThreshHigh/ThreshLow against measured samples. A client group whose response times are frequently landing above tn3270eRtCollCtlThreshHigh, as reflected in the higher tn3270eRtCollCtlBucketBndry buckets, would indicate degraded terminal session performance for that user group, warranting investigation of network path or server load.

What Can Be Monitored

response time collection type and sampling period
response time threshold high/low crossings
response time distribution bucket boundaries
client group idle rate

Imported Objects

From IANATn3270eTC-MIB

IANATn3270eAddrType
IANATn3270eAddress

From SNA-NAU-MIB

snanauMIB

MODULE-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

DateAndTime
RowStatus
TestAndIncr
TimeStamp

From TN3270E-MIB

tn3270eClientGroupName	OBJECT-TYPE
tn3270eResMapElementType	OBJECT-TYPE
tn3270eSrvrConfIndex	OBJECT-TYPE

How to Use in IPNetwork Monitor

Example using tn3270eRtDataTotalRts OID:

Select a device implementing TN3270E-RT-MIB 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 tn3270eRtDataTotalRts 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. The count of the total response times collected. 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 sharply between polls relative to its normal baseline (in tenths of seconds), since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
tn3270eRtMIB	1.3.6.1.2.1.34.9			This module defines a portion of the management information base (MIB) that enables monitoring of TN3270 and TN3270E clients' response times by a TN3270E server.
tn3270eRtNotifications	1.3.6.1.2.1.34.9.0
NTF tn3270eRtExceeded	1.3.6.1.2.1.34.9.0.1			This notification is generated when the average response time, tn3270eRtDataAvgRt, exceeds tn3270eRtCollCtlThresholdHigh at the end of a collection interval specified by tn3270eCollCtlSPeriod times tn3270eCollCtlSPMult. Note that the corresponding tn3270eCollCtlType must have traps(5) and average(3) set for this notification to be generated. In addition, tn3270eRtDataAvgCountTrans, tn3270eRtCollCtlThreshHigh, and tn3270eRtDataAvgRt are algorithmically compared to tn3270eRtCollCtlIdleCount for determination if this notification will be suppressed.
NTF tn3270eRtOkay	1.3.6.1.2.1.34.9.0.2			This notification is generated when the average response time, tn3270eRtDataAvgRt, falls below tn3270eRtCollCtlThresholdLow at the end of a collection interval specified by tn3270eCollCtlSPeriod times tn3270eCollCtlSPMult, after a tn3270eRtExceeded notification was generated. Note that the corresponding tn3270eCollCtlType must have traps(5) and average(3) set for this notification to be generated.
NTF tn3270eRtCollStart	1.3.6.1.2.1.34.9.0.3			This notification is generated when response time data collection is enabled for a member of a client group. In order for this notification to occur the corresponding tn3270eRtCollCtlType must have traps(5) selected. tn3270eResMapElementType contains a valid value only if tn3270eRtDataClientAddress contains a valid address (rather than a zero-length octet string).
NTF tn3270eRtCollEnd	1.3.6.1.2.1.34.9.0.4			This notification is generated when an tn3270eRtDataEntry is deleted after being active (actual data collected), in order to enable a management application monitoring an tn3270eRtDataEntry to get the entry's final values. Note that the corresponding tn3270eCollCtlType must have traps(5) set for this notification to be generated.
tn3270eRtObjects	1.3.6.1.2.1.34.9.1
tn3270eRtCollCtlTable	1.3.6.1.2.1.34.9.1.1		not-accessible	The response time monitoring collection control table, which allows a management application to control the types of response time data being collected, and the clients for which it is being collected. This table is indexed by tn3270eSrvrConfIndex and tn3270eClientGroupName imported from the TN3270E-MIB. tn3270eSrvrConfIndex indicates within a host which TN3270E server an entry applies to. tn3270eClientGroupName it identifies the set of IP clients for which response time data is being collected. The particular IP clients making up the set are identified in the tn3270eClientGroupTable in the TN3270E-MIB.
tn3270eRtCollCtlEntry	1.3.6.1.2.1.34.9.1.1.1		not-accessible	An entry in the TN3270E response time monitoring collection control table. To handle the case of multiple TN3270E servers on the same host, the first index of this table is the tn3270eSrvrConfIndex from the TN3270E-MIB.
BIT tn3270eRtCollCtlType	1.3.6.1.2.1.34.9.1.1.1.2	Bits	read-create	This object controls what types of response time data to collect, whether to summarize the data across the members of a client group or keep it individually, whether to introduce dynamic definite responses, and whether to generate traps. aggregate(0) - Aggregate response time data for the client group as a whole. If this bit is set to 0, then maintain response time data separately for each member of the client group. excludeIpComponent(1) - Do not include the IP-network component in any response times. ddr(2) - Enable dynamic definite response. average(3) - Produce an average response time based on a specified collection interval. buckets(4) - Maintain tn3270eRtDataBucket values in a corresponding tn3270eRtDataEntry, based on the bucket boundaries specified in the tn3270eRtCollCtlBucketBndry objects . traps(5) - generate the notifications specified in this MIB module. The tn3270eRtExceeded and tn3270eRtOkay notifications are generated only if average(3) is also specified.
U32 tn3270eRtCollCtlSPeriod	1.3.6.1.2.1.34.9.1.1.1.3	Unsigned32	read-create	The number of seconds that defines the sample period. The actual interval is defined as tn3270eRtCollCtlSPeriod times tn3270eRtCollCtlSPMult. The value of this object is used only if the corresponding tn3270eRtCollCtlType has the average(3) setting.
U32 tn3270eRtCollCtlSPMult	1.3.6.1.2.1.34.9.1.1.1.4	Unsigned32	read-create	The sample period multiplier; this value is multiplied by the sample period, tn3270eRtCollCtlSPeriod, to determine the collection interval. Sliding-window average calculation can, if necessary, be disabled, by setting the sample period multiplier, tn3270eRtCollCtlSPMult, to 1, and setting the sample period, tn3270eRtCollCtlSPeriod, to the required collection interval. The value of this object is used only if the corresponding tn3270eRtCollCtlType has the average(3) setting.
U32 tn3270eRtCollCtlThreshHigh	1.3.6.1.2.1.34.9.1.1.1.5	Unsigned32	read-create	The threshold for generating a tn3270eRtExceeded notification, signalling that a monitored total response time has exceeded the specified limit. A value of zero for this object suppresses generation of this notification. The value of this object is used only if the corresponding tn3270eRtCollCtlType has average(3) and traps(5) selected. A tn3270eRtExceeded notification is not generated again for a tn3270eRtDataEntry until an average response time falling below the low threshold tn3270eRtCollCtlThreshLow specified for the client group has occurred for the entry.
U32 tn3270eRtCollCtlThreshLow	1.3.6.1.2.1.34.9.1.1.1.6	Unsigned32	read-create	The threshold for generating a tn3270eRtOkay notification, signalling that a monitored total response time has fallen below the specified limit. A value of zero for this object suppresses generation of this notification. The value of this object is used only if the corresponding tn3270eRtCollCtlType has average(3) and traps(5) selected. A tn3270eRtOkay notification is not generated again for a tn3270eRtDataEntry until an average response time exceeding the high threshold tn3270eRtCollCtlThreshHigh specified for the client group has occurred for the entry.
U32 tn3270eRtCollCtlIdleCount	1.3.6.1.2.1.34.9.1.1.1.7	Unsigned32	read-create	The value of this object is used to determine whether a sample that yields an average response time exceeding the value of tn3270eRtCollCtlThreshHigh was a statistically valid one. If the following statement is true, then the sample was statistically valid, and so a tn3270eRtExceeded notification should be generated: AvgCountTrans * ((AvgRt/ThreshHigh - 1) ** 2) >= IdleCount This comparison is done only if the corresponding tn3270eRtCollCtlType has average(3) and traps(5) selected.
U32 tn3270eRtCollCtlBucketBndry1	1.3.6.1.2.1.34.9.1.1.1.8	Unsigned32	read-create	The value of this object defines the range of transaction response times counted in the Tn3270eRtDataBucket1Rts object: those less than or equal to this value.
U32 tn3270eRtCollCtlBucketBndry2	1.3.6.1.2.1.34.9.1.1.1.9	Unsigned32	read-create	The value of this object, together with that of the tn3270eRtCollCtlBucketBndry1 object, defines the range of transaction response times counted in the Tn3270eRtDataBucket2Rts object: those greater than the value of the tn3270eRtCollCtlBucketBndry1 object, and less than or equal to the value of this object.
U32 tn3270eRtCollCtlBucketBndry3	1.3.6.1.2.1.34.9.1.1.1.10	Unsigned32	read-create	The value of this object, together with that of the tn3270eRtCollCtlBucketBndry2 object, defines the range of transaction response times counted in the Tn3270eRtDataBucket3Rts object: those greater than the value of the tn3270eRtCollCtlBucketBndry2 object, and less than or equal to the value of this object.
U32 tn3270eRtCollCtlBucketBndry4	1.3.6.1.2.1.34.9.1.1.1.11	Unsigned32	read-create	The value of this object, together with that of the tn3270eRtCollCtlBucketBndry3 object, defines the range of transaction response times counted in the Tn3270eRtDataBucket4Rts object: those greater than the value of the tn3270eRtCollCtlBucketBndry3 object, and less than or equal to the value of this object. The value of this object also defines the range of transaction response times counted in the Tn3270eRtDataBucket5Rts object: those greater than the value of this object.
ROW tn3270eRtCollCtlRowStatus	1.3.6.1.2.1.34.9.1.1.1.12	RowStatus	read-create	This object allows entries to be created and deleted in the tn3270eRtCollCtlTable. An entry in this table is deleted by setting this object to destroy(6). Deleting an entry in this table has the side-effect of removing all entries from the tn3270eRtDataTable that are associated with the entry being deleted.
tn3270eRtDataTable	1.3.6.1.2.1.34.9.1.2		not-accessible	The response time data table. Entries in this table are created based on entries in the tn3270eRtCollCtlTable.
tn3270eRtDataEntry	1.3.6.1.2.1.34.9.1.2.1		not-accessible	Entries in this table are created based upon the tn3270eRtCollCtlTable. When the corresponding tn3270eRtCollCtlType has aggregate(0) specified, a single entry is created in this table, with a tn3270eRtDataClientAddrType of unknown(0), a zero-length octet string value for tn3270eRtDataClientAddress, and a tn3270eRtDataClientPort value of 0. When aggregate(0) is not specified, a separate entry is created for each client in the group. Note that the following objects defined within an entry in this table can wrap: tn3270eRtDataTotalRts tn3270eRtDataTotalIpRts tn3270eRtDataCountTrans tn3270eRtDataCountDrs tn3270eRtDataElapsRnTrpSq tn3270eRtDataElapsIpRtSq tn3270eRtDataBucket1Rts tn3270eRtDataBucket2Rts tn3270eRtDataBucket3Rts tn3270eRtDataBucket4Rts tn3270eRtDataBucket5Rts
IAN tn3270eRtDataClientAddrType	1.3.6.1.2.1.34.9.1.2.1.1	IANATn3270eAddrType	not-accessible	Indicates the type of address represented by the value of tn3270eRtDataClientAddress. The value unknown(0) is used if aggregate data is being collected for the client group.
ADR tn3270eRtDataClientAddress	1.3.6.1.2.1.34.9.1.2.1.2	IANATn3270eAddress	not-accessible	Contains the IP address of the TN3270 client being monitored. A zero-length octet string is used if aggregate data is being collected for the client group.
U32 tn3270eRtDataClientPort	1.3.6.1.2.1.34.9.1.2.1.3	Unsigned32	not-accessible	Contains the client port number of the TN3270 client being monitored. The value 0 is used if aggregate data is being collected for the client group, or if the tn3270eRtDataClientAddrType identifies an address type that does not support ports.
G32 tn3270eRtDataAvgRt	1.3.6.1.2.1.34.9.1.2.1.4	Gauge32	read-only	The average total response time measured over the last collection interval.
G32 tn3270eRtDataAvgIpRt	1.3.6.1.2.1.34.9.1.2.1.5	Gauge32	read-only	The average IP response time measured over the last collection interval.
G32 tn3270eRtDataAvgCountTrans	1.3.6.1.2.1.34.9.1.2.1.6	Gauge32	read-only	The sliding transaction count used for calculating the values of the tn3270eRtDataAvgRt and tn3270eRtDataAvgIpRt objects. The actual transaction count is available in the tn3270eRtDataCountTrans object. The initial value of this object, before any averages have been calculated, is 0.
DAT tn3270eRtDataIntTimeStamp	1.3.6.1.2.1.34.9.1.2.1.7	DateAndTime	read-only	The date and time of the last interval that tn3270eRtDataAvgRt, tn3270eRtDataAvgIpRt, and tn3270eRtDataAvgCountTrans were calculated. Prior to the calculation of the first interval averages, this object returns the value 0x0000000000000000000000. When this value is returned, the remaining objects in the entry have no significance.
C32 tn3270eRtDataTotalRtsEx	1.3.6.1.2.1.34.9.1.2.1.8	Counter32	read-only	The count of the total response times collected. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
C32 tn3270eRtDataTotalIpRts	1.3.6.1.2.1.34.9.1.2.1.9	Counter32	read-only	The count of the total IP-network response times collected. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
C32 tn3270eRtDataCountTrans	1.3.6.1.2.1.34.9.1.2.1.10	Counter32	read-only	The count of the total number of transactions detected. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
C32 tn3270eRtDataCountDrs	1.3.6.1.2.1.34.9.1.2.1.11	Counter32	read-only	The count of the total number of definite responses detected. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
U32 tn3270eRtDataElapsRndTrpSq	1.3.6.1.2.1.34.9.1.2.1.12	Unsigned32	read-only	The sum of the elapsed round trip time squared. The sum of the squares is kept in order to enable calculation of a variance.
U32 tn3270eRtDataElapsIpRtSq	1.3.6.1.2.1.34.9.1.2.1.13	Unsigned32	read-only	The sum of the elapsed IP round trip time squared. The sum of the squares is kept in order to enable calculation of a variance.
C32 tn3270eRtDataBucket1Rts	1.3.6.1.2.1.34.9.1.2.1.14	Counter32	read-only	The count of the response times falling into bucket 1. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
C32 tn3270eRtDataBucket2Rts	1.3.6.1.2.1.34.9.1.2.1.15	Counter32	read-only	The count of the response times falling into bucket 2. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
C32 tn3270eRtDataBucket3Rts	1.3.6.1.2.1.34.9.1.2.1.16	Counter32	read-only	The count of the response times falling into bucket 3. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
C32 tn3270eRtDataBucket4Rts	1.3.6.1.2.1.34.9.1.2.1.17	Counter32	read-only	The count of the response times falling into bucket 4. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
C32 tn3270eRtDataBucket5Rts	1.3.6.1.2.1.34.9.1.2.1.18	Counter32	read-only	The count of the response times falling into bucket 5. A management application can detect discontinuities in this counter by monitoring the tn3270eRtDataDiscontinuityTime object.
INT tn3270eRtDataRtMethod	1.3.6.1.2.1.34.9.1.2.1.19	INTEGER	read-only	The value of this object indicates the method that was used in calculating the IP network time. The value 'none(0) indicates that response times were not calculated for the IP network.
TIM tn3270eRtDataDiscontinuityTime	1.3.6.1.2.1.34.9.1.2.1.20	TimeStamp	read-only	The value of sysUpTime on the most recent occasion at which one or more of this entry's counter objects suffered a discontinuity. This may happen if a TN3270E server is stopped and then restarted, and local methods are used to set up collection policy (tn3270eRtCollCtlTable entries).
TES tn3270eRtSpinLock	1.3.6.1.2.1.34.9.1.3	TestAndIncr	read-write	An advisory lock used to allow cooperating TN3270E-RT-MIB applications to coordinate their use of the tn3270eRtCollCtlTable. When creating a new entry or altering an existing entry in the tn3270eRtCollCtlTable, an application should make use of tn3270eRtSpinLock to serialize application changes or additions. Since this is an advisory lock, the use of this lock is not enforced.
tn3270eRtConformance	1.3.6.1.2.1.34.9.3
tn3270eRtGroups	1.3.6.1.2.1.34.9.3.1
tn3270eRtGroup	1.3.6.1.2.1.34.9.3.1.1			This group is mandatory for all implementations that support the TN3270E-RT-MIB.
tn3270eRtNotGroup	1.3.6.1.2.1.34.9.3.1.2			The notifications that must be supported when the TN3270E-RT-MIB is implemented.
tn3270eRtCompliances	1.3.6.1.2.1.34.9.3.2
tn3270eRtCompliance	1.3.6.1.2.1.34.9.3.2.1			The compliance statement for agents that support the TN327E-RT-MIB.

RFC description

Monitors TN3270/TN3270E client response times and performance metrics on remote hosts.

Start monitoring vendor-neutral, standards-based MIB, TN3270E server/gateway (response-time distribution/threshold status) 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 TN3270E-RT-MIB