home *** CD-ROM | disk | FTP | other *** search
/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / RFCs / rfc2561.txt < prev    next >
Encoding:
Text File  |  1999-10-14  |  114.1 KB  |  3,140 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                           K. White
  8. Request for Comments: 2561                                     IBM Corp.
  9. Category: Standards Track                                       R. Moore
  10.                                                                IBM Corp.
  11.                                                               April 1999
  12.  
  13.  
  14.                 Base Definitions of Managed Objects for
  15.                           TN3270E Using SMIv2
  16.  
  17. Status of this Memo
  18.  
  19.    This document specifies an Internet standards track protocol for the
  20.    Internet community, and requests discussion and suggestions for
  21.    improvements.  Please refer to the current edition of the "Internet
  22.    Official Protocol Standards" (STD 1) for the standardization state
  23.    and status of this protocol.  Distribution of this memo is unlimited.
  24.  
  25. Copyright Notice
  26.  
  27.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  28.  
  29. Abstract
  30.  
  31.    This memo defines a Management Information Base (MIB) for configuring
  32.    and managing TN3270E servers.  TN3270E, defined by RFC 2355 [19],
  33.    refers to the enhancements made to the Telnet 3270 (TN3270) terminal
  34.    emulation practices.  Refer to RFC 1041 [18], STD 8, RFC 854 [16],
  35.    and STD 31, RFC 860 [17] for a sample of what is meant by TN3270
  36.    practices.
  37.  
  38.    The MIB defined by this memo provides generic support for both host
  39.    and gateway TN3270E server implementations.  A TN3270E server
  40.    connects a Telnet client performing 3270 emulation to a target SNA
  41.    host over both a client-side network (client to TN3270E server) and
  42.    an SNA Network (TN3270E server to target SNA host).  The client-side
  43.    network is typically TCP/IP, but it need not be.
  44.  
  45.    A host TN3270E server refers to an implementation where the TN3270E
  46.    server is collocated with the Systems Network Architecture (SNA)
  47.    System Services Control Point (SSCP) for the dependent Secondary
  48.    Logical Units (SLUs) that the server makes available to its clients
  49.    for connecting into a SNA network.  A gateway TN3270E server resides
  50.    on an SNA node other than an SSCP, either an SNA type 2.0 node, a
  51.    boundary-function-attached type 2.1 node, or an APPN node acting in
  52.    the role of a Dependent LU Requester (DLUR).  Host and gateway
  53.    TN3270E server implementations typically differ greatly as to their
  54.    internal implementation and system definition (SYSDEF) methods.
  55.  
  56.  
  57.  
  58. White & Moore               Standards Track                     [Page 1]
  59.  
  60. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  61.  
  62.  
  63.    It is the intent that the MIB defined herein be extended by
  64.    subsequent memos.  For example, one such extension enables collection
  65.    of TN3270E response time data.
  66.  
  67. Table of Contents
  68.  
  69.    1.0  Introduction  . . . . . . . . . . . . . . . . . . . . . . .   2
  70.    2.0  The SNMP Network Management Framework   . . . . . . . . . .   3
  71.    3.0  Structure of the MIB  . . . . . . . . . . . . . . . . . . .   4
  72.    3.1  TN3270E Server Control  . . . . . . . . . . . . . . . . . .   5
  73.      3.1.1  tn3270eSrvrConfTable  . . . . . . . . . . . . . . . . .   5
  74.      3.1.2  tn3270eSrvrPortTable  . . . . . . . . . . . . . . . . .   6
  75.      3.1.3  tn3270eSrvrStatsTable   . . . . . . . . . . . . . . . .   7
  76.    3.2  TN3270E Server Resource Configuration   . . . . . . . . . .   7
  77.    3.3  Resource Name / Client Address Mappings   . . . . . . . . .   8
  78.      3.3.1  tn3270eSnaMapTable  . . . . . . . . . . . . . . . . . .   8
  79.      3.3.2  tn3270eResMapTable  . . . . . . . . . . . . . . . . . .   9
  80.      3.3.3  tn3270eTcpConnTable   . . . . . . . . . . . . . . . . .   9
  81.    3.4  Advisory Spin Lock Usage  . . . . . . . . . . . . . . . . .   9
  82.    3.5  Row Persistence   . . . . . . . . . . . . . . . . . . . . .  10
  83.    3.6  IANA Considerations   . . . . . . . . . . . . . . . . . . .  10
  84.    4.0  Definitions   . . . . . . . . . . . . . . . . . . . . . . .  11
  85.    5.0  Security Considerations   . . . . . . . . . . . . . . . . .  51
  86.    6.0  Intellectual Property   . . . . . . . . . . . . . . . . . .  52
  87.    7.0  Acknowledgments   . . . . . . . . . . . . . . . . . . . . .  53
  88.    8.0  References  . . . . . . . . . . . . . . . . . . . . . . . .  53
  89.    9.0  Authors' Addresses  . . . . . . . . . . . . . . . . . . . .  55
  90.    Full Copyright Statement   . . . . . . . . . . . . . . . . . . .  56
  91.  
  92. 1.0  Introduction
  93.  
  94.    This document is a product of the TN3270E Working Group.  Its purpose
  95.    is to define a MIB module for support by a TCP/IP implementation for
  96.    configuration and management of TN3270E servers.
  97.  
  98.    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  99.    "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this
  100.    document are to be interpreted as described in RFC 2119, reference
  101.    [22].
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. White & Moore               Standards Track                     [Page 2]
  115.  
  116. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  117.  
  118.  
  119. 2.0  The SNMP Network Management Framework
  120.  
  121.    The SNMP Management Framework presently consists of five major
  122.    components:
  123.  
  124.    o   An overall architecture, described in RFC 2271 [1].
  125.  
  126.    o   Mechanisms for describing and naming objects and events for the
  127.        purpose of management.  The first version of this Structure of
  128.        Management Information (SMI) is called SMIv1 and described in STD
  129.        16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4].  The
  130.        second version, called SMIv2, is described in RFC 1902 [5], RFC
  131.        1903 [6] and RFC 1904 [7].
  132.  
  133.    o   Message protocols for transferring management information.  The
  134.        first version of the SNMP message protocol is called SNMPv1 and
  135.        described in STD 15, RFC 1157 [8].  A second version of the SNMP
  136.        message protocol, which is not an Internet standards track
  137.        protocol, is called SNMPv2c and described in RFC 1901 [9] and RFC
  138.        1906 [10].  The third version of the message protocol is called
  139.        SNMPv3 and described in RFC 1906 [10], RFC 2272 [11] and RFC 2274
  140.        [12].
  141.  
  142.    o   Protocol operations for accessing management information.  The
  143.        first set of protocol operations and associated PDU formats is
  144.        described in STD 15, RFC 1157 [8].  A second set of protocol
  145.        operations and associated PDU formats is described in RFC 1905
  146.        [13].
  147.  
  148.    o   A set of fundamental applications described in RFC 2273 [14] and
  149.        the view-based access control mechanism described in RFC 2275
  150.        [15].
  151.  
  152.    Managed objects are accessed via a virtual information store, termed
  153.    the Management Information Base or MIB.  Objects in the MIB are
  154.    defined using the mechanisms defined in the SMI.
  155.  
  156.    This memo specifies a MIB module that is compliant to the SMIv2.  A
  157.    MIB conforming to the SMIv1 can be produced through the appropriate
  158.    translations.  The resulting translated MIB must be semantically
  159.    equivalent, except where objects or events are omitted because no
  160.    translation is possible (use of Counter64).  Some machine readable
  161.    information in SMIv2 will be converted into textual descriptions in
  162.    SMIv1 during the translation process.  However, this loss of machine
  163.    readable information is not considered to change the semantics of the
  164.    MIB.
  165.  
  166.  
  167.  
  168.  
  169.  
  170. White & Moore               Standards Track                     [Page 3]
  171.  
  172. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  173.  
  174.  
  175. 3.0  Structure of the MIB
  176.  
  177.    The TN3270E-MIB is split into the following components:
  178.  
  179.    o   TN3270E Server Control
  180.    o   TN3270E Server Resource Configuration
  181.    o   Resource/Client Address Mappings
  182.  
  183.    There are three additional sections to address:
  184.  
  185.    o   Advisory Spin Lock Usage
  186.    o   Row Persistence
  187.    o   IANA Considerations
  188.  
  189.    The TN3270E-MIB is defined primarily for TN3270E servers.  This memo
  190.    does not explicitly address use of the MIB by TN3270 servers that do
  191.    not support the TN3270E protocol.  Even though a significant number
  192.    of the objects in the MIB do apply in the TN3270-only case, the case
  193.    was not addressed, since it is unlikely that a TN3270-only server
  194.    would implement this MIB.
  195.  
  196.    The SYSAPPL-MIB, reference [24], contains the Utf8String textual
  197.    convention (TC) that the TN3270E-MIB imports.  This TC, which is used
  198.    for some MIB objects containing textual information, enables
  199.    internationalization of text strings, whereas the DisplayString TC
  200.    does not.  The SNMP-FRAMEWORK-MIB, reference [1], contains the
  201.    SnmpAdminString TC that the TN3270E-MIB also imports.  Like the
  202.    Utf8String TC, this TC also enables internationalization of text
  203.    strings; in addition, it provides some guidelines on the length and
  204.    content of the strings.
  205.  
  206.    It is important to note that implementation of the SYSAPPL-MIB is not
  207.    actually a prerequisite for implementing the TN3270E-MIB.  On the
  208.    other hand, implementation of the TN3270E-MIB does not preclude
  209.    implementing the SYSAPPL-MIB as well.  When both MIBs are
  210.    implemented, the primary index into most of the TN3270E-MIB tables,
  211.    tn3270eSrvrConfIndex, SHOULD equal one of the SYSAPPL-MIB's
  212.    sysApplElmtRunIndex values.  In this case the entry in the
  213.    sysApplElmtRunTable provides additional information on a TN3270E
  214.    server.
  215.  
  216.    The MIB defined by this memo supports use of both IPv4 and IPv6
  217.    addressing.  Two textual conventions, IANATn3270eAddrType and
  218.    Tn3270eAddress, are defined for this purpose.  IANATn3270eAddress is
  219.    essentially equivalent to the TAddress TC, defined by RFC 1903.  The
  220.    difference between the two is that IANATn3270eAddress allows a zero-
  221.    length octet string, while TAddress doesn't.  It is important that
  222.    IANATn3270eAddress allow for the absence of an address, because some
  223.  
  224.  
  225.  
  226. White & Moore               Standards Track                     [Page 4]
  227.  
  228. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  229.  
  230.  
  231.    objects with this syntax are used as table indexes, and have special
  232.    meanings when they contain zero-length strings.
  233.  
  234.    The IANATn3270eAddrType textual convention is used rather than the
  235.    TDomain TC (defined by RFC 1903) for identifying the contents of a
  236.    tn3270eTAddress object.  TDomain uses an OID to characterize the
  237.    contents of an associated TAddress object.  IANATn3270eAddrType was
  238.    chosen over TDomain because, with a SYNTAX of Unsigned32 (enumeration
  239.    type), it is much simpler to use as a component in an instance
  240.    identifier.  It was placed in the IANA-administered module to allow
  241.    for the addition of values to cover cases (such as proxy servers) not
  242.    covered by the TN3270E-MIB itself.
  243.  
  244. 3.1  TN3270E Server Control
  245.  
  246.    This group of objects provides for TN3270E server configuration and
  247.    control.  It consists of three tables:
  248.  
  249.    o   tn3270eSrvrConfTable
  250.    o   tn3270eSrvrPortTable
  251.    o   tn3270eSrvrStatsTable
  252.  
  253.    The tn3270eSrvrConfTable is the primary table within the entire
  254.    TN3270E-MIB.  As section 3.1.1 indicates, each TN3270E server is
  255.    represented by an entry in this table, indexed by
  256.    tn3270eSrvrConfIndex.  Most of the other tables defined by the
  257.    TN3270E-MIB have tn3270eSrvrConfIndex as their primary index.
  258.    Entries in these tables MUST NOT exist for a TN3270E server when it
  259.    does not have a tn3270eSrvrConfigEntry.
  260.  
  261. 3.1.1  tn3270eSrvrConfTable
  262.  
  263.    The tn3270eSrvrConfTable contains a set of objects primarily used for
  264.    configuring and managing TN3270E servers.  As with most of the other
  265.    tables in the TN3270E-MIB, this table is indexed by an unsigned
  266.    integer, tn3270eSrvrConfIndex.  This primary index element enables
  267.    support of multiple TN3270E servers by a single SNMP agent.  Within
  268.    the set of MIB objects returned by one SNMP agent,
  269.    tn3270eSrvrConfIndex values MUST be unique, and need not be
  270.    contiguous.
  271.  
  272.    The tn3270eSrvrConfInactivityTimer object defines the inactivity
  273.    period for user traffic on TN3270 and TN3270E sessions.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. White & Moore               Standards Track                     [Page 5]
  283.  
  284. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  285.  
  286.  
  287.    The four objects:
  288.  
  289.    o   tn3270eSrvrConfConnectivityChk
  290.    o   tn3270eSrvrConfTmNopInterval
  291.    o   tn3270eSrvrConfTmNopInactTime
  292.    o   tn3270eSrvrConfTmTimeout
  293.  
  294.    define the parameters for performing the "Telnet Timing Mark Option"
  295.    as defined by RFC 860 [17].  The object
  296.    tn3270eSrvrConfConnectivityChk allows a Management Station to select
  297.    either a NOP command or a TIMING-MARK command.  Sending a NOP command
  298.    results in less overhead then a TIMING-MARK command, since a client
  299.    doesn't send a reply.
  300.  
  301.    The objects tn3270eSrvrConfAdminStatus and tn3270eSrvrConfOperStatus
  302.    enable remote starting and stopping of a TN3270E server, and report
  303.    the current state of the server.  The object
  304.    tn3270eSrvrConfFunctionsSupported indicates which of the TN3270 and
  305.    TN3270E options a server supports.  The object
  306.    tn3270eSrvrConfSessionTermState defines as a TN3270E server-wide
  307.    option what SHOULD occur when the SNA portion of a TN3270 or TN3270E
  308.    session terminates with respect to the associated TCP connection.
  309.    The object tn3270eSrvrConfSrvrType indicates whether the TN3270E
  310.    server represented by a tn3270eSrvrConfEntry is a host or a gateway
  311.    server.  The object tn3270eSrvrConfContact provides a scratch pad
  312.    area for a TN3270E server administrator to store information for
  313.    later retrieval.  The object tn3270eSrvrConfLastActTime reports the
  314.    DateAndTime when the server was most recently activated.  The special
  315.    value of all '00'Hs indicates that the server has never been active.
  316.  
  317.    The object tn3270eSrvrConfRowStatus provides the capability to
  318.    perform row creation and deletion operations on this table.
  319.  
  320. 3.1.2  tn3270eSrvrPortTable
  321.  
  322.    The tn3270eSrvrPortTable represents the local TCP ports associated
  323.    with a TN3270E server.  This information is important because some
  324.    TN3270E server implementations support usage of multiple local ports.
  325.    A tn3270eSrvrPortEntry is indexed by:
  326.  
  327.    o   tn3270eSrvrConfIndex
  328.    o   tn3270eSrvrConfPort
  329.    o   tn3270eSrvrConfPortAddrType
  330.    o   tn3270eSrvrConfPortAddress
  331.  
  332.    Certain TN3270E server implementations restrict a local TCP port to a
  333.    particular local IP address, instead of allowing connections for any
  334.    local IP address to occur via the port.  tn3270eSrvrConfPortAddrType
  335.  
  336.  
  337.  
  338. White & Moore               Standards Track                     [Page 6]
  339.  
  340. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  341.  
  342.  
  343.    and tn3270eSrvrConfPortAddress allow this restriction to be
  344.    represented in the MIB.  A TN3270E server that doesn't restrict
  345.    connections over a port to a local IP Address SHALL use the value
  346.    unknown(0) for tn3270eSrvrConfPortAddrType, and a zero-length octet
  347.    string for tn3270eSrvrConfPortAddress.
  348.  
  349. 3.1.3  tn3270eSrvrStatsTable
  350.  
  351.    The tn3270eSrvrStatsTable defines a series of objects that provide
  352.    general usage statistics for a TN3270E server.  An entry can
  353.    represent the total activity for a server, or it can represent the
  354.    activity occurring at the server on either a port or a port-and-
  355.    local-address basis.
  356.  
  357.    An implementation of this table MUST use only one of the three levels
  358.    of refinement that the indexing of this table supports for the
  359.    entries associated with a single TN3270E server.
  360.  
  361.    The objects in this table reporting maximum, in-use, and spare LUs
  362.    for terminals and printers presuppose an implementation where
  363.    terminal resources and printer resources come from disjoint,
  364.    dedicated pools.  An implementation where resources for the two types
  365.    of LUs come from a single shared pool should return the following
  366.    values:
  367.  
  368.    o   maximum:  maximum size of the shared pool
  369.    o   in-use:   number currently in use as this type of LU
  370.    o   spare:    maximum - (terminal in-use + printer in-use)
  371.  
  372. 3.2  TN3270E Server Resource Configuration
  373.  
  374.    The following three tables provide for configuration of resources at
  375.    a TN3270E server:
  376.  
  377.    o   tn3270eClientGroupTable
  378.    o   tn3270eResPoolTable
  379.    o   tn3270eClientResMapTable
  380.  
  381.    tn3270eClientGroupTable and tn3270eResPoolTable enable
  382.    implementations to define groupings of both client addresses and
  383.    resource pools for mapping client addresses to resources.  The
  384.    tn3270eClientResMapTable provides a mapping from a client group to a
  385.    resource pool.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394. White & Moore               Standards Track                     [Page 7]
  395.  
  396. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  397.  
  398.  
  399. 3.3  Resource Name / Client Address Mappings
  400.  
  401.    The TN3270E-MIB contains three tables for mapping resource names to
  402.    client addresses, and client addresses to resource names:
  403.  
  404.    o   tn3270eSnaMapTable
  405.    o   tn3270eResMapTable
  406.    o   tn3270eTcpConnTable
  407.  
  408. 3.3.1  tn3270eSnaMapTable
  409.  
  410.    The tn3270eSnaMapTable is a read-only table that maps a secondary
  411.    LU's SNA network name to the name by which it is known locally at the
  412.    TN3270E server.  For correlation with data from the SNA network, the
  413.    name of the associated primary LU also appears in a
  414.    tn3270eSnaMapEntry.  An entry in this table is created when the
  415.    Activate LU (ACTLU) request carrying the SNA network name of the SLU
  416.    is received from the SSCP.  The entry is deleted when the SLU is
  417.    deactivated.
  418.  
  419.    A TN3270E server provides a client with access to an SNA application
  420.    by associating a TCP connection from the client with an SNA secondary
  421.    LU (SLU) at the server.  This SLU in turn has an SNA session with a
  422.    primary LU (PLU) running on an SNA host.  This PLU represents the
  423.    application with which the client is communicating.  The TN3270E-MIB
  424.    includes two tables for mapping back and forth among the SNA name
  425.    identifying the PLU, the SNA name identifying the SLU, and the TCP
  426.    connection with the client.
  427.  
  428.    In order to understand how these name mappings work, it is necessary
  429.    to understand a subtlety involving the names of the SLUs at the
  430.    TN3270E server:  these names are often different from the names by
  431.    which the SLUs are known in the rest of the SNA network.  In the
  432.    TN3270E-MIB, these two types of SLU names are termed "local names"
  433.    and "SSCP-supplied names"; the latter term indicates that the name by
  434.    which the SLU is known in the SNA network comes to the TN3270E server
  435.    from the SNA System Services Control Point.
  436.  
  437.    SSCPs don't always send SLU names down to secondary LUs; in some
  438.    cases this capability must be turned on.  In the case of SLUs served
  439.    by a Dependent LU Requester (DLUR), an SSCP always sends SLU names to
  440.    the DLUR.  It is necessary, however, to enable the DLUR's PU/LU
  441.    Network Name Forwarding function, so that it forwards the SLU names
  442.    it receives from the SSCP down to the PUs that it serves.
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. White & Moore               Standards Track                     [Page 8]
  451.  
  452. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  453.  
  454.  
  455.    For SLUs associated with an SNA type 2.0 node (or with a boundary-
  456.    function-attached type 2.1 node) not served by a DLUR, inclusion of
  457.    SLU names on ACTLU must be enabled explicitly at the SSCP via local
  458.    configuration.
  459.  
  460. 3.3.2  tn3270eResMapTable
  461.  
  462.    The tn3270eResMapTable is a read-only table that maps a resource name
  463.    to a client's address.  An entry in this table is created when a TCP
  464.    connection is received by a TN3270E server and mapped to a resource.
  465.    The entry is deleted when the resource-to-address association is no
  466.    longer valid.
  467.  
  468. 3.3.3  tn3270eTcpConnTable
  469.  
  470.    The TCP Connection Table is currently defined by RFC 2012 (Refer to
  471.    reference [20], TCP-MIB Definitions).  It contains the following
  472.    objects:
  473.  
  474.    o   tcpConnState (INTEGER)
  475.    o   tcpConnLocalAddress (IpAddress)
  476.    o   tcpConnLocalPort (INTEGER)
  477.    o   tcpConnRemAddress (IpAddress)
  478.    o   tcpConnRemPort (INTEGER)
  479.  
  480.    It is indexed by: tcpConnLocalAddress, tcpConnLocalPort,
  481.    tcpConnRemAddress, and tcpConnRemPort.
  482.  
  483.    The tn3270eTcpConnTable contains objects for keeping a list of the
  484.    current set of TN3270 and TN3270E sessions at a TN3270E server.  The
  485.    relationship between the tcpConnTable and the Tn3270eTcpConnTable is
  486.    not one-to-one, since the tn3270eTcpConnTable contains information
  487.    pertaining only to TN3270(E) sessions.
  488.  
  489.    The tn3270eTcpConnTable has a different indexing structure from that
  490.    of the tcpConnTable.  Instead of using IpAddress objects,
  491.    Tn3270eAddress and IANATn3270eAddrType object pairs are used to
  492.    specify client addresses (both local and remote).  This enables
  493.    support of IPv6 addresses.  In addition, the remote address pair
  494.    precedes the local address pair in the index clause, in order to
  495.    enable a GET-NEXT operation using only the remote address pair.
  496.  
  497. 3.4  Advisory Spin Lock Usage
  498.  
  499.    Within the TN3270E-MIB, tn3270eConfSpinLock is defined as an advisory
  500.    lock that allows cooperating TN3270E-MIB applications to coordinate
  501.    their use of the tn3270eSrvrConfTable, the tn3270eSrvrPortTable, the
  502.    tn3270eClientGroupTable, the tn3270eResPoolTable, and the
  503.  
  504.  
  505.  
  506. White & Moore               Standards Track                     [Page 9]
  507.  
  508. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  509.  
  510.  
  511.    tn3270eClientResMapTable.  When creating a new entry or altering an
  512.    existing entry in any of these tables, an application SHOULD make use
  513.    of tn3270eConfSpinLock to serialize application changes or additions.
  514.    Since this is an advisory lock, its use by management applications
  515.    SHALL NOT be enforced by agents.  Agents MUST, however, implement the
  516.    tn3270eConfSpinLock object.
  517.  
  518. 3.5  Row Persistence
  519.  
  520.    The following tables enable remote creation of their entries by
  521.    including RowStatus objects:
  522.  
  523.    o   tn3270eSrvrConfTable
  524.    o   tn3270eSrvrPortTable
  525.    o   tn3270eClientGroupTable
  526.    o   tn3270eResPoolTable
  527.    o   tn3270eClientResMapTable
  528.  
  529.    An implementation SHOULD NOT retain SNMP-created entries in these
  530.    tables across reIPLs (Initial Program Loads) of the corresponding
  531.    TN3270E server, since management applications need to see consistent
  532.    behavior with respect to the persistence of the table entries that
  533.    they create.
  534.  
  535.    It is expected that local, implementation-dependent configuration
  536.    information will be used to define the initial and persistent
  537.    configurations for TN3270E server usage.  Thus it is not necessary to
  538.    enable persistence of table entries by adding StorageType (refer to
  539.    RFC 1903 [6]) objects to these tables.
  540.  
  541. 3.6  IANA Considerations
  542.  
  543.    The tn3270eSrvrFunctionsSupported, tn3270eTcpConnFunctions,
  544.    tn3270eTcpConnClientIdFormat, and tn3270eTcpConnLogInfo objects, as
  545.    well as a number of objects identifying various address types,
  546.    resource types, and device types, use textual conventions imported
  547.    from the IANATn3270eTC-MIB.  The purpose of defining these textual
  548.    conventions in a separate MIB module is to allow additional values to
  549.    be defined without having to issue a new version of this document.
  550.    The Internet Assigned Numbers Authority (IANA) is responsible for the
  551.    assignment of all Internet numbers, including various SNMP-related
  552.    numbers; it will administer the values associated with these textual
  553.    conventions.
  554.  
  555.    The rules for additions or changes to the IANATn3270eTC-MIB are
  556.    outlined in the DESCRIPTION clause associated with its MODULE-
  557.    IDENTITY statement.
  558.  
  559.  
  560.  
  561.  
  562. White & Moore               Standards Track                    [Page 10]
  563.  
  564. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  565.  
  566.  
  567.    The current version of the IANATn3270eTC-MIB can be accessed from the
  568.    IANA home page at: "http://www.iana.org/".
  569.  
  570. 4.0  Definitions
  571.  
  572.   TN3270E-MIB DEFINITIONS ::= BEGIN
  573.  
  574.   IMPORTS
  575.       MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, TimeTicks,
  576.       IpAddress, Counter32, Gauge32, Counter64
  577.           FROM SNMPv2-SMI
  578.       TEXTUAL-CONVENTION, RowStatus, TestAndIncr, DateAndTime,
  579.       TimeStamp
  580.           FROM SNMPv2-TC
  581.       MODULE-COMPLIANCE, OBJECT-GROUP
  582.           FROM SNMPv2-CONF
  583.       snanauMIB
  584.           FROM SNA-NAU-MIB
  585.       Utf8String
  586.           FROM SYSAPPL-MIB
  587.       SnmpAdminString
  588.           FROM SNMP-FRAMEWORK-MIB
  589.       IANATn3270eAddrType, IANATn3270eAddress,
  590.       IANATn3270eClientType, IANATn3270Functions,
  591.       IANATn3270ResourceType, IANATn3270DeviceType,
  592.       IANATn3270eLogData
  593.           FROM IANATn3270eTC-MIB;
  594.  
  595.     tn3270eMIB MODULE-IDENTITY
  596.         LAST-UPDATED "9807270000Z" -- July 27, 1998
  597.         ORGANIZATION "TN3270E Working Group"
  598.         CONTACT-INFO
  599.             "Kenneth White (kennethw@vnet.ibm.com)
  600.              IBM Corp. - Dept. BRQA/Bldg. 501/G114
  601.              P.O. Box 12195
  602.              3039 Cornwallis
  603.              RTP, NC 27709-2195
  604.              USA
  605.  
  606.              Robert Moore (remoore@us.ibm.com)
  607.              IBM Corp. - Dept. BRQA/Bldg. 501/G114
  608.              P.O. Box 12195
  609.              3039 Cornwallis
  610.              RTP, NC 27709-2195
  611.              USA
  612.              +1-919-254-4436"
  613.         DESCRIPTION
  614.             "This module defines a portion of the management
  615.  
  616.  
  617.  
  618. White & Moore               Standards Track                    [Page 11]
  619.  
  620. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  621.  
  622.  
  623.             information base (MIB) for managing TN3270E servers."
  624.         REVISION  "9807270000Z" -- July 27, 1998
  625.         DESCRIPTION
  626.             "RFC nnnn (Proposed Standard)" -- RFC Editor to fill in
  627.         ::= { snanauMIB 8 }
  628.  
  629.   -- Textual Conventions
  630.  
  631.   SnaResourceName ::= TEXTUAL-CONVENTION
  632.       STATUS      current
  633.       DESCRIPTION
  634.           "The textual convention for defining an SNA resource
  635.            name. A fully qualified SNA resource name, consisting
  636.            of a 1 to 8 character network identifier (NetId), a
  637.            period ('.'), and a 1 to 8 character resource name
  638.            (ResName).
  639.  
  640.            The NetId and ResName are constructed from the
  641.            uppercase letters 'A' - 'Z' and the numerics '0' - '9',
  642.            all encoded in ASCII, with the restriction that the
  643.            first character of each must be a letter.  Blanks are
  644.            not allowed.
  645.  
  646.            Earlier versions of SNA permitted three additional
  647.            characters in NetIds and ResNames:  '#', '@', and '$'.
  648.            While this use of these characters has been retired,
  649.            a Management Station should still accept them for
  650.            backward compatibility.
  651.  
  652.            Note: This Textual Convention is not subject to
  653.            internationalization, and does not use the character
  654.            encodings used by the Utf8String Textual Convention."
  655.       SYNTAX     OCTET STRING (SIZE(0..17))
  656.  
  657.   Tn3270eTraceData ::= TEXTUAL-CONVENTION
  658.       STATUS      current
  659.       DESCRIPTION
  660.           "An octet string representing trace data from the
  661.           Telnet half of a TN3270E session, from the SNA half,
  662.           or from both.  The octet string contains a sequence
  663.           of trace elements, with the trace elements in the
  664.           string ordered from earliest to latest.
  665.  
  666.           Each trace element has the following form:
  667.  
  668.                   +---+---+----+----------------------+
  669.                   !length !type!data                  !
  670.                   +---+---+----+----------------------+
  671.  
  672.  
  673.  
  674. White & Moore               Standards Track                    [Page 12]
  675.  
  676. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  677.  
  678.  
  679.             where:
  680.  
  681.             length = two-octet length of the data portion of the
  682.                      trace element, not including the length and
  683.                      type octets
  684.  
  685.             type   = one-octet code point characterizing the data;
  686.                      defined values are:
  687.  
  688.                      X'01' telnet PDU from the server to the client
  689.                      X'02' telnet PDU from the client to the server
  690.                      X'03' SNA data from the server to the SNA host
  691.                      X'04' SNA data from the SNA host to the server
  692.  
  693.             data   = initial part of a PDU.
  694.  
  695.           It is implementation-dependent where the 'initial part of
  696.           a PDU' starts.  For SNA data, however, the starting point
  697.           SHOULD be the first byte of the TH.  For IP data the
  698.           starting point SHOULD be the first byte of the IP header.
  699.  
  700.           It is left to implementations to determine how much of
  701.           each PDU to return in a trace element.
  702.  
  703.           The zero-length string indicates that no trace
  704.           data is available."
  705.       SYNTAX OCTET STRING (SIZE (0 | 3..4096))
  706.  
  707.   -- Top-level structure of the MIB
  708.  
  709.   tn3270eNotifications  OBJECT IDENTIFIER ::= { tn3270eMIB 0 }
  710.   tn3270eObjects        OBJECT IDENTIFIER ::= { tn3270eMIB 1 }
  711.   tn3270eConformance    OBJECT IDENTIFIER ::= { tn3270eMIB 3 }
  712.  
  713.   -- MIB Objects
  714.  
  715.   tn3270eSrvrConfTable OBJECT-TYPE
  716.       SYNTAX      SEQUENCE OF Tn3270eSrvrConfEntry
  717.       MAX-ACCESS  not-accessible
  718.       STATUS      current
  719.       DESCRIPTION
  720.           "This table defines the configuration elements for
  721.           TN3270E servers.  The number of entries in this table
  722.           is expected to vary depending on the location of the
  723.           table.  A particular TN3270E server is expected to
  724.           have a single entry.  Modeling of the configuration
  725.           elements as a table allows multiple TN3270E
  726.           servers to be serviced by the same SNMP agent.
  727.  
  728.  
  729.  
  730. White & Moore               Standards Track                    [Page 13]
  731.  
  732. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  733.  
  734.  
  735.           An implementation SHOULD NOT retain an SNMP-created
  736.           entry in this table across re-IPLs (Initial Program
  737.           Loads) of the corresponding TN3270E server."
  738.  
  739.       ::= { tn3270eObjects 1 }
  740.  
  741.   tn3270eSrvrConfEntry OBJECT-TYPE
  742.       SYNTAX      Tn3270eSrvrConfEntry
  743.       MAX-ACCESS  not-accessible
  744.       STATUS      current
  745.       DESCRIPTION
  746.           "Definition of the configuration elements for a single
  747.           TN3270E server."
  748.       INDEX       { tn3270eSrvrConfIndex }
  749.       ::= { tn3270eSrvrConfTable 1 }
  750.  
  751.   Tn3270eSrvrConfEntry ::= SEQUENCE {
  752.       tn3270eSrvrConfIndex             Unsigned32,
  753.       tn3270eSrvrConfInactivityTimeout Unsigned32,
  754.       tn3270eSrvrConfConnectivityChk   INTEGER,
  755.       tn3270eSrvrConfTmNopInactTime    Unsigned32,
  756.       tn3270eSrvrConfTmNopInterval     Unsigned32,
  757.       tn3270eSrvrFunctionsSupported    IANATn3270Functions,
  758.       tn3270eSrvrConfAdminStatus       INTEGER,
  759.       tn3270eSrvrConfOperStatus        INTEGER,
  760.       tn3270eSrvrConfSessionTermState  INTEGER,
  761.       tn3270eSrvrConfSrvrType          INTEGER,
  762.       tn3270eSrvrConfContact           SnmpAdminString,
  763.       tn3270eSrvrConfRowStatus         RowStatus,
  764.       tn3270eSrvrConfLastActTime       DateAndTime,
  765.       tn3270eSrvrConfTmTimeout         Unsigned32
  766.     }
  767.  
  768.   tn3270eSrvrConfIndex  OBJECT-TYPE
  769.       SYNTAX      Unsigned32 (1..4294967295)
  770.       MAX-ACCESS  not-accessible
  771.       STATUS      current
  772.       DESCRIPTION
  773.          "Identifier for a single TN3270E server.
  774.  
  775.          tn3270eSrvrConfIndex values need not be
  776.          contiguous."
  777.       ::= { tn3270eSrvrConfEntry 1 }
  778.  
  779.   tn3270eSrvrConfInactivityTimeout OBJECT-TYPE
  780.       SYNTAX      Unsigned32 (0..99999999)
  781.       UNITS "seconds"
  782.       MAX-ACCESS  read-create
  783.  
  784.  
  785.  
  786. White & Moore               Standards Track                    [Page 14]
  787.  
  788. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  789.  
  790.  
  791.       STATUS      current
  792.       DESCRIPTION
  793.          "The inactivity time-out specified in seconds.  When a
  794.           connection has been inactive for the number of seconds
  795.           specified by this object it is closed.  Only user traffic
  796.           is considered when determining whether there has been
  797.           activity on a connection.
  798.  
  799.           The default value 0 means that no inactivity time-out is
  800.           in effect."
  801.       DEFVAL { 0 }
  802.       ::= { tn3270eSrvrConfEntry 2 }
  803.  
  804.   tn3270eSrvrConfConnectivityChk OBJECT-TYPE
  805.       SYNTAX      INTEGER {
  806.                             timingMark(1),
  807.                             nop(2),
  808.                             noCheck(3)
  809.                           }
  810.       MAX-ACCESS  read-create
  811.       STATUS      current
  812.       DESCRIPTION
  813.          "This object enables TIMING-MARK processing, NOP
  814.           processing, or neither for a TN3270E server."
  815.       DEFVAL { noCheck }
  816.       ::= { tn3270eSrvrConfEntry 3 }
  817.  
  818.   tn3270eSrvrConfTmNopInactTime OBJECT-TYPE
  819.       SYNTAX      Unsigned32 (1..86400) -- 1 second to 24 hours
  820.       UNITS "seconds"
  821.       MAX-ACCESS  read-create
  822.       STATUS      current
  823.       DESCRIPTION
  824.          "The amount of time a connection must have had no
  825.          traffic on it in order for a TIMING-MARK or NOP request
  826.          to be sent on the connection.  This value applies only
  827.          when connections are being examined for recent activity
  828.          on a scan interval controlled by the value of the
  829.          tn3270eSrvrConfTmNopInterval object."
  830.       DEFVAL { 600 }   -- 10 minutes
  831.       ::= { tn3270eSrvrConfEntry 4 }
  832.  
  833.   tn3270eSrvrConfTmNopInterval OBJECT-TYPE
  834.       SYNTAX      Unsigned32 (1..86400) -- 1 second to 24 hours
  835.       UNITS "seconds"
  836.       MAX-ACCESS  read-create
  837.       STATUS      current
  838.       DESCRIPTION
  839.  
  840.  
  841.  
  842. White & Moore               Standards Track                    [Page 15]
  843.  
  844. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  845.  
  846.  
  847.          "The scan interval to be used by a TN3270E server when
  848.          it examines its Telnet connections for recent activity.
  849.          The server scans its Telnet connections on the interval
  850.          provided by this object, looking for ones that have been
  851.          idle for more than the value provided by the
  852.          tn3270eSrvrConfTmNopInactTime object.  A TIMING-MARK or
  853.          NOP request is sent for each connection that has
  854.          exhibited no activity for this period of time."
  855.       DEFVAL { 120 }   -- 2 minutes
  856.       ::= { tn3270eSrvrConfEntry 5 }
  857.  
  858.   tn3270eSrvrFunctionsSupported OBJECT-TYPE
  859.       SYNTAX    IANATn3270Functions
  860.       MAX-ACCESS  read-only
  861.       STATUS      current
  862.       DESCRIPTION
  863.          "This object indicates the functions supported by a
  864.           TN3270E server."
  865.       DEFVAL { { scsCtlCodes, dataStreamCtl,
  866.                  responses, bindImage, sysreq } }
  867.       ::= { tn3270eSrvrConfEntry 6 }
  868.  
  869.   tn3270eSrvrConfAdminStatus OBJECT-TYPE
  870.       SYNTAX  INTEGER {
  871.                         up(1),
  872.                         down(2),
  873.                         stopImmediate(3)
  874.                       }
  875.       MAX-ACCESS  read-create
  876.       STATUS      current
  877.       DESCRIPTION
  878.           "The desired state of the TN3270E server represented
  879.            by this entry in the table:
  880.  
  881.            up(1)            - Activate this TN3270E server.
  882.            down(2)          - Informs the associated TN3270E
  883.                               server to gracefully terminate
  884.                               its processing.
  885.            stopImmediate(3) - Informs the associated TN3270E
  886.                               server to terminate itself
  887.                               immediately.
  888.  
  889.            When a managed system creates an entry in this table,
  890.            tn3270eSrvrConfAdminStatus and tn3270eSrvrConfOperStatus
  891.            are initialized as up(1) by default.
  892.  
  893.            The exact behavior of a server in response to a down(2)
  894.            or stopImmediate(3) command is left implementation-
  895.  
  896.  
  897.  
  898. White & Moore               Standards Track                    [Page 16]
  899.  
  900. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  901.  
  902.  
  903.            dependent.  A TN3270E server that is capable of it
  904.            SHOULD close all of its TN3270 and TN3270E sessions
  905.            during a graceful termination.
  906.  
  907.            Often the function enabled via stopImmediate(3) is used
  908.            as a last resort by a system administrator, to attempt
  909.            to either bring down a hung TN3270E server or free up
  910.            its resources immediately to aid in general system
  911.            availability, or to shut down a TN3270E server that is
  912.            not recognizing a down(2) request.
  913.  
  914.            A TN3270E server that does not distinguish between
  915.            down(2) or stopImmediate(3) transitions should not
  916.            support stopImmediate(3)."
  917.       DEFVAL { up }
  918.       ::= { tn3270eSrvrConfEntry 7 }
  919.  
  920.   tn3270eSrvrConfOperStatus OBJECT-TYPE
  921.       SYNTAX  INTEGER {
  922.                        up(1),
  923.                        down(2),
  924.                        busy(3),
  925.                        shuttingDown(4)
  926.                       }
  927.       MAX-ACCESS  read-only
  928.       STATUS      current
  929.       DESCRIPTION
  930.          "The current operational state of a TN3270E server.
  931.          The following values are defined:
  932.  
  933.           up(1)            - the server is active and accepting
  934.                              new client connections
  935.           down(2)          - the server is not active
  936.           busy(3)          - the server is active, but is not
  937.                              accepting new client connections
  938.                              because it lacks the resources to
  939.                              do so
  940.           shuttingDown(4)  - the server is active, but is not
  941.                              accepting new client connections
  942.                              because it is in the process of
  943.                              performing a graceful shutdown."
  944.       DEFVAL { up }
  945.       ::= { tn3270eSrvrConfEntry 8 }
  946.  
  947.   tn3270eSrvrConfSessionTermState OBJECT-TYPE
  948.       SYNTAX  INTEGER {
  949.                         terminate(1),
  950.                         luSessionPend(2),
  951.  
  952.  
  953.  
  954. White & Moore               Standards Track                    [Page 17]
  955.  
  956. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  957.  
  958.  
  959.                         queueSession(3)
  960.                       }
  961.       MAX-ACCESS  read-create
  962.       STATUS      current
  963.       DESCRIPTION
  964.          "This object determines what a TN3270E server
  965.           should do when a TN3270 Session terminates:
  966.          terminate(1)     => Terminate the TCP connection.
  967.          luSessionPend(2) => Do not drop the TCP connection
  968.                              associated with a client when its
  969.                              TN3270 session ends.  Processing
  970.                              should redrive session initialization
  971.                              as if the client were first connecting.
  972.          queueSession(3)  => This value relates to the Close
  973.                              Destination PASS (CLSDST PASS) operation
  974.                              in VTAM.  An example provides the
  975.                              easiest explanation.  Suppose a TN3270E
  976.                              client is in session with APPL1, and
  977.                              APPL1 does a CLSDST PASS of the client's
  978.                              session to APPL2.  queueSession(3)
  979.                              specifies that the TN3270E server must
  980.                              keep the TCP connection with the client
  981.                              active after it receives the UNBIND from
  982.                              APPL1, waiting for the BIND from APPL2."
  983.       DEFVAL { terminate }
  984.       ::= { tn3270eSrvrConfEntry 9 }
  985.  
  986.   tn3270eSrvrConfSrvrType OBJECT-TYPE
  987.       SYNTAX      INTEGER {
  988.                             host(1),
  989.                             gateway(2)
  990.                           }
  991.       MAX-ACCESS  read-only
  992.       STATUS      current
  993.       DESCRIPTION
  994.           "This object indicates the type of TN3270E server.
  995.           The existence of MIB tables and objects that will be
  996.           defined by follow-on MIBs may be predicated on whether
  997.           the TN3270E server can be local to the same host as a
  998.           target application (host(1)) or will always be remote
  999.           (gateway(2)).
  1000.  
  1001.           A host TN3270E server refers to an implementation where
  1002.           the TN3270E server is collocated with the Systems
  1003.           Network Architecture (SNA) System Services Control Point
  1004.           (SSCP) for the dependent Secondary Logical Units (SLUs)
  1005.           that the server makes available to its clients for
  1006.           connecting into an SNA network.
  1007.  
  1008.  
  1009.  
  1010. White & Moore               Standards Track                    [Page 18]
  1011.  
  1012. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1013.  
  1014.  
  1015.           A gateway TN3270E server resides on an SNA node other
  1016.           than an SSCP, either an SNA type 2.0 node or an APPN node
  1017.           acting in the role of a Dependent LU Requester (DLUR).
  1018.  
  1019.           Host and gateway TN3270E server implementations typically
  1020.           differ greatly as to their internal implementation and
  1021.           system definition (SYSDEF) requirements."
  1022.       ::= { tn3270eSrvrConfEntry 10 }
  1023.  
  1024.   tn3270eSrvrConfContact OBJECT-TYPE
  1025.       SYNTAX      SnmpAdminString
  1026.       MAX-ACCESS  read-create
  1027.       STATUS      current
  1028.       DESCRIPTION
  1029.           "This object provides a scratch pad for a TN3270E
  1030.           server administrator for storing information for
  1031.           later retrieval."
  1032.       DEFVAL { ''H }   -- the empty string
  1033.       ::= { tn3270eSrvrConfEntry 11 }
  1034.  
  1035.   tn3270eSrvrConfRowStatus OBJECT-TYPE
  1036.       SYNTAX      RowStatus
  1037.       MAX-ACCESS  read-create
  1038.       STATUS      current
  1039.       DESCRIPTION
  1040.           "This object allows entries to be created and deleted
  1041.           in the tn3270eSrvrConfTable.  Entries may also be
  1042.           created and deleted as a result of implementation-
  1043.           dependent operations.
  1044.  
  1045.           With the exception of tn3270eSrvrConfSrvrType, which
  1046.           an implementation can easily fill in for itself, all
  1047.           the columnar objects in this table have DEFVALs
  1048.           associated with them.  Consequently, a Management
  1049.           Station can create a conceptual row via a SET
  1050.           operation that specifies a value only for this object.
  1051.  
  1052.           When a tn3270eSrvrConfEntry is deleted (by setting
  1053.           this object to destroy(6)), this has the side-effect
  1054.           of removing all the associated entries (i.e., those
  1055.           having the same tn3270eSrvrConfIndex) from the
  1056.           tn3270eSrvrPortTable, the tn3270eSrvrStatsTable, the
  1057.           tn3270eClientGroupTable, the tn3270eResPoolTable,
  1058.           the tn3270eSnaMapTable, the tn3270eClientResMapTable,
  1059.           and the tn3270eResMapTable.  All entries in the
  1060.           tn3270eTcpConnTable that belong to a TN3270E server
  1061.           that has been deleted MUST also be removed.
  1062.  
  1063.  
  1064.  
  1065.  
  1066. White & Moore               Standards Track                    [Page 19]
  1067.  
  1068. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1069.  
  1070.  
  1071.           In other words, a tn3270eSrvrConfEntry must exist for
  1072.           a TN3270E server in order for it to have entries in
  1073.           any of the other tables defined by this MIB."
  1074.       REFERENCE
  1075.           "RFC 1903, 'Textual Conventions for version 2 of the
  1076.           Simple Network Management Protocol (SNMPv2).'"
  1077.       ::= { tn3270eSrvrConfEntry 12 }
  1078.  
  1079.   tn3270eSrvrConfLastActTime OBJECT-TYPE
  1080.       SYNTAX      DateAndTime
  1081.       MAX-ACCESS  read-only
  1082.       STATUS      current
  1083.       DESCRIPTION
  1084.           "This object reports the DateAndTime when a TN3270E
  1085.           server was most recently activated.
  1086.  
  1087.           The special value of all '00'Hs indicates that the
  1088.           server has never been active, i.e., that the value of
  1089.           tn3270eSrvrOperStatus has never been anything other
  1090.           than down(2)."
  1091.       DEFVAL { '0000000000000000'H }
  1092.       ::= { tn3270eSrvrConfEntry 13 }
  1093.  
  1094.   tn3270eSrvrConfTmTimeout OBJECT-TYPE
  1095.       SYNTAX      Unsigned32 (1..600) -- 1 second to 10 minutes
  1096.       UNITS "seconds"
  1097.       MAX-ACCESS  read-create
  1098.       STATUS      current
  1099.       DESCRIPTION
  1100.          "The TIMING-MARK time-out, specified in seconds."
  1101.       DEFVAL { 5 }   -- 5 seconds
  1102.       ::= { tn3270eSrvrConfEntry 14 }
  1103.  
  1104.   tn3270eSrvrPortTable OBJECT-TYPE
  1105.       SYNTAX      SEQUENCE OF Tn3270eSrvrPortEntry
  1106.       MAX-ACCESS  not-accessible
  1107.       STATUS      current
  1108.       DESCRIPTION
  1109.           "This table defines the TCP ports associated with
  1110.           TN3270E servers.  No entry in this table shall exist
  1111.           without a corresponding (same tn3270eSrvrConfIndex)
  1112.           entry in the tn3270eSrvrConfTable existing.
  1113.  
  1114.           An implementation SHOULD NOT retain SNMP-created
  1115.           entries in this table across re-IPLs (Initial Program
  1116.           Loads) of the corresponding TN3270E server."
  1117.       ::= { tn3270eObjects 2 }
  1118.  
  1119.  
  1120.  
  1121.  
  1122. White & Moore               Standards Track                    [Page 20]
  1123.  
  1124. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1125.  
  1126.  
  1127.   tn3270eSrvrPortEntry OBJECT-TYPE
  1128.       SYNTAX      Tn3270eSrvrPortEntry
  1129.       MAX-ACCESS  not-accessible
  1130.       STATUS      current
  1131.       DESCRIPTION
  1132.           "Definition of a single TCP port assignment to a
  1133.            TN3270E server.  Assignment of a port on a local
  1134.            address basis is enabled though use of
  1135.            tn3270eSrvrPortAddrType and tn3270eSrvrPortAddress.
  1136.  
  1137.            A TCP port assignment that is not restricted to
  1138.            a local address SHALL specify a tn3270eSrvrPortAddrType
  1139.            of unknown(0), and SHALL use a zero-length octet string
  1140.            for the tn3270eSrvrPortAddress."
  1141.       INDEX       {
  1142.                     tn3270eSrvrConfIndex,
  1143.                     tn3270eSrvrPort,
  1144.                     tn3270eSrvrPortAddrType,
  1145.                     tn3270eSrvrPortAddress
  1146.                   }
  1147.       ::= { tn3270eSrvrPortTable 1 }
  1148.  
  1149.   Tn3270eSrvrPortEntry ::= SEQUENCE {
  1150.       tn3270eSrvrPort                 Unsigned32,
  1151.       tn3270eSrvrPortAddrType         IANATn3270eAddrType,
  1152.       tn3270eSrvrPortAddress          IANATn3270eAddress,
  1153.       tn3270eSrvrPortRowStatus        RowStatus
  1154.     }
  1155.  
  1156.   tn3270eSrvrPort OBJECT-TYPE
  1157.       SYNTAX      Unsigned32 (0..65535)
  1158.       MAX-ACCESS  not-accessible
  1159.       STATUS      current
  1160.       DESCRIPTION
  1161.          "Indicates a port assigned to a server."
  1162.       ::= { tn3270eSrvrPortEntry 1 }
  1163.  
  1164.   tn3270eSrvrPortAddrType OBJECT-TYPE
  1165.       SYNTAX      IANATn3270eAddrType
  1166.       MAX-ACCESS  not-accessible
  1167.       STATUS      current
  1168.       DESCRIPTION
  1169.           "Indicates the type of an address local to the host on
  1170.           which the TN3270E server resides that is represented
  1171.           in tn3270eSrvrPortAddress.  A value of unknown(0)
  1172.           SHALL be used for this object when the port is not
  1173.           to be restricted to a local address."
  1174.       ::= { tn3270eSrvrPortEntry 2 }
  1175.  
  1176.  
  1177.  
  1178. White & Moore               Standards Track                    [Page 21]
  1179.  
  1180. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1181.  
  1182.  
  1183.   tn3270eSrvrPortAddress OBJECT-TYPE
  1184.       SYNTAX      IANATn3270eAddress
  1185.       MAX-ACCESS  not-accessible
  1186.       STATUS      current
  1187.       DESCRIPTION
  1188.           "A local address on the host that a TN3270E server
  1189.            resides on that is associated with a TCP port that
  1190.            is to be used or is in use by a TN3270E server.
  1191.            tn3270eClientGroupAddrType indicates the
  1192.            address type (IPv4 or IPv6, for example).
  1193.  
  1194.            A zero-length octet string SHALL be used as the
  1195.            value of this object when a local address isn't
  1196.            being specified."
  1197.       ::= { tn3270eSrvrPortEntry 3 }
  1198.  
  1199.   tn3270eSrvrPortRowStatus OBJECT-TYPE
  1200.       SYNTAX      RowStatus
  1201.       MAX-ACCESS  read-create
  1202.       STATUS      current
  1203.       DESCRIPTION
  1204.           "This object allows entries to be created and deleted
  1205.           in the tn3270eSrvrPortTable.  Entries may also be
  1206.           created and deleted as a result of implementation-
  1207.           dependent operations.
  1208.  
  1209.           Since this is the only accessible object in this table,
  1210.           a Management Station can create a conceptual row via a SET
  1211.           operation that specifies a value only for this object.
  1212.  
  1213.           An entry in this table is deleted by setting this object
  1214.           to destroy(6).  Deletion of a tn3270eSrvrPortEntry has
  1215.           no effect on any other table entry defined by this MIB."
  1216.       REFERENCE
  1217.           "RFC 1903, 'Textual Conventions for version 2 of the
  1218.           Simple Network Management Protocol (SNMPv2).'"
  1219.       ::= { tn3270eSrvrPortEntry 4 }
  1220.  
  1221.   tn3270eSrvrStatsTable OBJECT-TYPE
  1222.       SYNTAX      SEQUENCE OF Tn3270eSrvrStatsEntry
  1223.       MAX-ACCESS  not-accessible
  1224.       STATUS      current
  1225.       DESCRIPTION
  1226.           "This table defines a set of statistics concerning
  1227.           TN3270E server performance.
  1228.  
  1229.           No entry in this table shall exist without
  1230.           a corresponding (same tn3270eSrvrConfIndex) entry in
  1231.  
  1232.  
  1233.  
  1234. White & Moore               Standards Track                    [Page 22]
  1235.  
  1236. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1237.  
  1238.  
  1239.           the tn3270eSrvrConfTable existing."
  1240.       ::= { tn3270eObjects 3 }
  1241.  
  1242.   tn3270eSrvrStatsEntry OBJECT-TYPE
  1243.       SYNTAX      Tn3270eSrvrStatsEntry
  1244.       MAX-ACCESS  not-accessible
  1245.       STATUS      current
  1246.       DESCRIPTION
  1247.           "A collection of statistical and maximum usage objects
  1248.           for a single TN3270 server.  An entry can represent the total
  1249.           activity of the server, or it can represent the activity
  1250.           occurring at the server on either a port or a
  1251.           port-and-local-address basis.
  1252.  
  1253.           Collection of the statistics represented by the objects
  1254.           in this table is not mandatory.   An implementation
  1255.           of this table MUST use only one of the three levels of
  1256.           refinement that this table supports for the entries
  1257.           associated with each TN3270E server.
  1258.  
  1259.           The indexing for a row that represents total server
  1260.           statistics is as follows:
  1261.  
  1262.                tn3270eSrvrConfIndex      value identifying the server
  1263.                tn3270eSrvrPort           0
  1264.                tn3270eSrvrPortAddrType   unknown(0)
  1265.                tn3270eSrvrPortAddress    zero-length octet string.
  1266.  
  1267.           On a port basis:
  1268.  
  1269.                tn3270eSrvrConfIndex      value identifying the server
  1270.                tn3270eSrvrPort           > 0
  1271.                tn3270eSrvrPortAddrType   unknown(0)
  1272.                tn3270eSrvrPortAddress    zero-length octet string.
  1273.  
  1274.           On a port-and-local-address basis:
  1275.  
  1276.                tn3270eSrvrConfIndex      value identifying the server
  1277.                tn3270eSrvrPort           > 0
  1278.                tn3270eSrvrPortAddrType   valid value other than unknown(0)
  1279.                tn3270eSrvrPortAddress    non-zero-length octet string.
  1280.  
  1281.          "
  1282.       INDEX       {
  1283.                     tn3270eSrvrConfIndex,
  1284.                     tn3270eSrvrPort,
  1285.                     tn3270eSrvrPortAddrType,
  1286.                     tn3270eSrvrPortAddress
  1287.  
  1288.  
  1289.  
  1290. White & Moore               Standards Track                    [Page 23]
  1291.  
  1292. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1293.  
  1294.  
  1295.                   }
  1296.       ::= { tn3270eSrvrStatsTable 1 }
  1297.  
  1298.   Tn3270eSrvrStatsEntry ::= SEQUENCE {
  1299.       tn3270eSrvrStatsUpTime          TimeStamp,
  1300.       tn3270eSrvrStatsMaxTerms        Unsigned32,
  1301.       tn3270eSrvrStatsInUseTerms      Gauge32,
  1302.       tn3270eSrvrStatsSpareTerms      Gauge32,
  1303.       tn3270eSrvrStatsMaxPtrs         Unsigned32,
  1304.       tn3270eSrvrStatsInUsePtrs       Gauge32,
  1305.       tn3270eSrvrStatsSparePtrs       Gauge32,
  1306.       tn3270eSrvrStatsInConnects      Counter32,
  1307.       tn3270eSrvrStatsConnResrceRejs  Counter32,
  1308.       tn3270eSrvrStatsDisconnects     Counter32,
  1309.       tn3270eSrvrStatsHCInOctets      Counter64,
  1310.       tn3270eSrvrStatsInOctets        Counter32,
  1311.       tn3270eSrvrStatsHCOutOctets     Counter64,
  1312.       tn3270eSrvrStatsOutOctets       Counter32,
  1313.       tn3270eSrvrStatsConnErrorRejs   Counter32
  1314.     }
  1315.  
  1316.   tn3270eSrvrStatsUpTime OBJECT-TYPE
  1317.       SYNTAX      TimeStamp
  1318.       MAX-ACCESS  read-only
  1319.       STATUS      current
  1320.       DESCRIPTION
  1321.           "The value of the sysUpTime object the last time
  1322.           the TN3270E server was re-initialized.
  1323.  
  1324.           Server re-initialization is the only discontinuity
  1325.           event for the counters in this table.  Even if table
  1326.           entries are on a port or port-and-local-address
  1327.           basis, port deactivation and reactivation do not
  1328.           result in counter discontinuities."
  1329.       ::= { tn3270eSrvrStatsEntry 2 }
  1330.  
  1331.   tn3270eSrvrStatsMaxTerms OBJECT-TYPE
  1332.       SYNTAX      Unsigned32
  1333.       UNITS       "LUs"
  1334.       MAX-ACCESS  read-only
  1335.       STATUS      current
  1336.       DESCRIPTION
  1337.          "Indicates the maximum number of terminal LUs available
  1338.          for use at a TN3270E server for the granularity of this
  1339.          conceptual row (server-wide, port, or
  1340.          port-and-local-address)."
  1341.       ::= { tn3270eSrvrStatsEntry 3 }
  1342.  
  1343.  
  1344.  
  1345.  
  1346. White & Moore               Standards Track                    [Page 24]
  1347.  
  1348. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1349.  
  1350.  
  1351.   tn3270eSrvrStatsInUseTerms OBJECT-TYPE
  1352.       SYNTAX      Gauge32
  1353.       UNITS       "LUs"
  1354.       MAX-ACCESS  read-only
  1355.       STATUS      current
  1356.       DESCRIPTION
  1357.          "Indicates the number of terminal LUs currently in
  1358.          use at a TN3270E server for the granularity of this
  1359.          conceptual row (server-wide, port, or
  1360.          port-and-local-address)."
  1361.       ::= { tn3270eSrvrStatsEntry 4 }
  1362.  
  1363.   tn3270eSrvrStatsSpareTerms OBJECT-TYPE
  1364.       SYNTAX      Gauge32
  1365.       UNITS       "LUs"
  1366.       MAX-ACCESS  read-only
  1367.       STATUS      current
  1368.       DESCRIPTION
  1369.          "Indicates the number of free terminal LUs at a TN3270E
  1370.          server for the granularity of this conceptual row
  1371.          (server-wide, port, or port-and-local-address).
  1372.  
  1373.          It is possible that the difference between
  1374.          tn3270eSrvrStatsMaxTerms and tn3270eSrvrStatsInUseTerms
  1375.          in a conceptual row does not equal the value of
  1376.          tn3270eSrvrStatsSpareTerms in that row:  an LU may
  1377.          exist but not be usable by a client connection.
  1378.  
  1379.          Alternatively, the administrative ceiling represented
  1380.          by tn3270eSrvrStatsMaxTerms may have been lowered to
  1381.          a point where it is less than the current value of
  1382.          tn3270eSrvrStatsInUseTerms.  In this case
  1383.          tn3270eSrvrStatsSpareTerms returns the value 0."
  1384.  
  1385.       ::= { tn3270eSrvrStatsEntry 5 }
  1386.  
  1387.   tn3270eSrvrStatsMaxPtrs OBJECT-TYPE
  1388.       SYNTAX      Unsigned32
  1389.       UNITS       "Printer Resources"
  1390.       MAX-ACCESS  read-only
  1391.       STATUS      current
  1392.       DESCRIPTION
  1393.          "Indicates the maximum number of printer resources
  1394.          available for use by a TN3270E server for the
  1395.          granularity of this conceptual row (server-wide,
  1396.          port, or port-and-local-address)."
  1397.       ::= { tn3270eSrvrStatsEntry 6 }
  1398.  
  1399.  
  1400.  
  1401.  
  1402. White & Moore               Standards Track                    [Page 25]
  1403.  
  1404. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1405.  
  1406.  
  1407.   tn3270eSrvrStatsInUsePtrs OBJECT-TYPE
  1408.       SYNTAX      Gauge32
  1409.       UNITS       "Printer Resources"
  1410.       MAX-ACCESS  read-only
  1411.       STATUS      current
  1412.       DESCRIPTION
  1413.          "Indicates the number of printer resources
  1414.          currently in use by a TN3270E server for the
  1415.          granularity of this conceptual row (server-wide,
  1416.          port, or port-and-local-address)."
  1417.       ::= { tn3270eSrvrStatsEntry 7 }
  1418.  
  1419.   tn3270eSrvrStatsSparePtrs OBJECT-TYPE
  1420.       SYNTAX      Gauge32
  1421.       UNITS       "Spare Printer Resources"
  1422.       MAX-ACCESS  read-only
  1423.       STATUS      current
  1424.       DESCRIPTION
  1425.          "Indicates the number of free printer resources at
  1426.          a TN3270E server for the granularity of this conceptual
  1427.          row (server-wide, port, or port-and-local-address).
  1428.  
  1429.          It is possible that the difference between
  1430.          tn3270eSrvrStatsMaxPtrs and tn3270eSrvrStatsInUsePtrs
  1431.          in a conceptual row does not equal the value of
  1432.          tn3270eSrvrStatsSparePtrs in that row:  a printer
  1433.          resource may exist but not be usable by a client
  1434.          connection.
  1435.  
  1436.          Alternatively, the administrative ceiling represented
  1437.          by tn3270eSrvrStatsMaxPtrs may have been lowered to
  1438.          a point where it is less than the current value of
  1439.          tn3270eSrvrStatsInUsePtrs.  In this case
  1440.          tn3270eSrvrStatsSparePtrs returns the value 0."
  1441.       ::= { tn3270eSrvrStatsEntry 8 }
  1442.  
  1443.   tn3270eSrvrStatsInConnects OBJECT-TYPE
  1444.       SYNTAX      Counter32
  1445.       UNITS       "connections"
  1446.       MAX-ACCESS  read-only
  1447.       STATUS      current
  1448.       DESCRIPTION
  1449.          "Indicates the number of client (TCP) connections
  1450.          that succeeded at a TN3270E server for the
  1451.          granularity of this conceptual row (server-wide,
  1452.          port, or port-and-local-address).
  1453.  
  1454.          The tn3270eSrvrStatsConnResrceRejs and
  1455.  
  1456.  
  1457.  
  1458. White & Moore               Standards Track                    [Page 26]
  1459.  
  1460. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1461.  
  1462.  
  1463.          tn3270eSrvrStatsConnErrorRejs objects provide a count
  1464.          of failed connection attempts.
  1465.  
  1466.          A Management Station can detect discontinuities in
  1467.          this counter by monitoring the tn3270eSrvrStatsUpTime
  1468.          object."
  1469.       ::= { tn3270eSrvrStatsEntry 9 }
  1470.  
  1471.   tn3270eSrvrStatsConnResrceRejs OBJECT-TYPE
  1472.       SYNTAX      Counter32
  1473.       UNITS       "connection attempts"
  1474.       MAX-ACCESS  read-only
  1475.       STATUS      current
  1476.       DESCRIPTION
  1477.          "Indicates the number of (TCP) connections rejected
  1478.          during connection setup at a TN3270E server for the
  1479.          granularity of this conceptual row (server-wide,
  1480.          port, or port-and-local-address) due to a lack of
  1481.          resources at the server.  An example of when this
  1482.          counter would be incremented is when no terminal
  1483.          or printer resource is available to associate with a
  1484.          client's TCP connection.
  1485.  
  1486.          A Management Station can detect discontinuities in
  1487.          this counter by monitoring the tn3270eSrvrStatsUpTime
  1488.          object."
  1489.       ::= { tn3270eSrvrStatsEntry 10 }
  1490.  
  1491.   tn3270eSrvrStatsDisconnects OBJECT-TYPE
  1492.       SYNTAX      Counter32
  1493.       UNITS       "disconnections"
  1494.       MAX-ACCESS  read-only
  1495.       STATUS      current
  1496.       DESCRIPTION
  1497.          "Indicates the number of (TCP) connections that were
  1498.          disconnected at a TN3270E server for the
  1499.          granularity of this conceptual row (server-wide,
  1500.          port, or port-and-local-address).
  1501.  
  1502.          A Management Station can detect discontinuities in
  1503.          this counter by monitoring the tn3270eSrvrStatsUpTime
  1504.          object."
  1505.       ::= { tn3270eSrvrStatsEntry 11 }
  1506.  
  1507.   tn3270eSrvrStatsHCInOctets OBJECT-TYPE
  1508.       SYNTAX      Counter64
  1509.       UNITS       "octets"
  1510.       MAX-ACCESS  read-only
  1511.  
  1512.  
  1513.  
  1514. White & Moore               Standards Track                    [Page 27]
  1515.  
  1516. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1517.  
  1518.  
  1519.       STATUS      current
  1520.       DESCRIPTION
  1521.          "Indicates the number of octets received from TN3270
  1522.          and TN3270E clients for the granularity of this
  1523.          conceptual row (server-wide, port, or
  1524.          port-and-local-address).
  1525.  
  1526.          A Management Station can detect discontinuities in
  1527.          this counter by monitoring the tn3270eSrvrStatsUpTime
  1528.          object."
  1529.       ::= { tn3270eSrvrStatsEntry 12 }
  1530.  
  1531.   tn3270eSrvrStatsInOctets OBJECT-TYPE
  1532.       SYNTAX      Counter32
  1533.       UNITS       "octets"
  1534.       MAX-ACCESS  read-only
  1535.       STATUS      current
  1536.       DESCRIPTION
  1537.          "Low-order 32 bits of tn3270eSrvrStatsHCInOctets for
  1538.          this conceptual row.
  1539.  
  1540.          A Management Station can detect discontinuities in
  1541.          this counter by monitoring the tn3270eSrvrStatsUpTime
  1542.          object."
  1543.       ::= { tn3270eSrvrStatsEntry 13 }
  1544.  
  1545.   tn3270eSrvrStatsHCOutOctets OBJECT-TYPE
  1546.       SYNTAX      Counter64
  1547.       UNITS       "octets"
  1548.       MAX-ACCESS  read-only
  1549.       STATUS      current
  1550.       DESCRIPTION
  1551.          "Indicates the number of octets sent to TN3270
  1552.          and TN3270E clients for the granularity of this
  1553.          conceptual row (server-wide, port, or
  1554.          port-and-local-address).
  1555.  
  1556.          A Management Station can detect discontinuities in
  1557.          this counter by monitoring the tn3270eSrvrStatsUpTime
  1558.          object."
  1559.       ::= { tn3270eSrvrStatsEntry 14 }
  1560.  
  1561.   tn3270eSrvrStatsOutOctets OBJECT-TYPE
  1562.       SYNTAX      Counter32
  1563.       UNITS       "octets"
  1564.       MAX-ACCESS  read-only
  1565.       STATUS      current
  1566.       DESCRIPTION
  1567.  
  1568.  
  1569.  
  1570. White & Moore               Standards Track                    [Page 28]
  1571.  
  1572. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1573.  
  1574.  
  1575.          "Low-order 32 bits of tn3270eSrvrStatsHCOutOctets for
  1576.          this conceptual row.
  1577.  
  1578.          A Management Station can detect discontinuities in
  1579.          this counter by monitoring the tn3270eSrvrStatsUpTime
  1580.          object."
  1581.       ::= { tn3270eSrvrStatsEntry 15 }
  1582.  
  1583.   tn3270eSrvrStatsConnErrorRejs OBJECT-TYPE
  1584.       SYNTAX      Counter32
  1585.       UNITS       "connection attempts"
  1586.       MAX-ACCESS  read-only
  1587.       STATUS      current
  1588.       DESCRIPTION
  1589.          "Indicates the number of (TCP) connections rejected
  1590.          during connection setup at a TN3270E server for the
  1591.          granularity of this conceptual row (server-wide,
  1592.          port, or port-and-local-address) due to an error
  1593.          of some type.  An example of when this counter would
  1594.          be incremented is when the client and the server
  1595.          cannot agree on a common set of TN3270E functions for
  1596.          the connection.
  1597.  
  1598.          A Management Station can detect discontinuities in
  1599.          this counter by monitoring the tn3270eSrvrStatsUpTime
  1600.          object."
  1601.       ::= { tn3270eSrvrStatsEntry 16 }
  1602.  
  1603.   tn3270eClientGroupTable OBJECT-TYPE
  1604.       SYNTAX      SEQUENCE OF Tn3270eClientGroupEntry
  1605.       MAX-ACCESS  not-accessible
  1606.       STATUS      current
  1607.       DESCRIPTION
  1608.           "This table defines client address groupings for use
  1609.           by a TN3270E server.
  1610.  
  1611.           No entry in this table shall exist without
  1612.           a corresponding (same tn3270eSrvrConfIndex) entry in
  1613.           the tn3270eSrvrConfTable existing.
  1614.  
  1615.           An implementation SHOULD NOT retain SNMP-created
  1616.           entries in this table across re-IPLs (Initial Program
  1617.           Loads) of the corresponding TN3270E server."
  1618.       ::= { tn3270eObjects 4 }
  1619.  
  1620.   tn3270eClientGroupEntry OBJECT-TYPE
  1621.       SYNTAX      Tn3270eClientGroupEntry
  1622.       MAX-ACCESS  not-accessible
  1623.  
  1624.  
  1625.  
  1626. White & Moore               Standards Track                    [Page 29]
  1627.  
  1628. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1629.  
  1630.  
  1631.       STATUS      current
  1632.       DESCRIPTION
  1633.           "Definition of a single client address entry.  All
  1634.           entries with the same first two indexes,
  1635.           tn3270eSrvrConfIndex and tn3270eClientGroupName, are
  1636.           considered to be in the same client group."
  1637.       INDEX       { tn3270eSrvrConfIndex,
  1638.                     tn3270eClientGroupName,
  1639.                     tn3270eClientGroupAddrType,
  1640.                     tn3270eClientGroupAddress }
  1641.       ::= { tn3270eClientGroupTable 1 }
  1642.  
  1643.   Tn3270eClientGroupEntry ::= SEQUENCE {
  1644.       tn3270eClientGroupName           Utf8String,
  1645.       tn3270eClientGroupAddrType       IANATn3270eAddrType,
  1646.       tn3270eClientGroupAddress        IANATn3270eAddress,
  1647.       tn3270eClientGroupSubnetMask     IpAddress,
  1648.       tn3270eClientGroupPfxLength      Unsigned32,
  1649.       tn3270eClientGroupRowStatus      RowStatus
  1650.   }
  1651.  
  1652.   tn3270eClientGroupName OBJECT-TYPE
  1653.       SYNTAX      Utf8String (SIZE(1..24))
  1654.       MAX-ACCESS  not-accessible
  1655.       STATUS      current
  1656.       DESCRIPTION
  1657.           "The name of a client group.  Note: client group
  1658.           names are required to be unique only with respect
  1659.           to a single TN3270E server."
  1660.       ::= { tn3270eClientGroupEntry 1 }
  1661.  
  1662.   tn3270eClientGroupAddrType OBJECT-TYPE
  1663.       SYNTAX      IANATn3270eAddrType
  1664.       MAX-ACCESS  not-accessible
  1665.       STATUS      current
  1666.       DESCRIPTION
  1667.           "Indicates the type of the address represented in
  1668.            tn3270eClientGroupAddress."
  1669.       ::= { tn3270eClientGroupEntry 2 }
  1670.  
  1671.   tn3270eClientGroupAddress OBJECT-TYPE
  1672.       SYNTAX      IANATn3270eAddress
  1673.       MAX-ACCESS  not-accessible
  1674.       STATUS      current
  1675.       DESCRIPTION
  1676.           "The client address of a member of a client group.
  1677.           The value of tn3270eClientGroupAddrType indicates
  1678.           the address type (IPv4 or IPv6, for example)."
  1679.  
  1680.  
  1681.  
  1682. White & Moore               Standards Track                    [Page 30]
  1683.  
  1684. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1685.  
  1686.  
  1687.       ::= { tn3270eClientGroupEntry 3 }
  1688.  
  1689.   tn3270eClientGroupSubnetMask OBJECT-TYPE
  1690.       SYNTAX      IpAddress
  1691.       MAX-ACCESS  read-create
  1692.       STATUS      current
  1693.       DESCRIPTION
  1694.           "The corresponding subnet mask associated with
  1695.            tn3270eClientGroupAddress.  A single IP address is
  1696.            represented by having this object contain the value
  1697.            of 255.255.255.255.
  1698.  
  1699.            This object's value is meaningful only if
  1700.            tn3270eClientGroupAddrType has a value of ipv4(1)."
  1701.       DEFVAL { 'FFFFFFFF'H }
  1702.       ::= { tn3270eClientGroupEntry 4 }
  1703.  
  1704.   tn3270eClientGroupPfxLength OBJECT-TYPE
  1705.       SYNTAX      Unsigned32 (0..128)
  1706.       UNITS       "bits"
  1707.       MAX-ACCESS  read-create
  1708.       STATUS      current
  1709.       DESCRIPTION
  1710.           "The corresponding IPv6 network prefix length.
  1711.  
  1712.           This object's value is meaningful only if
  1713.           tn3270eClientGroupAddrType  has a value of ipv6(2)."
  1714.       DEFVAL { 0 }
  1715.       ::= { tn3270eClientGroupEntry 5 }
  1716.  
  1717.   tn3270eClientGroupRowStatus OBJECT-TYPE
  1718.       SYNTAX      RowStatus
  1719.       MAX-ACCESS  read-create
  1720.       STATUS      current
  1721.       DESCRIPTION
  1722.           "This object allows entries to be created and deleted
  1723.           in the tn3270eClientGroupTable.  Entries may also be
  1724.           created and deleted as a result of implementation-
  1725.           dependent operations.
  1726.  
  1727.           An entry in this table is deleted by setting this object
  1728.           to destroy(6).  When the number of entries in this table
  1729.           for a given client group becomes 0, this has the side-
  1730.           effect of removing any entries for the group in the
  1731.           tn3270eClientResMapTable."
  1732.       REFERENCE
  1733.           "RFC 1903, 'Textual Conventions for version 2 of the
  1734.           Simple Network Management Protocol (SNMPv2).'"
  1735.  
  1736.  
  1737.  
  1738. White & Moore               Standards Track                    [Page 31]
  1739.  
  1740. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1741.  
  1742.  
  1743.       ::= { tn3270eClientGroupEntry 6 }
  1744.  
  1745.   tn3270eResPoolTable OBJECT-TYPE
  1746.       SYNTAX      SEQUENCE OF Tn3270eResPoolEntry
  1747.       MAX-ACCESS  not-accessible
  1748.       STATUS      current
  1749.       DESCRIPTION
  1750.           "This table defines resource groupings; the term
  1751.           'pool' is used as it is defined by RFC 2355.
  1752.  
  1753.           No entry in this table shall exist without
  1754.           a corresponding (same tn3270eSrvrConfIndex) entry in
  1755.           the tn3270eSrvrConfTable existing.
  1756.  
  1757.           An implementation SHOULD NOT retain SNMP-created
  1758.           entries in this table across re-IPLs (Initial Program
  1759.           Loads) of the corresponding TN3270E server."
  1760.       ::= { tn3270eObjects 5 }
  1761.  
  1762.   tn3270eResPoolEntry OBJECT-TYPE
  1763.       SYNTAX      Tn3270eResPoolEntry
  1764.       MAX-ACCESS  not-accessible
  1765.       STATUS      current
  1766.       DESCRIPTION
  1767.           "Definition of a single resource pool member.  All entries
  1768.           with the same first two indexes, tn3270eSrvrConfIndex and
  1769.           tn3270eResPoolName, are considered to be in the same pool."
  1770.       INDEX  { tn3270eSrvrConfIndex,
  1771.                tn3270eResPoolName,
  1772.                tn3270eResPoolElementName }
  1773.       ::= { tn3270eResPoolTable 1 }
  1774.  
  1775.   Tn3270eResPoolEntry ::= SEQUENCE {
  1776.       tn3270eResPoolName           Utf8String,
  1777.       tn3270eResPoolElementName    SnaResourceName,
  1778.       tn3270eResPoolElementType    IANATn3270ResourceType,
  1779.       tn3270eResPoolRowStatus      RowStatus
  1780.   }
  1781.  
  1782.   tn3270eResPoolName OBJECT-TYPE
  1783.       SYNTAX      Utf8String (SIZE(1..24))
  1784.       MAX-ACCESS  not-accessible
  1785.       STATUS      current
  1786.       DESCRIPTION
  1787.           "The name of a resource pool."
  1788.       ::= { tn3270eResPoolEntry 1 }
  1789.  
  1790.   tn3270eResPoolElementName OBJECT-TYPE
  1791.  
  1792.  
  1793.  
  1794. White & Moore               Standards Track                    [Page 32]
  1795.  
  1796. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1797.  
  1798.  
  1799.       SYNTAX      SnaResourceName
  1800.       MAX-ACCESS  not-accessible
  1801.       STATUS      current
  1802.       DESCRIPTION
  1803.           "The name of a member of a resource pool."
  1804.       ::= { tn3270eResPoolEntry 2 }
  1805.  
  1806.   tn3270eResPoolElementType OBJECT-TYPE
  1807.       SYNTAX      IANATn3270ResourceType
  1808.       MAX-ACCESS  read-create
  1809.       STATUS      current
  1810.       DESCRIPTION
  1811.           "The type of the entity in a resource pool."
  1812.       ::= { tn3270eResPoolEntry 3 }
  1813.  
  1814.   tn3270eResPoolRowStatus OBJECT-TYPE
  1815.       SYNTAX      RowStatus
  1816.       MAX-ACCESS  read-create
  1817.       STATUS      current
  1818.       DESCRIPTION
  1819.           "This object allows entries to be created and deleted
  1820.           in the tn3270eResPoolTable.  Entries may also be
  1821.           created and deleted as a result of implementation-
  1822.           dependent operations.
  1823.  
  1824.           An entry in this table is deleted by setting this object
  1825.           to destroy(6).  When all entries in this table associated
  1826.           with the same tn3270eResPoolElementName have been removed,
  1827.           then any associated (tn3270eResPoolElementName matching
  1828.           tn3270eClientResMapPoolName with same tn3270eSrvrConfIndex
  1829.           values) entries in the tn3270eClientResMapTable SHALL
  1830.           also be removed."
  1831.       REFERENCE
  1832.           "RFC 1903, 'Textual Conventions for version 2 of the
  1833.           Simple Network Management Protocol (SNMPv2).'"
  1834.       ::= { tn3270eResPoolEntry 4 }
  1835.  
  1836.   tn3270eSnaMapTable OBJECT-TYPE
  1837.       SYNTAX      SEQUENCE OF Tn3270eSnaMapEntry
  1838.       MAX-ACCESS  not-accessible
  1839.       STATUS      current
  1840.       DESCRIPTION
  1841.           "This table provide a mapping from the name by which
  1842.           a secondary LU is known in the SNA network to the
  1843.           name by which it is known locally at the TN3270e
  1844.           server.  This latter name serves as an index into
  1845.           the tn3270eResPoolTable and the tn3270eResMapTable.
  1846.  
  1847.  
  1848.  
  1849.  
  1850. White & Moore               Standards Track                    [Page 33]
  1851.  
  1852. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1853.  
  1854.  
  1855.           No entry in this table shall exist without
  1856.           a corresponding (same tn3270eSrvrConfIndex) entry in
  1857.           the tn3270eSrvrConfTable existing."
  1858.       ::= { tn3270eObjects 6 }
  1859.  
  1860.   tn3270eSnaMapEntry OBJECT-TYPE
  1861.       SYNTAX      Tn3270eSnaMapEntry
  1862.       MAX-ACCESS  not-accessible
  1863.       STATUS      current
  1864.       DESCRIPTION
  1865.           "Definition of a single mapping from an SSCP-supplied
  1866.           SLU name to a local SLU name.
  1867.  
  1868.           Note:  In certain pathological cases, it is possible
  1869.           that an SSCP will send on an ACTLU for a local LU an
  1870.           SLU name currently represented by an entry in this
  1871.           table that associates it with a different local LU.
  1872.           In these cases the association from the newer ACTLU
  1873.           SHOULD be the one represented in this table."
  1874.       INDEX  { tn3270eSrvrConfIndex,
  1875.                tn3270eSnaMapSscpSuppliedName }
  1876.       ::= { tn3270eSnaMapTable 1 }
  1877.  
  1878.   Tn3270eSnaMapEntry ::= SEQUENCE {
  1879.       tn3270eSnaMapSscpSuppliedName     SnaResourceName,
  1880.       tn3270eSnaMapLocalName            SnaResourceName,
  1881.       tn3270eSnaMapPrimaryLuName        SnaResourceName
  1882.   }
  1883.  
  1884.   tn3270eSnaMapSscpSuppliedName OBJECT-TYPE
  1885.       SYNTAX      SnaResourceName
  1886.       MAX-ACCESS  not-accessible
  1887.       STATUS      current
  1888.       DESCRIPTION
  1889.           "The name of the secondary LU (SLU) as it is known in
  1890.            the SNA network.  This name is sent by the SSCP on
  1891.            the Activate Logical Unit (ACTLU) request."
  1892.       ::= { tn3270eSnaMapEntry 1 }
  1893.  
  1894.   tn3270eSnaMapLocalName OBJECT-TYPE
  1895.       SYNTAX      SnaResourceName
  1896.       MAX-ACCESS  read-only
  1897.       STATUS      current
  1898.       DESCRIPTION
  1899.           "The local name of the secondary LU (SLU)."
  1900.       ::= { tn3270eSnaMapEntry 2 }
  1901.  
  1902.   tn3270eSnaMapPrimaryLuName  OBJECT-TYPE
  1903.  
  1904.  
  1905.  
  1906. White & Moore               Standards Track                    [Page 34]
  1907.  
  1908. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1909.  
  1910.  
  1911.       SYNTAX   SnaResourceName
  1912.       MAX-ACCESS  read-only
  1913.       STATUS      current
  1914.       DESCRIPTION
  1915.           "When there is a currently active LU-LU session for
  1916.           this connection, this object returns the primary LU
  1917.           (PLU) name from the BIND.  When there is no active
  1918.           LU-LU session, or when the PLU name is unavailable
  1919.           for some other reason, this object returns a
  1920.           zero-length octet string."
  1921.       ::= { tn3270eSnaMapEntry 3 }
  1922.  
  1923.   tn3270eClientResMapTable OBJECT-TYPE
  1924.       SYNTAX      SEQUENCE OF Tn3270eClientResMapEntry
  1925.       MAX-ACCESS  not-accessible
  1926.       STATUS      current
  1927.       DESCRIPTION
  1928.           "This table defines resource-pool to client-group
  1929.           mappings.  Since both the resource pool name and client
  1930.           group name are included in the index clause of this
  1931.           table, multiple resource pools can be assigned to the
  1932.           same client group.  This enables use of multiple
  1933.           resource pools for use in client to resource mapping.
  1934.           Assigning multiple client groups to the same resource
  1935.           pool is also allowed, but is not the primary purpose
  1936.           for how the indexing is structured.
  1937.  
  1938.           Assignment of a resource pool to client group can be
  1939.           restricted based on TCP port.  An index value of 0 for
  1940.           tn3270eClientResMapClientPort disables restriction of
  1941.           resource assignment based on client target port
  1942.           selection.
  1943.  
  1944.           No entry in this table shall exist without
  1945.           a corresponding (same tn3270eSrvrConfIndex) entry in
  1946.           the tn3270eSrvrConfTable existing.
  1947.  
  1948.           An implementation SHOULD NOT retain SNMP-created
  1949.           entries in this table across re-IPLs (Initial Program
  1950.           Loads) of the corresponding TN3270E server."
  1951.       ::= { tn3270eObjects 7 }
  1952.  
  1953.   tn3270eClientResMapEntry OBJECT-TYPE
  1954.       SYNTAX      Tn3270eClientResMapEntry
  1955.       MAX-ACCESS  not-accessible
  1956.       STATUS      current
  1957.       DESCRIPTION
  1958.           "Definition of a single resource pool to client group
  1959.  
  1960.  
  1961.  
  1962. White & Moore               Standards Track                    [Page 35]
  1963.  
  1964. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  1965.  
  1966.  
  1967.           mapping."
  1968.       INDEX  { tn3270eSrvrConfIndex,
  1969.                tn3270eClientResMapPoolName,
  1970.                tn3270eClientResMapClientGroupName,
  1971.                tn3270eClientResMapClientPort }
  1972.       ::= { tn3270eClientResMapTable 1 }
  1973.  
  1974.   Tn3270eClientResMapEntry ::= SEQUENCE {
  1975.       tn3270eClientResMapPoolName           Utf8String,
  1976.       tn3270eClientResMapClientGroupName    Utf8String,
  1977.       tn3270eClientResMapClientPort         Unsigned32,
  1978.       tn3270eClientResMapRowStatus          RowStatus
  1979.   }
  1980.  
  1981.   tn3270eClientResMapPoolName OBJECT-TYPE
  1982.       SYNTAX      Utf8String (SIZE(1..24))
  1983.       MAX-ACCESS  not-accessible
  1984.       STATUS      current
  1985.       DESCRIPTION
  1986.           "The name of a resource pool."
  1987.       ::= { tn3270eClientResMapEntry 1 }
  1988.  
  1989.   tn3270eClientResMapClientGroupName OBJECT-TYPE
  1990.       SYNTAX      Utf8String (SIZE(1..24))
  1991.       MAX-ACCESS  not-accessible
  1992.       STATUS      current
  1993.       DESCRIPTION
  1994.           "The name of the client group that is mapped to a
  1995.            resource pool."
  1996.       ::= { tn3270eClientResMapEntry 2 }
  1997.  
  1998.   tn3270eClientResMapClientPort OBJECT-TYPE
  1999.       SYNTAX      Unsigned32 (0..65535)
  2000.       MAX-ACCESS  not-accessible
  2001.       STATUS      current
  2002.       DESCRIPTION
  2003.           "A port number restricting the scope of a mapping
  2004.           from a resource pool to a client group.  The
  2005.           value 0 for this object indicates that the scope
  2006.           of the mapping is not restricted."
  2007.       ::= { tn3270eClientResMapEntry 3 }
  2008.  
  2009.   tn3270eClientResMapRowStatus OBJECT-TYPE
  2010.       SYNTAX      RowStatus
  2011.       MAX-ACCESS  read-create
  2012.       STATUS      current
  2013.       DESCRIPTION
  2014.           "This object allows entries to be created and deleted
  2015.  
  2016.  
  2017.  
  2018. White & Moore               Standards Track                    [Page 36]
  2019.  
  2020. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2021.  
  2022.  
  2023.           in the tn3270eClientResMapTable.  Entries may also be
  2024.           created and deleted as a result of implementation-
  2025.           dependent operations.
  2026.  
  2027.           An entry in this table is deleted by setting this object
  2028.           to destroy(6).  Removing an entry from this table doesn't
  2029.           affect any other table entry defined in this MIB."
  2030.       REFERENCE
  2031.           "RFC 1903, 'Textual Conventions for version 2 of the
  2032.           Simple Network Management Protocol (SNMPv2).'"
  2033.       ::= { tn3270eClientResMapEntry 4 }
  2034.  
  2035.   tn3270eResMapTable OBJECT-TYPE
  2036.       SYNTAX      SEQUENCE OF Tn3270eResMapEntry
  2037.       MAX-ACCESS  not-accessible
  2038.       STATUS      current
  2039.       DESCRIPTION
  2040.           "This table defines the actual mapping of a resource
  2041.           to a client address.
  2042.  
  2043.           No entry in this table shall exist without
  2044.           a corresponding (same tn3270eSrvrConfIndex) entry in
  2045.           the tn3270eSrvrConfTable existing."
  2046.       ::= { tn3270eObjects 8 }
  2047.  
  2048.   tn3270eResMapEntry OBJECT-TYPE
  2049.       SYNTAX      Tn3270eResMapEntry
  2050.       MAX-ACCESS  not-accessible
  2051.       STATUS      current
  2052.       DESCRIPTION
  2053.           "Definition of the mapping of a Resource Element to
  2054.            a client address."
  2055.       INDEX  { tn3270eSrvrConfIndex,
  2056.                tn3270eResMapElementName }
  2057.       ::= { tn3270eResMapTable 1 }
  2058.  
  2059.   Tn3270eResMapEntry ::= SEQUENCE {
  2060.       tn3270eResMapElementName       SnaResourceName,
  2061.       tn3270eResMapAddrType          IANATn3270eAddrType,
  2062.       tn3270eResMapAddress           IANATn3270eAddress,
  2063.       tn3270eResMapPort              Unsigned32,
  2064.       tn3270eResMapElementType       IANATn3270ResourceType,
  2065.       tn3270eResMapSscpSuppliedName  SnaResourceName
  2066.   }
  2067.  
  2068.   tn3270eResMapElementName OBJECT-TYPE
  2069.       SYNTAX      SnaResourceName
  2070.       MAX-ACCESS  not-accessible
  2071.  
  2072.  
  2073.  
  2074. White & Moore               Standards Track                    [Page 37]
  2075.  
  2076. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2077.  
  2078.  
  2079.       STATUS      current
  2080.       DESCRIPTION
  2081.           "The name of a resource element.  This is the name by
  2082.           which the server implementing this table knows the
  2083.           resource.  It may be different from the name by which
  2084.           the resource is known in the SNA network.  This latter
  2085.           name is returned in the tn3270eResMapSscpSuppliedName
  2086.           object."
  2087.       ::= { tn3270eResMapEntry 1 }
  2088.  
  2089.   tn3270eResMapAddrType OBJECT-TYPE
  2090.       SYNTAX      IANATn3270eAddrType
  2091.       MAX-ACCESS  read-only
  2092.       STATUS      current
  2093.       DESCRIPTION
  2094.           "Indicates the type of the client address represented
  2095.           in tn3270eResMapAddress."
  2096.       ::= { tn3270eResMapEntry 2 }
  2097.  
  2098.   tn3270eResMapAddress OBJECT-TYPE
  2099.       SYNTAX      IANATn3270eAddress
  2100.       MAX-ACCESS  read-only
  2101.       STATUS      current
  2102.       DESCRIPTION
  2103.           "A client address."
  2104.       ::= { tn3270eResMapEntry 3 }
  2105.  
  2106.   tn3270eResMapPort OBJECT-TYPE
  2107.       SYNTAX      Unsigned32 (0..65535)
  2108.       MAX-ACCESS  read-only
  2109.       STATUS      current
  2110.       DESCRIPTION
  2111.           "A client port."
  2112.       ::= { tn3270eResMapEntry 4 }
  2113.  
  2114.   tn3270eResMapElementType OBJECT-TYPE
  2115.       SYNTAX      IANATn3270ResourceType
  2116.       MAX-ACCESS  read-only
  2117.       STATUS      current
  2118.       DESCRIPTION
  2119.           "The type of the associated resource element."
  2120.       ::= { tn3270eResMapEntry 5 }
  2121.  
  2122.   tn3270eResMapSscpSuppliedName OBJECT-TYPE
  2123.       SYNTAX      SnaResourceName
  2124.       MAX-ACCESS  read-only
  2125.       STATUS      current
  2126.       DESCRIPTION
  2127.  
  2128.  
  2129.  
  2130. White & Moore               Standards Track                    [Page 38]
  2131.  
  2132. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2133.  
  2134.  
  2135.           "The name of the secondary LU (SLU) as it is known
  2136.           in a SNA network.  This name is sent by the SSCP on
  2137.           the Activate Logical Unit (ACTLU) request.  If this
  2138.           name is not known, this object returns a zero-length
  2139.           octet string."
  2140.       ::= { tn3270eResMapEntry 6 }
  2141.  
  2142.   -- Define the set of objects to supplement the TCP Connection Table
  2143.  
  2144.   tn3270eTcpConnTable OBJECT-TYPE
  2145.       SYNTAX SEQUENCE OF Tn3270eTcpConnEntry
  2146.       MAX-ACCESS  not-accessible
  2147.       STATUS      current
  2148.       DESCRIPTION
  2149.            "This table has an entry for each TN3270(E) client
  2150.            connection that is currently active at a TN3270E server.
  2151.            An implementation MAY retain entries for connections
  2152.            that have been terminated, but which entries are
  2153.            retained, how many entries are retained, and how long
  2154.            they are retained is entirely implementation-dependent.
  2155.  
  2156.            The indexing for this table is designed to support the
  2157.            use of an SNMP GET-NEXT operation using only the remote
  2158.            address type, remote address, and remote port, as a way
  2159.            for a Management Station to retrieve the table entries
  2160.            related to a particular TN3270(E) client."
  2161.       ::= { tn3270eObjects 9 }
  2162.  
  2163.   tn3270eTcpConnEntry OBJECT-TYPE
  2164.       SYNTAX Tn3270eTcpConnEntry
  2165.       MAX-ACCESS  not-accessible
  2166.       STATUS      current
  2167.       DESCRIPTION
  2168.           "Provides information about a single TN3270/TN3270E
  2169.           session.  Note: a tn3270eSrvrConfIndex is not needed
  2170.           in this table, since the combination of remote and
  2171.           local addresses and ports is sufficient to
  2172.           guarantee uniqueness across the TN3270E servers
  2173.           serviced by an SNMP agent.  Because of this indexing
  2174.           structure, however, this table does not support
  2175.           view-based access control policies that provide
  2176.           access to table rows on a per-server basis."
  2177.       INDEX { tn3270eTcpConnRemAddrType,
  2178.               tn3270eTcpConnRemAddress,
  2179.               tn3270eTcpConnRemPort,
  2180.               tn3270eTcpConnLocalAddrType,
  2181.               tn3270eTcpConnLocalAddress,
  2182.               tn3270eTcpConnLocalPort
  2183.  
  2184.  
  2185.  
  2186. White & Moore               Standards Track                    [Page 39]
  2187.  
  2188. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2189.  
  2190.  
  2191.             }
  2192.       ::= { tn3270eTcpConnTable 1 }
  2193.  
  2194.   Tn3270eTcpConnEntry ::=
  2195.       SEQUENCE
  2196.       {
  2197.       tn3270eTcpConnRemAddrType          IANATn3270eAddrType,
  2198.       tn3270eTcpConnRemAddress           IANATn3270eAddress,
  2199.       tn3270eTcpConnRemPort              Unsigned32,
  2200.       tn3270eTcpConnLocalAddrType        IANATn3270eAddrType,
  2201.       tn3270eTcpConnLocalAddress         IANATn3270eAddress,
  2202.       tn3270eTcpConnLocalPort            Unsigned32,
  2203.       tn3270eTcpConnLastActivity         TimeTicks,
  2204.       tn3270eTcpConnBytesIn              Counter32,
  2205.       tn3270eTcpConnBytesOut             Counter32,
  2206.       tn3270eTcpConnResourceElement      SnaResourceName,
  2207.       tn3270eTcpConnResourceType         IANATn3270ResourceType,
  2208.       tn3270eTcpConnDeviceType           IANATn3270DeviceType,
  2209.       tn3270eTcpConnFunctions            IANATn3270Functions,
  2210.       tn3270eTcpConnId                   Unsigned32,
  2211.       tn3270eTcpConnClientIdFormat       IANATn3270eClientType,
  2212.       tn3270eTcpConnClientId             OCTET STRING,
  2213.       tn3270eTcpConnTraceData            Tn3270eTraceData,
  2214.       tn3270eTcpConnLogInfo              IANATn3270eLogData,
  2215.       tn3270eTcpConnLuLuBindImage        OCTET STRING,
  2216.       tn3270eTcpConnSnaState             INTEGER,
  2217.       tn3270eTcpConnStateLastDiscReason  INTEGER,
  2218.       tn3270eTcpConnSrvrConfIndex        Unsigned32,
  2219.       tn3270eTcpConnActivationTime       TimeStamp
  2220.       }
  2221.  
  2222.   tn3270eTcpConnRemAddrType OBJECT-TYPE
  2223.       SYNTAX   IANATn3270eAddrType
  2224.       MAX-ACCESS  not-accessible
  2225.       STATUS      current
  2226.       DESCRIPTION
  2227.           "Indicates the type of the value of the
  2228.           tn3270eTcpConnRemAddress object.  For example,
  2229.           ipv4(1) or ipv6(2)."
  2230.       ::= { tn3270eTcpConnEntry 1 }
  2231.  
  2232.   tn3270eTcpConnRemAddress OBJECT-TYPE
  2233.       SYNTAX      IANATn3270eAddress
  2234.       MAX-ACCESS  not-accessible
  2235.       STATUS      current
  2236.       DESCRIPTION
  2237.           "The remote address associated with a TN3270E client.
  2238.            tn3270eTcpConnRemAddrType indicates the address type
  2239.  
  2240.  
  2241.  
  2242. White & Moore               Standards Track                    [Page 40]
  2243.  
  2244. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2245.  
  2246.  
  2247.            (IPv4 or IPv6, for example).
  2248.  
  2249.            If a TN3270(E) client is connected to its
  2250.            server via a proxy client the address represented by
  2251.            the value of this object shall be the remote client's
  2252.            address, not the proxy client's address."
  2253.       ::= { tn3270eTcpConnEntry 2 }
  2254.  
  2255.   tn3270eTcpConnRemPort OBJECT-TYPE
  2256.       SYNTAX      Unsigned32 (0..65535)
  2257.       MAX-ACCESS  not-accessible
  2258.       STATUS      current
  2259.       DESCRIPTION
  2260.           "The remote port associated with a TN3270E client.  The value 0
  2261.           is used if the tn3270eTcpConnRemAddrType identifies an address
  2262.           type that does not support ports.
  2263.  
  2264.           If a TN3270(E) client is connected to its server via a proxy
  2265.           client, the port represented by the value of this object shall
  2266.           be the remote client's port, not the proxy client's port."
  2267.       ::= { tn3270eTcpConnEntry 3 }
  2268.  
  2269.   tn3270eTcpConnLocalAddrType OBJECT-TYPE
  2270.       SYNTAX   IANATn3270eAddrType
  2271.       MAX-ACCESS  not-accessible
  2272.       STATUS      current
  2273.       DESCRIPTION
  2274.           "Indicates the type of the value of the
  2275.           tn3270eTcpConnLocalAddress object.  For example,
  2276.           ipv4(1) or ipv6(2)."
  2277.       ::= { tn3270eTcpConnEntry 4 }
  2278.  
  2279.   tn3270eTcpConnLocalAddress OBJECT-TYPE
  2280.       SYNTAX      IANATn3270eAddress
  2281.       MAX-ACCESS  not-accessible
  2282.       STATUS      current
  2283.       DESCRIPTION
  2284.           "The local address associated with a TN3270E client.
  2285.            tn3270eTcpConnRemAddrType indicates the address type
  2286.            (IPv4 or IPv6, for example)."
  2287.       ::= { tn3270eTcpConnEntry 5 }
  2288.  
  2289.   tn3270eTcpConnLocalPort OBJECT-TYPE
  2290.       SYNTAX      Unsigned32 (1..65535)
  2291.       MAX-ACCESS  not-accessible
  2292.       STATUS      current
  2293.       DESCRIPTION
  2294.           "The remote port associated with a TN3270E client."
  2295.  
  2296.  
  2297.  
  2298. White & Moore               Standards Track                    [Page 41]
  2299.  
  2300. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2301.  
  2302.  
  2303.       ::= { tn3270eTcpConnEntry 6 }
  2304.  
  2305.   tn3270eTcpConnLastActivity OBJECT-TYPE
  2306.       SYNTAX   TimeTicks
  2307.       MAX-ACCESS  read-only
  2308.       STATUS      current
  2309.       DESCRIPTION
  2310.           "The number of 100ths of seconds since any data was
  2311.            transferred for the associated TCP Connection."
  2312.       DEFVAL  { 0 }
  2313.       ::= { tn3270eTcpConnEntry 7 }
  2314.  
  2315.   tn3270eTcpConnBytesIn OBJECT-TYPE
  2316.       SYNTAX   Counter32
  2317.       UNITS "octets"
  2318.       MAX-ACCESS  read-only
  2319.       STATUS      current
  2320.       DESCRIPTION
  2321.           "The number of bytes received by the server from TCP
  2322.           for this connection.
  2323.  
  2324.           A Management Station can detect discontinuities in
  2325.           this counter by monitoring the
  2326.           tn3270eTcpConnActivationTime object."
  2327.       ::= { tn3270eTcpConnEntry 8 }
  2328.  
  2329.   tn3270eTcpConnBytesOut OBJECT-TYPE
  2330.       SYNTAX   Counter32
  2331.       UNITS "octets"
  2332.       MAX-ACCESS  read-only
  2333.       STATUS      current
  2334.       DESCRIPTION
  2335.           "The number of bytes sent to TCP for this connection.
  2336.  
  2337.           A Management Station can detect discontinuities in
  2338.           this counter by monitoring the
  2339.           tn3270eTcpConnActivationTime object."
  2340.       ::= { tn3270eTcpConnEntry 9 }
  2341.  
  2342.   tn3270eTcpConnResourceElement OBJECT-TYPE
  2343.       SYNTAX   SnaResourceName
  2344.       MAX-ACCESS  read-only
  2345.       STATUS      current
  2346.       DESCRIPTION
  2347.           "LU/Print secondary name for connecting an client
  2348.            into an SNA network."
  2349.       ::= { tn3270eTcpConnEntry 10 }
  2350.  
  2351.  
  2352.  
  2353.  
  2354. White & Moore               Standards Track                    [Page 42]
  2355.  
  2356. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2357.  
  2358.  
  2359.   tn3270eTcpConnResourceType OBJECT-TYPE
  2360.       SYNTAX   IANATn3270ResourceType
  2361.       MAX-ACCESS  read-only
  2362.       STATUS      current
  2363.       DESCRIPTION
  2364.           "Indicates the type of resource identified by
  2365.            tn3270eTcpConnResourceElement."
  2366.       ::= { tn3270eTcpConnEntry 11 }
  2367.  
  2368.   tn3270eTcpConnDeviceType OBJECT-TYPE
  2369.       SYNTAX   IANATn3270DeviceType
  2370.       MAX-ACCESS  read-only
  2371.       STATUS      current
  2372.       DESCRIPTION
  2373.           "Indicates the device type if negotiated with the
  2374.           client.  A value of unknown(100) should be used as
  2375.           the value of this object when a device type is not
  2376.           negotiated.  Refer to RFC 2355 for how device types
  2377.           can be negotiated."
  2378.       ::= { tn3270eTcpConnEntry 12 }
  2379.  
  2380.   tn3270eTcpConnFunctions OBJECT-TYPE
  2381.       SYNTAX   IANATn3270Functions
  2382.       MAX-ACCESS  read-only
  2383.       STATUS      current
  2384.       DESCRIPTION
  2385.           "This object indicates which of the TN3270 and TN3270E
  2386.           functions were negotiated by the server and the client
  2387.           for this TCP connection.
  2388.  
  2389.           Refer to tn3270eSrvrFunctionsSupported for the list of
  2390.           these functions supported by the server."
  2391.       ::= { tn3270eTcpConnEntry 13 }
  2392.  
  2393.   tn3270eTcpConnId OBJECT-TYPE
  2394.       SYNTAX      Unsigned32
  2395.       MAX-ACCESS  read-only
  2396.       STATUS      current
  2397.       DESCRIPTION
  2398.           "The connection identifier associated with a TN3270 or
  2399.            a TN3270E session's TCP connection.  TCP implementations
  2400.            often assign a unique (with respect to itself) unsigned
  2401.            integer as an identifier for a TCP connection.
  2402.  
  2403.            The value 0 indicates that a connection does not have
  2404.            a valid connection identifier."
  2405.       ::= { tn3270eTcpConnEntry 14 }
  2406.  
  2407.  
  2408.  
  2409.  
  2410. White & Moore               Standards Track                    [Page 43]
  2411.  
  2412. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2413.  
  2414.  
  2415.   tn3270eTcpConnClientIdFormat OBJECT-TYPE
  2416.       SYNTAX      IANATn3270eClientType
  2417.       MAX-ACCESS  read-only
  2418.       STATUS      current
  2419.       DESCRIPTION
  2420.           "The format of a corresponding tn3270eTcpConnClientId
  2421.           object as defined by the IANSTn3270eClientType textual
  2422.           convention imported from the IANATn3270eTC-MIB."
  2423.       ::= { tn3270eTcpConnEntry 15 }
  2424.  
  2425.   tn3270eTcpConnClientId OBJECT-TYPE
  2426.       SYNTAX      OCTET STRING (SIZE (0..512))
  2427.       MAX-ACCESS  read-only
  2428.       STATUS      current
  2429.       DESCRIPTION
  2430.           "Additional client identification information.  The
  2431.           type of this information is indicated by the value of
  2432.           the corresponding tn3270eTcpConnClientIdFormat object.
  2433.           All values are returned in network-byte order.
  2434.  
  2435.           The purpose of this object is to provide an alternate
  2436.           means of identifying a client, other than though the
  2437.           remote address returned in tn3270eTcpConnRemAddress."
  2438.       ::= { tn3270eTcpConnEntry 16 }
  2439.  
  2440.   tn3270eTcpConnTraceData OBJECT-TYPE
  2441.       SYNTAX   Tn3270eTraceData
  2442.       MAX-ACCESS  read-only
  2443.       STATUS      current
  2444.       DESCRIPTION
  2445.           "Trace data for this session."
  2446.       ::= { tn3270eTcpConnEntry 17 }
  2447.  
  2448.   tn3270eTcpConnLogInfo OBJECT-TYPE
  2449.       SYNTAX      IANATn3270eLogData
  2450.       MAX-ACCESS  read-only
  2451.       STATUS      current
  2452.       DESCRIPTION
  2453.           "Log information, encoded as specified in the
  2454.           IANATn3270eLogData textual convention from the
  2455.           IANAtn3270eTC-MIB."
  2456.       ::= { tn3270eTcpConnEntry 18 }
  2457.  
  2458.   tn3270eTcpConnLuLuBindImage  OBJECT-TYPE
  2459.       SYNTAX   OCTET STRING (SIZE (0..256))
  2460.       MAX-ACCESS  read-only
  2461.       STATUS      current
  2462.       DESCRIPTION
  2463.  
  2464.  
  2465.  
  2466. White & Moore               Standards Track                    [Page 44]
  2467.  
  2468. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2469.  
  2470.  
  2471.           "When there is a currently active LU-LU session for
  2472.           this connection, this object returns the BIND Image
  2473.           (defined to be bytes 1-p of the complete BIND Request
  2474.           Unit -- see 'SNA Formats' for more information)
  2475.           that was received from the PLU during session
  2476.           activation.  When there is no active LU-LU session,
  2477.           or when a BIND image is unavailable for some other
  2478.           reason, this object returns a zero-length octet
  2479.           string."
  2480.       REFERENCE
  2481.           "'Systems Network Architecture Formats', IBM
  2482.           Publication GA27-3136."
  2483.       ::= { tn3270eTcpConnEntry 19 }
  2484.  
  2485.   tn3270eTcpConnSnaState  OBJECT-TYPE
  2486.       SYNTAX   INTEGER {
  2487.                      unknown(1),
  2488.                      noSluSession(2),
  2489.                      sscpLuSession(3),  -- but no LU-LU session
  2490.                      luLuSession(4),    -- but no SSCP-LU session
  2491.                      sscpLuSessionAndLuLuSession(5)
  2492.                         }
  2493.       MAX-ACCESS  read-only
  2494.       STATUS      current
  2495.       DESCRIPTION
  2496.           "The current state of the SNA side of the end-to-end
  2497.           TN3270 connection.  The following states are defined:
  2498.  
  2499.               unknown(1)          - The true state is not known.
  2500.               noSluSession(2)     - The SLU has neither an SSCP-LU
  2501.                                     nor an LU-LU session active.
  2502.               sscpLuSession(3)    - The SSCP-LU session for the SLU
  2503.                                     is active, but the SLU is not
  2504.                                     currently in session with a PLU.
  2505.               luLuSession(4)      - The SLU is currently in session
  2506.                                     with a PLU, but the SSCP-LU
  2507.                                     session for the LU is not active.
  2508.               sscpLuSessionAndLuLuSession(5) - The SLU currently has
  2509.                                     an active session with a PLU,
  2510.                                     and the SSCP-LU session for the
  2511.                                     SLU is active."
  2512.  
  2513.       ::= { tn3270eTcpConnEntry 20 }
  2514.  
  2515.   tn3270eTcpConnStateLastDiscReason OBJECT-TYPE
  2516.       SYNTAX   INTEGER {
  2517.                     unknown(1),
  2518.                     hostSendsUnbind(2),
  2519.  
  2520.  
  2521.  
  2522. White & Moore               Standards Track                    [Page 45]
  2523.  
  2524. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2525.  
  2526.  
  2527.                     hostDontAcceptConnection(3),
  2528.                     outOfResource(4),
  2529.                     clientProtocolError(5),
  2530.                     invalidDeviceName(6),
  2531.                     deviceInUse(7),
  2532.                     inactivityTimeout(8),
  2533.                     hostNotResponding(9),
  2534.                     clientNotResponding(10),
  2535.                     serverClose(11),
  2536.                     sysreqLogoff(12),
  2537.                     serverSpecificHexCode(13)
  2538.                        }
  2539.       MAX-ACCESS  read-only
  2540.       STATUS      current
  2541.       DESCRIPTION
  2542.           "The last disconnect reason.  A session that has not
  2543.           experienced a disconnect shall use the value unknown(1)
  2544.           for this object.  Depending on when an implementation
  2545.           removes entries from this table, certain states may
  2546.           never be returned."
  2547.       ::= { tn3270eTcpConnEntry 21 }
  2548.  
  2549.   tn3270eTcpConnSrvrConfIndex OBJECT-TYPE
  2550.       SYNTAX      Unsigned32 (1..4294967295)
  2551.       MAX-ACCESS  read-only
  2552.       STATUS      current
  2553.       DESCRIPTION
  2554.           "tn3270eSrvrConfIndex of the tn3270eSrvrConfEntry
  2555.           belonging to the TN3270E server to which this entry
  2556.           belongs."
  2557.       ::= { tn3270eTcpConnEntry 22 }
  2558.  
  2559.   tn3270eTcpConnActivationTime OBJECT-TYPE
  2560.       SYNTAX      TimeStamp
  2561.       MAX-ACCESS  read-only
  2562.       STATUS      current
  2563.       DESCRIPTION
  2564.           "The value of the sysUpTime object the last time
  2565.           this TCP connection became active."
  2566.       ::= { tn3270eTcpConnEntry 23 }
  2567.  
  2568.   tn3270eConfSpinLock OBJECT-TYPE
  2569.       SYNTAX      TestAndIncr
  2570.       MAX-ACCESS  read-write
  2571.       STATUS      current
  2572.       DESCRIPTION
  2573.         "An advisory lock used to allow cooperating
  2574.         TN3270E-MIB applications to coordinate their use
  2575.  
  2576.  
  2577.  
  2578. White & Moore               Standards Track                    [Page 46]
  2579.  
  2580. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2581.  
  2582.  
  2583.         of the tn3270eSrvrConfTable, the tn3270eSrvrPortTable,
  2584.         the tn3270eClientGroupTable, the tn3270eResPoolTable,
  2585.         and the tn3270eClientResMapTable.
  2586.  
  2587.         When creating a new entry or altering an existing entry
  2588.         in the any of the tables mentioned above, an application
  2589.         should make use of tn3270eRtSpinLock to serialize
  2590.         application changes or additions.
  2591.  
  2592.         Since this is an advisory lock, the use of this lock is
  2593.         not enforced."
  2594.       ::= { tn3270eObjects 10 }
  2595.  
  2596.   -- Conformance Definitions
  2597.  
  2598.   tn3270eGroups      OBJECT IDENTIFIER ::= { tn3270eConformance 1 }
  2599.  
  2600.   tn3270eCompliances OBJECT IDENTIFIER ::= { tn3270eConformance 2 }
  2601.  
  2602.   -- compliance statements
  2603.  
  2604.   tn3270eCompliance MODULE-COMPLIANCE
  2605.       STATUS      current
  2606.       DESCRIPTION
  2607.           "The compliance statement for agents that support the
  2608.           TN3270E-MIB."
  2609.       MODULE -- this module
  2610.           MANDATORY-GROUPS { tn3270eBasicGroup,
  2611.                              tn3270eSessionGroup
  2612.                            }
  2613.           GROUP       tn3270eResMapGroup
  2614.           DESCRIPTION
  2615.               "This group is optional and provides a method of
  2616.               performing tn3270eClientGroup to tn3270eResPool
  2617.               mapping."
  2618.  
  2619.           GROUP       tn3270eHiCapacityGroup
  2620.           DESCRIPTION
  2621.               "This group is optional and provides for support
  2622.               of high capacity counters."
  2623.  
  2624.           OBJECT tn3270eSrvrConfConnectivityChk
  2625.              MIN-ACCESS  read-only
  2626.              DESCRIPTION
  2627.                 "The agent is not required to support a set to this
  2628.                  object if the associated TN3270E server doesn't
  2629.                  support either TIMING-MARK or NOP processing.  In
  2630.                  this case an agent should return noCheck on
  2631.  
  2632.  
  2633.  
  2634. White & Moore               Standards Track                    [Page 47]
  2635.  
  2636. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2637.  
  2638.  
  2639.                  retrieval."
  2640.  
  2641.           OBJECT tn3270eSrvrConfTmNopInactTime
  2642.              MIN-ACCESS  read-only
  2643.              DESCRIPTION
  2644.                 "The agent is not required to support a set to this
  2645.                  object if the functions enabled by
  2646.                  tn3270eSrvrConfConnectivityChk are not supported.
  2647.                  An agent in this case should return a value of 0."
  2648.  
  2649.           OBJECT tn3270eSrvrConfTmNopInterval
  2650.              MIN-ACCESS  read-only
  2651.              DESCRIPTION
  2652.                 "The agent is not required to support a set to this
  2653.                  object if the functions enabled by
  2654.                  tn3270eSrvrConfConnectivityChk are not supported.
  2655.                  An agent in this case should return a value of 0."
  2656.  
  2657.          OBJECT  tn3270eSrvrConfAdminStatus
  2658.              DESCRIPTION
  2659.                 "A TN3270E server is not required to support a
  2660.                  stopImmediate state transition."
  2661.  
  2662.           OBJECT tn3270eSrvrConfRowStatus
  2663.              MIN-ACCESS read-only
  2664.              DESCRIPTION
  2665.                  "Write access is not required."
  2666.  
  2667.           OBJECT tn3270eSrvrConfTmTimeout
  2668.              MIN-ACCESS  read-only
  2669.              DESCRIPTION
  2670.                 "The agent is not required to support a set to this
  2671.                  object if the functions enabled by
  2672.                  tn3270eSrvrConfConnectivityChk are not supported.
  2673.                  An agent in this case should return a value of 0."
  2674.  
  2675.           OBJECT tn3270eSrvrPortRowStatus
  2676.              MIN-ACCESS read-only
  2677.              DESCRIPTION
  2678.                  "Write access is not required."
  2679.  
  2680.           OBJECT tn3270eClientGroupRowStatus
  2681.              MIN-ACCESS read-only
  2682.              DESCRIPTION
  2683.                  "Write access is not required."
  2684.  
  2685.           OBJECT tn3270eResPoolRowStatus
  2686.              MIN-ACCESS read-only
  2687.  
  2688.  
  2689.  
  2690. White & Moore               Standards Track                    [Page 48]
  2691.  
  2692. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2693.  
  2694.  
  2695.              DESCRIPTION
  2696.                  "Write access is not required."
  2697.  
  2698.           OBJECT tn3270eClientResMapRowStatus
  2699.              MIN-ACCESS read-only
  2700.              DESCRIPTION
  2701.                  "Write access is not required."
  2702.  
  2703.       ::= { tn3270eCompliances 1 }
  2704.  
  2705.   -- units of conformance
  2706.  
  2707.   tn3270eBasicGroup OBJECT-GROUP
  2708.       OBJECTS {
  2709.           tn3270eSrvrConfInactivityTimeout,
  2710.           tn3270eSrvrConfConnectivityChk,
  2711.           tn3270eSrvrConfTmNopInactTime,
  2712.           tn3270eSrvrConfTmNopInterval,
  2713.           tn3270eSrvrFunctionsSupported,
  2714.           tn3270eSrvrConfAdminStatus,
  2715.           tn3270eSrvrConfOperStatus,
  2716.           tn3270eSrvrConfSessionTermState,
  2717.           tn3270eSrvrConfSrvrType,
  2718.           tn3270eSrvrConfContact,
  2719.           tn3270eSrvrConfRowStatus,
  2720.           tn3270eSrvrConfLastActTime,
  2721.           tn3270eSrvrConfTmTimeout,
  2722.           tn3270eSrvrPortRowStatus,
  2723.           tn3270eSrvrStatsUpTime,
  2724.           tn3270eSrvrStatsMaxTerms,
  2725.           tn3270eSrvrStatsInUseTerms,
  2726.           tn3270eSrvrStatsSpareTerms,
  2727.           tn3270eSrvrStatsMaxPtrs,
  2728.           tn3270eSrvrStatsInUsePtrs,
  2729.           tn3270eSrvrStatsSparePtrs,
  2730.           tn3270eSrvrStatsInConnects,
  2731.           tn3270eSrvrStatsConnResrceRejs,
  2732.           tn3270eSrvrStatsDisconnects,
  2733.           tn3270eSrvrStatsInOctets,
  2734.           tn3270eSrvrStatsOutOctets,
  2735.           tn3270eSrvrStatsConnErrorRejs,
  2736.           tn3270eClientGroupSubnetMask,
  2737.           tn3270eClientGroupPfxLength,
  2738.           tn3270eClientGroupRowStatus,
  2739.           tn3270eSnaMapLocalName,
  2740.           tn3270eSnaMapPrimaryLuName,
  2741.           tn3270eConfSpinLock
  2742.       }
  2743.  
  2744.  
  2745.  
  2746. White & Moore               Standards Track                    [Page 49]
  2747.  
  2748. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2749.  
  2750.  
  2751.       STATUS  current
  2752.       DESCRIPTION
  2753.           "This group is mandatory for all hosts supporting the
  2754.            TN3270E-MIB."
  2755.       ::= { tn3270eGroups 1 }
  2756.  
  2757.   tn3270eSessionGroup OBJECT-GROUP
  2758.       OBJECTS {
  2759.           tn3270eResMapAddrType,
  2760.           tn3270eResMapAddress,
  2761.           tn3270eResMapPort,
  2762.           tn3270eResMapElementType,
  2763.           tn3270eResMapSscpSuppliedName,
  2764.           tn3270eTcpConnLastActivity,
  2765.           tn3270eTcpConnBytesIn,
  2766.           tn3270eTcpConnBytesOut,
  2767.           tn3270eTcpConnResourceElement,
  2768.           tn3270eTcpConnResourceType,
  2769.           tn3270eTcpConnDeviceType,
  2770.           tn3270eTcpConnFunctions,
  2771.           tn3270eTcpConnSrvrConfIndex,
  2772.           tn3270eTcpConnActivationTime
  2773.         }
  2774.       STATUS  current
  2775.       DESCRIPTION
  2776.           "This group is mandatory for all hosts supporting the
  2777.            TN3270E-MIB."
  2778.       ::= { tn3270eGroups 2 }
  2779.  
  2780.   tn3270eResMapGroup OBJECT-GROUP
  2781.       OBJECTS {
  2782.           tn3270eResPoolElementType,
  2783.           tn3270eResPoolRowStatus,
  2784.           tn3270eClientResMapRowStatus,
  2785.           tn3270eTcpConnId,
  2786.           tn3270eTcpConnClientIdFormat,
  2787.           tn3270eTcpConnClientId,
  2788.           tn3270eTcpConnTraceData,
  2789.           tn3270eTcpConnLogInfo,
  2790.           tn3270eTcpConnLuLuBindImage,
  2791.           tn3270eTcpConnSnaState,
  2792.           tn3270eTcpConnStateLastDiscReason
  2793.         }
  2794.       STATUS  current
  2795.       DESCRIPTION
  2796.           "This group is optional for all hosts supporting the
  2797.            TN3270E-MIB."
  2798.       ::= { tn3270eGroups 3 }
  2799.  
  2800.  
  2801.  
  2802. White & Moore               Standards Track                    [Page 50]
  2803.  
  2804. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2805.  
  2806.  
  2807.   tn3270eHiCapacityGroup OBJECT-GROUP
  2808.       OBJECTS {
  2809.           tn3270eSrvrStatsHCInOctets,
  2810.           tn3270eSrvrStatsHCOutOctets
  2811.         }
  2812.       STATUS  current
  2813.       DESCRIPTION
  2814.            "Support of these objects is REQUIRED when the
  2815.            Counter32 versions can potentially wrap too
  2816.            frequently.  This group is optional for all other
  2817.            hosts supporting the TN3270E-MIB.
  2818.  
  2819.            The IF-MIB (RFC 2233) requires that the 64-bit
  2820.            versions of its counters be implemented when an
  2821.            interface can support rates of around 20 million
  2822.            bits per second or greater.  This implies a minimum
  2823.            wrap rate of just over 28 minutes.  It is recommended
  2824.            that this same guideline be used for determining
  2825.            whether an implementation implements these objects.
  2826.  
  2827.            This group contains two objects with the syntax
  2828.            Counter64.  An implementation that doesn't support
  2829.            these objects should return noSuchObject, since
  2830.            returning a zero is misleading."
  2831.  
  2832.       ::= { tn3270eGroups 4 }
  2833.  
  2834.   END
  2835.  
  2836. 5.0  Security Considerations
  2837.  
  2838.    Certain management information defined in this MIB may be considered
  2839.    sensitive in some network environments.  Therefore, authentication of
  2840.    received SNMP requests and controlled access to management
  2841.    information SHOULD be employed in such environments.  An
  2842.    authentication protocol is defined in [12].  A protocol for access
  2843.    control is defined in [15].
  2844.  
  2845.    Several objects in this MIB allow write access or provide for row
  2846.    creation.  Allowing this support in a non-secure environment can have
  2847.    a negative effect on network operations.  It is RECOMMENDED that
  2848.    implementers seriously consider whether set operations or row
  2849.    creation should be allowed without providing, at a minimum,
  2850.    authentication of request origin.  It is RECOMMENDED that without
  2851.    such support, the following objects be implemented as read-only:
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858. White & Moore               Standards Track                    [Page 51]
  2859.  
  2860. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2861.  
  2862.  
  2863.    o   tn3270eSrvrConfInactivityTimout
  2864.    o   tn3270eSrvrConfConnectivityChk
  2865.    o   tn3270eSrvrConfActivityTimeout
  2866.    o   tn3270eSrvrConfActivityInterval
  2867.    o   tn3270eSrvrConfAdminStatus
  2868.    o   tn3270eSrvrConfSessionTermState
  2869.    o   tn3270eSrvrConfContact
  2870.    o   tn3270eClientGroupSubnetMask
  2871.    o   tn3270eResPoolElementType
  2872.    o   tn3270eSrvrConfRowStatus
  2873.    o   tn3270eSrvrPortRowStatus
  2874.    o   tn3270eClientGroupRowStatus
  2875.    o   tn3270eResPoolRowStatus
  2876.    o   tn3270eResMapRowStatus
  2877.  
  2878.    For all tables in the MIB except the tn3270eTcpConnTable, the first
  2879.    index identifies an individual TN3270E server.  This makes it easy to
  2880.    implement an access control policy under which different principals
  2881.    have access to objects related to different servers.  Implementation
  2882.    of such a policy is not possible for the entries in the
  2883.    tn3270eTcpConTable.
  2884.  
  2885. 6.0  Intellectual Property
  2886.  
  2887.    The IETF takes no position regarding the validity or scope of any
  2888.    intellectual property or other rights that might be claimed to
  2889.    pertain to the implementation or use of the technology described in
  2890.    this document or the extent to which any license under such rights
  2891.    might or might not be available; neither does it represent that it
  2892.    has made any effort to identify any such rights.  Information on the
  2893.    IETF's procedures with respect to rights in standards-track and
  2894.    standards-related documentation can be found in BCP-11.  Copies of
  2895.    claims of rights made available for publication and any assurances of
  2896.    licenses to be made available, or the result of an attempt made to
  2897.    obtain a general license or permission for the use of such
  2898.    proprietary rights by implementers or users of this specification can
  2899.    be obtained from the IETF Secretariat.
  2900.  
  2901.    The IETF invites any interested party to bring to its attention any
  2902.    copyrights, patents or patent applications, or other proprietary
  2903.    rights which may cover technology that may be required to practice
  2904.    this standard.  Please address the information to the IETF Executive
  2905.    Director.
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914. White & Moore               Standards Track                    [Page 52]
  2915.  
  2916. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2917.  
  2918.  
  2919. 7.0  Acknowledgments
  2920.  
  2921.    This document is a product of the TN3270E Working Group.  Thanks to
  2922.    Randy Presuhn of BMC Software for his valuable review comments on
  2923.    several versions of the document.
  2924.  
  2925. 8.0  References
  2926.  
  2927.    [1]  Harrington D., Presuhn, R. and B. Wijnen, "An Architecture for
  2928.         Describing SNMP Management Frameworks", RFC 2271, January 1998.
  2929.  
  2930.    [2]  Rose, M. and K. McCloghrie, "Structure and Identification of
  2931.         Management Information for TCP/IP-based Internets", STD 16, RFC
  2932.         1155, May 1990
  2933.  
  2934.    [3]  Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16,
  2935.         RFC 1212, March 1991.
  2936.  
  2937.    [4]  Rose, M., "A Convention for Defining Traps for use with the
  2938.         SNMP", RFC 1215, Performance Systems International, March 1991
  2939.  
  2940.    [5]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Structure
  2941.         of Management Information for Version 2 of the Simple Network
  2942.         Management Protocol (SNMPv2)", RFC 1902, January 1996.
  2943.  
  2944.    [6]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Textual
  2945.         Conventions for Version 2 of the Simple Network Management
  2946.         Protocol (SNMPv2)", RFC 1903, January 1996.
  2947.  
  2948.    [7]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
  2949.         "Conformance Statements for Version 2 of the Simple Network
  2950.         Management Protocol (SNMPv2)", RFC 1904, January 1996.
  2951.  
  2952.    [8]  Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple
  2953.         Network Management Protocol", STD 15, RFC 1157, May 1990.
  2954.  
  2955.    [9]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
  2956.         "Introduction to Community-based SNMPv2", RFC 1901, January
  2957.         1996.
  2958.  
  2959.    [10] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Transport
  2960.         Mappings for Version 2 of the Simple Network Management Protocol
  2961.         (SNMPv2)", RFC 1906, January 1996.
  2962.  
  2963.    [11] Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message
  2964.         Processing and Dispatching for the Simple Network Management
  2965.         Protocol (SNMP)", RFC 2272, January 1998.
  2966.  
  2967.  
  2968.  
  2969.  
  2970. White & Moore               Standards Track                    [Page 53]
  2971.  
  2972. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  2973.  
  2974.  
  2975.    [12] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM)
  2976.         for version 3 of the Simple Network Management Protocol
  2977.         (SNMPv3)", RFC 2274, January 1998.
  2978.  
  2979.    [13] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Protocol
  2980.         Operations for Version 2 of the Simple Network Management
  2981.         Protocol (SNMPv2)", RFC 1905, January 1996.
  2982.  
  2983.    [14] Levi, D., Meyer, P. and B. Stewart, "SNMPv3 Applications", RFC
  2984.         2273, January 1998.
  2985.  
  2986.    [15] Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access
  2987.         Control Model (VACM) for the Simple Network Management Protocol
  2988.         (SNMP)", RFC 2275, January 1998.
  2989.  
  2990.    [16] Postel, J. and J. Reynolds, "Telnet Protocol Specification", STD
  2991.         8, RFC 854, May 1983.
  2992.  
  2993.    [17] Postel, J. and J. Reynolds, "Telnet Timing Mark Option", STD 31,
  2994.         RFC 860, May 1983.
  2995.  
  2996.    [18] Rekhter, J., "Telnet 3270 Regime Option", RFC 1041, January
  2997.         1988.
  2998.  
  2999.    [19] Kelly, B., "TN3270 Enhancements", RFC 2355, June 1998.
  3000.  
  3001.         [20] McCloghrie, K., "TCP-MIB Definitions", RFC 2012, November
  3002.         1996.
  3003.  
  3004.    [21] Hovey, R. and S. Bradner, "The Organizations Involved in the
  3005.         IETF Standards Process", BCP 11, RFC 2028, October 1996.
  3006.  
  3007.    [22] Bradner, S., "Key words for use in RFCs to Indicate Requirement
  3008.         Levels", BCP 14, RFC 2119, March 1997.
  3009.  
  3010.    [23] Hinden, R. and S. Deering, "IP Version 6 Addressing
  3011.         Architecture", RFC 2373, July 1998.
  3012.  
  3013.    [24] Krupczak, C. and J. Saperia, "Definitions of System-Level
  3014.         Managed Objects for Applications", RFC 2287, February 1998.
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026. White & Moore               Standards Track                    [Page 54]
  3027.  
  3028. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  3029.  
  3030.  
  3031. 9.0  Authors' Addresses
  3032.  
  3033.    Kenneth D. White
  3034.    Dept. BRQA/Bldg. 501/G114
  3035.    IBM Corporation
  3036.    P.O.Box 12195
  3037.    3039 Cornwallis
  3038.    Research Triangle Park, NC 27709, USA
  3039.  
  3040.    EMail: kennethw@vnet.ibm.com
  3041.  
  3042.  
  3043.    Robert Moore
  3044.    Dept. BRQA/Bldg. 501/G114
  3045.    IBM Corporation
  3046.    P.O.Box 12195
  3047.    3039 Cornwallis
  3048.    Research Triangle Park, NC 27709, USA
  3049.  
  3050.    Phone: +1-919-254-4436
  3051.    EMail: remoore@us.ibm.com
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082. White & Moore               Standards Track                    [Page 55]
  3083.  
  3084. RFC 2561                TN3270E Using SMIv2 MIB               April 1999
  3085.  
  3086.  
  3087. Full Copyright Statement
  3088.  
  3089.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  3090.  
  3091.    This document and translations of it may be copied and furnished to
  3092.    others, and derivative works that comment on or otherwise explain it
  3093.    or assist in its implementation may be prepared, copied, published
  3094.    and distributed, in whole or in part, without restriction of any
  3095.    kind, provided that the above copyright notice and this paragraph are
  3096.    included on all such copies and derivative works.  However, this
  3097.    document itself may not be modified in any way, such as by removing
  3098.    the copyright notice or references to the Internet Society or other
  3099.    Internet organizations, except as needed for the purpose of
  3100.    developing Internet standards in which case the procedures for
  3101.    copyrights defined in the Internet Standards process must be
  3102.    followed, or as required to translate it into languages other than
  3103.    English.
  3104.  
  3105.    The limited permissions granted above are perpetual and will not be
  3106.    revoked by the Internet Society or its successors or assigns.
  3107.  
  3108.    This document and the information contained herein is provided on an
  3109.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  3110.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  3111.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  3112.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  3113.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138. White & Moore               Standards Track                    [Page 56]
  3139.  
  3140.