home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_q_t / draft-ietf-tn3270e-rt-mib-01.txt < prev    next >
Text File  |  1997-10-01  |  95KB  |  2,517 lines

  1.  
  2.  
  3.  
  4. TN3270E Working Group
  5. INTERNET DRAFT: <draft-ietf-tn3270e-rt-mib-01.txt>         Kenneth White
  6. Expiration Date: September 1998                             Robert Moore
  7.                                                                IBM Corp.
  8.  
  9.                                                           September 1997
  10.  
  11.                Definitions of Managed Objects for TN3270E
  12.                   Response Time Collection Using SMIv2
  13.                             (TN3270E-RT-MIB)
  14.                    <draft-ietf-tn3270e-rt-mib-01.txt>
  15.  
  16.  
  17. Status of this Memo
  18.  
  19.   This document is an Internet Draft. Internet Drafts are working
  20.   documents of the Internet Engineering Task Force (IETF), its Areas,
  21.   and its Working Groups. Note that other groups may also distribute
  22.   working documents as Internet Drafts.
  23.  
  24.   Internet Drafts are draft documents valid for a maximum of six
  25.   months. Internet Drafts may be updated, replaced, or obsoleted by
  26.   other documents at any time. It is not appropriate to use Internet
  27.   Drafts as reference material or to cite them other than as a "working
  28.   draft" or "work in progress."
  29.  
  30.   Please check the I-D abstract listing contained in each Internet
  31.   Draft directory to learn the current status of this or any Internet
  32.   Draft. Distribution of this document is unlimited.
  33.  
  34. Abstract
  35.  
  36.   The purpose of this memo is to define the protocol and the Management
  37.   Information Base (MIB) for performing response time data collection
  38.   on TN3270 and TN3270E
  39.   sessions by a TN3270E Server. The response time data
  40.   collected by a TN3270E Server is structured to support both validation
  41.   of service level agreements and performance monitoring of
  42.   TN3270 and TN3270E
  43.   Sessions. This MIB has as a prerequisite the TN3270E-MIB
  44.   reference [10].
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55. Expires March 1998                                              [Page 1]~
  56.  
  57.  
  58.  
  59.  
  60.  
  61. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  62.  
  63.  
  64.   Table of Contents
  65.  
  66.   1.0 Introduction............................................. 2
  67.   2.0 The SNMPv2 Network Management Framework.................. 2
  68.   2.1 Object Definitions....................................... 3
  69.   3.0 Response Time Collection Methodology..................... 3
  70.   3.1 General Response Time Collection......................... 4
  71.   3.2 TN3270E Server Response Time Collection.................. 5
  72.   3.3 Correlating TN3270E Server and Host Response Times....... 9
  73.   3.4 Timestamp Calculation....................................10
  74.   3.4.1 DR Usage...............................................11
  75.   3.4.2 TIMEMARK Usage.........................................13
  76.   3.5 Performance Data Modelling...............................14
  77.   3.5.1 Averaging Response Times...............................15
  78.   3.5.2 Response Time Buckets..................................17
  79.   4.0 Structure of the MIB.....................................18
  80.   4.1 tn3270eRtCollCtlTable....................................18
  81.   4.2 tn3270eRtDataTable.......................................21
  82.   4.3 Notifications............................................23
  83.   5.0 Definitions..............................................24
  84.   6.0 Security Considerations..................................39
  85.   7.0 Acknowledgments..........................................40
  86.   8.0 References...............................................40
  87.   9.0 Authors' Addresses.......................................42
  88.  
  89.  
  90.  
  91. 1.  Introduction
  92.  
  93.   This document is a product of the TN3270E Working Group. Its purpose
  94.   is to define a protocol and a MIB module to enable a TN3270E server to
  95.   collect response time data for both TN3270 and TN3270E clients.
  96.   Prerequisites for implementing this MIB are:
  97.  
  98.          o TN3270E-MIB, Base Definitions of Managed Objects for TN3270E
  99.                    Using SMIv2 [10].
  100.  
  101.          o TN3270E RFCs
  102.  
  103.          o SYSAPPL-MIB, import Utf8String Textual Convention for
  104.                    international text string support, reference [13].
  105.  
  106.  
  107. 2.  The SNMPv2 Network Management Framework
  108.  
  109.   The SNMP Network Management Framework presently consists of three
  110.   major components.  They are:
  111.  
  112.  
  113.  
  114.  
  115. Expires March 1998                                              [Page 2]~
  116.  
  117.  
  118.  
  119.  
  120.  
  121. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  122.  
  123.  
  124.   o the SMI, described in RFC 1902 [1], - the mechanisms used for
  125.     describing and naming objects for the purpose of management.
  126.  
  127.   o the MIB-II, STD 17, RFC 1213 [5], - the core set of managed
  128.     objects for the Internet suite of protocols.
  129.  
  130.   o the protocol, RFC 1157 [9] and/or RFC 1905 [7] - the protocol
  131.     for accessing managed information.
  132.  
  133.   It is the intent of this MIB to fully adhere to all prerequisite MIBs
  134.   unless explicitly stated. Deviations will be documented in
  135.   corresponding conformance statements. The specification of this MIB
  136.   uses the Structure of Management Information (SMI) for Version 2 of
  137.   the Simple Network Management Protocol Version (refer to RFC1902,
  138.   reference [1]).
  139.  
  140.   Textual conventions are defined in RFC 1903 [6], and conformance
  141.   statements are defined in RFC 1904 [8].
  142.  
  143.   The Framework permits new objects to be defined for the purpose of
  144.   experimentation and evaluation.
  145.  
  146.   This memo specifies a MIB module that is compliant to the SNMPv2 SMI.
  147.   A semantically identical MIB conforming to the SNMPv1 SMI can be
  148.   produced through the appropriate translation.
  149.  
  150.  
  151.  
  152. 2.1.  Object Definitions
  153.  
  154.   Managed objects are accessed via a virtual information store, termed
  155.   the Management Information Base or MIB.  Objects in the MIB are
  156.   defined using the subset of Abstract Syntax Notation One (ASN.1)
  157.   defined in the SMI.  In particular, each object type is named by an
  158.   OBJECT IDENTIFIER, an administratively assigned name.  The object type
  159.   together with an object instance serves to uniquely identify a
  160.   specific instantiation of the object.  For human convenience, we often
  161.   use a textual string, termed the descriptor, to refer to the object
  162.   type.
  163.  
  164.  
  165. 3.  Response Time Collection Methodology
  166.  
  167.   This section explains the methodology and approach used by the MIB
  168.   defined by this memo for response time data collection by a TN3270E
  169.   Server.
  170.  
  171.  
  172.  
  173.  
  174.  
  175. Expires March 1998                                              [Page 3]~
  176.  
  177.  
  178.  
  179.  
  180.  
  181. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  182.  
  183.  
  184. 3.1.  General Response Time Collection
  185.  
  186.   Two primary methods exist for measuring response times in SNA
  187.   networks:
  188.  
  189.       o The SNA Management Services (SNA/MS) Response Time
  190.         Monitoring (RTM) function
  191.       o Timestamping using definite response flows.
  192.  
  193.   This memo defines an approach using definite responses to timestamp
  194.   the flows between a client and its TN3270E server, rather than on the
  195.   RTM method. Extensions to the SNA/MS RTM flow were considered, but
  196.   this approach was deemed unsuitable since not all TN3270E Server
  197.   implementations have access to their underlying SNA stacks. The RTM
  198.   concepts of keeping response time buckets for service level agreements
  199.   and of interval-based response time collection for performance
  200.   monitoring are preserved in the MIB module defined in this memo.
  201.  
  202.   As mentioned, this memo focuses on using definite responses to
  203.   timestamp the flows between a client and its TN3270E server for
  204.   generating performance data. Use of a definite response flow requires
  205.   that the client supports TN3270E with the RESPONSES function
  206.   negotiated. The TN3270 TIMEMARK option can be used instead of definite
  207.   response for supporting TN3270 Clients or TN3270E Clients that don't
  208.   support RESPONSES.  This document focuses on defining the protocol and
  209.   methods for generating performance data using definite responses and
  210.   then describes how the TIMEMARK option can be used instead of definite
  211.   response.
  212.  
  213.   In an SNA network, a transaction between a client Logical Unit (LU)
  214.   and a target host in general looks as follows:
  215.  
  216.         ------------------------------------------------
  217.         |                                              |
  218.         | Client LU                    Target SNA Host |
  219.         |                                              |
  220.         |                               Timestamps     |
  221.         |              request              A          |
  222.         | ----------------------------------------->   |
  223.         |              reply(DR)            B      |   |
  224.         | <---------------------------------------<    |
  225.         | |            +/-RSP               C          |
  226.         | >--------------------------------------->    |
  227.         |                                              |
  228.         | DR: Definite Response requested              |
  229.         | DR +/-: Definite Response                    |
  230.         |                                              |
  231.         ------------------------------------------------
  232.  
  233.  
  234.  
  235. Expires March 1998                                              [Page 4]~
  236.  
  237.  
  238.  
  239.  
  240.  
  241. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  242.  
  243.  
  244.   This transaction is a simple one, and is being used only to illustrate
  245.   how timestamping at a target SNA host can be used to generate response
  246.   times.  An IBM redbook [12] provides a more detailed description of
  247.   response time collection for a transaction of this type.  Note that
  248.   for the purpose of calculating an approximation for network transit
  249.   time, is doesn't matter if the response is positive or negative.  Two
  250.   response time values are typically calculated:
  251.  
  252.       o Host Transit Time: Timestamp B - A
  253.       o Network Transit Time: Timestamp C - B
  254.  
  255.   Network transit time is an approximation for the amount of time that a
  256.   transaction requires to flow across a network, since the response flow
  257.   is being substituted for the request flow at the start of the
  258.   transaction.  Network transit time, timestamp C - B, is the amount of
  259.   time that the definite response request and its response required.
  260.   Host time, timestamp B - A, is the actual time that the host required
  261.   to process the transaction.  Experience has shown that using the
  262.   response flow to approximate network transit times is useful, and does
  263.   correlate well with actual network transit times.
  264.  
  265.   The TN3270E-RT-MIB describes a method of collecting performance data
  266.   that is not appropriate for printer (LU Type 1 or LU Type 3) sessions;
  267.   thus collection of performance data for printer sessions is excluded
  268.   from this MIB.  This exclusion of printer sessions is not considered a
  269.   problem, since these sessions are not the most important ones for
  270.   response time monitoring, and since historically they were excluded
  271.   from SNA/MS RTM collection.  The tn3270eTcpConnResourceType object in
  272.   a tn3270eTcpConnEntry (in the TN3270E-MIB) can be examined to
  273.   determine if a client session is ineligible for response time data
  274.   collection.
  275.  
  276.  
  277. 3.2.  TN3270E Server Response Time Collection
  278.  
  279.   A TN3270E Server connects an IP client performing 3270 emulation to a
  280.   target SNA host over both an IP network (IP client to TN3270E server)
  281.   and an SNA Network (TN3270E server to target SNA host). A TN3270E
  282.   server can use SNA definite responses and the TN3270 Enhancement (RFC
  283.   1647 [11]) RESPONSES function to calculate response times for a
  284.   transaction, by timestamping when a client sends a request, when the
  285.   reply arrives from the target host, and when the response
  286.   acknowledging this reply arrives from the client.
  287.  
  288.   Section 3.4, Timestamp Calculation, provides specifics on when in the
  289.   sequence of flows between a TN3270E client and its target SNA host a
  290.   TN3270E server takes its timestamps. In addition, there is information
  291.   on how the TN3270 TIMEMARK request/response flow can be used instead
  292.  
  293.  
  294.  
  295. Expires March 1998                                              [Page 5]~
  296.  
  297.  
  298.  
  299.  
  300.  
  301. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  302.  
  303.  
  304.   of DR for approximating IP network transit times.
  305.  
  306.   The following figure adds a TN3270E server between the client, in this
  307.   case a TN3270E client and the target SNA host:
  308.  
  309.  
  310.         ------------------------------------------------
  311.         |                                              |
  312.         | Client            TN3270E           Target   |
  313.         |                    Server          SNA Host  |
  314.         |                   Timestamps                 |
  315.         |                                              |
  316.         | <---IP Network-------><---SNA Network--->    |
  317.         |                                              |
  318.         |      request         D                       |
  319.         | ------------------------------------------>  |
  320.         |      reply(DR)       E                    |  |
  321.         | <----------------------------------------<   |
  322.         | |    +/-RSP          F                       |
  323.         |  >-------------------- - - - - - - - - - >   |
  324.         |                                              |
  325.         ------------------------------------------------
  326.  
  327.   A TN3270E server can save timestamp D when it receives a client
  328.   request, save timestamp E when the target SNA host replies, and save
  329.   timestamp F when the client responds to the definite response request
  330.   that flowed with the reply. In fact, it doesn't matter whether the
  331.   target SNA host requested a definite response on its reply:  if it
  332.   didn't, the TN3270E server makes the request on its own, to enable it
  333.   to produce timestamp F.  In this case the TN3270E server does not
  334.   forward the response to the target SNA host, as the dotted line in the
  335.   figure indicates.
  336.  
  337.   In order to generate timestamp F, a TN3270E server must insure that
  338.   the transaction specifies DR, and that the TN3270E RESPONSES function
  339.   has been negotiated between itself and the client.  Negotiation of the
  340.   TN3270E RESPONSES function occurs during the client's TN3270E session
  341.   initialization.  The TN3270E servers that the authors are aware of do
  342.   request the RESPONSES function during client session initialization.
  343.   TN3270E clients either automatically support the RESPONSES function,
  344.   or can be configured during startup to support it.
  345.  
  346.   Using timestamps D, E, and F the following response times can be
  347.   calculated by a TN3270E server:
  348.  
  349.      o Total Response time: F - D
  350.      o IP Network Transit Time: F - E
  351.  
  352.  
  353.  
  354.  
  355. Expires March 1998                                              [Page 6]~
  356.  
  357.  
  358.  
  359.  
  360.  
  361. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  362.  
  363.  
  364.   The MIB provides an object, tn3270eRtCollCtlType, to control several
  365.   aspects of response time data collection.  One of the available
  366.   options in setting up a response time collection policy is to
  367.   eliminate the IP-network component altogether.  This might be done
  368.   because it is determined either that the additional IP network traffic
  369.   would not be desirable, or that the IP-network components of the
  370.   overall response times are not significant.
  371.  
  372.   Excluding the IP-network component from response times also has an
  373.   implication for the way in which response time data is aggregated.  A
  374.   TN3270E server may find that some of its clients simply don't support
  375.   any of the functions necessary for the server to calculate the IP-
  376.   network component of response times.  For these clients, the most that
  377.   the server can calculate is the SNA-network component of their overall
  378.   response times; the server records this SNA-network component as the
  379.   TOTAL response time each of these clients' transactions.  If a
  380.   response time collection is aggregating data from a number of clients,
  381.   some of which have the support necessary for including the IP-network
  382.   component in their total response time calculations, and some of which
  383.   do not, then the server aggregates the data differently depending on
  384.   whether the collection has been defined to include or exclude the IP-
  385.   network component:
  386.  
  387.       o If the IP-network component is included, then transactions
  388.         for the clients that don't support calculation of the
  389.         IP-network component of their response times are excluded
  390.         from the aggregation altogether.
  391.       o If the IP-network component is excluded, then total response
  392.         times for ALL clients include only the SNA-network component,
  393.         even though the server could have included an IP-network
  394.         component in the overall response times for some of these
  395.         clients.  The server does this by setting timestamp F, which
  396.         marks the end of a transaction's total response time, equal
  397.         to timestamp E, the end of the transaction's SNA-network
  398.         component.
  399.  
  400.   The principle here is that all the transactions contributing their
  401.   response times to an aggregated value must make the same contribution.
  402.   If the aggregation specifies that an IP-network component must be
  403.   included in the aggregation's response times, then transactions for
  404.   which an IP-network component cannot be calculated aren't included at
  405.   all.  If the aggregation specifies that an IP-network component is not
  406.   to be included, then only the SNA-network component is used, even for
  407.   those transactions for which an IP-network component could have been
  408.   calculated.
  409.  
  410.   There is one more complication here:  the MIB allows a management
  411.   application to enable or disable dynamic definite responses for a
  412.  
  413.  
  414.  
  415. Expires March 1998                                              [Page 7]~
  416.  
  417.  
  418.  
  419.  
  420.  
  421. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  422.  
  423.  
  424.   response time collection.  Once again the purpose of this option is to
  425.   give the network operator control over the amount of traffic
  426.   introduced into the IP network for response time data collection.  A
  427.   DYNAMIC definite response is one that the TN3270E server itself adds
  428.   to a reply, in a transaction for which the SNA application at the
  429.   target SNA host did not specify DR in its reply.  When the +/-RSP
  430.   comes back from the client, the server uses this response to calculate
  431.   timestamp F, but then it does not forward it on to the SNA application
  432.   (since the application is not expecting a response to its reply).
  433.  
  434.   This dynamic definite responses option is related to the option of
  435.   including or excluding the IP-network component of response times
  436.   (discussed above) as follows:
  437.  
  438.       o If the IP-network component is excluded, then there is
  439.         no reason for enabling dynamic definite responses:  the
  440.         server always sets timestamp F equal to timestamp E, so
  441.         the additional IP-network traffic elicited by a dynamic
  442.         definite response would serve no purpose.
  443.       o If the IP-network component is included, then enabling
  444.         dynamic definite responses causes MORE transactions to
  445.         be included in the aggregated response time values:
  446.  
  447.            - For clients that do not support sending of responses,
  448.              timestamp F can never be calculated, and so their
  449.              transactions are never included in the aggregate.
  450.            - For clients that support sending of responses,
  451.              timestamp F will always be calculated for transactions
  452.              in which the host SNA application specifies DR in
  453.              its reply, and so these transactions will always be
  454.              included in the aggregate.
  455.            - For clients that support sending of responses,
  456.              having dynamic definite responses enabled for a
  457.              collection results in the inclusion of additional
  458.              transactions in the aggregate:  specifically, those
  459.              for which the host SNA application did not specify
  460.              DR in its reply.
  461.  
  462.   A TN3270E server also has the option of substituting TIMEMARK
  463.   processing for definite responses in calculating the IP-network
  464.   component of a transaction's response time.  Once again, there is no
  465.   reason for the server to do this if the collection has been set up to
  466.   exclude the IP-network component altogether in computing response
  467.   times.
  468.  
  469.   The MIB is structured to keep for each response time the total time (F
  470.   - D) and the IP-network component (F - E).  A management application
  471.   can obviously calculate from these two values a response time's SNA-
  472.  
  473.  
  474.  
  475. Expires March 1998                                              [Page 8]~
  476.  
  477.  
  478.  
  479.  
  480.  
  481. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  482.  
  483.  
  484.   network component (E - D).  The SNA-network component would also
  485.   contain the host processing time at both the TN3270E Server and at the
  486.   target application. As in the IP case, these response times are only
  487.   approximations, because the +/-RSP's crossing of the IP network is
  488.   substituted for that of the request that started the transaction.
  489.  
  490.   When a TN3270E server is in the same SNA host as the target
  491.   application, then the SNA-network component of a transaction's
  492.   response time will approximately equal the host transit time (B - A)
  493.   described previously. A host (as opposed to a gateway) TN3270E server
  494.   implementation can typically support the establishment of sessions to
  495.   target applications in remote SNA hosts; in this case the SNA-network
  496.   component equals the actual SNA-network transit time plus two host
  497.   transit times.
  498.  
  499.  
  500. 3.3.  Correlating TN3270E Server and Host Response Times
  501.  
  502.   It is possible that response time data is collected from TN3270E
  503.   servers at the same time as a management application is monitoring the
  504.   SNA sessions at a host. For example, a management application can be
  505.   monitoring a secondary logical unit (SLU) while retrieving data from a
  506.   TN3270E server. Consider the following figure:
  507.  
  508.         ------------------------------------------------
  509.         |                                              |
  510.         | Client            TN3270E            Target  |
  511.         |                    Server           SNA Host |
  512.         |                   Timestamps         (PLU)   |
  513.         |                    (SLU)           Timestamps|
  514.         | <---IP Network-------><---SNA Network--->    |
  515.         |                                              |
  516.         |      request         D                 A     |
  517.         | ------------------------------------------>  |
  518.         |      reply(DR)       E                 B  |  |
  519.         | <----------------------------------------<   |
  520.         | |    +/-RSP          F                 C     |
  521.         |  >-------------------------------------->    |
  522.         |                                              |
  523.         ------------------------------------------------
  524.  
  525.   The following response times are available:
  526.  
  527.       o Target SNA host transit time: B - A
  528.       o Target SNA host (total) network transit time: C - B
  529.       o TN3270E server total response time: F - D
  530.       o TN3270E server IP-network component: F - E
  531.  
  532.  
  533.  
  534.  
  535. Expires March 1998                                              [Page 9]~
  536.  
  537.  
  538.  
  539.  
  540.  
  541. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  542.  
  543.  
  544.   The value added by the TN3270E server in this situation is its
  545.   approximation of the IP-network component of the overall response
  546.   time. The IP-network component can be subtracted from the total
  547.   network transit time determined by monitoring the SLU to see the
  548.   actual SNA versus IP network transit times.
  549.  
  550.   The MIB defined by this memo does not specifically address correlation
  551.   of the data it contains with response time data collected by direct
  552.   monitoring of SNA resources:  its focus is exclusively response time
  553.   data collection from a TN3270E server perspective.  It has, however,
  554.   in conjunction with the TN3270E-MIB [10], been structured to provide
  555.   the information necessary for correlation between TN3270E server-
  556.   provided response time information and that gathered from directly
  557.   monitoring SNA resources.
  558.  
  559.   A management application attempting to correlate SNA resource usage to
  560.   IP clients can monitor either the tn3270eResMapTable or the
  561.   tn3270eTcpConnTable to determine resource-to-client address mappings.
  562.   Both of these tables are defined by the TN3270E-MIB [10].  Another
  563.   helpful table is the tn3270eSnaMapTable, which provides a mapping
  564.   between SLU names as they are known at the SSCP (VTAM) and their local
  565.   names at the TN3270E server.  Neither the tn3270eClientGroupTable, the
  566.   tn3270eResPoolTable, nor the tn3270eClientResMapTable from the
  567.   TN3270E-MIB can be used for correlation, since the mappings defined by
  568.   these tables can overlap and may not provide one-to-one mappings.
  569.  
  570.  
  571. 3.4.  Timestamp Calculation
  572.  
  573.   This section goes into more detail concerning when the various
  574.   timestamps can be taken as the flows between a TN3270E client and its
  575.   target SNA host pass through a TN3270E server.  In addition,
  576.   information is provided on how the TN3270 TIMEMARK request/response
  577.   flow can be used in place of DR for approximating IP network transit
  578.   times.
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595. Expires March 1998                                             [Page 10]~
  596.  
  597.  
  598.  
  599.  
  600.  
  601. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  602.  
  603.  
  604. 3.4.1.  DR Usage
  605.  
  606.   Consider the following flow:
  607.  
  608.      ----------------------------------------------------------
  609.      |                                                        |
  610.      | Client            TN3270E            Target SNA        |
  611.      |                    Server              Host            |
  612.      |                   Timestamps                           |
  613.      |                                                        |
  614.      | <---IP Network-------><---SNA Network--->              |
  615.      |                                                        |
  616.      |      request         D    (BB,CD,OIC,ER)               |
  617.      | ------------------------------------------->           |
  618.      |      reply                (FIC,ER,EB)      |           |
  619.      | <-----------------------------------------<            |
  620.      |      reply                (MIC,ER)                     |
  621.      | <-----------------------------------------<            |
  622.      |      reply                (MIC,ER)                     |
  623.      | <-----------------------------------------<            |
  624.      |      reply(DR)       E    (LIC,DR)                     |
  625.      | <-----------------------------------------<            |
  626.      | |    +/-RSP          F                                 |
  627.      |  >---------------------------------------->            |
  628.      |                                                        |
  629.      | BB : Begin Bracket    ER : Response by exception       |
  630.      | EB : End Bracket      DR : Definite Response Requested |
  631.      | CD : Change Direction FIC : First in chain             |
  632.      | OIC: Only in chain    MIC: Middle in chain             |
  633.      | LIC: Last in chain                                     |
  634.      ----------------------------------------------------------
  635.  
  636.   Timestamp D is taken at the TN3270E server when a client sends data to
  637.   the server for forwarding to its target SNA host. This is most likely
  638.   when the server finds the end of record indicator in the TCP data
  639.   received from the client. The target SNA returns its reply in one or
  640.   more SNA Request Units (RUs); in this example there are four RUs in
  641.   the reply.  The first RU is marked as first in chain (FIC), the next
  642.   two are marked as middle in chain (MIC), and the last is marked as
  643.   last in chain (LIC).  Timestamp E should be taken prior to sending the
  644.   RESPONSES request to the client; normally this is done when the server
  645.   receives the LIC RU. Timestamp F is taken when the RESPONSES response
  646.   is received from the client.
  647.  
  648.   A target SNA application doesn't necessarily return data to a client
  649.   in a transaction; it may, for example, require more data from the
  650.   client before it can formulate a reply.  In this case the application
  651.   may simply return to the TN3270E server a change of direction
  652.  
  653.  
  654.  
  655. Expires March 1998                                             [Page 11]~
  656.  
  657.  
  658.  
  659.  
  660.  
  661. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  662.  
  663.  
  664.   indicator.  A TCP connection is full duplex:  data can be received and
  665.   sent on it at the same time.  An SNA session, on the other hand, is
  666.   half duplex, with a change of direction indicator to alter the
  667.   direction of data flow.  Timestamps E and F require a reply to flow to
  668.   the client.  A best-effort approach should be followed by a TN3270E
  669.   server when it attempts to calculate timestamps.  For cases where the
  670.   target SNA application sends a change of direction indicator rather
  671.   than a reply, it is suggested that the entire transaction be omitted
  672.   from any response time calculations.
  673.  
  674.   Another consideration is a mismatch between DR requested on the SNA
  675.   side and DR requested by a TN3270E server. If the SNA host sends a
  676.   multiple-RU chain, the server does not know until the last RU is
  677.   received whether DR is being requested.  Meanwhile, the server may
  678.   have forwarded the first RU in the chain to the client.  In practice,
  679.   therefore, some servers convert ER flows to DR flows.  Timestamp E can
  680.   be taken when the first RESPONSES request flows to the client, and
  681.   timestamp F when its response is received.  In this instance an
  682.   additional timestamp G is needed when the LIC RU is received:
  683.  
  684.      ---------------------------------------------------
  685.      |                                                 |
  686.      | Client            TN3270E             Target    |
  687.      |                    Server            SNA Host   |
  688.      |                   Timestamps                    |
  689.      |                                                 |
  690.      | <---IP Network-------><---SNA Network--->       |
  691.      |                                                 |
  692.      |      request         D    (BB,CD,OIC,ER)        |
  693.      | ------------------------------------------>     |
  694.      |      reply(DR)       E    (FIC,ER,EB)     |     |
  695.      | <----------------------------------------<      |
  696.      | |     +/-RSP         F                          |
  697.      |  >------------------->                          |
  698.      |      reply                (MIC,ER)              |
  699.      | <----------------------------------------<      |
  700.      |      reply                (MIC,ER)              |
  701.      | <----------------------------------------<      |
  702.      |      reply(DR)            (LIC,DR)              |
  703.      | <----------------------------------------<      |
  704.      | |    +/-RSP          G                          |
  705.      |  >------------------->                          |
  706.      |                                                 |
  707.      ---------------------------------------------------
  708.  
  709.   The response times can then be calculated as follows:
  710.  
  711.       o Total response time: G - D
  712.  
  713.  
  714.  
  715. Expires March 1998                                             [Page 12]~
  716.  
  717.  
  718.  
  719.  
  720.  
  721. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  722.  
  723.  
  724.       o IP network transit time: F - E
  725.  
  726.   If DR is requested by the LIC RU, then the TN3270E server can use
  727.   either its response or the earlier one for approximating IP network
  728.   transit time.
  729.  
  730.  
  731. 3.4.2.  TIMEMARK Usage
  732.  
  733.   It is possible for a TN3270E server to use the TIMEMARK flow for
  734.   approximating IP network transit times.  Using TIMEMARKs would make it
  735.   possible for a server to collect performance data for TN3270 clients,
  736.   as well as for TN3270E clients that do not support the RESPONSES
  737.   function.  In order for TIMEMARKs to be used in this way, a client
  738.   can't have the NOP option enabled, since responses are needed to the
  739.   server's TIMEMARK requests. An IP network transit time approximation
  740.   using a TIMEMARK is basically the amount of time it takes for a TN3270
  741.   server to receive a response from a client to a TIMEMARK request.
  742.  
  743.   If a TN3270 server is performing the TIMEMARK function (independent of
  744.   the response time monitoring use of the function discussed here), then
  745.   it most likely has a TIMEMARK interval for determining when to examine
  746.   client sessions for sending the TIMEMARK request.  (This interval,
  747.   which is ordinarily a global value for an entire TN3270E server, is
  748.   represented in the TN3270E-MIB by the tn3270eSrvrConfActivityInterval
  749.   object.)  A TIMEMARK request is sent only if, when it is examined, a
  750.   client session is found to have had no activity for a different length
  751.   of time, represented in the TN3270E-MIB by the
  752.   tn3270eSrvrConfActivityTimeout object.
  753.  
  754.   If a TN3270E server sends a TIMEMARK request to every client with no
  755.   session activity, based solely on the server's TIMEMARK interval, then
  756.   network flooding may result, since a server may be supporting
  757.   thousands of client sessions. The use of TIMEMARKs for response time
  758.   monitoring could help to reduce this network flooding.  Suppose a
  759.   server sends a TIMEMARK request to a client after a LIC RU has been
  760.   received, as a means of approximating IP network transit time:
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775. Expires March 1998                                             [Page 13]~
  776.  
  777.  
  778.  
  779.  
  780.  
  781. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  782.  
  783.  
  784.      ---------------------------------------------------
  785.      |                                                 |
  786.      | Client            TN3270E             Target    |
  787.      |                    Server              Host     |
  788.      |                   Timestamps                    |
  789.      |                                                 |
  790.      | <---IP Network-------><---SNA Network--->       |
  791.      |                                                 |
  792.      |      request         D    (BB,CD,OIC,ER)        |
  793.      | ------------------------------------------->    |
  794.      |      reply                (FIC,ER,EB)      |    |
  795.      | <-----------------------------------------<     |
  796.      |      reply                (MIC,ER)              |
  797.      | <-----------------------------------------<     |
  798.      |      reply                (MIC,ER)              |
  799.      | <-----------------------------------------<     |
  800.      |      reply(DR)            (LIC,ER)              |
  801.      | <-----------------------------------------<     |
  802.      |      TIMEMARK Rqst   E                          |
  803.      | <---------------------                          |
  804.      | |    TIMEMARK Rsp    F                          |
  805.      |  >------------------->                          |
  806.      |                                                 |
  807.      ---------------------------------------------------
  808.  
  809.   The response times can then be calculated as follows:
  810.  
  811.       o TN3270E server total response time: F - D
  812.       o TN3270E server IP network time: F - E
  813.  
  814.   A TN3270E server would need to consider its normal TIMEMARK processing
  815.   when using TIMEMARKs for this purpose. For example, it must not send a
  816.   second TIMEMARK request to a client while waiting for the first to
  817.   return.  Also, if a TIMEMARK flow has just been performed for a client
  818.   shortly before the LIC RU arrives, the server might use the interval
  819.   from this flow as its approximation for IP network transit time; in
  820.   this case the server would have to remember to add the interval from
  821.   this TIMEMARK flow (F' - E') to the interval from the transaction (E -
  822.   D) to get its approximation for the transaction's total response time.
  823.  
  824.  
  825.  
  826. 3.5.  Performance Data Modelling
  827.  
  828.   The following two subsections detail how the TN3270E-RT-MIB models and
  829.   controls capture of two types of response time data:  average response
  830.   times and response time buckets.
  831.  
  832.  
  833.  
  834.  
  835. Expires March 1998                                             [Page 14]~
  836.  
  837.  
  838.  
  839.  
  840.  
  841. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  842.  
  843.  
  844. 3.5.1.  Averaging Response Times
  845.  
  846.   Average response times play two different roles in the MIB:
  847.  
  848.       o They are made available for management applications to retrieve.
  849.       o They serve as triggers for emitting notifications.
  850.  
  851.   Sliding-window averages are used rather than straight interval-based
  852.   averages, because they are often more meaningful, and because they
  853.   cause less notification thrashing. Sliding-window average calculation
  854.   can, if necessary, be disabled, by setting the sample period
  855.   multiplier, tn3270eRtCollCtlSPMult, to 1, and setting the sample
  856.   period, tn3270eRtCollCtlSPeriod, to the required collection interval.
  857.  
  858.   In order to calculate sliding-window averages, a TN3270E server must:
  859.  
  860.       o Select a fixed, relative short, sample period SPeriod; the
  861.         default value for SPeriod in the MIB is 20 seconds.
  862.  
  863.       o Select an averaging period multiplier SPMult.  The actual
  864.         collection interval will then be SPMult times SPeriod.  The
  865.         default value for SPMult in the MIB is 30, yielding a default
  866.         collection interval of 10 minutes.  Note that the collection
  867.         interval (SPMult*SPeriod) is always a multiple of the sample
  868.         period.
  869.  
  870.       o Maintain the following counters to keep track of activity within
  871.         the current sample period; these are internal counters, not
  872.         made visible to a management application via the MIB.
  873.  
  874.         - T (number of transactions in the period)
  875.         - TotalRt (sum of the total response times for all
  876.           transactions in the period)
  877.         - TotalIpRt (sum of the IP network transit times for
  878.           all transactions in the period; note that if IP
  879.           network transit times are being excluded from the
  880.           response time collection, this value will always be 0).
  881.  
  882.       o Also maintain sliding counters, initialized to zero, for each
  883.         of the quantities being counted:
  884.  
  885.         - AvgTransCount (sliding count of transactions)
  886.         - TotalRtSliding (sliding count of total response times)
  887.         - TotalIpRtSliding (sliding count of IP network transit times)
  888.  
  889.       o At the end of each sample period, update the sliding counters:
  890.  
  891.            AvgTransCount = AvgTransCount + T
  892.  
  893.  
  894.  
  895. Expires March 1998                                             [Page 15]~
  896.  
  897.  
  898.  
  899.  
  900.  
  901. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  902.  
  903.  
  904.                 - (AvgTransCount / SPMult)
  905.  
  906.            TotalRtSliding = TotalRtSliding + TotalRt
  907.                 - (TotalRtSliding / SPMult)
  908.  
  909.            TotalIpRtSliding = TotalIpRtSliding + TotalIpRt
  910.                 - (TotalIpRtSliding / SPMult)
  911.  
  912.         Then reset T, TotalRt, and TotalIpRt to zero for use during the
  913.         next sample period.
  914.  
  915.       o At the end of a collection interval, update the following MIB
  916.         objects as indicated:
  917.  
  918.            tn3270eRtDataAvgTransCount = AvgTransCount
  919.            tn3270eRtDataAvgRt = TotalRtSliding / AvgTransCount
  920.            tn3270eRtDataAvgIpRt = TotalIpRtSliding / AvgTransCount
  921.  
  922.         As expected, if IP network transit times are being excluded
  923.         from response time collection, then tn3270eRtDataAvgIpRt
  924.         will always return 0.
  925.  
  926.   The sliding transaction counter AvgTransCount is not used for updating
  927.   the MIB object tn3270eRtDataTransCount:  this object is an ordinary
  928.   SMI Counter32, which maintains a total count of transactions since its
  929.   last discontinuity event. The sliding counters are used only for
  930.   calculating averages.
  931.  
  932.   Two mechanisms are present in the MIB to inhibit the generation of an
  933.   excessive number of notifications related to average response times.
  934.   First, there are high and low thresholds for average response times. A
  935.   tn3270eRtExceeded notification is generated the first time a
  936.   statistically significant average response time is found to have
  937.   exceeded the high threshold.  After this, no other tn3270eRtExceeded
  938.   notifications are generated until an average response time is found to
  939.   have fallen below the low threshold.
  940.  
  941.   The other mechanism to limit notifications is the significance test
  942.   for a high average response time.  Intuitively, the significance of an
  943.   average is directly related to the number of samples that go into it;
  944.   so we might be inclined to use a rule such as "for the purpose of
  945.   generating tn32709eRtExceeded notifications, ignore average response
  946.   times based on fewer than 20 transactions in the sample period."
  947.  
  948.   In the case of response times, however, the number of transactions
  949.   sampled in a fixed sampling period is tied to these transactions'
  950.   response times. A few transactions with long response times can
  951.   guarantee that there will not be many transactions in a sample,
  952.  
  953.  
  954.  
  955. Expires March 1998                                             [Page 16]~
  956.  
  957.  
  958.  
  959.  
  960.  
  961. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  962.  
  963.  
  964.   because these transactions "use up" the sampling time. Yet this case
  965.   of a few transactions with very poor response times should obviously
  966.   be classified as a problem, not as a statistical anomaly based on too
  967.   small a sample.
  968.  
  969.   The solution is to make the significance level for a sample a function
  970.   of the average response time.  In order to determine at a collection
  971.   interval whether to generate a tn3270eRtExceeded notification, a
  972.   TN3270E server uses the following algorithm:
  973.  
  974.      if AvgTransCount * ((AvgRt/ThreshHigh - 1) ** 2) <  IdleRate
  975.      then generate the notification
  976.  
  977.   Two examples illustrate how this algorithm works.  Suppose that
  978.   IdleRate has been set to 20 transactions, and the high threshold to
  979.   200 msecs per transaction.  If the average observed response time is
  980.   300 msecs, then a notification will be generated only if AvgTransCount
  981.   >= 80.  If, however, the observed response time is 500 msecs, then a
  982.   notification is generated if AvgTransCount >= 9.
  983.  
  984.   There is no corresponding significance test for the tn3270eRtOkay
  985.   notification:  this notification is generated based on an average
  986.   response time that falls below the low threshold, regardless of the
  987.   sample size behind that average.
  988.  
  989.  
  990. 3.5.2.  Response Time Buckets
  991.  
  992.   The MIB also supports collection of response time data into a set of
  993.   five buckets. This data is suitable either for verification of service
  994.   level agreements, or for monitoring by a management application to
  995.   identify performance problems. The buckets provide counts of
  996.   transactions whose total response times fall into a set of specified
  997.   ranges.
  998.  
  999.   Like everything for a collection, the "total" response times collected
  1000.   in the buckets are governed by the specification of whether IP network
  1001.   transit times are to be included in the totals. Depending on how this
  1002.   option is specified, the response times being counted in the buckets
  1003.   will either be total response times (F - D), or only SNA network
  1004.   transit times (effectively E - D, because when it is excluding the
  1005.   IP-network component of transactions, a server makes timestamp F
  1006.   identical to timestamp E).
  1007.   Four bucket boundaries are specified for a response time collection,
  1008.   resulting in five buckets. The first response time bucket counts those
  1009.   transactions whose total response times were less than or equal to
  1010.   Boundary 1, the second bucket counts those whose response times were
  1011.   greater than Boundary 1 but less than or equal to Boundary 2, and so
  1012.  
  1013.  
  1014.  
  1015. Expires March 1998                                             [Page 17]~
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1022.  
  1023.  
  1024.   on.  The fifth bucket is unbounded on the top, counting all
  1025.   transactions whose response times were greater than Boundary 4.
  1026.  
  1027.   The four bucket boundaries have default values of: 1 second, 2
  1028.   seconds, 5 seconds, and 10 seconds, respectively.  These values are
  1029.   the defaults in the 3174 controller's implementation of the SNA/MS RTM
  1030.   function, and were thought to be appropriate for this MIB as well.
  1031.  
  1032.   In SNA/MS the counter buckets were (by today's standards) relatively
  1033.   small, with a maximum value of 65,535. The bucket objects in the MIB
  1034.   are all Counter32's.
  1035.  
  1036.   The following figure represents the buckets pictorially:
  1037.  
  1038.          ----------------------------------------------
  1039.          |                                            |
  1040.          |          Response Time Boundaries          |
  1041.          | |       |       |       |       |       |  |
  1042.          | |       |       |       |       |       |  |
  1043.          | |       |       |       |       |      no  |
  1044.          | 0      B-1     B-2     B-3     B-4    bound|
  1045.          | |       |       |       |       |       |  |
  1046.          | |Bucket1|Bucket2|Bucket3|Bucket4|Bucket5|  |
  1047.          | -----------------------------------------  |
  1048.          |                                            |
  1049.          ----------------------------------------------
  1050.  
  1051.  
  1052. 4.  Structure of the MIB
  1053.  
  1054.   The TN3270E-RT-MIB has the following components:
  1055.  
  1056.     o tn3270eRtCollCtlTable
  1057.     o tn3270eRtDataTable
  1058.     o Notifications
  1059.  
  1060.  
  1061. 4.1.  tn3270eRtCollCtlTable
  1062.  
  1063.   The tn3270eRtCollCtlTable is indexed by tn3270eSrvrConfIndex, imported
  1064.   from the TN3270E-MIB, and by tn3270eRtCollCtlClientGroupName.
  1065.   tn3270eSrvrConfIndex identifies within a host a particular TN3270E
  1066.   server.  tn3270eRtCollCtlClientGroupName identifies a collection of IP
  1067.   clients for which response time data is to be collected.  The
  1068.   collection itself is defined using the tn3270eClientGroupTable from
  1069.   the TN3270E-MIB.  The index from the tn3270eClientGroupTable,
  1070.   tn3270eClientGroupName, was not used directly, since doing so causes
  1071.   an inconsistent indexing scheme error in some MIB compilers.  To avoid
  1072.  
  1073.  
  1074.  
  1075. Expires March 1998                                             [Page 18]~
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1082.  
  1083.  
  1084.   this error, tn3270eRtCollCtlClientGroupName was defined directly in
  1085.   the tn3270eRtCollCtlEntry.
  1086.  
  1087.   A tn3270eRtCollCtlEntry contains the following objects:
  1088.  
  1089.              --------------------------------------------------
  1090.    1st Index | tn3270eSrvrConfIndex             Unsigned32    |
  1091.    2nd Index | tn3270eRtCollCtlClientGroupName  Utf8String    |
  1092.              | tn3270eRtCollCtlType             BITS          |
  1093.              | tn3270eRtCollCtlSPeriod          Unsigned32    |
  1094.              | tn3270eRtCollCtlSPMult           Unsigned32    |
  1095.              | tn3270eRtCollCtlThreshHigh       Unsigned32    |
  1096.              | tn3270eRtCollCtlThreshLow        Unsigned32    |
  1097.              | tn3270eRtCollCtlIdleRate         Unsigned32    |
  1098.              | tn3270eRtCollCtlBucketBndry1     Unsigned32    |
  1099.              | tn3270eRtCollCtlBucketBndry2     Unsigned32    |
  1100.              | tn3270eRtCollCtlBucketBndry3     Unsigned32    |
  1101.              | tn3270eRtCollCtlBucketBndry4     Unsigned32    |
  1102.              | tn3270eRtCollCtlRowStatus        RowStatus     |
  1103.              --------------------------------------------------
  1104.  
  1105.   The tn3270eRtCollCtlType object controls the type(s) of response time
  1106.   collection that occur, the granularity of the collection, whether
  1107.   dynamic definite responses should be initiated, and whether
  1108.   notifications should be generated. This object is of BITS SYNTAX, and
  1109.   thus allows selection of multiple options.
  1110.  
  1111.   The BITS in the tn3270eRtCollCtlType object have the following
  1112.   meanings:
  1113.  
  1114.       o aggregate(0) - If this bit is set to 1, then data should be
  1115.         aggregated for the whole client group.  In this case there will
  1116.         be only one row created for the collection in the
  1117.         tn3270eRtDataTable. The first two indexes for this row,
  1118.         tn3270eSrvrConfIndex and tn3270eRtCollCtlClientGroupName, will
  1119.         have the same values as the indexes for this row in the
  1120.         tn3270eRtCollCtlTable.  The third and fourth indexes for an
  1121.         aggregated tn3270eRtDataEntry have the values 'unknown(0)'
  1122.         (for tn3270eRtDataClientAddrType) and a null octet string
  1123.         (for tn3270eRtDataClientAddress).
  1124.  
  1125.         If this bit is set to 0, then a separate entry is created in the
  1126.         tn3270eRtDataTable for each member of the client group.  In this
  1127.         case the tn3270eRtDataClientAddress contains the client's actual
  1128.         IP Address, and tn3270eRtDataClientAddrType indicates the type
  1129.         of this address.
  1130.  
  1131.       o excludeIpComponent(1) - If this bit is set to 1, then the
  1132.  
  1133.  
  1134.  
  1135. Expires March 1998                                             [Page 19]~
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1142.  
  1143.  
  1144.         server should exclude the IP-network component from all the
  1145.         response times for this collection.  If the target SNA
  1146.         application specifies DR in any of its replies, this DR will
  1147.         still be passed down to the client, and the client's response
  1148.         will still be forwarded to the application.  But this response
  1149.         will play no role in the server's response time calculations.
  1150.  
  1151.         If this bit is set to 0, then the server includes in the
  1152.         collection only those transactions for which it can include an
  1153.         (approximate) IP-network component in the total response time
  1154.         for the transaction.  This component may be derived from a
  1155.         "natural" DR (if the client supports the RESPONSES function),
  1156.         from a dynamic DR introduced by the server (if the client
  1157.         supports the RESPONSES function and the ddr(2) bit has been
  1158.         set to 1), or from TIMEMARK processing (if the client supports
  1159.         TIMEMARKs).
  1160.  
  1161.         If this bit is set to 1, then the ddr(2) bit is ignored, since
  1162.         there is no reason for the server to request additional
  1163.         responses from the client(s) in the group.
  1164.  
  1165.       o ddr(2) - If this bit is set to 1, then the server should, for
  1166.         those clients in the group that support the RESPONSES function,
  1167.         add a DR request to a reply in each transaction (usually, but
  1168.         not necessarily the LIC reply), and use the client's subsequent
  1169.         response for calculating an (approximate) IP-network component
  1170.         to include in the transaction's total response times.
  1171.  
  1172.         If this bit is set to 0, then the server does not add a DR
  1173.         request to any replies from the target SNA application.
  1174.  
  1175.         If the excludeIpComponent(1) bit is set to 1, then this bit is
  1176.         ignored by the server.
  1177.  
  1178.       o average(3) - If this bit is set to 1, then the server should
  1179.         calculate a sliding-window average for the collection, based
  1180.         on the parameters specfied for the group.
  1181.  
  1182.         If this bit is set to 0, then an average is not calculated.  In
  1183.         this case the tn3270eRtExceeded and tn3270eRtOkay notifications
  1184.         are not generated, even if the traps(5) bit is set to 1.
  1185.  
  1186.       o buckets(4) - If this bit is set to 1, then the server should
  1187.         create and increment response time buckets for the collection,
  1188.         based on the parameters specified for the group.
  1189.  
  1190.         If this bit is set to 0, then response time buckets are not
  1191.         created.
  1192.  
  1193.  
  1194.  
  1195. Expires March 1998                                             [Page 20]~
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1202.  
  1203.  
  1204.       o traps(5) - If this bit is set to 1, then the server generates
  1205.         the notifications defined in this MIB.  The tn3270CollStart and
  1206.         tn3270CollEnd notifications are always generated when this bit
  1207.         is set to 1; the tn3270eRtExceeded and tn3270eRtOkay
  1208.         notifications are generated only if the average(3) bit is also
  1209.         set to 1.
  1210.  
  1211.         If this bit is set to 0, then none of the notifications defined
  1212.         in this MIB are generated by the server.
  1213.  
  1214.   Either the average(3) or the buckets(4) bit must be set to 1 in order
  1215.   for response time data collection to occur. If the average(3) bit is
  1216.   set to 1, then the following objects have meaning, and are used to
  1217.   control the calculation of the averages, as well as the generation of
  1218.   the two notifications related to them:
  1219.  
  1220.       o tn3270eRtCollCtlSPeriod
  1221.       o tn3270eRtCollCtlSPMult
  1222.       o tn3270eRtCollCtlThreshHigh
  1223.       o tn3270eRtCollCtlThreshLow
  1224.       o tn3270eRtCollCtlIdleRate
  1225.  
  1226.  
  1227.   If the buckets(4) bit is set to 1, then the following objects have
  1228.   meaning, and specify the bucket boundaries:
  1229.  
  1230.       o tn3270eRtCollCtlBucketBndry1
  1231.       o tn3270eRtCollCtlBucketBndry2
  1232.       o tn3270eRtCollCtlBucketBndry3
  1233.       o tn3270eRtCollCtlBucketBndry4
  1234.  
  1235.  
  1236. 4.2.  tn3270eRtDataTable
  1237.  
  1238.   Either a single entry or multiple entries are created in the
  1239.   tn3270eRtDataTable for each tn3270eRtCollCtlEntry, depending on
  1240.   whether tn3270eRtCollCtlType in the control entry has aggregate(0)
  1241.   selected.  The contents of an entry in the tn3270eRtDataTable depend
  1242.   on the contents of the corresponding entry in the
  1243.   tn3270eRtCollCtlTable:  some objects in the data entry return
  1244.   meaningful values only when the average(3) option is selected in the
  1245.   control entry, while others return meaningful values only when the
  1246.   buckets(4) option is selected.  If both options are selected, then all
  1247.   the objects return meaningful values.  When an object is not specified
  1248.   to return a meaningful value, an implementation may return any value
  1249.   in response to a Get operation.
  1250.  
  1251.   The following objects return meaningful values if and only if the
  1252.  
  1253.  
  1254.  
  1255. Expires March 1998                                             [Page 21]~
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1262.  
  1263.  
  1264.   average(3) option was selected in the corresponding
  1265.   tn3270eRtCollCtlEntry:
  1266.  
  1267.        o tn3270eRtDataAvgRt
  1268.        o tn3270eRtDataAvgIpRt
  1269.        o tn3270eRtDataAvgTransCount
  1270.        o tn3270eRtDataIntTimeStamp
  1271.        o tn3270eRtDataTotalRt
  1272.        o tn3270eRtDataTotalIpRt
  1273.        o tn3270eRtDataTransCount
  1274.        o tn3270eRtDataDrCount
  1275.        o tn3270eRtDataElapsRndTrpSq
  1276.        o tn3270eRtDataElapsIpRtSq
  1277.  
  1278.   The first three objects in this list return values derived from the
  1279.   sliding-window average calculations described earlier.  The time of
  1280.   the most recent sample for these calculations is returned in the
  1281.   tn3270eRtDaraIntTimeStamp object. The next four objects are normal
  1282.   Counter32 objects, maintaining counts of total response time and total
  1283.   transactions. The last two objects return sum of the squares values,
  1284.   to enable variance calculations by a management application.
  1285.  
  1286.        o tn3270eRtDataElapsRndTrpSq
  1287.        o tn3270eRtDataElapsIpRtSq
  1288.  
  1289.  
  1290.   The following objects return meaningful values if and only if the
  1291.   buckets(4) option was selected in the corresponding
  1292.   tn3270eRtCollCtlEntry:
  1293.  
  1294.        o tn3270eRtDataBucket1
  1295.        o tn3270eRtDataBucket2
  1296.        o tn3270eRtDataBucket3
  1297.        o tn3270eRtDataBucket4
  1298.        o tn3270eRtDataBucket5
  1299.  
  1300.   A discontinuity object, tn3270eRtDataDiscontinuityTime, can be used by
  1301.   a management application to detect when the values of the counter
  1302.   objects in this table may have been reset, or otherwise experienced a
  1303.   discontinuity. A possible cause for such a discontinuity is the
  1304.   TN3270E server's being stopped or restarted.  This object returns a
  1305.   meaningful value regardless of which collection control options were
  1306.   selected.
  1307.  
  1308.   When an entry is created in the tn3270eRtCollCtlTable with its
  1309.   tn3270eRtCollCtlType aggregate(0) bit set to 1, an entry is
  1310.   automatically created in the tn3270eRtDataTable; this entry's
  1311.   tn3270eRtDataClientAddress has the value of a null octet string, and
  1312.  
  1313.  
  1314.  
  1315. Expires March 1998                                             [Page 22]~
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1322.  
  1323.  
  1324.   its tn3270eRtDataClientAddrType has the value of unknown(0).
  1325.  
  1326.   When an entry is created in the tn3270eRtCollCtlTable with its
  1327.   tn3270eRtCollCtlType aggregate(0) bit set to 0, a separate entry is
  1328.   created in the tn3270eRtDataTable for each member of the client group
  1329.   that currently has a session with the TN3270E server.  Entries are
  1330.   subsequently created for clients that the TN3270E server determines to
  1331.   be members of the client group when these clients establish sessions
  1332.   with the server.
  1333.  
  1334.   All entries associated with a tn3270eRtCollCtlEntry are deleted from
  1335.   the tn3270eRtDataTable when that entry is deleted from the
  1336.   tn3270eRtCollCtlTable.  An entry for an individual client in a client
  1337.   group is deleted when its TCP connection terminates.
  1338.  
  1339.  
  1340. 4.3.  Notifications
  1341.  
  1342.   This MIB defines four notifications related to a tn3270eRtDataEntry.
  1343.   If the associated tn3270eRtCollCtlType object's traps(5) bit is set to
  1344.   1, then the tn3270RtCollStart and tn3270RtCollEnd notifications are
  1345.   generated when, respsectively, the tn3270eRtDataEntry is created and
  1346.   deleted.  If, in addition, this tn3270eRtCollCtlType object's
  1347.   average(3) bit is set to 1, then the the tn3270eRtExceeded and
  1348.   tn3270eRtOkay notifications are generated when the conditions they
  1349.   report occur.
  1350.  
  1351.   The following notifications are defined by this MIB:
  1352.  
  1353.       o tn3270eRtExceeded - The purpose of this notification is to
  1354.         signal that a performance problem has been detected. If
  1355.         average(3) response time data is being collected, then this
  1356.         notification is generated whenever (1) an average response
  1357.         time is first found, on a collection interval boundary, to
  1358.         have exceeded the high threshold tn3270eRtCollCtlThreshHigh
  1359.         specified for the client group, AND (2) the sample on which the
  1360.         average is based is determined to have been a significant one,
  1361.         via the significance algorithm described earlier. This
  1362.         notification is not generated again for a tn3270eRtDataEntry
  1363.         until an average response time falling below the low
  1364.         threshold tn3270eRtCollCtlThreshLow specified for the client
  1365.         group has occured for the entry.
  1366.  
  1367.       o tn3270eRtOkay - The purpose of this notification is to signal
  1368.         that a previously reported performance problem has been
  1369.         resolved. If average(3) response time data is being collected,
  1370.         then this notification is generated whenever (1) a
  1371.         tn3270eRtExceeded notification has already been generated, AND
  1372.  
  1373.  
  1374.  
  1375. Expires March 1998                                             [Page 23]~
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1382.  
  1383.  
  1384.         (2) an average response time is first found, on a collection
  1385.         interval boundary, to have fallen below the low threshold
  1386.         tn3270eRtCollCtlThreshLow specified for the client group.
  1387.         This notification is not generated again for a
  1388.         tn3270eRtDataEntry until an average response time
  1389.         exceeding the high threshold tn3270eRtCollCtlThreshHigh
  1390.         specified for the client group has occurred for the entry.
  1391.  
  1392.   Taken together, the two preceding notifications serve to minimize the
  1393.   generation of an excessive number of traps in the case of an average
  1394.   response time that oscillates about its high threshold.
  1395.  
  1396.       o tn3270eRtCollStart - This notification is generated whenever
  1397.         data collection begins for a client group, or when a new
  1398.         tn3270eRtDataEntry becomes active.  The primary purpose of
  1399.         this notification is signal to a management application that
  1400.         a new client TCP session has been established, and to provide
  1401.         the IP-to-resource mapping for the session. This notification
  1402.         is not critical when average(3) data collection is not being
  1403.         performed for the client group.
  1404.  
  1405.       o tn3270eRtCollEnd - This notification is generated whenever
  1406.         a data collection ends. For an aggregate collection, this
  1407.         occurs when the corresponding tn3270eRtCollCtlEntry is
  1408.         deleted.  For an individual collection, this occurs either
  1409.         when the tn3270eRtCollCtlEntry is deleted, or when the
  1410.         client's TCP connection terminates.  The purpose of this
  1411.         notification is to enable a management application to
  1412.         complete a monitoring function that it was performing, by
  1413.         returning final values for the collection's data objects.
  1414.  
  1415.  
  1416. 5.  Definitions
  1417.  
  1418.   TN3270E-RT-MIB DEFINITIONS ::= BEGIN
  1419.  
  1420.   IMPORTS
  1421.       MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  1422.       experimental, Counter32, BITS, Unsigned32,
  1423.       Gauge32
  1424.                   FROM SNMPv2-SMI
  1425.       RowStatus, DateAndTime, TimeStamp
  1426.                   FROM SNMPv2-TC
  1427.       MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
  1428.                   FROM SNMPv2-CONF
  1429.       Tn3270eAddrType, Tn3270eTAddress, tn3270eSrvrConfIndex,
  1430.       tn3270eResMapElementName, tn3270eResMapElementType
  1431.                   FROM TN3270E-MIB
  1432.  
  1433.  
  1434.  
  1435. Expires March 1998                                             [Page 24]~
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1442.  
  1443.  
  1444.       Utf8String
  1445.                   FROM SYSAPPL-MIB;
  1446.  
  1447.   tn3270eRtMIB   MODULE-IDENTITY
  1448.       LAST-UPDATED "9709240000Z" -- September 24, 1997
  1449.       ORGANIZATION "TN3270E Working Group"
  1450.       CONTACT-INFO
  1451.         "Kenneth White (kennethw@vnet.ibm.com)
  1452.          IBM Corp. - Dept. BRQA/Bldg. 503/C117
  1453.          P.O. Box 12195
  1454.          3039 Cornwallis
  1455.          RTP, NC 27709-2195
  1456.          (919) 254-0102
  1457.  
  1458.          Robert Moore (remoore@us.ibm.com)
  1459.          IBM Corp. - Dept. BRQA/Bldg. 501/G114
  1460.          P.O. Box 12195
  1461.          3039 Cornwallis
  1462.          RTP, NC 27709-2195
  1463.          (919) 254-7507"
  1464.       DESCRIPTION
  1465.         "This module defines a portion of the management information
  1466.          base (MIB) that enables monitoring of TN3270 and TN3270E
  1467.          clients' response times by a TN3270E server."
  1468.       ::= { experimental 81 }
  1469.  
  1470.   -- Top level structure of the MIB
  1471.  
  1472.   tn3270eRtNotifications   OBJECT IDENTIFIER  ::= { tn3270eRtMIB 0 }
  1473.   tn3270eRtObjects         OBJECT IDENTIFIER  ::= { tn3270eRtMIB 1 }
  1474.   tn3270eRtConformance     OBJECT IDENTIFIER  ::= { tn3270eRtMIB 3 }
  1475.  
  1476.   -- MIB Objects
  1477.  
  1478.   -- Response Time Control Table
  1479.  
  1480.   tn3270eRtCollCtlTable  OBJECT-TYPE
  1481.       SYNTAX       SEQUENCE OF Tn3270eRtCollCtlEntry
  1482.       MAX-ACCESS   not-accessible
  1483.       STATUS       current
  1484.       DESCRIPTION
  1485.         "The response time monitoring collection control table, which
  1486.          allows a management application to control the types of
  1487.          response time data being collected, and the clients for which
  1488.          it is being collected.
  1489.  
  1490.          This table is indexed by tn3270eSrvrConfIndex, imported from
  1491.          the TN3270E-MIB, and by tn3270eRtCollCtlClientGroupName.
  1492.  
  1493.  
  1494.  
  1495. Expires March 1998                                             [Page 25]~
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1502.  
  1503.  
  1504.          tn3270eSrvrConfIndex indicates within a host which TN3270E
  1505.          server an entry applied to.
  1506.  
  1507.          tn3270eRtCollCtlClientGroupName is equivalent to the
  1508.          tn3270eClientGroupName index in the TN3270E-MIB; it identifies
  1509.          the collection of IP clients for which response time data
  1510.          is being collectedr. The particular IP clients making up the
  1511.          collection are identified in the tn3270eClientGroupTable in
  1512.          the TN3270E-MIB."
  1513.       ::= { tn3270eRtObjects 1}
  1514.  
  1515.   tn3270eRtCollCtlEntry    OBJECT-TYPE
  1516.       SYNTAX        Tn3270eRtCollCtlEntry
  1517.       MAX-ACCESS    not-accessible
  1518.       STATUS        current
  1519.       DESCRIPTION
  1520.         "Entry in the TN3270E response time monitoring collection
  1521.          control table. To handle the case of multiple TN3270E servers
  1522.          on the same host, the first index of this table is the
  1523.          tn3270eSrvrConfIndex from the TN3270E-MIB."
  1524.       INDEX {
  1525.         tn3270eSrvrConfIndex,             -- Server's index
  1526.         tn3270eRtCollCtlClientGroupName } -- What to collect on
  1527.       ::= { tn3270eRtCollCtlTable 1 }
  1528.  
  1529.   Tn3270eRtCollCtlEntry ::= SEQUENCE {
  1530.       tn3270eRtCollCtlClientGroupName   Utf8String,
  1531.       tn3270eRtCollCtlType              BITS,
  1532.       tn3270eRtCollCtlSPeriod           Unsigned32,
  1533.       tn3270eRtCollCtlSPMult            Unsigned32,
  1534.       tn3270eRtCollCtlThreshHigh        Unsigned32,
  1535.       tn3270eRtCollCtlThreshLow         Unsigned32,
  1536.       tn3270eRtCollCtlIdleRate          Unsigned32,
  1537.       tn3270eRtCollCtlBucketBndry1      Unsigned32,
  1538.       tn3270eRtCollCtlBucketBndry2      Unsigned32,
  1539.       tn3270eRtCollCtlBucketBndry3      Unsigned32,
  1540.       tn3270eRtCollCtlBucketBndry4      Unsigned32,
  1541.       tn3270eRtCollCtlRowStatus         RowStatus   }
  1542.  
  1543.   tn3270eRtCollCtlClientGroupName OBJECT-TYPE
  1544.       SYNTAX      Utf8String (SIZE(1..24))
  1545.       MAX-ACCESS  not-accessible
  1546.       STATUS      current
  1547.       DESCRIPTION
  1548.           "The name of a client group. Membership in a client group is
  1549.            specified via the TN3270E-MIB's tn3270eClientGroupTable.
  1550.            The index for that table, tn3270eClientGroupName, is
  1551.            equivalent to this object; it was not imported because
  1552.  
  1553.  
  1554.  
  1555. Expires March 1998                                             [Page 26]~
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1562.  
  1563.  
  1564.            doing so results in MIB compiler errors."
  1565.  
  1566.       ::= { tn3270eRtCollCtlEntry 1 }
  1567.  
  1568.   tn3270eRtCollCtlType  OBJECT-TYPE
  1569.       SYNTAX    BITS {
  1570.                     aggregate(0),
  1571.                     excludeIpComponent(1),
  1572.                     ddr(2),
  1573.                     average(3),
  1574.                     buckets(4),
  1575.                     traps(5)
  1576.                      }
  1577.       MAX-ACCESS   read-create
  1578.       STATUS       current
  1579.       DESCRIPTION
  1580.         "This object controls what types of response time data to
  1581.          collect, whether to summarize the data across the members
  1582.          of a client group or keep it individually, whether to
  1583.          introduce dynamic definite responses, and whether to
  1584.          generate traps.
  1585.  
  1586.          aggregate(0)          - Aggregate response time data for the
  1587.                                  client group as a whole. If this bit is
  1588.                                  set to 0, then maintain response time
  1589.                                  data separately for each member of the
  1590.                                  client group.
  1591.          excludeIpComponent(1) - Do not include the IP-network component
  1592.                                  in any response times.
  1593.          ddr(2)                - Enable dynamic definite response.
  1594.          average(3)            - Produce an average response time based
  1595.                                  on a specified collection interval.
  1596.          buckets(4)            - Maintain tn3270eRtDataBucket values in
  1597.                                  a corresponding tn3270eRtDataEntry,
  1598.                                  based on the bucket boundaries
  1599.                                  specified in the
  1600.                                  tn3270eRtDataBucketBndry objects.
  1601.          traps(5)              - generate the traps specified in this
  1602.                                  MIB module. The tn3270eRtExceeded and
  1603.                                  tn3270eRtOkay are generated only if
  1604.                                  average(3) is also specified."
  1605.       ::= { tn3270eRtCollCtlEntry 2 }
  1606.  
  1607.   tn3270eRtCollCtlSPeriod OBJECT-TYPE
  1608.       SYNTAX  Unsigned32 -- 15 second minimum to 24 hour max
  1609.       UNITS   "seconds"
  1610.       MAX-ACCESS   read-create
  1611.       STATUS       current
  1612.  
  1613.  
  1614.  
  1615. Expires March 1998                                             [Page 27]~
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1622.  
  1623.  
  1624.       DESCRIPTION
  1625.         "The number of seconds that defines the sample period.
  1626.          The actual interval is defined as tn3270eRtCollCtlSPeriod
  1627.          times tn3270eRtCollCtlSPMult.
  1628.  
  1629.          The value of this object is used only if the corresponding
  1630.          tn3270eRtCollCtlType has the average(3) setting."
  1631.       DEFVAL   {20}    -- 20 seconds
  1632.       ::= { tn3270eRtCollCtlEntry 3 }
  1633.  
  1634.   tn3270eRtCollCtlSPMult OBJECT-TYPE
  1635.       SYNTAX  Unsigned32 -- should be > 1
  1636.       UNITS   "count"
  1637.       MAX-ACCESS   read-create
  1638.       STATUS       current
  1639.       DESCRIPTION
  1640.         "The sample period multiplier; this value is multiplied by the
  1641.          sample period, tn3270eRtCollCtlSPeriod, to determine the
  1642.          collection interval.
  1643.  
  1644.          The value of this object is used only if the corresponding
  1645.          tn3270eRtCollCtlType has the average(3) setting."
  1646.       DEFVAL   { 30 }    -- yields an interval of 10 minutes when
  1647.                          -- used with the default SPeriod value
  1648.       ::= { tn3270eRtCollCtlEntry 4 }
  1649.  
  1650.   tn3270eRtCollCtlThreshHigh  OBJECT-TYPE
  1651.       SYNTAX            Unsigned32
  1652.       UNITS             "seconds"
  1653.       MAX-ACCESS        read-create
  1654.       STATUS            current
  1655.       DESCRIPTION
  1656.         "The threshold for generating a tn3270eRtExceeded notification,
  1657.         signalling that a monitored total response time has exceeded the
  1658.         specified limit.  A value of zero for this object suppresses
  1659.         generation of this notification.  The value of this object is
  1660.         used only if the corresponding tn3270eRtCollCtlType has
  1661.         average(3) and traps(5) selected."
  1662.        ::= { tn3270eRtCollCtlEntry 5 }
  1663.  
  1664.   tn3270eRtCollCtlThreshLow   OBJECT-TYPE
  1665.       SYNTAX            Unsigned32
  1666.       UNITS             "seconds"
  1667.       MAX-ACCESS        read-create
  1668.       STATUS            current
  1669.       DESCRIPTION
  1670.         "The threshold for generating a tn3270eRtOkay notification,
  1671.         signalling that a monitored total response time has fallen below
  1672.  
  1673.  
  1674.  
  1675. Expires March 1998                                             [Page 28]~
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1682.  
  1683.  
  1684.         the specified limit.  A value of zero for this object suppresses
  1685.         generation of this notification.  The value of this object is
  1686.         used only if the corresponding tn3270eRtCollCtlType has
  1687.         average(3) and traps(5) selected."
  1688.       ::= { tn3270eRtCollCtlEntry 6 }
  1689.  
  1690.   tn3270eRtCollCtlIdleRate   OBJECT-TYPE
  1691.       SYNTAX            Unsigned32
  1692.       UNITS             "transaction count"
  1693.       MAX-ACCESS        read-create
  1694.       STATUS            current
  1695.       DESCRIPTION
  1696.         "The value of this object is used to determine whether a sample
  1697.          that yields an average response time exceeding the value of
  1698.          tn3270eRtCollCtlThreshHigh was a statistically valid one.  If
  1699.          the following statement is true, then the sample was
  1700.          statistically valid, and so a tn3270eRtExceeded notification
  1701.          should be generated:
  1702.  
  1703.             AvgTransCount * ((AvgRt/ThreshHigh - 1) ** 2) <  IdleRate
  1704.  
  1705.          This comparison is done only if the corresponding
  1706.          tn3270eRtCollCtlType has average(3) and traps(5) selected."
  1707.       DEFVAL { 1 }
  1708.       ::= { tn3270eRtCollCtlEntry 7 }
  1709.  
  1710.   tn3270eRtCollCtlBucketBndry1   OBJECT-TYPE
  1711.       SYNTAX            Unsigned32
  1712.       UNITS             "tenths of seconds"
  1713.       MAX-ACCESS        read-create
  1714.       STATUS            current
  1715.       DESCRIPTION
  1716.         "The value of this object defines the range of transaction
  1717.          response times counted in the Tn3270eRtDataBucket1 object:
  1718.          those less than or equal to this value."
  1719.       DEFVAL { 10 }
  1720.       ::= { tn3270eRtCollCtlEntry 8 }
  1721.  
  1722.   tn3270eRtCollCtlBucketBndry2   OBJECT-TYPE
  1723.       SYNTAX            Unsigned32
  1724.       UNITS             "tenths of seconds"
  1725.       MAX-ACCESS        read-create
  1726.       STATUS            current
  1727.       DESCRIPTION
  1728.         "The value of this object, together with that of the
  1729.         tn3270eRtCollCtlBucketBndry1 object, defines the range of
  1730.         transaction response times counted in the Tn3270eRtDataBucket2
  1731.         object:  those greater than the value of the
  1732.  
  1733.  
  1734.  
  1735. Expires March 1998                                             [Page 29]~
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1742.  
  1743.  
  1744.         tn3270eRtCollCtlBucketBndry1 object, and less than or equal to
  1745.         the value of this object."
  1746.       DEFVAL { 20 }
  1747.       ::= { tn3270eRtCollCtlEntry 9 }
  1748.  
  1749.   tn3270eRtCollCtlBucketBndry3   OBJECT-TYPE
  1750.       SYNTAX            Unsigned32
  1751.       UNITS             "tenths of seconds"
  1752.       MAX-ACCESS        read-create
  1753.       STATUS            current
  1754.       DESCRIPTION
  1755.         "The value of this object, together with that of the
  1756.         tn3270eRtCollCtlBucketBndry2 object, defines the range of
  1757.         transaction response times counted in the Tn3270eRtDataBucket3
  1758.         object:  those greater than the value of the
  1759.         tn3270eRtCollCtlBucketBndry2 object, and less than or equal to
  1760.         the value of this object."
  1761.       DEFVAL { 50 }
  1762.       ::= { tn3270eRtCollCtlEntry 10 }
  1763.  
  1764.   tn3270eRtCollCtlBucketBndry4   OBJECT-TYPE
  1765.       SYNTAX            Unsigned32
  1766.       UNITS             "tenths of seconds"
  1767.       MAX-ACCESS        read-create
  1768.       STATUS            current
  1769.       DESCRIPTION
  1770.         "The value of this object, together with that of the
  1771.         tn3270eRtCollCtlBucketBndry3 object, defines the range of
  1772.         transaction response times counted in the Tn3270eRtDataBucket4
  1773.         object:  those greater than the value of the
  1774.         tn3270eRtCollCtlBucketBndry3 object, and less than or equal to
  1775.         the value of this object.
  1776.  
  1777.         The value of this object also defines the range of transaction
  1778.         response times counted in the Tn3270eRtDataBucket5 object:
  1779.         those greater than the value of this object."
  1780.       DEFVAL { 100 }
  1781.       ::= { tn3270eRtCollCtlEntry 11 }
  1782.  
  1783.   tn3270eRtCollCtlRowStatus  OBJECT-TYPE
  1784.       SYNTAX            RowStatus
  1785.       MAX-ACCESS        read-create
  1786.       STATUS            current
  1787.       DESCRIPTION
  1788.         "This object allows entries to be created and deleted
  1789.          in the tn3270eRtCollCtlTable.  An entry in this table
  1790.          is deleted by setting this object to destroy(6).
  1791.          Deleting an entry in this table has the side-effect
  1792.  
  1793.  
  1794.  
  1795. Expires March 1998                                             [Page 30]~
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1802.  
  1803.  
  1804.          of removing all entries from the tn3270eRtDataTable
  1805.          that are associated with the entry being deleted."
  1806.       ::= { tn3270eRtCollCtlEntry 12 }
  1807.  
  1808.  
  1809.   -- TN3270E Response Time Data Table
  1810.  
  1811.   tn3270eRtDataTable  OBJECT-TYPE
  1812.       SYNTAX       SEQUENCE OF Tn3270eRtDataEntry
  1813.       MAX-ACCESS   not-accessible
  1814.       STATUS       current
  1815.       DESCRIPTION
  1816.         "The response time data table. Entries in this table are
  1817.          created based on entries in the tn3270eRtCollCtlTable."
  1818.       ::= { tn3270eRtObjects 2 }
  1819.  
  1820.   tn3270eRtDataEntry  OBJECT-TYPE
  1821.       SYNTAX        Tn3270eRtDataEntry
  1822.       MAX-ACCESS    not-accessible
  1823.       STATUS        current
  1824.       DESCRIPTION
  1825.         "An entry in this table is created based upon the
  1826.          tn3270eRtCollCtlTable.  A single entry is created with a
  1827.          tn3270eRtDataClientAddrType of 'unknown(0)' and a null octet
  1828.          string value for tn3270eRtDataClientAddress when the
  1829.          corresponding tn3270eRtCollCtlType has aggregate(0) specified.
  1830.          When aggregate(0) is not specified, then a separate entry is
  1831.          created for each client.
  1832.  
  1833.          Note that the following objects defined within an
  1834.          entry in this table can wrap:
  1835.             tn3270eRtDataTotalRt
  1836.             tn3270eRtDataTotalIpRt
  1837.             tn3270eRtDataTransCount
  1838.             tn3270eRtDataDrCount
  1839.             tn3270eRtDataElapsRnTrpSq
  1840.             tn3270eRtDataElapsIpRtSq
  1841.             tn3270eRtDataBucket1
  1842.             tn3270eRtDataBucket2
  1843.             tn3270eRtDataBucket3
  1844.             tn3270eRtDataBucket4
  1845.             tn3270eRtDataBucket5"
  1846.       INDEX {
  1847.          tn3270eSrvrConfIndex,            -- Server's local index
  1848.          tn3270eRtCollCtlClientGroupName, -- Target of data collection
  1849.          tn3270eRtDataClientAddrType,
  1850.          tn3270eRtDataClientAddress }
  1851.       ::= { tn3270eRtDataTable 1 }
  1852.  
  1853.  
  1854.  
  1855. Expires March 1998                                             [Page 31]~
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1862.  
  1863.  
  1864.   Tn3270eRtDataEntry ::= SEQUENCE {
  1865.          tn3270eRtDataClientAddrType        Tn3270eAddrType,
  1866.          tn3270eRtDataClientAddress         Tn3270eTAddress,
  1867.          tn3270eRtDataDiscontinuityTime     TimeStamp,
  1868.          tn3270eRtDataAvgRt                 Gauge32,
  1869.          tn3270eRtDataAvgIpRt               Gauge32,
  1870.          tn3270eRtDataAvgTransCount         Counter32,
  1871.          tn3270eRtDataIntTimeStamp          DateAndTime,
  1872.          tn3270eRtDataTotalRt               Counter32,
  1873.          tn3270eRtDataTotalIpRt             Counter32,
  1874.          tn3270eRtDataTransCount            Counter32,
  1875.          tn3270eRtDataDrCount               Counter32,
  1876.          tn3270eRtDataElapsRndTrpSq         Unsigned32,
  1877.          tn3270eRtDataElapsIpRtSq           Unsigned32,
  1878.          tn3270eRtDataBucket1               Counter32,
  1879.          tn3270eRtDataBucket2               Counter32,
  1880.          tn3270eRtDataBucket3               Counter32,
  1881.          tn3270eRtDataBucket4               Counter32,
  1882.          tn3270eRtDataBucket5               Counter32
  1883.      }
  1884.  
  1885.   tn3270eRtDataClientAddrType   OBJECT-TYPE
  1886.       SYNTAX    Tn3270eAddrType
  1887.       MAX-ACCESS   not-accessible
  1888.       STATUS       current
  1889.       DESCRIPTION
  1890.         "Indicates the type of address that following in the
  1891.          instance OID represented by tn3270eRtDataClientAddress."
  1892.       ::= { tn3270eRtDataEntry 1 }
  1893.  
  1894.   tn3270eRtDataClientAddress   OBJECT-TYPE
  1895.       SYNTAX    Tn3270eTAddress
  1896.       MAX-ACCESS   not-accessible
  1897.       STATUS       current
  1898.       DESCRIPTION
  1899.         "Contains the IP address of the TN3270 client being
  1900.          monitored. A null octet string is used if the aggregate
  1901.          of the Client Group is being collected "
  1902.       ::= { tn3270eRtDataEntry 2 }
  1903.  
  1904.   tn3270eRtDataDiscontinuityTime OBJECT-TYPE
  1905.       SYNTAX      TimeStamp
  1906.       MAX-ACCESS  read-only
  1907.       STATUS      current
  1908.       DESCRIPTION
  1909.           "The value of sysUpTime on the most recent occasion at
  1910.            which any one or more of this entry's objects
  1911.            suffered a discontinuity. One possibility of this is
  1912.  
  1913.  
  1914.  
  1915. Expires March 1998                                             [Page 32]~
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1922.  
  1923.  
  1924.            when a TN3270E Server is stopped and then restarted
  1925.            where local methods are used to setup collection
  1926.            policy (tn3270eRtCollCtlTable entries).
  1927.  
  1928.            In order to prevent a TN3270E Server from caching this
  1929.            object it is recommended that the TN3270E Server's
  1930.            startup time be used as the objects initial value."
  1931.       ::= { tn3270eRtDataEntry 3 }
  1932.  
  1933.   tn3270eRtDataAvgRt OBJECT-TYPE
  1934.       SYNTAX       Gauge32
  1935.       UNITS        "tenths of seconds"
  1936.       MAX-ACCESS   read-only
  1937.       STATUS       current
  1938.       DESCRIPTION
  1939.         "The average total response time measured over the last
  1940.          collection interval."
  1941.       DEFVAL { 0 }
  1942.       ::= { tn3270eRtDataEntry 4 }
  1943.  
  1944.   tn3270eRtDataAvgIpRt OBJECT-TYPE
  1945.       SYNTAX       Gauge32
  1946.       UNITS        "tenths of seconds"
  1947.       MAX-ACCESS   read-only
  1948.       STATUS       current
  1949.       DESCRIPTION
  1950.         "The average IP response time measured over the last
  1951.          collection interval."
  1952.       DEFVAL { 0 }
  1953.       ::= { tn3270eRtDataEntry 5 }
  1954.  
  1955.   tn3270eRtDataAvgTransCount   OBJECT-TYPE
  1956.       SYNTAX       Counter32
  1957.       UNITS        "transactions"
  1958.       MAX-ACCESS   read-only
  1959.       STATUS       current
  1960.       DESCRIPTION
  1961.         "The sliding transaction count used for calculating the values
  1962.          of the tn3270eRtDataAvgRt and tn3270eRtDataAvgIpRt objects.
  1963.          The actual transaction count is available in the
  1964.          tn3270eRtDataTransCount object."
  1965.       ::= { tn3270eRtDataEntry 6 }
  1966.  
  1967.   tn3270eRtDataIntTimeStamp   OBJECT-TYPE
  1968.       SYNTAX       DateAndTime
  1969.       MAX-ACCESS   read-only
  1970.       STATUS       current
  1971.       DESCRIPTION
  1972.  
  1973.  
  1974.  
  1975. Expires March 1998                                             [Page 33]~
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  1982.  
  1983.  
  1984.         "The date and time of the last interval that tn3270eRtDataAvgRt,
  1985.          tn3270eRtDataAvgIpRt, and tn3270eRtDataAvgTransCount were
  1986.          calculated."
  1987.       ::= { tn3270eRtDataEntry 7 }
  1988.  
  1989.   tn3270eRtDataTotalRt   OBJECT-TYPE
  1990.       SYNTAX       Counter32
  1991.       UNITS        "tenths of seconds"
  1992.       MAX-ACCESS   read-only
  1993.       STATUS       current
  1994.       DESCRIPTION
  1995.         "A count of the total response time collected."
  1996.       ::= { tn3270eRtDataEntry 8 }
  1997.  
  1998.   tn3270eRtDataTotalIpRt   OBJECT-TYPE
  1999.       SYNTAX       Counter32
  2000.       UNITS        "tenths of seconds"
  2001.       MAX-ACCESS   read-only
  2002.       STATUS       current
  2003.       DESCRIPTION
  2004.         "A count of the total IP-network response time collected."
  2005.       ::= { tn3270eRtDataEntry 9 }
  2006.  
  2007.   tn3270eRtDataTransCount   OBJECT-TYPE
  2008.       SYNTAX       Counter32
  2009.       UNITS        "transactions"
  2010.       MAX-ACCESS   read-only
  2011.       STATUS       current
  2012.       DESCRIPTION
  2013.         "A count of the total number of transactions detected."
  2014.       ::= { tn3270eRtDataEntry 10 }
  2015.  
  2016.   tn3270eRtDataDrCount   OBJECT-TYPE
  2017.       SYNTAX       Counter32
  2018.       UNITS        "transactions"
  2019.       MAX-ACCESS   read-only
  2020.       STATUS       current
  2021.       DESCRIPTION
  2022.         "A count of the total number of definite responses detected."
  2023.       ::= { tn3270eRtDataEntry 11 }
  2024.  
  2025.   tn3270eRtDataElapsRndTrpSq   OBJECT-TYPE
  2026.       SYNTAX       Unsigned32
  2027.       UNITS        "tenths of seconds squared"
  2028.       MAX-ACCESS   read-only
  2029.       STATUS       current
  2030.       DESCRIPTION
  2031.         "The sum of the elapsed round trip time squared.  A sum of the
  2032.  
  2033.  
  2034.  
  2035. Expires March 1998                                             [Page 34]~
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  2042.  
  2043.  
  2044.          squares is keep in order to calculate a variance."
  2045.       DEFVAL { 0 }
  2046.       ::= { tn3270eRtDataEntry 12 }
  2047.  
  2048.   tn3270eRtDataElapsIpRtSq   OBJECT-TYPE
  2049.       SYNTAX       Unsigned32
  2050.       UNITS        "tenths of seconds squared"
  2051.       MAX-ACCESS   read-only
  2052.       STATUS       current
  2053.       DESCRIPTION
  2054.         "The sum of the elapsed IP round trip time squared.  A sum of
  2055.          the squares is keep in order to calculate a variance."
  2056.       DEFVAL { 0 }
  2057.       ::= { tn3270eRtDataEntry 13 }
  2058.  
  2059.   tn3270eRtDataBucket1   OBJECT-TYPE
  2060.       SYNTAX       Counter32
  2061.       MAX-ACCESS   read-only
  2062.       STATUS       current
  2063.       DESCRIPTION
  2064.         "A count of the response times falling into bucket 1."
  2065.       ::= { tn3270eRtDataEntry 14 }
  2066.  
  2067.   tn3270eRtDataBucket2   OBJECT-TYPE
  2068.       SYNTAX       Counter32
  2069.       MAX-ACCESS   read-only
  2070.       STATUS       current
  2071.       DESCRIPTION
  2072.         "A count of the response times falling into bucket 2."
  2073.       ::= { tn3270eRtDataEntry 15 }
  2074.  
  2075.   tn3270eRtDataBucket3   OBJECT-TYPE
  2076.       SYNTAX       Counter32
  2077.       MAX-ACCESS   read-only
  2078.       STATUS       current
  2079.       DESCRIPTION
  2080.         "A count of the response times falling into bucket 3."
  2081.       ::= { tn3270eRtDataEntry 16 }
  2082.  
  2083.   tn3270eRtDataBucket4  OBJECT-TYPE
  2084.       SYNTAX       Counter32
  2085.       MAX-ACCESS   read-only
  2086.       STATUS       current
  2087.       DESCRIPTION
  2088.          "A count of the response times falling into bucket 4."
  2089.       ::= { tn3270eRtDataEntry 17 }
  2090.  
  2091.   tn3270eRtDataBucket5  OBJECT-TYPE
  2092.  
  2093.  
  2094.  
  2095. Expires March 1998                                             [Page 35]~
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  2102.  
  2103.  
  2104.       SYNTAX       Counter32
  2105.       MAX-ACCESS   read-only
  2106.       STATUS       current
  2107.       DESCRIPTION
  2108.         "A count of the response times falling into bucket 5."
  2109.       ::= { tn3270eRtDataEntry 18 }
  2110.  
  2111.   -- Notifications
  2112.  
  2113.   tn3270eRtExceeded   NOTIFICATION-TYPE
  2114.       OBJECTS {
  2115.          tn3270eSrvrConfIndex,            -- server's local index
  2116.          tn3270eRtCollCtlClientGroupName, -- target of data collection
  2117.          tn3270eRtDataClientAddrType,
  2118.          tn3270eRtDataClientAddress,
  2119.          tn3270eRtDataIntTimeStamp,
  2120.          tn3270eRtDataAvgRt,
  2121.          tn3270eRtDataAvgIpRt,
  2122.          tn3270eRtDataAvgTransCount
  2123.       }
  2124.       STATUS  current
  2125.       DESCRIPTION
  2126.         "This notification is generated when the average response time,
  2127.         tn3270eRtDataAvgRt, exceeds tn3270eRtCollCtlThresholdHigh at
  2128.         the end of a collection interval specified by
  2129.         tn3270eCollCtlSPeriod times tn3270eCollCtlSPMult.  Note that
  2130.         the corresponding tn3270eCollCtlType must have traps(5) and
  2131.         average(3) set for this notification to be generated.  In
  2132.         addition, tn3270eRtDataAvgTransCount,
  2133.         tn3270eRtCollCtlThreshHigh and tn3270eRtDataAvgRt are
  2134.         algorithmically compared to tn3270eRtCollCtlIdleRate for
  2135.         determination if this will be suppressed."
  2136.       ::= { tn3270eRtNotifications 1 }
  2137.  
  2138.   tn3270eRtOkay   NOTIFICATION-TYPE
  2139.       OBJECTS {
  2140.          tn3270eSrvrConfIndex,            -- server's local index
  2141.          tn3270eRtCollCtlClientGroupName, -- target of data collection
  2142.          tn3270eRtDataClientAddrType,
  2143.          tn3270eRtDataClientAddress,-- IP Address or null octet string
  2144.          tn3270eRtDataIntTimeStamp,
  2145.          tn3270eRtDataAvgRt,
  2146.          tn3270eRtDataAvgIpRt,
  2147.          tn3270eRtDataAvgTransCount
  2148.       }
  2149.       STATUS  current
  2150.       DESCRIPTION
  2151.         "This notification is generated when the average response time,
  2152.  
  2153.  
  2154.  
  2155. Expires March 1998                                             [Page 36]~
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  2162.  
  2163.  
  2164.         tn3270eRtDataAvgRt, falls below tn3270eRtCollCtlThresholdLow at
  2165.         the end of a collection interval specified by
  2166.         tn3270eCollCtlSPeriod times tn3270eCollCtlSPMult, after a
  2167.         tn3270eRtExceeded notification was generated.  Note that the
  2168.         corresponding tn3270eCollCtlType must have traps(5) and
  2169.         average(3) set for this notification to be generated."
  2170.       ::= { tn3270eRtNotifications 2 }
  2171.  
  2172.   tn3270eRtCollStart NOTIFICATION-TYPE
  2173.       OBJECTS {
  2174.          tn3270eSrvrConfIndex,        -- server's local index
  2175.          tn3270eRtCollCtlClientGroupName, -- Data collection target
  2176.          tn3270eRtDataClientAddrType,
  2177.          tn3270eRtDataClientAddress,  -- IP Address or null octet string
  2178.          tn3270eResMapElementName,    -- IDs LU or printer association
  2179.          tn3270eResMapElementType     -- type of resource
  2180.       }
  2181.       STATUS  current
  2182.       DESCRIPTION
  2183.         "This notification is generated when response time data
  2184.         collection is enabled for a member of a client group.  In order
  2185.         for this notification to occur the corresponding
  2186.         tn3270eRtCollCtlType must have traps(5) selected.  The objects
  2187.         tn3270eResMapElementName and tn3270eResMapElementType contains
  2188.         valid values only if tn3270eRtDataClientAddress contains a
  2189.         valid IP address (rather than the null octet string)."
  2190.       ::= { tn3270eRtNotifications 3 }
  2191.  
  2192.   tn3270eRtCollEnd   NOTIFICATION-TYPE
  2193.       OBJECTS {
  2194.          tn3270eSrvrConfIndex,            -- server's local index
  2195.          tn3270eRtCollCtlClientGroupName, -- data collection target
  2196.          tn3270eRtDataClientAddrType,
  2197.          tn3270eRtDataClientAddress,
  2198.          tn3270eRtDataDiscontinuityTime,
  2199.          tn3270eRtDataAvgRt,
  2200.          tn3270eRtDataAvgIpRt,
  2201.          tn3270eRtDataAvgTransCount,
  2202.          tn3270eRtDataIntTimeStamp,
  2203.          tn3270eRtDataTotalRt,
  2204.          tn3270eRtDataTotalIpRt,
  2205.          tn3270eRtDataTransCount,
  2206.          tn3270eRtDataDrCount,
  2207.          tn3270eRtDataElapsRndTrpSq,
  2208.          tn3270eRtDataElapsIpRtSq,
  2209.          tn3270eRtDataBucket1,
  2210.          tn3270eRtDataBucket2,
  2211.          tn3270eRtDataBucket3,
  2212.  
  2213.  
  2214.  
  2215. Expires March 1998                                             [Page 37]~
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  2222.  
  2223.  
  2224.          tn3270eRtDataBucket4,
  2225.          tn3270eRtDataBucket5
  2226.       }
  2227.       STATUS  current
  2228.       DESCRIPTION
  2229.         "This notification is generated when a tn3270eRtDataEntry is
  2230.         deleted after being active (actual data collected), in order to
  2231.         enable a management application monitoring a tn3270eRtDataTable
  2232.         entry to end get the entry's final values.  Note that the
  2233.         corresponding tn3270eCollCtlType must have traps(5) set for this
  2234.         notification to be generated."
  2235.       ::= { tn3270eRtNotifications 4 }
  2236.  
  2237.   -- Conformance Statement
  2238.  
  2239.   tn3270eRtGroups       OBJECT IDENTIFIER ::= { tn3270eRtConformance 1 }
  2240.   tn3270eRtCompliances  OBJECT IDENTIFIER ::= { tn3270eRtConformance 2 }
  2241.  
  2242.   -- Compliance statements
  2243.  
  2244.   tn3270eRtCompliance     MODULE-COMPLIANCE
  2245.       STATUS current
  2246.       DESCRIPTION
  2247.         "The compliance statement for agents that support the
  2248.          TN327E-RT-MIB "
  2249.       MODULE   -- this module
  2250.          MANDATORY-GROUPS { tn3270eRtGroup, tn3270eRtNotGroup }
  2251.       OBJECT tn3270eRtCollCtlSPeriod
  2252.          MIN-ACCESS  read-only
  2253.          DESCRIPTION
  2254.             "The agent is not required to allow the user to change
  2255.              the default value of this object and is allowed
  2256.              to use a different default."
  2257.       ::= {tn3270eRtCompliances 1 }
  2258.  
  2259.   -- Group definitions
  2260.  
  2261.   tn3270eRtGroup         OBJECT-GROUP
  2262.       OBJECTS {
  2263.           tn3270eRtCollCtlType,
  2264.           tn3270eRtCollCtlSPeriod,
  2265.           tn3270eRtCollCtlSPMult,
  2266.           tn3270eRtCollCtlThreshHigh,
  2267.           tn3270eRtCollCtlThreshLow,
  2268.           tn3270eRtCollCtlIdleRate,
  2269.           tn3270eRtCollCtlBucketBndry1,
  2270.           tn3270eRtCollCtlBucketBndry2,
  2271.           tn3270eRtCollCtlBucketBndry3,
  2272.  
  2273.  
  2274.  
  2275. Expires March 1998                                             [Page 38]~
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  2282.  
  2283.  
  2284.           tn3270eRtCollCtlBucketBndry4,
  2285.           tn3270eRtCollCtlRowStatus,
  2286.           tn3270eRtDataDiscontinuityTime,
  2287.           tn3270eRtDataAvgRt,
  2288.           tn3270eRtDataAvgIpRt,
  2289.           tn3270eRtDataAvgTransCount,
  2290.           tn3270eRtDataIntTimeStamp,
  2291.           tn3270eRtDataTotalRt,
  2292.           tn3270eRtDataTotalIpRt,
  2293.           tn3270eRtDataTransCount,
  2294.           tn3270eRtDataDrCount,
  2295.           tn3270eRtDataElapsRndTrpSq,
  2296.           tn3270eRtDataElapsIpRtSq,
  2297.           tn3270eRtDataBucket1,
  2298.           tn3270eRtDataBucket2,
  2299.           tn3270eRtDataBucket3,
  2300.           tn3270eRtDataBucket4,
  2301.           tn3270eRtDataBucket5 }
  2302.       STATUS  current
  2303.       DESCRIPTION
  2304.         "This group is mandatory for all host supporting the
  2305.          TN3270E-RT-MIB. "
  2306.       ::= { tn3270eRtGroups 1 }
  2307.  
  2308.   tn3270eRtNotGroup         NOTIFICATION-GROUP
  2309.       NOTIFICATIONS {
  2310.           tn3270eRtExceeded,
  2311.           tn3270eRtOkay,
  2312.           tn3270eRtCollStart,
  2313.           tn3270eRtCollEnd
  2314.        }
  2315.       STATUS  current
  2316.       DESCRIPTION
  2317.         "The notifications which must be supported when the
  2318.          TN3270E-RT-MIB is implemented. "
  2319.       ::= { tn3270eRtGroups 2 }
  2320.  
  2321.   END
  2322.  
  2323.  
  2324. 6.  Security Considerations
  2325.  
  2326.   Certain management information defined in this MIB may be considered
  2327.   sensitive in some network environments.  Therefore, authentication of
  2328.   received SNMP requests and controlled access to management information
  2329.   should be employed in such environments.  The method for this
  2330.   authentication is a function of the SNMP Administrative Framework, and
  2331.   has not been expanded by this MIB.
  2332.  
  2333.  
  2334.  
  2335. Expires March 1998                                             [Page 39]~
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  2342.  
  2343.  
  2344.   Several objects in this MIB allow write access or provide for remote
  2345.   creation. Allowing this support in a non-secure environment can have a
  2346.   negative effect on network operations.  It is recommended that
  2347.   implementers seriously consider whether set operations should be
  2348.   allowed without providing, at a minimum, authentication of request
  2349.   origin. It it recommended that without such support that the following
  2350.   objects be implemented as read-only:
  2351.  
  2352.       o tn3270eRtCollCtlType
  2353.       o tn3270eRtCollSPeriod
  2354.       o tn3270eRtCollSPMult
  2355.       o tn3270eRtCollCtlThreshHigh
  2356.       o tn3270eRtCollCtlThreshLow
  2357.       o tn3270eRtCollCtlIdleRate
  2358.       o tn3270eRtCollCtlBucketBndry1
  2359.       o tn3270eRtCollCtlBucketBndry2
  2360.       o tn3270eRtCollCtlBucketBndry3
  2361.       o tn3270eRtCollCtlBucketBndry4
  2362.  
  2363.   The following object should either be implemented as read-only or not
  2364.   implemented when security is an issue as previously discussed:
  2365.  
  2366.       o tn3270eRtCollCtlRowStatus
  2367.  
  2368.   The administrative method to use to create and manage the
  2369.   tn3270eRtCollCtlTable when SET support is not allowed is outside of
  2370.   the scope of this memo.
  2371.  
  2372.  
  2373. 7.  Acknowledgments
  2374.  
  2375.   This document is a product of the TN3270E Working Group. Special
  2376.   thanks is due to Derek Bolton and Michael Boe of Cisco Systems for
  2377.   their numerous comments and suggestions for improving the structure of
  2378.   this MIB.
  2379.  
  2380.  
  2381. 8.  References
  2382.  
  2383.  
  2384. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  2385.      Waldbusser S., "Structure of Management Information for version 2
  2386.      of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  2387.      January 1996.
  2388.  
  2389.  
  2390. [2]  Network Working Group, Postel, J., and Reynolds, J., "Telnet
  2391.      Protocol Specification", RFC 854, May 1983.
  2392.  
  2393.  
  2394.  
  2395. Expires March 1998                                             [Page 40]~
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  2402.  
  2403.  
  2404. [3]  Network Working Group, Postel, J., and Reynolds, J., "Telnet Timing
  2405.      Mark Option", RFC 860, May 1983.
  2406.  
  2407.  
  2408. [4]  Network Working Group and Rekhter J., "Telnet 3270 Regime Option",
  2409.      RFC 1041, January 1988.
  2410.  
  2411.  
  2412. [5]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  2413.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  2414.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  2415.      March 1991.
  2416.  
  2417.  
  2418. [6]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  2419.      Waldbusser, "Textual Conventions for version 2 of the Simple
  2420.      Network Management Protocol (SNMPv2)", RFC 1903, January 1996.
  2421.  
  2422.  
  2423. [7]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  2424.      Waldbusser, "Protocol Operations for version 2 of the Simple
  2425.      Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  2426.  
  2427.  
  2428. [8]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  2429.      Waldbusser, "Conformance Statements for version 2 of the Simple
  2430.      Network Management Protocol (SNMPv2)", RFC 1904, January 1996.
  2431.  
  2432.  
  2433. [9]  Case, J., M. Fedor, M. Schoffstall, J. Davin, "Simple Network
  2434.      Management Protocol", RFC 1157, SNMP Research, Performance Systems
  2435.      International, MIT Laboratory for Computer Science, May 1990.
  2436.  
  2437.  
  2438. [10] IETF TN3270E Working Group and White, K., "Base Definitions of
  2439.      Managed Objects for TN3270E Using SMIv2", Internet-Draft Work in
  2440.      progress, June 1997.
  2441.  
  2442.  
  2443. [11] Network Working Group, and Kelly, B., "TN3270 Enhancements", RFC
  2444.      1647, July 1994.
  2445.  
  2446.  
  2447. [12] IBM, International Technical Support Centers, "Response Time Data
  2448.      Gathering", GG24-3212-01, November 1990.
  2449.  
  2450.  
  2451. [13] Krupczak, Cheryl, Saperia, Jonathan, "Definitions of System-Level
  2452.  
  2453.  
  2454.  
  2455. Expires March 1998                                             [Page 41]~
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461. White, Moore      TN3270E Response Time Collection MIB 29 September 1997
  2462.  
  2463.  
  2464.      Managed Objects for Applications", April 15, 1997.
  2465.  
  2466.  
  2467. 9.  Authors' Addresses
  2468.  
  2469.   Kenneth D. White
  2470.   Dept. BRQA/Bldg. 503/C117
  2471.   IBM Corporation
  2472.   P.O.Box 12195
  2473.   3039 Cornwallis
  2474.   Research Triangle Park, NC 27709, USA
  2475.   Phone: +1-919-254-0102
  2476.   E-mail: kennethw@vnet.ibm.com
  2477.  
  2478.   Robert Moore
  2479.   Dept. BRQA/Bldg. 501/G114
  2480.   IBM Corporation
  2481.   P.O.Box 12195
  2482.   3039 Cornwallis
  2483.   Research Triangle Park, NC 27709, USA
  2484.   Phone: +1-919-254-7507
  2485.   E-mail: remoore@us.ibm.com
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515. Expires March 1998                                             [Page 42]~
  2516.  
  2517.