mibs/ietf/TN3270E-RT-MIB

   1 TN3270E-RT-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4     MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
   5     Counter32, Unsigned32, Gauge32
   6                 FROM SNMPv2-SMI
   7     RowStatus, DateAndTime, TimeStamp, TestAndIncr
   8                 FROM SNMPv2-TC
   9     MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
  10                 FROM SNMPv2-CONF
  11     tn3270eSrvrConfIndex, tn3270eClientGroupName,
  12     tn3270eResMapElementType
  13                 FROM TN3270E-MIB
  14     IANATn3270eAddrType, IANATn3270eAddress
  15                 FROM IANATn3270eTC-MIB
  16     snanauMIB
  17                 FROM SNA-NAU-MIB;
  18
  19   tn3270eRtMIB   MODULE-IDENTITY
  20       LAST-UPDATED "9807270000Z" -- July 27, 1998
  21       ORGANIZATION "TN3270E Working Group"
  22       CONTACT-INFO
  23         "Kenneth White (kennethw@vnet.ibm.com)
  24          IBM Corp. - Dept. BRQA/Bldg. 501/G114
  25          P.O. Box 12195
  26          3039 Cornwallis
  27          RTP, NC 27709-2195
  28
  29          Robert Moore (remoore@us.ibm.com)
  30          IBM Corp. - Dept. BRQA/Bldg. 501/G114
  31          P.O. Box 12195
  32          3039 Cornwallis
  33          RTP, NC 27709-2195
  34          (919) 254-4436"
  35      DESCRIPTION
  36         "This module defines a portion of the management
  37         information base (MIB) that enables monitoring of
  38         TN3270 and TN3270E clients' response times by a
  39         TN3270E server."
  40      REVISION  "9807270000Z" -- July 27, 1998
  41      DESCRIPTION
  42          "RFC nnnn (Proposed Standard)" -- RFC Editor to fill in
  43 ::= { snanauMIB 9 }
  44 -- snanauMIB ::= { mib-2 34 }
  45
  46 -- Top level structure of the MIB
  47
  48 tn3270eRtNotifications   OBJECT IDENTIFIER  ::= { tn3270eRtMIB 0 }
  49 tn3270eRtObjects         OBJECT IDENTIFIER  ::= { tn3270eRtMIB 1 }
  50 tn3270eRtConformance     OBJECT IDENTIFIER  ::= { tn3270eRtMIB 3 }
  51
  52 -- MIB Objects
  53
  54 -- Response Time Control Table
  55
  56 tn3270eRtCollCtlTable  OBJECT-TYPE
  57     SYNTAX       SEQUENCE OF Tn3270eRtCollCtlEntry
  58     MAX-ACCESS   not-accessible
  59     STATUS       current
  60     DESCRIPTION
  61       "The response time monitoring collection control table,
  62       which allows a management application to control the
  63       types of response time data being collected, and the
  64       clients for which it is being collected.
  65
  66       This table is indexed by tn3270eSrvrConfIndex and
  67       tn3270eClientGroupName imported from the
  68       TN3270E-MIB.  tn3270eSrvrConfIndex indicates within
  69       a host which TN3270E server an entry applies to.
  70       tn3270eClientGroupName it identifies the set of IP
  71       clients for which response time data is being collected.
  72       The particular IP clients making up the set are identified
  73       in the tn3270eClientGroupTable in the TN3270E-MIB."
  74     ::= { tn3270eRtObjects 1}
  75
  76 tn3270eRtCollCtlEntry    OBJECT-TYPE
  77     SYNTAX        Tn3270eRtCollCtlEntry
  78     MAX-ACCESS    not-accessible
  79     STATUS        current
  80     DESCRIPTION
  81       "An entry in the TN3270E response time monitoring collection
  82       control table.  To handle the case of multiple TN3270E
  83       servers on the same host, the first index of this table is
  84       the tn3270eSrvrConfIndex from the TN3270E-MIB."
  85     INDEX {
  86       tn3270eSrvrConfIndex,    -- Server's index
  87       tn3270eClientGroupName } -- What to collect on
  88     ::= { tn3270eRtCollCtlTable 1 }
  89
  90 Tn3270eRtCollCtlEntry ::= SEQUENCE {
  91     tn3270eRtCollCtlType              BITS,
  92     tn3270eRtCollCtlSPeriod           Unsigned32,
  93     tn3270eRtCollCtlSPMult            Unsigned32,
  94     tn3270eRtCollCtlThreshHigh        Unsigned32,
  95     tn3270eRtCollCtlThreshLow         Unsigned32,
  96     tn3270eRtCollCtlIdleCount         Unsigned32,
  97     tn3270eRtCollCtlBucketBndry1      Unsigned32,
  98     tn3270eRtCollCtlBucketBndry2      Unsigned32,
  99     tn3270eRtCollCtlBucketBndry3      Unsigned32,
 100     tn3270eRtCollCtlBucketBndry4      Unsigned32,
 101     tn3270eRtCollCtlRowStatus         RowStatus   }
 102
 103 -- The OID { tn3270eRtCollCtlEntry 1 } is not used
 104
 105 tn3270eRtCollCtlType  OBJECT-TYPE
 106     SYNTAX    BITS {
 107                      aggregate(0),
 108                      excludeIpComponent(1),
 109                      ddr(2),
 110                      average(3),
 111                      buckets(4),
 112                      traps(5)
 113                    }
 114     MAX-ACCESS   read-create
 115     STATUS       current
 116     DESCRIPTION
 117       "This object controls what types of response time data to
 118        collect, whether to summarize the data across the members
 119        of a client group or keep it individually, whether to
 120        introduce dynamic definite responses, and whether to
 121        generate traps.
 122        aggregate(0)          - Aggregate response time data for the
 123                                client group as a whole.  If this bit
 124                                is set to 0, then maintain response
 125                                time data separately for each member
 126                                of the client group.
 127        excludeIpComponent(1) - Do not include the IP-network
 128                                component in any response times.
 129        ddr(2)                - Enable dynamic definite response.
 130        average(3)            - Produce an average response time
 131                                based on a specified collection
 132                                interval.
 133        buckets(4)            - Maintain tn3270eRtDataBucket values in
 134                                a corresponding tn3270eRtDataEntry,
 135                                based on the bucket boundaries specified
 136                                in the tn3270eRtCollCtlBucketBndry
 137                                objects          .
 138        traps(5)              - generate the notifications specified
 139                                in this MIB module.  The
 140                                tn3270eRtExceeded and tn3270eRtOkay
 141                                notifications are generated only if
 142                                average(3) is also specified."
 143     ::= { tn3270eRtCollCtlEntry 2 }
 144
 145 tn3270eRtCollCtlSPeriod OBJECT-TYPE
 146     SYNTAX  Unsigned32 (15..86400) -- 15 second min, 24 hour max
 147     UNITS   "seconds"
 148     MAX-ACCESS   read-create
 149     STATUS       current
 150     DESCRIPTION
 151       "The number of seconds that defines the sample period.
 152        The actual interval is defined as tn3270eRtCollCtlSPeriod
 153        times tn3270eRtCollCtlSPMult.
 154
 155        The value of this object is used only if the corresponding
 156        tn3270eRtCollCtlType has the average(3) setting."
 157     DEFVAL   {20}    -- 20 seconds
 158     ::= { tn3270eRtCollCtlEntry 3 }
 159
 160 tn3270eRtCollCtlSPMult OBJECT-TYPE
 161     SYNTAX  Unsigned32 (1..5760) -- 5760 x SPeriod of 15 is 24 hours
 162     UNITS   "period"
 163     MAX-ACCESS   read-create
 164     STATUS       current
 165     DESCRIPTION
 166       "The sample period multiplier; this value is multiplied by
 167       the sample period, tn3270eRtCollCtlSPeriod, to determine
 168       the collection interval.
 169       Sliding-window average calculation can, if necessary, be
 170       disabled, by setting the sample period multiplier,
 171       tn3270eRtCollCtlSPMult, to 1, and setting the sample
 172       period, tn3270eRtCollCtlSPeriod, to the required
 173       collection interval.
 174
 175       The value of this object is used only if the corresponding
 176       tn3270eRtCollCtlType has the average(3) setting."
 177     DEFVAL   { 30 }    -- yields an interval of 10 minutes when
 178                        -- used with the default SPeriod value
 179     ::= { tn3270eRtCollCtlEntry 4 }
 180
 181 tn3270eRtCollCtlThreshHigh  OBJECT-TYPE
 182     SYNTAX            Unsigned32
 183     UNITS             "seconds"
 184     MAX-ACCESS        read-create
 185     STATUS            current
 186     DESCRIPTION
 187       "The threshold for generating a tn3270eRtExceeded
 188       notification, signalling that a monitored total response
 189       time has exceeded the specified limit.  A value of zero
 190       for this object suppresses generation of this notification.
 191       The value of this object is used only if the corresponding
 192       tn3270eRtCollCtlType has average(3) and traps(5) selected.
 193
 194       A tn3270eRtExceeded notification is not generated again for a
 195       tn3270eRtDataEntry until an average response time falling below
 196       the low threshold tn3270eRtCollCtlThreshLow specified for the
 197       client group has occurred for the entry."
 198
 199     DEFVAL   { 0 }   -- suppress notifications
 200     ::= { tn3270eRtCollCtlEntry 5 }
 201
 202 tn3270eRtCollCtlThreshLow   OBJECT-TYPE
 203     SYNTAX            Unsigned32
 204     UNITS             "seconds"
 205     MAX-ACCESS        read-create
 206     STATUS            current
 207     DESCRIPTION
 208       "The threshold for generating a tn3270eRtOkay notification,
 209       signalling that a monitored total response time has fallen
 210       below the specified limit.  A value of zero for this object
 211       suppresses generation of this notification.  The value of
 212       this object is used only if the corresponding
 213       tn3270eRtCollCtlType has average(3) and traps(5) selected.
 214
 215       A tn3270eRtOkay notification is not generated again for a
 216       tn3270eRtDataEntry until an average response time
 217       exceeding the high threshold tn3270eRtCollCtlThreshHigh
 218       specified for the client group has occurred for the entry."
 219     DEFVAL   { 0 }   -- suppress notifications
 220     ::= { tn3270eRtCollCtlEntry 6 }
 221
 222 tn3270eRtCollCtlIdleCount   OBJECT-TYPE
 223     SYNTAX            Unsigned32
 224     UNITS             "transactions"
 225     MAX-ACCESS        read-create
 226     STATUS            current
 227     DESCRIPTION
 228       "The value of this object is used to determine whether a
 229       sample that yields an average response time exceeding the
 230       value of tn3270eRtCollCtlThreshHigh was a statistically
 231       valid one.  If the following statement is true, then the
 232       sample was statistically valid, and so a tn3270eRtExceeded
 233       notification should be generated:
 234
 235         AvgCountTrans * ((AvgRt/ThreshHigh - 1) ** 2) >=  IdleCount
 236
 237       This comparison is done only if the corresponding
 238       tn3270eRtCollCtlType has average(3) and traps(5) selected."
 239     DEFVAL { 1 }
 240     ::= { tn3270eRtCollCtlEntry 7 }
 241
 242 tn3270eRtCollCtlBucketBndry1   OBJECT-TYPE
 243     SYNTAX            Unsigned32
 244     UNITS             "tenths of seconds"
 245     MAX-ACCESS        read-create
 246     STATUS            current
 247     DESCRIPTION
 248       "The value of this object defines the range of transaction
 249        response times counted in the Tn3270eRtDataBucket1Rts
 250        object: those less than or equal to this value."
 251     DEFVAL { 10 }
 252     ::= { tn3270eRtCollCtlEntry 8 }
 253
 254 tn3270eRtCollCtlBucketBndry2   OBJECT-TYPE
 255     SYNTAX            Unsigned32
 256     UNITS             "tenths of seconds"
 257     MAX-ACCESS        read-create
 258     STATUS            current
 259     DESCRIPTION
 260       "The value of this object, together with that of the
 261       tn3270eRtCollCtlBucketBndry1 object, defines the range
 262       of transaction response times counted in the
 263       Tn3270eRtDataBucket2Rts object: those greater than the
 264       value of the tn3270eRtCollCtlBucketBndry1 object, and
 265       less than or equal to the value of this object."
 266     DEFVAL { 20 }
 267     ::= { tn3270eRtCollCtlEntry 9 }
 268
 269 tn3270eRtCollCtlBucketBndry3   OBJECT-TYPE
 270     SYNTAX            Unsigned32
 271     UNITS             "tenths of seconds"
 272     MAX-ACCESS        read-create
 273     STATUS            current
 274     DESCRIPTION
 275       "The value of this object, together with that of the
 276       tn3270eRtCollCtlBucketBndry2 object, defines the range of
 277       transaction response times counted in the
 278       Tn3270eRtDataBucket3Rts object:  those greater than the
 279       value of the tn3270eRtCollCtlBucketBndry2 object, and less
 280       than or equal to the value of this object."
 281     DEFVAL { 50 }
 282     ::= { tn3270eRtCollCtlEntry 10 }
 283
 284 tn3270eRtCollCtlBucketBndry4   OBJECT-TYPE
 285     SYNTAX            Unsigned32
 286     UNITS             "tenths of seconds"
 287     MAX-ACCESS        read-create
 288     STATUS            current
 289     DESCRIPTION
 290       "The value of this object, together with that of the
 291       tn3270eRtCollCtlBucketBndry3 object, defines the range
 292       of transaction response times counted in the
 293       Tn3270eRtDataBucket4Rts object: those greater than the
 294       value of the tn3270eRtCollCtlBucketBndry3 object, and
 295       less than or equal to the value of this object.
 296
 297       The value of this object also defines the range of
 298       transaction response times counted in the
 299       Tn3270eRtDataBucket5Rts object: those greater than the
 300       value of this object."
 301     DEFVAL { 100 }
 302     ::= { tn3270eRtCollCtlEntry 11 }
 303
 304 tn3270eRtCollCtlRowStatus  OBJECT-TYPE
 305     SYNTAX            RowStatus
 306     MAX-ACCESS        read-create
 307     STATUS            current
 308     DESCRIPTION
 309       "This object allows entries to be created and deleted
 310        in the tn3270eRtCollCtlTable.  An entry in this table
 311        is deleted by setting this object to destroy(6).
 312        Deleting an entry in this table has the side-effect
 313        of removing all entries from the tn3270eRtDataTable
 314        that are associated with the entry being deleted."
 315     ::= { tn3270eRtCollCtlEntry 12 }
 316
 317
 318 -- TN3270E Response Time Data Table
 319
 320 tn3270eRtDataTable  OBJECT-TYPE
 321     SYNTAX       SEQUENCE OF Tn3270eRtDataEntry
 322     MAX-ACCESS   not-accessible
 323     STATUS       current
 324     DESCRIPTION
 325       "The response time data table.  Entries in this table are
 326        created based on entries in the tn3270eRtCollCtlTable."
 327     ::= { tn3270eRtObjects 2 }
 328
 329 tn3270eRtDataEntry  OBJECT-TYPE
 330     SYNTAX        Tn3270eRtDataEntry
 331     MAX-ACCESS    not-accessible
 332     STATUS        current
 333     DESCRIPTION
 334       "Entries in this table are created based upon the
 335       tn3270eRtCollCtlTable.  When the corresponding
 336       tn3270eRtCollCtlType has aggregate(0) specified, a single
 337       entry is created in this table, with a tn3270eRtDataClientAddrType
 338       of unknown(0), a zero-length octet string value for
 339       tn3270eRtDataClientAddress, and a tn3270eRtDataClientPort value of
 340       0.  When aggregate(0) is not specified, a separate entry is
 341       created for each client in the group.
 342
 343       Note that the following objects defined within an entry in this
 344       table can  wrap:
 345           tn3270eRtDataTotalRts
 346           tn3270eRtDataTotalIpRts
 347           tn3270eRtDataCountTrans
 348           tn3270eRtDataCountDrs
 349           tn3270eRtDataElapsRnTrpSq
 350           tn3270eRtDataElapsIpRtSq
 351           tn3270eRtDataBucket1Rts
 352           tn3270eRtDataBucket2Rts
 353           tn3270eRtDataBucket3Rts
 354           tn3270eRtDataBucket4Rts
 355           tn3270eRtDataBucket5Rts"
 356     INDEX {
 357        tn3270eSrvrConfIndex,      -- Server's local index
 358        tn3270eClientGroupName,    -- Collection target
 359        tn3270eRtDataClientAddrType,
 360        tn3270eRtDataClientAddress,
 361        tn3270eRtDataClientPort }
 362     ::= { tn3270eRtDataTable 1 }
 363
 364 Tn3270eRtDataEntry ::= SEQUENCE {
 365        tn3270eRtDataClientAddrType        IANATn3270eAddrType,
 366        tn3270eRtDataClientAddress         IANATn3270eAddress,
 367        tn3270eRtDataClientPort            Unsigned32,
 368        tn3270eRtDataAvgRt                 Gauge32,
 369        tn3270eRtDataAvgIpRt               Gauge32,
 370        tn3270eRtDataAvgCountTrans         Gauge32,
 371        tn3270eRtDataIntTimeStamp          DateAndTime,
 372        tn3270eRtDataTotalRts              Counter32,
 373        tn3270eRtDataTotalIpRts            Counter32,
 374        tn3270eRtDataCountTrans            Counter32,
 375        tn3270eRtDataCountDrs              Counter32,
 376        tn3270eRtDataElapsRndTrpSq         Unsigned32,
 377        tn3270eRtDataElapsIpRtSq           Unsigned32,
 378        tn3270eRtDataBucket1Rts            Counter32,
 379        tn3270eRtDataBucket2Rts            Counter32,
 380        tn3270eRtDataBucket3Rts            Counter32,
 381        tn3270eRtDataBucket4Rts            Counter32,
 382        tn3270eRtDataBucket5Rts            Counter32,
 383        tn3270eRtDataRtMethod              INTEGER,
 384        tn3270eRtDataDiscontinuityTime     TimeStamp
 385    }
 386
 387 tn3270eRtDataClientAddrType   OBJECT-TYPE
 388     SYNTAX    IANATn3270eAddrType
 389     MAX-ACCESS   not-accessible
 390     STATUS       current
 391     DESCRIPTION
 392       "Indicates the type of address represented by the value
 393       of tn3270eRtDataClientAddress.  The value unknown(0) is
 394       used if aggregate data is being collected for the client
 395       group."
 396     ::= { tn3270eRtDataEntry 1 }
 397
 398 tn3270eRtDataClientAddress   OBJECT-TYPE
 399     SYNTAX    IANATn3270eAddress
 400     MAX-ACCESS   not-accessible
 401     STATUS       current
 402     DESCRIPTION
 403       "Contains the IP address of the TN3270 client being
 404       monitored.  A zero-length octet string is used if
 405       aggregate data is being collected for the client group."
 406     ::= { tn3270eRtDataEntry 2 }
 407
 408 tn3270eRtDataClientPort   OBJECT-TYPE
 409     SYNTAX       Unsigned32(0..65535)
 410     MAX-ACCESS   not-accessible
 411     STATUS       current
 412     DESCRIPTION
 413       "Contains the client port number of the TN3270 client being
 414       monitored.  The value 0 is used if aggregate data is being
 415       collected for the client group, or if the
 416       tn3270eRtDataClientAddrType identifies an address type that
 417       does not support ports."
 418     ::= { tn3270eRtDataEntry 3 }
 419
 420 tn3270eRtDataAvgRt OBJECT-TYPE
 421     SYNTAX       Gauge32
 422     UNITS        "tenths of seconds"
 423     MAX-ACCESS   read-only
 424     STATUS       current
 425     DESCRIPTION
 426       "The average total response time measured over the last
 427       collection interval."
 428     DEFVAL { 0 }
 429     ::= { tn3270eRtDataEntry 4 }
 430
 431 tn3270eRtDataAvgIpRt OBJECT-TYPE
 432     SYNTAX       Gauge32
 433     UNITS        "tenths of seconds"
 434     MAX-ACCESS   read-only
 435     STATUS       current
 436     DESCRIPTION
 437       "The average IP response time measured over the last
 438       collection interval."
 439     DEFVAL { 0 }
 440     ::= { tn3270eRtDataEntry 5 }
 441
 442 tn3270eRtDataAvgCountTrans   OBJECT-TYPE
 443     SYNTAX       Gauge32
 444     UNITS        "transactions"
 445     MAX-ACCESS   read-only
 446     STATUS       current
 447     DESCRIPTION
 448       "The sliding transaction count used for calculating the
 449       values of the tn3270eRtDataAvgRt and tn3270eRtDataAvgIpRt
 450       objects.  The actual transaction count is available in
 451       the tn3270eRtDataCountTrans object.
 452
 453       The initial value of this object, before any averages have
 454       been calculated, is 0."
 455     ::= { tn3270eRtDataEntry 6 }
 456
 457 tn3270eRtDataIntTimeStamp   OBJECT-TYPE
 458     SYNTAX       DateAndTime
 459     MAX-ACCESS   read-only
 460     STATUS       current
 461     DESCRIPTION
 462       "The date and time of the last interval that
 463       tn3270eRtDataAvgRt, tn3270eRtDataAvgIpRt, and
 464       tn3270eRtDataAvgCountTrans were calculated.
 465
 466       Prior to the calculation of the first interval
 467       averages, this object returns the value
 468       0x0000000000000000000000.  When this value is
 469       returned, the remaining objects in the entry have
 470       no significance."
 471     ::= { tn3270eRtDataEntry 7 }
 472
 473 tn3270eRtDataTotalRts   OBJECT-TYPE
 474     SYNTAX       Counter32
 475     UNITS        "tenths of seconds"
 476     MAX-ACCESS   read-only
 477     STATUS       current
 478     DESCRIPTION
 479       "The count of the total response times collected.
 480
 481       A management application can detect discontinuities in this
 482       counter by monitoring the tn3270eRtDataDiscontinuityTime
 483       object."
 484     ::= { tn3270eRtDataEntry 8 }
 485
 486 tn3270eRtDataTotalIpRts   OBJECT-TYPE
 487     SYNTAX       Counter32
 488     UNITS        "tenths of seconds"
 489     MAX-ACCESS   read-only
 490     STATUS       current
 491     DESCRIPTION
 492       "The count of the total IP-network response times
 493       collected.
 494
 495       A management application can detect discontinuities in this
 496       counter by monitoring the tn3270eRtDataDiscontinuityTime
 497       object."
 498     ::= { tn3270eRtDataEntry 9 }
 499
 500 tn3270eRtDataCountTrans   OBJECT-TYPE
 501     SYNTAX       Counter32
 502     UNITS        "transactions"
 503     MAX-ACCESS   read-only
 504     STATUS       current
 505     DESCRIPTION
 506       "The count of the total number of transactions detected.
 507
 508       A management application can detect discontinuities in this
 509       counter by monitoring the tn3270eRtDataDiscontinuityTime
 510       object."
 511     ::= { tn3270eRtDataEntry 10 }
 512
 513 tn3270eRtDataCountDrs   OBJECT-TYPE
 514     SYNTAX       Counter32
 515     UNITS        "definite responses"
 516     MAX-ACCESS   read-only
 517     STATUS       current
 518     DESCRIPTION
 519       "The count of the total number of definite responses
 520       detected.
 521
 522       A management application can detect discontinuities in this
 523       counter by monitoring the tn3270eRtDataDiscontinuityTime
 524       object."
 525     ::= { tn3270eRtDataEntry 11 }
 526
 527 tn3270eRtDataElapsRndTrpSq   OBJECT-TYPE
 528     SYNTAX       Unsigned32
 529     UNITS        "tenths of seconds squared"
 530     MAX-ACCESS   read-only
 531     STATUS       current
 532     DESCRIPTION
 533       "The sum of the elapsed round trip time squared.  The sum
 534       of the squares is kept in order to enable calculation of
 535       a variance."
 536     DEFVAL { 0 }
 537     ::= { tn3270eRtDataEntry 12 }
 538
 539 tn3270eRtDataElapsIpRtSq   OBJECT-TYPE
 540     SYNTAX       Unsigned32
 541     UNITS        "tenths of seconds squared"
 542     MAX-ACCESS   read-only
 543     STATUS       current
 544     DESCRIPTION
 545       "The sum of the elapsed IP round trip time squared.
 546       The sum of the squares is kept in order to enable
 547       calculation of a variance."
 548     DEFVAL { 0 }
 549     ::= { tn3270eRtDataEntry 13 }
 550
 551 tn3270eRtDataBucket1Rts   OBJECT-TYPE
 552     SYNTAX       Counter32
 553     MAX-ACCESS   read-only
 554     STATUS       current
 555     DESCRIPTION
 556       "The count of the response times falling into bucket 1.
 557
 558       A management application can detect discontinuities in this
 559       counter by monitoring the tn3270eRtDataDiscontinuityTime
 560       object."
 561     ::= { tn3270eRtDataEntry 14 }
 562
 563 tn3270eRtDataBucket2Rts   OBJECT-TYPE
 564     SYNTAX       Counter32
 565     MAX-ACCESS   read-only
 566     STATUS       current
 567     DESCRIPTION
 568       "The count of the response times falling into bucket 2.
 569
 570       A management application can detect discontinuities in this
 571       counter by monitoring the tn3270eRtDataDiscontinuityTime
 572       object."
 573     ::= { tn3270eRtDataEntry 15 }
 574
 575 tn3270eRtDataBucket3Rts   OBJECT-TYPE
 576     SYNTAX       Counter32
 577     MAX-ACCESS   read-only
 578     STATUS       current
 579     DESCRIPTION
 580       "The count of the response times falling into bucket 3.
 581
 582       A management application can detect discontinuities in this
 583       counter by monitoring the tn3270eRtDataDiscontinuityTime
 584       object."
 585     ::= { tn3270eRtDataEntry 16 }
 586
 587 tn3270eRtDataBucket4Rts  OBJECT-TYPE
 588     SYNTAX       Counter32
 589     MAX-ACCESS   read-only
 590     STATUS       current
 591     DESCRIPTION
 592       "The count of the response times falling into bucket 4.
 593
 594       A management application can detect discontinuities in this
 595       counter by monitoring the tn3270eRtDataDiscontinuityTime
 596       object."
 597     ::= { tn3270eRtDataEntry 17 }
 598
 599 tn3270eRtDataBucket5Rts  OBJECT-TYPE
 600     SYNTAX       Counter32
 601     MAX-ACCESS   read-only
 602     STATUS       current
 603     DESCRIPTION
 604       "The count of the response times falling into bucket 5.
 605
 606       A management application can detect discontinuities in this
 607       counter by monitoring the tn3270eRtDataDiscontinuityTime
 608       object."
 609     ::= { tn3270eRtDataEntry 18 }
 610
 611 tn3270eRtDataRtMethod OBJECT-TYPE
 612     SYNTAX       INTEGER {
 613                            none(0),
 614                            responses(1),
 615                            timingMark(2)
 616                          }
 617     MAX-ACCESS   read-only
 618     STATUS       current
 619     DESCRIPTION
 620       "The value of this object indicates the method that was
 621       used in calculating the IP network time.
 622
 623       The value 'none(0) indicates that response times were not
 624       calculated for the IP network."
 625     ::= { tn3270eRtDataEntry 19 }
 626
 627 tn3270eRtDataDiscontinuityTime OBJECT-TYPE
 628     SYNTAX      TimeStamp
 629     MAX-ACCESS  read-only
 630     STATUS      current
 631     DESCRIPTION
 632         "The value of sysUpTime on the most recent occasion at
 633         which one or more of this entry's counter objects
 634         suffered a discontinuity.  This may happen if a TN3270E
 635         server is stopped and then restarted, and local methods
 636         are used to set up collection policy
 637         (tn3270eRtCollCtlTable entries)."
 638     ::= { tn3270eRtDataEntry 20 }
 639
 640
 641 tn3270eRtSpinLock OBJECT-TYPE
 642     SYNTAX      TestAndIncr
 643     MAX-ACCESS  read-write
 644     STATUS      current
 645     DESCRIPTION
 646       "An advisory lock used to allow cooperating TN3270E-RT-MIB
 647       applications to coordinate their use of the
 648       tn3270eRtCollCtlTable.
 649       When creating a new entry or altering an existing entry
 650       in the tn3270eRtCollCtlTable, an application should make
 651       use of tn3270eRtSpinLock to serialize application changes
 652       or additions.
 653
 654       Since this is an advisory lock, the use of this lock is
 655       not enforced."
 656     ::= { tn3270eRtObjects 3 }
 657
 658 -- Notifications
 659
 660 tn3270eRtExceeded   NOTIFICATION-TYPE
 661     OBJECTS {
 662        tn3270eRtDataIntTimeStamp,
 663        tn3270eRtDataAvgRt,
 664        tn3270eRtDataAvgIpRt,
 665        tn3270eRtDataAvgCountTrans,
 666        tn3270eRtDataRtMethod
 667     }
 668     STATUS  current
 669     DESCRIPTION
 670       "This notification is generated when the average response
 671       time, tn3270eRtDataAvgRt, exceeds
 672       tn3270eRtCollCtlThresholdHigh at the end of a collection
 673       interval specified by tn3270eCollCtlSPeriod
 674       times tn3270eCollCtlSPMult.  Note that the corresponding
 675       tn3270eCollCtlType must have traps(5) and average(3) set
 676       for this notification to be generated.  In addition,
 677       tn3270eRtDataAvgCountTrans, tn3270eRtCollCtlThreshHigh, and
 678       tn3270eRtDataAvgRt are algorithmically compared to
 679       tn3270eRtCollCtlIdleCount for determination if this
 680       notification will be suppressed."
 681     ::= { tn3270eRtNotifications 1 }
 682
 683 tn3270eRtOkay   NOTIFICATION-TYPE
 684     OBJECTS {
 685        tn3270eRtDataIntTimeStamp,
 686        tn3270eRtDataAvgRt,
 687        tn3270eRtDataAvgIpRt,
 688        tn3270eRtDataAvgCountTrans,
 689        tn3270eRtDataRtMethod
 690     }
 691     STATUS  current
 692     DESCRIPTION
 693       "This notification is generated when the average response
 694       time, tn3270eRtDataAvgRt, falls below
 695       tn3270eRtCollCtlThresholdLow at the end of a collection
 696       interval specified by tn3270eCollCtlSPeriod times
 697       tn3270eCollCtlSPMult, after a tn3270eRtExceeded
 698       notification was generated.  Note that the corresponding
 699       tn3270eCollCtlType must have traps(5) and average(3)
 700       set for this notification to be generated."
 701     ::= { tn3270eRtNotifications 2 }
 702
 703 tn3270eRtCollStart NOTIFICATION-TYPE
 704     OBJECTS {
 705        tn3270eRtDataRtMethod,       -- type of collection
 706        tn3270eResMapElementType     -- type of resource
 707     }
 708     STATUS  current
 709     DESCRIPTION
 710       "This notification is generated when response time data
 711       collection is enabled for a member of a client group.
 712       In order for this notification to occur the corresponding
 713       tn3270eRtCollCtlType must have traps(5) selected.
 714
 715       tn3270eResMapElementType contains a valid value only if
 716       tn3270eRtDataClientAddress contains a valid address
 717       (rather than a zero-length octet string)."
 718     ::= { tn3270eRtNotifications 3 }
 719
 720 tn3270eRtCollEnd   NOTIFICATION-TYPE
 721     OBJECTS {
 722        tn3270eRtDataDiscontinuityTime,
 723        tn3270eRtDataAvgRt,
 724        tn3270eRtDataAvgIpRt,
 725        tn3270eRtDataAvgCountTrans,
 726        tn3270eRtDataIntTimeStamp,
 727        tn3270eRtDataTotalRts,
 728        tn3270eRtDataTotalIpRts,
 729        tn3270eRtDataCountTrans,
 730        tn3270eRtDataCountDrs,
 731        tn3270eRtDataElapsRndTrpSq,
 732        tn3270eRtDataElapsIpRtSq,
 733        tn3270eRtDataBucket1Rts,
 734        tn3270eRtDataBucket2Rts,
 735        tn3270eRtDataBucket3Rts,
 736        tn3270eRtDataBucket4Rts,
 737        tn3270eRtDataBucket5Rts,
 738        tn3270eRtDataRtMethod
 739     }
 740     STATUS  current
 741     DESCRIPTION
 742       "This notification is generated when an tn3270eRtDataEntry
 743       is deleted after being active (actual data collected), in
 744       order to enable a management application monitoring an
 745       tn3270eRtDataEntry to get the entry's final values.  Note
 746       that the corresponding tn3270eCollCtlType must have traps(5)
 747       set for this notification to be generated."
 748     ::= { tn3270eRtNotifications 4 }
 749
 750 -- Conformance Statement
 751
 752 tn3270eRtGroups       OBJECT IDENTIFIER ::= { tn3270eRtConformance 1 }
 753 tn3270eRtCompliances  OBJECT IDENTIFIER ::= { tn3270eRtConformance 2 }
 754
 755 -- Compliance statements
 756
 757 tn3270eRtCompliance     MODULE-COMPLIANCE
 758     STATUS current
 759     DESCRIPTION
 760       "The compliance statement for agents that support the
 761       TN327E-RT-MIB."
 762     MODULE   -- this module
 763        MANDATORY-GROUPS { tn3270eRtGroup, tn3270eRtNotGroup }
 764
 765     OBJECT tn3270eRtCollCtlType
 766        MIN-ACCESS  read-only
 767        DESCRIPTION
 768           "The agent is not required to support a SET operation to
 769           this object in the absence of adequate security."
 770
 771     OBJECT tn3270eRtCollCtlSPeriod
 772        MIN-ACCESS  read-only
 773        DESCRIPTION
 774           "The agent is not required to allow the user to change
 775           the default value of this object, and is allowed to
 776           use a different default."
 777
 778     OBJECT tn3270eRtCollCtlSPMult
 779        MIN-ACCESS  read-only
 780        DESCRIPTION
 781           "The agent is not required to support a SET operation
 782           to this object in the absence of adequate security."
 783
 784     OBJECT tn3270eRtCollCtlThreshHigh
 785        MIN-ACCESS  read-only
 786        DESCRIPTION
 787           "The agent is not required to support a SET operation
 788           to this object in the absence of adequate security."
 789
 790     OBJECT tn3270eRtCollCtlThreshLow
 791        MIN-ACCESS  read-only
 792        DESCRIPTION
 793           "The agent is not required to support a SET operation
 794           to this object in the absence of adequate security."
 795
 796     OBJECT tn3270eRtCollCtlIdleCount
 797        MIN-ACCESS  read-only
 798        DESCRIPTION
 799           "The agent is not required to support a SET operation
 800           to this object in the absence of adequate security."
 801
 802     OBJECT tn3270eRtCollCtlBucketBndry1
 803        MIN-ACCESS  read-only
 804        DESCRIPTION
 805           "The agent is not required to support a SET operation
 806           to this object in the absence of adequate security."
 807
 808     OBJECT tn3270eRtCollCtlBucketBndry2
 809        MIN-ACCESS  read-only
 810        DESCRIPTION
 811           "The agent is not required to support a SET operation
 812           to this object in the absence of adequate security."
 813
 814     OBJECT tn3270eRtCollCtlBucketBndry3
 815        MIN-ACCESS  read-only
 816        DESCRIPTION
 817           "The agent is not required to support a SET operation
 818           to this object in the absence of adequate security."
 819
 820     OBJECT tn3270eRtCollCtlBucketBndry4
 821        MIN-ACCESS  read-only
 822        DESCRIPTION
 823           "The agent is not required to support a SET operation
 824           to this object in the absence of adequate security."
 825
 826     OBJECT tn3270eRtCollCtlRowStatus
 827        SYNTAX   INTEGER {
 828                          active(1) -- subset of RowStatus
 829                         }
 830        MIN-ACCESS read-only
 831        DESCRIPTION
 832           "Write access is not required, and only one of the six
 833           enumerated values for the RowStatus textual convention
 834           need be supported, specifically: active(1)."
 835
 836     ::= {tn3270eRtCompliances 1 }
 837
 838 -- Group definitions
 839
 840 tn3270eRtGroup         OBJECT-GROUP
 841     OBJECTS {
 842         tn3270eRtCollCtlType,
 843         tn3270eRtCollCtlSPeriod,
 844         tn3270eRtCollCtlSPMult,
 845         tn3270eRtCollCtlThreshHigh,
 846         tn3270eRtCollCtlThreshLow,
 847         tn3270eRtCollCtlIdleCount,
 848         tn3270eRtCollCtlBucketBndry1,
 849         tn3270eRtCollCtlBucketBndry2,
 850         tn3270eRtCollCtlBucketBndry3,
 851         tn3270eRtCollCtlBucketBndry4,
 852         tn3270eRtCollCtlRowStatus,
 853         tn3270eRtDataDiscontinuityTime,
 854         tn3270eRtDataAvgRt,
 855         tn3270eRtDataAvgIpRt,
 856         tn3270eRtDataAvgCountTrans,
 857         tn3270eRtDataIntTimeStamp,
 858         tn3270eRtDataTotalRts,
 859         tn3270eRtDataTotalIpRts,
 860         tn3270eRtDataCountTrans,
 861         tn3270eRtDataCountDrs,
 862         tn3270eRtDataElapsRndTrpSq,
 863         tn3270eRtDataElapsIpRtSq,
 864         tn3270eRtDataBucket1Rts,
 865         tn3270eRtDataBucket2Rts,
 866         tn3270eRtDataBucket3Rts,
 867         tn3270eRtDataBucket4Rts,
 868         tn3270eRtDataBucket5Rts,
 869         tn3270eRtDataRtMethod,
 870         tn3270eRtSpinLock }
 871     STATUS  current
 872     DESCRIPTION
 873       "This group is mandatory for all implementations that
 874       support the TN3270E-RT-MIB. "
 875     ::= { tn3270eRtGroups 1 }
 876
 877 tn3270eRtNotGroup         NOTIFICATION-GROUP
 878     NOTIFICATIONS {
 879         tn3270eRtExceeded,
 880         tn3270eRtOkay,
 881         tn3270eRtCollStart,
 882         tn3270eRtCollEnd
 883      }
 884     STATUS  current
 885     DESCRIPTION
 886       "The notifications that must be supported when the
 887       TN3270E-RT-MIB is implemented. "
 888     ::= { tn3270eRtGroups 2 }
 889
 890 END