home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_q_t / draft-ietf-tn3270e-tn3270-mib-03.txt < prev    next >
Text File  |  1997-09-15  |  75KB  |  2,279 lines
  1.  
  2.  
  3.  
  4. TN3270E Working Group
  5. INTERNET DRAFT: <draft-ietf-tn3270e-tn3270-mib-03.txt>     Kenneth White
  6. Expiration Date: March, 1998
  7.                                                                IBM Corp.
  8.  
  9.                                                           September 1997
  10.  
  11.                 Base Definitions of Managed Objects for
  12.                           TN3270E Using SMIv2
  13.  
  14.                  <draft-ietf-tn3270e-tn3270-mib-03.txt>
  15.  
  16.  
  17. Status of this Memo
  18.  
  19.   This document is an Internet Draft. Internet Drafts are working
  20.   documents of the Internet Engineering Task Force (IETF), its Areas,
  21.   and its Working Groups. Note that other groups may also distribute
  22.   working documents as Internet Drafts.
  23.  
  24.   Internet Drafts are draft documents valid for a maximum of six
  25.   months. Internet Drafts may be updated, replaced, or obsoleted by
  26.   other documents at any time. It is not appropriate to use Internet
  27.   Drafts as reference material or to cite them other than as a "working
  28.   draft" or "work in progress."
  29.  
  30.   Please check the I-D abstract listing contained in each Internet
  31.   Draft directory to learn the current status of this or any Internet
  32.   Draft. Distribution of this document is unlimited.
  33.  
  34. Abstract
  35.  
  36.   The purpose of this memo is to define a Management Information Base
  37.   (MIB) for configuring and managing TN3270E Servers.
  38.   The MIB defined by this memo is intended to provide generic
  39.   support for both Host and Gateway TN3270E server implementations.
  40.   It is the intent that the MIB defined herein be extended
  41.   by subsequent memos to provide non-generic configuration support
  42.   and to enable TN3270E Response Time Collection.
  43.  
  44.   It is the intent of this MIB to fully adhere to all prerequisite MIBs
  45.   unless explicitly stated. Deviations will be documented in
  46.   corresponding conformance statements. The specification of this MIB
  47.   will utilize the Structure of Management Information (SMI) for
  48.   Version 2 of the Simple Network Management Protocol Version (refer to
  49.   RFC1902, reference [1]).
  50.  
  51.   Table of Contents
  52.  
  53.  
  54.  
  55. Expires March 1998                                              [Page 1]
  56.  
  57.  
  58.  
  59.  
  60.  
  61. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  62.  
  63.  
  64.  
  65.   1.0 Introduction............................................. 2
  66.   2.0 The SNMPv2 Network Management Framework.................. 2
  67.   2.1 Object Definitions....................................... 3
  68.   3.0 Structure of the MIB..................................... 3
  69.   3.1 TN3270E Server Control................................... 4
  70.   3.1.1 tn3270eSrvrConfTable................................... 4
  71.   3.1.2 tn3270eSrvrPortTable................................... 5
  72.   3.1.3 tn3270eSrvrStatsTable.................................. 5
  73.   3.2 TN3270E Server Resource Configuration.................... 6
  74.   3.3 Resource/Client Address Mappings......................... 6
  75.   3.3.1 tn3270eSnaMapTable..................................... 6
  76.   3.3.2 tn3270eResMapTable..................................... 6
  77.   3.3.3 TCP Connection Table Additions......................... 6
  78.   4.0 Definitions.............................................. 7
  79.   5.0 Security Considerations..................................36
  80.   6.0 Acknowledgments..........................................36
  81.   7.0 References...............................................37
  82.   8.0 Authors' Address.........................................38
  83.  
  84.  
  85. 1.  Introduction
  86.  
  87.   This document is a product of the TN3270E Working Group.  Its purpose
  88.   is to define a MIB module for extending the traditional MIBs supported
  89.   by a TCP/IP implementation for configuration and management of TN3270E
  90.   servers.
  91.  
  92.  
  93. 2.  The SNMPv2 Network Management Framework
  94.  
  95.   The SNMP Network Management Framework presently consists of three
  96.   major components.  They are:
  97.  
  98.   o the SMI, described in RFC 1902 [1], - the mechanisms used for
  99.     describing and naming objects for the purpose of management.
  100.  
  101.   o the MIB-II, STD 17, RFC 1213 [5], - the core set of managed
  102.     objects for the Internet suite of protocols.
  103.  
  104.   o the protocol, RFC 1157 [9] and/or RFC 1905 [7] - the protocol
  105.     for accessing managed information.
  106.  
  107.   Textual conventions are defined in RFC 1903 [6], and conformance
  108.   statements are defined in RFC 1904 [8].
  109.  
  110.   The Framework permits new objects to be defined for the purpose of
  111.   experimentation and evaluation.
  112.  
  113.  
  114.  
  115.  
  116. Expires March 1998                                              [Page 2]
  117.  
  118.  
  119.  
  120.  
  121.  
  122. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  123.  
  124.  
  125.   This memo specifies a MIB module that is compliant to the SNMPv2 SMI.
  126.   A semantically identical MIB conforming to the SNMPv1 SMI can be
  127.   produced through the appropriate translation.
  128.  
  129.  
  130. 2.1.  Object Definitions
  131.  
  132.   Managed objects are accessed via a virtual information store, termed
  133.   the Management Information Base or MIB.  Objects in the MIB are
  134.   defined using the subset of Abstract Syntax Notation One (ASN.1)
  135.   defined in the SMI.  In particular, each object object type is named
  136.   by an OBJECT IDENTIFIER, an administratively assigned name.  The
  137.   object type together with an object instance serves to uniquely
  138.   identify a specific instantiation of the object.  For human
  139.   convenience, we often use a textual string, termed the descriptor, to
  140.   refer to the object type.
  141.  
  142.  
  143.  
  144. 3.  Structure of the MIB
  145.  
  146.   The TN3270E-MIB is split into the following components:
  147.  
  148.     o TN3270E Server Control
  149.     o TN3270E Server Resource Configuration
  150.     o Resource/Client Address Mappings
  151.  
  152.   The TN3270E-MIB is defined primarily for TN3270E servers.  This memo
  153.   does not explicitly address use of the MIB by TN3270 servers that do
  154.   not support the TN3270E protocol.  Although a significant number of
  155.   the objects do apply in the TN3270-only case, the case was not
  156.   addressed since it is unlikely that a TN3270-only server would
  157.   implement this MIB.
  158.  
  159.   The SYSAPPL-MIB, reference [12], is a prerequisite for the TN3270E-
  160.   MIB, so that the Utf8String Textual Convention (TC) can be imported.
  161.   This TC, which is used for some MIB objects containing textual
  162.   information, enables internationalization of text strings, whereas the
  163.   DisplayString TC does not.
  164.  
  165.   The MIB defined by this memo handles both IPv4 and IPv6 addressing.
  166.   Two Textual Conventions, Tn3270eAddrType and Tn3270eTAddress, are
  167.   defined for this purpose.  Tn3270eTAddress is essentially equivalent
  168.   to TAddress, defined by RFC 1903.  The difference is that
  169.   Tn3270eTAddress allows a null-length octet string, while TAddress
  170.   doesn't.  Allowing a null IP Address is important, since in places
  171.   Tn3270eTAddress object values are used as a component of an object
  172.   instance, and need not actually contain an IP Address. In general, use
  173.  
  174.  
  175.  
  176. Expires March 1998                                              [Page 3]
  177.  
  178.  
  179.  
  180.  
  181.  
  182. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  183.  
  184.  
  185.   of Tn3270eTAddress replaces the prior use of IpAddress to represent IP
  186.   Addresses.
  187.  
  188.   Tn3270eAddrType is functionally equivalent to the TDomain TC, also
  189.   defined by RFC 1903.  TDomain uses an OID to identify the contents of
  190.   a TAddress object.  Tn3270eAddrType was chosen over TDomain because,
  191.   with a SYNTAX of Unsigned32 (enumeration type), it is much simpler
  192.   than an OID to specify in an instance identifier.
  193.  
  194.  
  195. 3.1.  TN3270E Server Control
  196.  
  197.   This group of objects provides for TN3270E server configuration, and
  198.   consists of:
  199.  
  200.       o tn3270eSrvrConfTable
  201.       o tn3270eSrvrPortTable
  202.       o tn3270eSrvrStatsTable
  203.  
  204.  
  205. 3.1.1.  tn3270eSrvrConfTable
  206.  
  207.   The tn3270eSrvrConfTable contains a set of objects primarily for
  208.   configuring and managing a TN3270E server.  As with most of the other
  209.   tables in the TN3270E-MIB, this table is indexed by an unsigned
  210.   integer, tn3270eSrvrConfIndex.  This primary index element enables
  211.   support of multiple TN3270E servers on the same host.  Within a host,
  212.   tn3270eSrvrConfIndex values must be unique, and need not be
  213.   contiguous; otherwise these values are implementation-dependent.
  214.  
  215.   An earlier version of this memo had used the local IP Address
  216.   associated with a TN3270E server along with tn3270eSrvrConfIndex as
  217.   the primary indexes into most of its tables.  Use of a local IP
  218.   Address was thought to enable use of these tables by management
  219.   applications.  This approach was dropped, since it introduces a level
  220.   of complexity into MIB table indexing for little actual benefit.
  221.  
  222.   tn3270eSrvrConfInactivityTimer defines the inactivity period for
  223.   TN3270 and TN3270E Sessions. tn3270eSrvrConfSessionTermState defines
  224.   how a session should be terminated. The three objects:
  225.  
  226.       o tn3270eSrvrConfActivityCheck
  227.       o tn3270eSrvrConfActivityTimeout
  228.       o tn3270eSrvrConfActivityInterval
  229.  
  230.   define the parameters for performing the "Telnet Timing Mark Option"
  231.   as defined by RFC 860 [3].  The object tn3270eSrvrConfActivityCheck is
  232.   defined to enable selection of either a NOP command or a TIMEMARK
  233.  
  234.  
  235.  
  236. Expires March 1998                                              [Page 4]
  237.  
  238.  
  239.  
  240.  
  241.  
  242. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  243.  
  244.  
  245.   command.  Sending a NOP command results in less overhead then a
  246.   TIMEMARK command, since a client doesn't send a reply.
  247.  
  248.   The objects tn3270eSrvrConfAdminStatus and tn3270eSrvrConfOperStatus
  249.   enable remote starting and stopping of a TN3270E server.
  250.   tn3270eSrvrConfFunctionsSupported indicates which of the TN3270 and
  251.   TN3270E options a server supports.  The object
  252.   tn3270eSrvrConfSessionTermState defines as a global option the
  253.   processing steps that a TN3270E server should perform when a TN3270E
  254.   session terminates with respect to the associated TCP connection.  The
  255.   object tn3270eSrvrConfSrvrType indicates whether the TN3270E server
  256.   represented by the tn3270eSrvrConfEntry is a host or a gateway server.
  257.   The object tn3270eSrvrConfContact provides a scratch pad area for a
  258.   TN3270E server administrator to store information for later retrieval.
  259.   The object tn3270eSrvrConfRowStatus provides the capability to perform
  260.   remote creation and deletion operations on this table.
  261.  
  262.  
  263. 3.1.2.  tn3270eSrvrPortTable
  264.  
  265.   The tn3270eSrvrPortTable exists in order to assign and retrieve the
  266.   local TCP ports associated with a TN3270E server, since some TN3270E
  267.   server implementations support multiple local ports.  A
  268.   tn3270eSrvrPortEntry is indexed by:
  269.  
  270.       o tn3270eSrvrConfIndex
  271.       o tn3270eSrvrConfPort
  272.       o tn3270eSrvrConfPortAddrType
  273.       o tn3270eSrvrConfPortAddress
  274.  
  275.   Certain TN3270E server implementations retrict a local TCP port to a
  276.   particular local IP Address, instead of allowing connections for any
  277.   local IP Address to occur via the port.  tn3270eSrvrConfPortAddrType
  278.   and tn3270eSrvrConfPortAddress allow this restriction to be
  279.   represented in the MIB.  A TN3270E server that doesn't restrict
  280.   connections over a port to a local IP Address should use the value
  281.   'unknown(0)' for tn3270eSrvrConfPortAddrType, and a null octet string
  282.   for tn3270eSrvrConfPortAddress.
  283.  
  284.  
  285. 3.1.3.  tn3270eSrvrStatsTable
  286.  
  287.   The tn3270eSrvrStatsTable defines a series of objects used to provide
  288.   general statistics on the use of a TN3270E server.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296. Expires March 1998                                              [Page 5]
  297.  
  298.  
  299.  
  300.  
  301.  
  302. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  303.  
  304.  
  305. 3.2.  TN3270E Server Resource Configuration
  306.  
  307. The TN3270E Server Resource Configuration collection of objects consists
  308. of three tables:
  309.  
  310.     o tn3270eClientGroupTable
  311.     o tn3270eResPoolTable
  312.     o tn3270eClientResMapTable
  313.  
  314. tn3270eClientGroupTable and tn3270eResPoolTable enable implementations
  315. to define groupings of both client addresses and resource pools for
  316. mapping client addresses to resources. The mapping of a client group to
  317. a resource pool is enabled via the tn3270eClientResMapTable.
  318.  
  319.  
  320.  
  321. 3.3.  Resource/Client Address Mappings
  322.  
  323. Three tables are defined by this memo to enable mapping of resource
  324. names to client addresses, and client addresses to resource names:
  325.  
  326.     o tn3270eSnaMapTable
  327.     o tn3270eResMapTable
  328.     o TCP Connection Table Additions
  329.  
  330.  
  331. 3.3.1.  tn3270eSnaMapTable
  332.  
  333. The tn3270eSnaMapTable is a read-only table that maps a secondary LU's
  334. SNA network name to the name by which it is known locally at the TN3270e
  335. server. An entry in this table is created when the Activate LU (ACTLU)
  336. request carrying the SNA network name of the SLU is received from the
  337. SSCP.  The entry is deleted when the SLU is deactivated.
  338.  
  339.  
  340. 3.3.2.  tn3270eResMapTable
  341.  
  342. The tn3270eResMapTable is a read-only table that maps a resource name to
  343. a client's address. An entry in this table is created when a TCP
  344. connection is received by a TN3270E server and mapped to a resource. The
  345. entry is deleted when the resource-to-address association is no longer
  346. valid.
  347.  
  348.  
  349.  
  350. 3.3.3.  TCP Connection Table Additions
  351.  
  352. The TCP Connection Table is defined by RFC 2012 (Refer to reference 10,
  353.  
  354.  
  355.  
  356. Expires March 1998                                              [Page 6]
  357.  
  358.  
  359.  
  360.  
  361.  
  362. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  363.  
  364.  
  365. TCP-MIB Definitions). Traditionally, the contents of the TCP Connection
  366. Table have been implementation-dependent.  Its formal definition
  367. consists of the following objects:
  368.  
  369.    o tcpConnState (INTEGER)
  370.    o tcpConnLocalAddress (IpAddress)
  371.    o tcpConnLocalPort (INTEGER)
  372.    o tcpConnRemAddress (IpAddress)
  373.    o tcpConnRemPort (INTEGER)
  374.  
  375. It is indexed by: tcpConnLocalAddress, tcpConnLocalPort,
  376. tcpConnRemAddress, and tcpConnRemPort.
  377.  
  378. The tn3270eTcpConnTable contains objects for keeping a list of the
  379. current set of TN3270 and TN3270E sessions at a TN3270E server.  The
  380. relationship between the tcpConnTable and the Tn3270eTcpConnTable is not
  381. one-to-one, since the tn3270eTcpConnTable contains information
  382. pertaining only to TN3270(E) sessions.
  383.  
  384. The tn3270eTcpConnTable has a different indexing structure from that of
  385. the tcpConnTable. Instead of using IpAddress objects, Tn3270eTAddress
  386. and Tn3270eAddrType object pairs are used to specify client addresses
  387. (both local and remote). This enables support of IPv6 addresses. In
  388. addition, the remote address pair precedes the local address pair in the
  389. index clause, in order to enable a GET-NEXT operation using only the
  390. remote address pair.
  391.  
  392.  
  393. 4.  Definitions
  394.  
  395.   TN3270E-MIB DEFINITIONS ::= BEGIN
  396.  
  397.   IMPORTS
  398.       MODULE-IDENTITY, OBJECT-TYPE, BITS, Unsigned32,
  399.       experimental, TimeTicks, IpAddress,
  400.       Counter32, Gauge32, Counter64
  401.           FROM SNMPv2-SMI
  402.       TEXTUAL-CONVENTION, RowStatus
  403.           FROM SNMPv2-TC
  404.       MODULE-COMPLIANCE, OBJECT-GROUP
  405.           FROM SNMPv2-CONF
  406.       Utf8String
  407.           FROM SYSAPPL-MIB;
  408.  
  409.   tn3270eMIB MODULE-IDENTITY
  410.       LAST-UPDATED "9709130000Z" -- September 13, 1997
  411.       ORGANIZATION "TN3270E Working Group"
  412.       CONTACT-INFO
  413.  
  414.  
  415.  
  416. Expires March 1998                                              [Page 7]
  417.  
  418.  
  419.  
  420.  
  421.  
  422. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  423.  
  424.  
  425.           "Kenneth White (kennethw@vnet.ibm.com)
  426.            IBM Corp."
  427.       DESCRIPTION
  428.           "This module defines a portion of the management
  429.           information base (MIB) for managing TN3270E servers"
  430.       ::= { experimental 80 }
  431.  
  432.   -- Textual Conventions
  433.  
  434.   SnaResourceName ::= TEXTUAL-CONVENTION
  435.       STATUS      current
  436.       DESCRIPTION
  437.           "The textual convention for defining an SNA resource
  438.            name. A fully qualified SNA resource name, consisting of
  439.            a 1 to 8 character network identifier (NetId), a
  440.            period ('.'), and a 1 to 8 character resource name
  441.            (ResName).
  442.  
  443.            The NetId and ResName are constructed from the uppercase
  444.            letter 'A' - 'Z' and the numerics '0' - '9', all encoded
  445.            in ASCII, with the restriction that the first character
  446.            of each must be a letter. Trailing blanks are not allowed.
  447.  
  448.            Earlier versions of SNA permitted three additional
  449.            characters in NetIds and ResNames:  '#', '@', and '$'.
  450.            While this use of these characters has been retired,
  451.            a Management Station should still accept them for
  452.            backward compatibility.
  453.  
  454.            Note: This Textual Convention is not subject to
  455.            internationalization, and does not use the character
  456.            encodings used by the Utf8String Textual Convention."
  457.       SYNTAX     OCTET STRING (SIZE(0..17))
  458.  
  459.   Tn3270eAddrType ::= TEXTUAL-CONVENTION
  460.       STATUS      current
  461.       DESCRIPTION
  462.           "The textual convention for defining the type of an IP
  463.            Address."
  464.       SYNTAX      INTEGER {
  465.                             unknown(0),
  466.                             ipv4(1),
  467.                             ipv6(2)
  468.                           }
  469.  
  470.  
  471.   Tn3270ResourceType ::= TEXTUAL-CONVENTION
  472.       STATUS      current
  473.  
  474.  
  475.  
  476. Expires March 1998                                              [Page 8]
  477.  
  478.  
  479.  
  480.  
  481.  
  482. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  483.  
  484.  
  485.       DESCRIPTION
  486.           "The type of resource defined by a resource pool. Refer
  487.           to tn3270eResPoolTable."
  488.       SYNTAX      INTEGER {
  489.                             other(0),
  490.                             lu(1),
  491.                             printer(2)
  492.                           }
  493.  
  494.   Tn3270eTAddress ::= TEXTUAL-CONVENTION
  495.       STATUS       current
  496.       DESCRIPTION
  497.             "Denotes an IP Address. The type of IP Address is determined
  498.              by use of the Tn3270eAddrType Textual Convention.
  499.              The length in octets of a Tn3270eTAddress object is:
  500.  
  501.               Tn3270eAddrType ENUM
  502.                    unknown(0)             not known, must look at the
  503.                                           actual length of the
  504.                                           Tn3270eTAddress OCTET STRING.
  505.                    ipv4(1)                4 OCTETS
  506.                    ipv6(2)                16 OCTETS
  507.  
  508.             This textual convention is similar to the TAddress TC
  509.             defined by RFC1903 except that it allows a zero length
  510.             OCTET STRING and is not a full transport layer address."
  511.       SYNTAX       OCTET STRING (SIZE (0..255))
  512.  
  513.   Tn3270Functions ::= TEXTUAL-CONVENTION
  514.       STATUS      current
  515.       DESCRIPTION
  516.           "This textual convention is intended to reflect the
  517.           current set of TN3270 and TN3270E functions that can
  518.           be negotiated between a server and its client:
  519.  
  520.           RFC856
  521.           transmitBinary    The sender of this command REQUESTS
  522.                             permission to begin transmitting, or
  523.                             confirms that it will now begin transmitting
  524.                             characters which are to be interpreted
  525.                             as 8 bits of binary data by
  526.                             the receiver of the data.
  527.           RFC820
  528.           timeMark         The sender of this command REQUESTS that
  529.                            the receiver of this command return a WILL
  530.                            TIMING-MARK in the data stream at the
  531.                            'appropriate place' ...
  532.           RFC885
  533.  
  534.  
  535.  
  536. Expires March 1998                                              [Page 9]
  537.  
  538.  
  539.  
  540.  
  541.  
  542. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  543.  
  544.  
  545.           endOfRecord      The sender of this command requests
  546.                            permission to begin transmission of the
  547.                            Telnet END-OF-RECORD (EOR) code when
  548.                            transmitting data characters, or
  549.                            the sender of this command confirms it will
  550.                            now begin transmission of EORs with
  551.                            transmitted data characters.
  552.           RFC1091
  553.           terminalType     Sender is willing to send terminal type
  554.                            information in a subsequent sub-negotiation.
  555.           RFC1041
  556.           tn3270Regime     Sender is willing to send list of supported
  557.                            3270 Regimes in a subsequent sub-negotiation.
  558.           RFC1647
  559.           scsCtlCodes     (Printer sessions only).  Allows the use
  560.                           of the SNA Character Stream (SCS) and SCS
  561.                           control codes on the session.  SCS is
  562.                           used with LU type 1 SNA sessions.
  563.           dataStreamCtl   (Printer sessions only).  Allows the use
  564.                           of the standard 3270 data stream.  This
  565.                           corresponds to LU type 3 SNA sessions.
  566.           responses       Provides support for positive and
  567.                           negative response handling.  Allows the
  568.                           server to reflect to the client any and
  569.                           all definite, exception, and no response
  570.                           requests sent by the host application.
  571.           bindImage       Allows the server to send the SNA Bind
  572.                           image and Unbind notification to the
  573.                           client.
  574.           sysreq          Allows the client and server to emulate
  575.                           some (or all, depending on the server) of
  576.                           the functions of the SYSREQ key in an SNA
  577.                           environment."
  578.       SYNTAX      BITS {
  579.                          transmitBinary(0),-- rfc856
  580.                          timemark(1),      -- rfc860
  581.                          endOfRecord(2),   -- rfc885
  582.                          terminalType(3),  -- rfc1091
  583.                          tn3270Regime(4),  -- rfc1041
  584.                          scsCtlCodes(5),   -- rfc1647
  585.                          dataStreamCtl(6), -- rfc1647
  586.                          responses(7),     -- rfc1647
  587.                          bindImage(8),     -- rfc1647
  588.                          sysreq(9)         -- rfc1647
  589.                        }
  590.  
  591.   Tn3270DeviceTypes ::= TEXTUAL-CONVENTION
  592.       STATUS      current
  593.  
  594.  
  595.  
  596. Expires March 1998                                             [Page 10]
  597.  
  598.  
  599.  
  600.  
  601.  
  602. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  603.  
  604.  
  605.       DESCRIPTION
  606.           "This textual convention defines the list of device types
  607.           that can be set as defined by RFC 1647."
  608.       SYNTAX      INTEGER { -- terminals
  609.                     unknown(0),
  610.                     ibm3278d2(1),    -- (24 row x 80 col display)
  611.                     ibm3278d2E(2),   -- (24 row x 80 col display)
  612.                     ibm3278d3(3),    -- (32 row x 80 col display)
  613.                     ibm3278d3E(4),   -- (32 row x 80 col display)
  614.                     ibm3278d4(5),    -- (43 row x 80 col display)
  615.                     ibm3278d4E(6),   -- (43 row x 80 col display)
  616.                     ibm3278d5(7),    -- (27 row x 132 col display)
  617.                     ibm3278d5E(8),   -- (27 row x 132 col display)
  618.                     ibmDynamic(9),   -- (no pre-defined display size)
  619.                     ibm3287d1(10)    -- printers
  620.            }
  621.  
  622.   -- Top-level structure of the MIB
  623.  
  624.   tn3270eNotifications  OBJECT IDENTIFIER ::= { tn3270eMIB 0 }
  625.   tn3270eObjects        OBJECT IDENTIFIER ::= { tn3270eMIB 1 }
  626.   tn3270eConformance    OBJECT IDENTIFIER ::= { tn3270eMIB 3 }
  627.  
  628.   -- MIB Objects
  629.  
  630.   tn3270eSrvrConfTable OBJECT-TYPE
  631.       SYNTAX      SEQUENCE OF Tn3270eSrvrConfEntry
  632.       MAX-ACCESS  not-accessible
  633.       STATUS      current
  634.       DESCRIPTION
  635.           "This table defines the configuration elements for
  636.           TN3270E Servers. The number of entries in this table
  637.           is expected to vary depending on the location of the
  638.           table. A particular TN3270E server is expected to
  639.           have a single entry. Modeling of the configuration
  640.           elements as a table allows multiple
  641.           TN3270E Servers to exist at the same host."
  642.       ::= { tn3270eObjects 1 }
  643.  
  644.   tn3270eSrvrConfEntry OBJECT-TYPE
  645.       SYNTAX      Tn3270eSrvrConfEntry
  646.       MAX-ACCESS  not-accessible
  647.       STATUS      current
  648.       DESCRIPTION
  649.           "Definition of the configuration elements for a single
  650.           TN3270E server."
  651.       INDEX       { tn3270eSrvrConfIndex }
  652.       ::= { tn3270eSrvrConfTable 1 }
  653.  
  654.  
  655.  
  656. Expires March 1998                                             [Page 11]
  657.  
  658.  
  659.  
  660.  
  661.  
  662. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  663.  
  664.  
  665.   Tn3270eSrvrConfEntry ::= SEQUENCE {
  666.       tn3270eSrvrConfIndex             Unsigned32,
  667.       tn3270eSrvrConfInactivityTimeout Unsigned32,
  668.       tn3270eSrvrConfActivityCheck     INTEGER,
  669.       tn3270eSrvrConfActivityTimeout   Unsigned32,
  670.       tn3270eSrvrConfActivityInterval  Unsigned32,
  671.       tn3270eSrvrFunctionsSupported    Tn3270Functions,
  672.       tn3270eSrvrConfAdminStatus       INTEGER,
  673.       tn3270eSrvrConfOperStatus        INTEGER,
  674.       tn3270eSrvrConfSessionTermState  INTEGER,
  675.       tn3270eSrvrConfSrvrType          INTEGER,
  676.       tn3270eSrvrConfContact           Utf8String,
  677.       tn3270eSrvrConfRowStatus         RowStatus
  678.     }
  679.  
  680.   tn3270eSrvrConfIndex  OBJECT-TYPE
  681.       SYNTAX      Unsigned32
  682.       MAX-ACCESS  not-accessible
  683.       STATUS      current
  684.       DESCRIPTION
  685.          "Indicates the instance of a TN3270E server that
  686.           exists at an IP Host. Assignments of tn3270eSrvrConfIndex
  687.           values need not be continuous and is implementation
  688.           dependent. Within a host, assignment of
  689.           tn3270eSrvrConfIndex values must be unique."
  690.       ::= { tn3270eSrvrConfEntry 1 }
  691.  
  692.   tn3270eSrvrConfInactivityTimeout OBJECT-TYPE
  693.       SYNTAX      Unsigned32 (0..99999999)
  694.       UNITS "seconds"
  695.       MAX-ACCESS  read-create
  696.       STATUS      current
  697.       DESCRIPTION
  698.          "The inactivity time-out specified in seconds. When a
  699.           connection has been inactive for the number of seconds
  700.           specified by this object it is closed. The default of
  701.           0 means no inactivity time-out."
  702.       DEFVAL { 0 }
  703.       ::= { tn3270eSrvrConfEntry 2 }
  704.  
  705.   tn3270eSrvrConfActivityCheck OBJECT-TYPE
  706.       SYNTAX      INTEGER {
  707.                             noCheck(0),
  708.                             timeMark(1),
  709.                             nop(2)
  710.                           }
  711.       MAX-ACCESS  read-create
  712.       STATUS      current
  713.  
  714.  
  715.  
  716. Expires March 1998                                             [Page 12]
  717.  
  718.  
  719.  
  720.  
  721.  
  722. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  723.  
  724.  
  725.       DESCRIPTION
  726.          "This object is intended to enable either timemark or
  727.           nop processing."
  728.       DEFVAL { noCheck }
  729.       ::= { tn3270eSrvrConfEntry 3 }
  730.  
  731.   tn3270eSrvrConfActivityTimeout OBJECT-TYPE
  732.       SYNTAX      Unsigned32 (1..99999999)
  733.       UNITS "seconds"
  734.       MAX-ACCESS  read-create
  735.       STATUS      current
  736.       DESCRIPTION
  737.          "The TIMEMARK or NOP processing time-out specified in seconds.
  738.           Note that a value of 0 is not allowed for this object since
  739.           the function that uses this object relies on
  740.           tn3270eSrvrConfActivityCheck for function enablement."
  741.       DEFVAL { 600 }   -- 10 minutes
  742.       ::= { tn3270eSrvrConfEntry 4 }
  743.  
  744.   tn3270eSrvrConfActivityInterval OBJECT-TYPE
  745.       SYNTAX      Unsigned32 (1..99999999)
  746.       UNITS "seconds"
  747.       MAX-ACCESS  read-create
  748.       STATUS      current
  749.       DESCRIPTION
  750.          "The scan interval to be used by a TN3270E server.
  751.           TIMEMARK or NOP processing scans the Telnet sessions
  752.           on the interval provided by this object looking for
  753.           sessions that have been idle for more than the value
  754.           provided by tn3270eSrvrConfActivityTimeout.
  755.           Note that a value of 0 is not allowed for this object since
  756.           the function that uses this object relies on
  757.           tn3270eSrvrConfActivityCheck for function enablement."
  758.       DEFVAL { 120 }   -- 2 minutes
  759.       ::= { tn3270eSrvrConfEntry 5 }
  760.  
  761.   tn3270eSrvrFunctionsSupported OBJECT-TYPE
  762.       SYNTAX    Tn3270Functions
  763.       MAX-ACCESS  read-only
  764.       STATUS      current
  765.       DESCRIPTION
  766.          "This object indicates the functions supported by a
  767.           TN3270E server."
  768.       DEFVAL { { scsCtlCodes, dataStreamCtl,
  769.                  responses, bindImage, sysreq } }
  770.       ::= { tn3270eSrvrConfEntry 6 }
  771.  
  772.   tn3270eSrvrConfAdminStatus OBJECT-TYPE
  773.  
  774.  
  775.  
  776. Expires March 1998                                             [Page 13]
  777.  
  778.  
  779.  
  780.  
  781.  
  782. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  783.  
  784.  
  785.       SYNTAX  INTEGER {
  786.                         up(1),
  787.                         down(2),
  788.                         stopImmediate(3)
  789.                       }
  790.       MAX-ACCESS  read-create
  791.       STATUS      current
  792.       DESCRIPTION
  793.           "The desired state of the TN3270E server:
  794.  
  795.            up(1)            - Activate a TN3270E server.
  796.            down(2)          - Informs the associating TN3270E server
  797.                               to gracefully terminate its processing.
  798.            stopImmediate(3) - Informs the associating TN3270E server
  799.                               to terminate immediately.
  800.  
  801.            Implementation as to the exact semantics of either down(2)
  802.            or stopImmediate(3) processing is left as implementation
  803.            dependent. A TN3270E server that does not distinguish
  804.            between down or stopImmediate transitions should not
  805.            support stopImmediate."
  806.       ::= { tn3270eSrvrConfEntry 7 }
  807.  
  808.   tn3270eSrvrConfOperStatus OBJECT-TYPE
  809.       SYNTAX  INTEGER {
  810.                         up(1),
  811.                         down(2)
  812.                       }
  813.       MAX-ACCESS  read-only
  814.       STATUS      current
  815.       DESCRIPTION
  816.          "The current operational state of a TN3270E server:
  817.  
  818.           up(1)   - The corresponding TN3270E server is active.
  819.           down(2) - The corresponding TN3270E server is inactive."
  820.       ::= { tn3270eSrvrConfEntry 8 }
  821.  
  822.   tn3270eSrvrConfSessionTermState OBJECT-TYPE
  823.       SYNTAX  INTEGER {
  824.                         terminate(1),
  825.                         luSessionPend(2),
  826.                         queueSession(3)
  827.                       }
  828.       MAX-ACCESS  read-create
  829.       STATUS      current
  830.       DESCRIPTION
  831.          "The current state for determining what a TN3270E server
  832.           should do when a TN3270 Session terminates:
  833.  
  834.  
  835.  
  836. Expires March 1998                                             [Page 14]
  837.  
  838.  
  839.  
  840.  
  841.  
  842. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  843.  
  844.  
  845.          terminate(1)     => Terminate TCP connection.
  846.          luSessionPend(2) => Do not drop the TCP Connection
  847.                              associated with an IP client when their
  848.                              TN3270 Session ends. Processing should
  849.                              redrive session initialization as if the
  850.                              client was first connecting.
  851.          queueSession(3)  => QUEUESESSION deals with CLSDST-Pass.
  852.                              An example is the easiest explanation.
  853.                              Assume APPL1 does a CLSDST-Pass
  854.                              to APPL2.  Then the client logs off APPL
  855.                              Without QUEUESESSION the connection
  856.                              would now be broken. With QUEUESESSION
  857.                              the TN3270E server keeps the LU around
  858.                              after getting the APPL2 unbind waiting
  859.                              for a bind from APPL1."
  860.       DEFVAL { terminate }
  861.       ::= { tn3270eSrvrConfEntry 9 }
  862.  
  863.   tn3270eSrvrConfSrvrType OBJECT-TYPE
  864.       SYNTAX      INTEGER {
  865.                             unknown(0),
  866.                             host(1),
  867.                             gateway(2)
  868.                           }
  869.       MAX-ACCESS  read-only
  870.       STATUS      current
  871.       DESCRIPTION
  872.           "This object indicates the type of TN3270E server.
  873.           The existence of MIB tables and objects that will be
  874.           defined by follow-on MIBs may be predicated on whether the
  875.           TN3270E server can be local to the same host as a
  876.           Target Application (host(1)) or will always be remote
  877.           (gateway(2))."
  878.       ::= { tn3270eSrvrConfEntry 10 }
  879.  
  880.   tn3270eSrvrConfContact OBJECT-TYPE
  881.       SYNTAX      Utf8String (SIZE(0..255))
  882.       MAX-ACCESS  read-create
  883.       STATUS      current
  884.       DESCRIPTION
  885.           "This object provides a scratch pad for a TN3270E server
  886.           administrator for storing information for later retrieval."
  887.       ::= { tn3270eSrvrConfEntry 11 }
  888.  
  889.   tn3270eSrvrConfRowStatus OBJECT-TYPE
  890.       SYNTAX      RowStatus
  891.       MAX-ACCESS  read-create
  892.       STATUS      current
  893.  
  894.  
  895.  
  896. Expires March 1998                                             [Page 15]
  897.  
  898.  
  899.  
  900.  
  901.  
  902. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  903.  
  904.  
  905.       DESCRIPTION
  906.           "This object allows entries to be created and deleted in the
  907.           tn3270eSrvrConfTable.
  908.  
  909.           An entry in this table is deleted by setting this object
  910.           to destroy(6)."
  911.       REFERENCE
  912.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  913.           Network Management Protocol (SNMPv2).'"
  914.       ::= { tn3270eSrvrConfEntry 12 }
  915.  
  916.   tn3270eSrvrPortTable OBJECT-TYPE
  917.       SYNTAX      SEQUENCE OF Tn3270eSrvrPortEntry
  918.       MAX-ACCESS  not-accessible
  919.       STATUS      current
  920.       DESCRIPTION
  921.           "This table defines the TCP ports associated with TN3270E
  922.           Servers."
  923.       ::= { tn3270eObjects 2 }
  924.  
  925.   tn3270eSrvrPortEntry OBJECT-TYPE
  926.       SYNTAX      Tn3270eSrvrPortEntry
  927.       MAX-ACCESS  not-accessible
  928.       STATUS      current
  929.       DESCRIPTION
  930.           "Definition of a single TCP port assignment to a
  931.            TN3270E server."
  932.       INDEX       {
  933.                     tn3270eSrvrConfIndex,
  934.                     tn3270eSrvrPort,
  935.                     tn3270eSrvrPortAddrType,
  936.                     tn3270eSrvrPortAddress
  937.                   }
  938.       ::= { tn3270eSrvrPortTable 1 }
  939.  
  940.   Tn3270eSrvrPortEntry ::= SEQUENCE {
  941.       tn3270eSrvrPort                 Unsigned32,
  942.       tn3270eSrvrPortAddrType         Tn3270eAddrType,
  943.       tn3270eSrvrPortAddress          Tn3270eTAddress,
  944.       tn3270eSrvrPortRowStatus        RowStatus
  945.     }
  946.  
  947.   tn3270eSrvrPort OBJECT-TYPE
  948.       SYNTAX      Unsigned32 (0..65535)
  949.       MAX-ACCESS  not-accessible
  950.       STATUS      current
  951.       DESCRIPTION
  952.          "Indicates a port assigned to a server."
  953.  
  954.  
  955.  
  956. Expires March 1998                                             [Page 16]
  957.  
  958.  
  959.  
  960.  
  961.  
  962. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  963.  
  964.  
  965.       ::= { tn3270eSrvrPortEntry 1 }
  966.  
  967.   tn3270eSrvrPortAddrType OBJECT-TYPE
  968.       SYNTAX      Tn3270eAddrType
  969.       MAX-ACCESS  not-accessible
  970.       STATUS      current
  971.       DESCRIPTION
  972.           "Indicates the type of the IP Address represented in
  973.            tn3270eSrvrPortAddress."
  974.       ::= { tn3270eSrvrPortEntry 2 }
  975.  
  976.   tn3270eSrvrPortAddress OBJECT-TYPE
  977.       SYNTAX      Tn3270eTAddress
  978.       MAX-ACCESS  not-accessible
  979.       STATUS      current
  980.       DESCRIPTION
  981.           "The IP Address associated with a TN3270E server port.
  982.            tn3270eClientGroupAddrType indicates the address type
  983.            (ipv4 or ipv6 for example)."
  984.       ::= { tn3270eSrvrPortEntry 3 }
  985.  
  986.   tn3270eSrvrPortRowStatus OBJECT-TYPE
  987.       SYNTAX      RowStatus
  988.       MAX-ACCESS  read-create
  989.       STATUS      current
  990.       DESCRIPTION
  991.           "This object allows entries to be created and deleted in the
  992.           tn3270eSrvrPortTable.
  993.  
  994.           An entry in this table is deleted by setting this object
  995.           to destroy(6)."
  996.       REFERENCE
  997.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  998.           Network Management Protocol (SNMPv2).'"
  999.       ::= { tn3270eSrvrPortEntry 4 }
  1000.  
  1001.   tn3270eSrvrStatsTable OBJECT-TYPE
  1002.       SYNTAX      SEQUENCE OF Tn3270eSrvrStatsEntry
  1003.       MAX-ACCESS  not-accessible
  1004.       STATUS      current
  1005.       DESCRIPTION
  1006.           "This table defines a set of statistics concerning
  1007.           global TN3270E server performance."
  1008.       ::= { tn3270eObjects 3 }
  1009.  
  1010.   tn3270eSrvrStatsEntry OBJECT-TYPE
  1011.       SYNTAX      Tn3270eSrvrStatsEntry
  1012.       MAX-ACCESS  not-accessible
  1013.  
  1014.  
  1015.  
  1016. Expires March 1998                                             [Page 17]
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1023.  
  1024.  
  1025.       STATUS      current
  1026.       DESCRIPTION
  1027.           "Collection of a set of statistic objects for a single
  1028.           TN3270 server. An entry can be global with respect to
  1029.           a single TN3270E server or be specified at a port level.
  1030.           Refer to the text description for tn3270eSrvrStatsPort.
  1031.  
  1032.           It is possible that a TN3270E server implementation may
  1033.           not be structured to support resource usage on a port basis
  1034.           but provide statistics via an entry in this table for
  1035.           each port. The recommended approach for this is to
  1036.           provide a global entry (a value of 0 for
  1037.           tn3270eSrvrStatsPort) with:
  1038.  
  1039.                tn3270eSrvrStatsMaxLus
  1040.                tn3270eSrvrStatsMaxLus
  1041.                tn3270eSrvrStatsLusInUse
  1042.                tn3270eSrvrStatsSpareLus
  1043.                tn3270eSrvrStatsMaxPtrs
  1044.                tn3270eSrvrStatsPtrsInUse
  1045.                tn3270eSrvrStatsSparePtrs
  1046.  
  1047.         set at this layer but set to zero at the port layer."
  1048.       INDEX       { tn3270eSrvrConfIndex, tn3270eSrvrStatsPort }
  1049.       ::= { tn3270eSrvrStatsTable 1 }
  1050.  
  1051.   Tn3270eSrvrStatsEntry ::= SEQUENCE {
  1052.       tn3270eSrvrStatsPort            Unsigned32,
  1053.       tn3270eSrvrStatsUpTime          TimeTicks,
  1054.       tn3270eSrvrStatsMaxLus          Unsigned32,
  1055.       tn3270eSrvrStatsLusInUse        Gauge32,
  1056.       tn3270eSrvrStatsSpareLus        Gauge32,
  1057.       tn3270eSrvrStatsMaxPtrs         Unsigned32,
  1058.       tn3270eSrvrStatsPtrsInUse       Gauge32,
  1059.       tn3270eSrvrStatsSparePtrs       Gauge32,
  1060.       tn3270eSrvrStatsConnectsIn      Counter32,
  1061.       tn3270eSrvrStatsConnRejects     Counter32,
  1062.       tn3270eSrvrStatsDisconnects     Counter32,
  1063.       tn3270eSrvrStatsOctetsIn        Counter64,
  1064.       tn3270eSrvrStatsOctetsInLow     Counter32,
  1065.       tn3270eSrvrStatsOctetsOut       Counter64,
  1066.       tn3270eSrvrStatsOctetsOutLow    Counter32
  1067.     }
  1068.  
  1069.   tn3270eSrvrStatsPort OBJECT-TYPE
  1070.       SYNTAX      Unsigned32 (0..65535)
  1071.       MAX-ACCESS  not-accessible
  1072.       STATUS      current
  1073.  
  1074.  
  1075.  
  1076. Expires March 1998                                             [Page 18]
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1083.  
  1084.  
  1085.       DESCRIPTION
  1086.          "Indicates the port that the corresponding statistics are
  1087.           for. Implementation of collection of these statistics
  1088.           on a port basis is not mandatory. An implementation may
  1089.           limit itself to keeping this data on a global basis by
  1090.           using a value of 0."
  1091.       ::= { tn3270eSrvrStatsEntry 1 }
  1092.  
  1093.   tn3270eSrvrStatsUpTime OBJECT-TYPE
  1094.       SYNTAX      TimeTicks
  1095.       MAX-ACCESS  read-only
  1096.       STATUS      current
  1097.       DESCRIPTION
  1098.          "Indicates when either usage of a associating port becomes
  1099.           active (tn3270eSrvrStatsPort non-zero) or if the entry
  1100.           is being kept on a global basis the time that the TN3270E
  1101.           server becomes active.  The value of this object does not
  1102.           get reset based on port usage status changes or changes
  1103.           to tn3270eSrvrConfOperStatus."
  1104.       ::= { tn3270eSrvrStatsEntry 2 }
  1105.  
  1106.   tn3270eSrvrStatsMaxLus OBJECT-TYPE
  1107.       SYNTAX      Unsigned32
  1108.       MAX-ACCESS  read-only
  1109.       STATUS      current
  1110.       DESCRIPTION
  1111.          "Indicates the maximum number of LUs for use by a
  1112.           TN3270E server. The granularity of this data can be
  1113.           either global (corresponding tn3270eSrvrStatsPort index
  1114.           equal to 0) or on a port basis."
  1115.       ::= { tn3270eSrvrStatsEntry 3 }
  1116.  
  1117.   tn3270eSrvrStatsLusInUse OBJECT-TYPE
  1118.       SYNTAX      Gauge32
  1119.       MAX-ACCESS  read-only
  1120.       STATUS      current
  1121.       DESCRIPTION
  1122.          "Indicates the current number of LUs in use by a
  1123.           TN3270E server. The granularity of this data can be
  1124.           either global (corresponding tn3270eSrvrStatsPort index
  1125.           equal to 0) or on a port basis."
  1126.       ::= { tn3270eSrvrStatsEntry 4 }
  1127.  
  1128.   tn3270eSrvrStatsSpareLus OBJECT-TYPE
  1129.       SYNTAX      Gauge32
  1130.       MAX-ACCESS  read-only
  1131.       STATUS      current
  1132.       DESCRIPTION
  1133.  
  1134.  
  1135.  
  1136. Expires March 1998                                             [Page 19]
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1143.  
  1144.  
  1145.          "Indicates the number of free LUs for a particular TN3270E
  1146.           server. It is possible that the difference between
  1147.           tn3270eSrvrStatsMaxLus and tn3270eSrvrStatsLusInUse does
  1148.           not equal tn3270eSrvrStatsSpareLus. An LU may exist
  1149.           but not be useable by an IP client connection.
  1150.           The granularity of this data can be
  1151.           either global (corresponding tn3270eSrvrStatsPort index
  1152.           equal to 0) or on a port basis."
  1153.       ::= { tn3270eSrvrStatsEntry 5 }
  1154.  
  1155.   tn3270eSrvrStatsMaxPtrs OBJECT-TYPE
  1156.       SYNTAX      Unsigned32
  1157.       MAX-ACCESS  read-only
  1158.       STATUS      current
  1159.       DESCRIPTION
  1160.          "Indicates the maximum number of Printer Resources for
  1161.           use by a TN3270E server. The granularity of this data
  1162.           can be either global (corresponding tn3270eSrvrStatsPort
  1163.           index equal to 0) or on a port basis."
  1164.       ::= { tn3270eSrvrStatsEntry 6 }
  1165.  
  1166.   tn3270eSrvrStatsPtrsInUse OBJECT-TYPE
  1167.       SYNTAX      Gauge32
  1168.       MAX-ACCESS  read-only
  1169.       STATUS      current
  1170.       DESCRIPTION
  1171.          "Indicates the current number of Printer Resources in
  1172.           use by a TN3270E server. The granularity of this data
  1173.           can be either global (corresponding tn3270eSrvrStatsPort
  1174.           index equal to 0) or on a port basis."
  1175.       ::= { tn3270eSrvrStatsEntry 7 }
  1176.  
  1177.   tn3270eSrvrStatsSparePtrs OBJECT-TYPE
  1178.       SYNTAX      Gauge32
  1179.       MAX-ACCESS  read-only
  1180.       STATUS      current
  1181.       DESCRIPTION
  1182.          "Indicates the number of free Printer Resources for a
  1183.           particular TN3270E server. It is possible that the
  1184.           difference between tn3270eSrvrStatsMaxPtrs and
  1185.           tn3270eSrvrStatsPtrsInUse does not equal
  1186.           tn3270eSrvrStatsSparePtrs. A Printer resource may
  1187.           exist but not be useable by an IP client connection.
  1188.           The granularity of this data
  1189.           can be either global (corresponding tn3270eSrvrStatsPort
  1190.           index equal to 0) or on a port basis."
  1191.       ::= { tn3270eSrvrStatsEntry 8 }
  1192.  
  1193.  
  1194.  
  1195.  
  1196. Expires March 1998                                             [Page 20]
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1203.  
  1204.  
  1205.   tn3270eSrvrStatsConnectsIn OBJECT-TYPE
  1206.       SYNTAX      Counter32
  1207.       MAX-ACCESS  read-only
  1208.       STATUS      current
  1209.       DESCRIPTION
  1210.          "Indicates the number of client connections received by a
  1211.           TN3270E server. The granularity of this data
  1212.           can be either global (corresponding tn3270eSrvrStatsPort
  1213.           index equal to 0) or on a port basis."
  1214.       ::= { tn3270eSrvrStatsEntry 9 }
  1215.  
  1216.   tn3270eSrvrStatsConnRejects OBJECT-TYPE
  1217.       SYNTAX      Counter32
  1218.       MAX-ACCESS  read-only
  1219.       STATUS      current
  1220.       DESCRIPTION
  1221.          "Indicates the number of client connections rejected during
  1222.           connection setup. An example of this is when no LU or
  1223.           Printer resource is available to associate with the
  1224.           TCP Connection of an IP client. The granularity of this data
  1225.           can be either global (corresponding tn3270eSrvrStatsPort
  1226.           index equal to 0) or on a port basis."
  1227.       ::= { tn3270eSrvrStatsEntry 10 }
  1228.  
  1229.   tn3270eSrvrStatsDisconnects OBJECT-TYPE
  1230.       SYNTAX      Counter32
  1231.       MAX-ACCESS  read-only
  1232.       STATUS      current
  1233.       DESCRIPTION
  1234.          "Indicates the number of client connections disconnected by a
  1235.           TN3270E server. The granularity of this data
  1236.           can be either global (corresponding tn3270eSrvrStatsPort
  1237.           index equal to 0) or on a port basis."
  1238.       ::= { tn3270eSrvrStatsEntry 11 }
  1239.  
  1240.   tn3270eSrvrStatsOctetsIn OBJECT-TYPE
  1241.       SYNTAX      Counter64
  1242.       MAX-ACCESS  read-only
  1243.       STATUS      current
  1244.       DESCRIPTION
  1245.          "Indicates the number of octets received from TN3270
  1246.           and TN3270E Clients.  The granularity
  1247.           of this data  can be either global (corresponding
  1248.           tn3270eSrvrStatsPort index equal to 0) or on a port basis."
  1249.       ::= { tn3270eSrvrStatsEntry 12 }
  1250.  
  1251.   tn3270eSrvrStatsOctetsInLow OBJECT-TYPE
  1252.       SYNTAX      Counter32
  1253.  
  1254.  
  1255.  
  1256. Expires March 1998                                             [Page 21]
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1263.  
  1264.  
  1265.       MAX-ACCESS  read-only
  1266.       STATUS      current
  1267.       DESCRIPTION
  1268.          "Low order 32 bits of tn3270eSrvrStatsOctetsIn."
  1269.       ::= { tn3270eSrvrStatsEntry 13 }
  1270.  
  1271.   tn3270eSrvrStatsOctetsOut OBJECT-TYPE
  1272.       SYNTAX      Counter64
  1273.       MAX-ACCESS  read-only
  1274.       STATUS      current
  1275.       DESCRIPTION
  1276.          "Indicates the number of octets sent to TN3270
  1277.           and TN3270E Clients. The granularity
  1278.           of this data  can be either global (corresponding
  1279.           tn3270eSrvrStatsPort index equal to 0) or on a port basis."
  1280.       ::= { tn3270eSrvrStatsEntry 14 }
  1281.  
  1282.   tn3270eSrvrStatsOctetsOutLow OBJECT-TYPE
  1283.       SYNTAX      Counter32
  1284.       MAX-ACCESS  read-only
  1285.       STATUS      current
  1286.       DESCRIPTION
  1287.          "Low order 32 bits of tn3270eSrvrStatsOctetsOut."
  1288.       ::= { tn3270eSrvrStatsEntry 15 }
  1289.  
  1290.   tn3270eClientGroupTable OBJECT-TYPE
  1291.       SYNTAX      SEQUENCE OF Tn3270eClientGroupEntry
  1292.       MAX-ACCESS  not-accessible
  1293.       STATUS      current
  1294.       DESCRIPTION
  1295.           "This table defines client address groupings for use by a
  1296.           TN3270E server."
  1297.       ::= { tn3270eObjects 4 }
  1298.  
  1299.   tn3270eClientGroupEntry OBJECT-TYPE
  1300.       SYNTAX      Tn3270eClientGroupEntry
  1301.       MAX-ACCESS  not-accessible
  1302.       STATUS      current
  1303.       DESCRIPTION
  1304.           "Definition of a single client address entry. All entries with
  1305.           the same first two indexes, tn3270eSrvrConfIndex and
  1306.           tn3270eClientGroupName, are considered to be in the same
  1307.           client group."
  1308.       INDEX       { tn3270eSrvrConfIndex,
  1309.                     tn3270eClientGroupName,
  1310.                     tn3270eClientGroupAddrType,
  1311.                     tn3270eClientGroupAddress }
  1312.       ::= { tn3270eClientGroupTable 1 }
  1313.  
  1314.  
  1315.  
  1316. Expires March 1998                                             [Page 22]
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1323.  
  1324.  
  1325.   Tn3270eClientGroupEntry ::= SEQUENCE {
  1326.       tn3270eClientGroupName           Utf8String,
  1327.       tn3270eClientGroupAddrType       Tn3270eAddrType,
  1328.       tn3270eClientGroupAddress        Tn3270eTAddress,
  1329.       tn3270eClientGroupSubnetMask     IpAddress,
  1330.       tn3270eClientGroupPfxLength      Unsigned32,
  1331.       tn3270eClientGroupRowStatus      RowStatus }
  1332.  
  1333.   tn3270eClientGroupName OBJECT-TYPE
  1334.       SYNTAX      Utf8String (SIZE(1..24))
  1335.       MAX-ACCESS  not-accessible
  1336.       STATUS      current
  1337.       DESCRIPTION
  1338.           "The name of a client group."
  1339.       ::= { tn3270eClientGroupEntry 1 }
  1340.  
  1341.   tn3270eClientGroupAddrType OBJECT-TYPE
  1342.       SYNTAX      Tn3270eAddrType
  1343.       MAX-ACCESS  not-accessible
  1344.       STATUS      current
  1345.       DESCRIPTION
  1346.           "Indicates the type of the address represented in
  1347.            tn3270eClientGroupAddress."
  1348.       ::= { tn3270eClientGroupEntry 2 }
  1349.  
  1350.   tn3270eClientGroupAddress OBJECT-TYPE
  1351.       SYNTAX      Tn3270eTAddress
  1352.       MAX-ACCESS  not-accessible
  1353.       STATUS      current
  1354.       DESCRIPTION
  1355.           "The client address of a member of a client group. The value
  1356.            of tn3270eClientGroupAddrType indicates the address
  1357.            type (ipv4 or ipv6 for example)."
  1358.       ::= { tn3270eClientGroupEntry 3 }
  1359.  
  1360.   tn3270eClientGroupSubnetMask OBJECT-TYPE
  1361.       SYNTAX      IpAddress
  1362.       MAX-ACCESS  read-create
  1363.       STATUS      current
  1364.       DESCRIPTION
  1365.           "The corresponding subnet mask associated with
  1366.            tn3270eClientGroupAddress. A single IP Address is
  1367.            represented by having this object contain the value
  1368.            of 255.255.255.255. This object is valid only if
  1369.            tn3270eClientGroupAddrType has a value of ipv4(1)."
  1370.       DEFVAL { 'FFFFFFFF'H }
  1371.       ::= { tn3270eClientGroupEntry 4 }
  1372.  
  1373.  
  1374.  
  1375.  
  1376. Expires March 1998                                             [Page 23]
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1383.  
  1384.  
  1385.   tn3270eClientGroupPfxLength OBJECT-TYPE
  1386.       SYNTAX      Unsigned32 (0..128)
  1387.       MAX-ACCESS  read-create
  1388.       STATUS      current
  1389.       DESCRIPTION
  1390.           "The corresponding IPv6 network prefix length. This
  1391.            object is valid only if tn3270eClientGroupAddrType
  1392.            has a value of ipv6(2)."
  1393.       DEFVAL { 0 }
  1394.       ::= { tn3270eClientGroupEntry 5 }
  1395.  
  1396.   tn3270eClientGroupRowStatus OBJECT-TYPE
  1397.       SYNTAX      RowStatus
  1398.       MAX-ACCESS  read-create
  1399.       STATUS      current
  1400.       DESCRIPTION
  1401.           "This object allows entries to be created and deleted in the
  1402.           tn3270eClientGroupTable.
  1403.  
  1404.           An entry in this table is deleted by setting this object
  1405.           to destroy(6)."
  1406.       REFERENCE
  1407.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  1408.           Network Management Protocol (SNMPv2).'"
  1409.       ::= { tn3270eClientGroupEntry 6 }
  1410.  
  1411.   tn3270eResPoolTable OBJECT-TYPE
  1412.       SYNTAX      SEQUENCE OF Tn3270eResPoolEntry
  1413.       MAX-ACCESS  not-accessible
  1414.       STATUS      current
  1415.       DESCRIPTION
  1416.           "This table defines resource groupings; the term
  1417.            'pool' is used as it is defined by RFC 1647."
  1418.       ::= { tn3270eObjects 5 }
  1419.  
  1420.   tn3270eResPoolEntry OBJECT-TYPE
  1421.       SYNTAX      Tn3270eResPoolEntry
  1422.       MAX-ACCESS  not-accessible
  1423.       STATUS      current
  1424.       DESCRIPTION
  1425.           "Definition of a single resource pool member. All entries
  1426.           with the same first two indexes, tn3270eSrvrConfIndex and
  1427.           tn3270eResPoolName, are considered to be in the same pool."
  1428.       INDEX  { tn3270eSrvrConfIndex,
  1429.                tn3270eResPoolName,
  1430.                tn3270eResPoolElementName }
  1431.       ::= { tn3270eResPoolTable 1 }
  1432.  
  1433.  
  1434.  
  1435.  
  1436. Expires March 1998                                             [Page 24]
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1443.  
  1444.  
  1445.   Tn3270eResPoolEntry ::= SEQUENCE {
  1446.       tn3270eResPoolName           Utf8String,
  1447.       tn3270eResPoolElementName    SnaResourceName,
  1448.       tn3270eResPoolElementType    Tn3270ResourceType,
  1449.       tn3270eResPoolRowStatus      RowStatus }
  1450.  
  1451.   tn3270eResPoolName OBJECT-TYPE
  1452.       SYNTAX      Utf8String (SIZE(1..24))
  1453.       MAX-ACCESS  not-accessible
  1454.       STATUS      current
  1455.       DESCRIPTION
  1456.           "The name of a resource pool.."
  1457.       ::= { tn3270eResPoolEntry 1 }
  1458.  
  1459.   tn3270eResPoolElementName OBJECT-TYPE
  1460.       SYNTAX      SnaResourceName
  1461.       MAX-ACCESS  not-accessible
  1462.       STATUS      current
  1463.       DESCRIPTION
  1464.           "The name of a member of a resource pool."
  1465.       ::= { tn3270eResPoolEntry 2 }
  1466.  
  1467.   tn3270eResPoolElementType OBJECT-TYPE
  1468.       SYNTAX      Tn3270ResourceType
  1469.       MAX-ACCESS  read-create
  1470.       STATUS      current
  1471.       DESCRIPTION
  1472.           "The type of the entity in a resource pool."
  1473.       ::= { tn3270eResPoolEntry 3 }
  1474.  
  1475.   tn3270eResPoolRowStatus OBJECT-TYPE
  1476.       SYNTAX      RowStatus
  1477.       MAX-ACCESS  read-create
  1478.       STATUS      current
  1479.       DESCRIPTION
  1480.           "This object allows entries to be created and deleted in the
  1481.           tn3270eResPoolTable.
  1482.  
  1483.           An entry in this table is deleted by setting this object
  1484.           to destroy(6)."
  1485.       REFERENCE
  1486.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  1487.           Network Management Protocol (SNMPv2).'"
  1488.       ::= { tn3270eResPoolEntry 4 }
  1489.  
  1490.   tn3270eSnaMapTable OBJECT-TYPE
  1491.       SYNTAX      SEQUENCE OF Tn3270eSnaMapEntry
  1492.       MAX-ACCESS  not-accessible
  1493.  
  1494.  
  1495.  
  1496. Expires March 1998                                             [Page 25]
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1503.  
  1504.  
  1505.       STATUS      current
  1506.       DESCRIPTION
  1507.           "This table provide a mapping from the name by which
  1508.            a secondary LU is known in the SNA network to the
  1509.            name by which it is known locally at the TN3270e
  1510.            server.  This latter name serves as an index into
  1511.            the tn3270eResPoolTable and the tn3270eResMapTable."
  1512.       ::= { tn3270eObjects 6 }
  1513.  
  1514.   tn3270eSnaMapEntry OBJECT-TYPE
  1515.       SYNTAX      Tn3270eSnaMapEntry
  1516.       MAX-ACCESS  not-accessible
  1517.       STATUS      current
  1518.       DESCRIPTION
  1519.           "Definition of a single mapping from an SSCP-supplied
  1520.            SLU name to a local SLU name."
  1521.       INDEX  { tn3270eSrvrConfIndex,
  1522.                tn3270eSnaMapSscpSuppliedName }
  1523.       ::= { tn3270eSnaMapTable 1 }
  1524.  
  1525.   Tn3270eSnaMapEntry ::= SEQUENCE {
  1526.       tn3270eSnaMapSscpSuppliedName     SnaResourceName,
  1527.       tn3270eSnaMapLocalName            SnaResourceName }
  1528.  
  1529.   tn3270eSnaMapSscpSuppliedName OBJECT-TYPE
  1530.       SYNTAX      SnaResourceName
  1531.       MAX-ACCESS  not-accessible
  1532.       STATUS      current
  1533.       DESCRIPTION
  1534.           "The name of the secondary LU (SLU) as it is known in the
  1535.            SNA network.  This name is sent by the SSCP on the
  1536.            Activate Logical Unit (ACTLU) request."
  1537.       ::= { tn3270eSnaMapEntry 1 }
  1538.  
  1539.   tn3270eSnaMapLocalName OBJECT-TYPE
  1540.       SYNTAX      SnaResourceName
  1541.       MAX-ACCESS  read-only
  1542.       STATUS      current
  1543.       DESCRIPTION
  1544.           "The local name of the secondary LU (SLU)."
  1545.       ::= { tn3270eSnaMapEntry 2 }
  1546.  
  1547.   tn3270eClientResMapTable OBJECT-TYPE
  1548.       SYNTAX      SEQUENCE OF Tn3270eClientResMapEntry
  1549.       MAX-ACCESS  not-accessible
  1550.       STATUS      current
  1551.       DESCRIPTION
  1552.           "This table defines resource pool to client group mappings.
  1553.  
  1554.  
  1555.  
  1556. Expires March 1998                                             [Page 26]
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1563.  
  1564.  
  1565.            Since both the resource pool name and client group name
  1566.            are included in the index clause of this table, multiple
  1567.            resource pools can be assigned to the same client group. This
  1568.            enables use of multiple resource pools for use in client to
  1569.            resource mapping. Assigning multiple client Groups to the
  1570.            same resource pool is also allowed, but is not the primary
  1571.            purpose for how the indexing is structured.
  1572.  
  1573.            Assignment of a resource pool to client group can be
  1574.            restricted based on TCP port. An index value of 0 for
  1575.            tn3270eClientResMapClientPort disables restriction of
  1576.            resource assignment based on client target port selection."
  1577.       ::= { tn3270eObjects 7 }
  1578.  
  1579.   tn3270eClientResMapEntry OBJECT-TYPE
  1580.       SYNTAX      Tn3270eClientResMapEntry
  1581.       MAX-ACCESS  not-accessible
  1582.       STATUS      current
  1583.       DESCRIPTION
  1584.           "Definition of a single resource pool to client group
  1585.   mapping."
  1586.       INDEX  { tn3270eSrvrConfIndex,
  1587.                tn3270eClientResMapPoolName,
  1588.                tn3270eClientResMapClientGroupName,
  1589.                tn3270eClientResMapClientPort }
  1590.       ::= { tn3270eClientResMapTable 1 }
  1591.  
  1592.   Tn3270eClientResMapEntry ::= SEQUENCE {
  1593.       tn3270eClientResMapPoolName           Utf8String,
  1594.       tn3270eClientResMapClientGroupName    Utf8String,
  1595.       tn3270eClientResMapClientPort         Unsigned32,
  1596.       tn3270eClientResMapRowStatus          RowStatus }
  1597.  
  1598.   tn3270eClientResMapPoolName OBJECT-TYPE
  1599.       SYNTAX      Utf8String (SIZE(1..24))
  1600.       MAX-ACCESS  not-accessible
  1601.       STATUS      current
  1602.       DESCRIPTION
  1603.           "The name of a resource pool."
  1604.       ::= { tn3270eClientResMapEntry 1 }
  1605.  
  1606.   tn3270eClientResMapClientGroupName OBJECT-TYPE
  1607.       SYNTAX      Utf8String (SIZE(1..24))
  1608.       MAX-ACCESS  not-accessible
  1609.       STATUS      current
  1610.       DESCRIPTION
  1611.           "The name of the client group that is mapped to a
  1612.            resource pool."
  1613.  
  1614.  
  1615.  
  1616. Expires March 1998                                             [Page 27]
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1623.  
  1624.  
  1625.       ::= { tn3270eClientResMapEntry 2 }
  1626.  
  1627.   tn3270eClientResMapClientPort OBJECT-TYPE
  1628.       SYNTAX      Unsigned32 (0..65535)
  1629.       MAX-ACCESS  not-accessible
  1630.       STATUS      current
  1631.       DESCRIPTION
  1632.           "The port to restrict a resource pool to a client group
  1633.            mapping. A value of 0 for this objects implies that
  1634.            the mapping is not restricted."
  1635.       ::= { tn3270eClientResMapEntry 3 }
  1636.  
  1637.   tn3270eClientResMapRowStatus OBJECT-TYPE
  1638.       SYNTAX      RowStatus
  1639.       MAX-ACCESS  read-create
  1640.       STATUS      current
  1641.       DESCRIPTION
  1642.           "This object allows entries to be created and deleted in the
  1643.           tn3270eClientResMapTable.
  1644.  
  1645.           An entry in this table is deleted by setting this object
  1646.           to destroy(6)."
  1647.       REFERENCE
  1648.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  1649.           Network Management Protocol (SNMPv2).'"
  1650.       ::= { tn3270eClientResMapEntry 4 }
  1651.  
  1652.   tn3270eResMapTable OBJECT-TYPE
  1653.       SYNTAX      SEQUENCE OF Tn3270eResMapEntry
  1654.       MAX-ACCESS  not-accessible
  1655.       STATUS      current
  1656.       DESCRIPTION
  1657.           "This table defines the actual mapping of a resource to
  1658.            a client Address."
  1659.       ::= { tn3270eObjects 8 }
  1660.  
  1661.   tn3270eResMapEntry OBJECT-TYPE
  1662.       SYNTAX      Tn3270eResMapEntry
  1663.       MAX-ACCESS  not-accessible
  1664.       STATUS      current
  1665.       DESCRIPTION
  1666.           "Definition of the mapping of a Resource Element to
  1667.            a client Address."
  1668.       INDEX  { tn3270eSrvrConfIndex,
  1669.                tn3270eResMapElementName }
  1670.       ::= { tn3270eResMapTable 1 }
  1671.  
  1672.   Tn3270eResMapEntry ::= SEQUENCE {
  1673.  
  1674.  
  1675.  
  1676. Expires March 1998                                             [Page 28]
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1683.  
  1684.  
  1685.       tn3270eResMapElementName    SnaResourceName,
  1686.       tn3270eResMapAddrType       Tn3270eAddrType,
  1687.       tn3270eResMapAddress        Tn3270eTAddress,
  1688.       tn3270eResMapPort           Unsigned32,
  1689.       tn3270eResMapElementType    Tn3270ResourceType }
  1690.  
  1691.   tn3270eResMapElementName OBJECT-TYPE
  1692.       SYNTAX      SnaResourceName
  1693.       MAX-ACCESS  not-accessible
  1694.       STATUS      current
  1695.       DESCRIPTION
  1696.           "The name of a resource element."
  1697.       ::= { tn3270eResMapEntry 1 }
  1698.  
  1699.   tn3270eResMapAddrType OBJECT-TYPE
  1700.       SYNTAX      Tn3270eAddrType
  1701.       MAX-ACCESS  read-only
  1702.       STATUS      current
  1703.       DESCRIPTION
  1704.           "Indicates the type of the client Address represented in
  1705.            tn3270eResMapAddress."
  1706.       ::= { tn3270eResMapEntry 2 }
  1707.  
  1708.   tn3270eResMapAddress OBJECT-TYPE
  1709.       SYNTAX      Tn3270eTAddress
  1710.       MAX-ACCESS  read-only
  1711.       STATUS      current
  1712.       DESCRIPTION
  1713.           "A client address."
  1714.       ::= { tn3270eResMapEntry 3 }
  1715.  
  1716.   tn3270eResMapPort OBJECT-TYPE
  1717.       SYNTAX      Unsigned32 (0..65535)
  1718.       MAX-ACCESS  read-only
  1719.       STATUS      current
  1720.       DESCRIPTION
  1721.           "A client Port."
  1722.       ::= { tn3270eResMapEntry 4 }
  1723.  
  1724.   tn3270eResMapElementType OBJECT-TYPE
  1725.       SYNTAX      Tn3270ResourceType
  1726.       MAX-ACCESS  read-only
  1727.       STATUS      current
  1728.       DESCRIPTION
  1729.           "The type of the associating resource element."
  1730.       ::= { tn3270eResMapEntry 5 }
  1731.  
  1732.   -- Define the set of objects to add to the Tcp Connection Table
  1733.  
  1734.  
  1735.  
  1736. Expires March 1998                                             [Page 29]
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1743.  
  1744.  
  1745.   tn3270eTcpConnTable OBJECT-TYPE
  1746.       SYNTAX SEQUENCE OF Tn3270eTcpConnEntry
  1747.       MAX-ACCESS not-accessible
  1748.       STATUS current
  1749.       DESCRIPTION
  1750.            "Provides a table that has an entry for each TN3270(E)
  1751.             client connection that is active at a TN3270E server.
  1752.             The table was originally modeled after the tcpConnTable
  1753.             but was changed to support different client Address types
  1754.             and to be indexed first by the remote address and port
  1755.             as oppose to local address and port. This is to enable
  1756.             use of a SNMP GET-NEXT operation using only the remote
  1757.             address and port."
  1758.       ::= { tn3270eObjects 9 }
  1759.  
  1760.   tn3270eTcpConnEntry OBJECT-TYPE
  1761.       SYNTAX Tn3270eTcpConnEntry
  1762.       MAX-ACCESS not-accessible
  1763.       STATUS current
  1764.       DESCRIPTION
  1765.            "Provides in formation about a single TN3270/TN3270E
  1766.             session. Note: a tn3270eSrvrConfIndex is not needed
  1767.             in this table since the combination of both remote
  1768.             local addresses and ports is sufficient to
  1769.             guarantee uniqueness between TN3270E Servers on the
  1770.             same or actually different hosts."
  1771.       INDEX { tn3270eTcpConnRemAddress,
  1772.               tn3270eTcpConnRemPort,
  1773.               tn3270eTcpConnRemAddrType,
  1774.               tn3270eTcpConnLocalAddress,
  1775.               tn3270eTcpConnLocalPort,
  1776.               tn3270eTcpConnLocalAddrType
  1777.             }
  1778.       ::= { tn3270eTcpConnTable 1 }
  1779.  
  1780.   Tn3270eTcpConnEntry ::=
  1781.       SEQUENCE
  1782.       {
  1783.           tn3270eTcpConnRemAddress         Tn3270eTAddress,
  1784.           tn3270eTcpConnRemPort            Unsigned32,
  1785.           tn3270eTcpConnRemAddrType        Tn3270eAddrType,
  1786.           tn3270eTcpConnLocalAddress       Tn3270eTAddress,
  1787.           tn3270eTcpConnLocalPort          Unsigned32,
  1788.           tn3270eTcpConnLocalAddrType      Tn3270eAddrType,
  1789.           tn3270eTcpConnLastActivity       TimeTicks,
  1790.           tn3270eTcpConnBytesIn            Counter32,
  1791.           tn3270eTcpConnBytesOut           Counter32,
  1792.           tn3270eTcpConnResourceElement    SnaResourceName,
  1793.  
  1794.  
  1795.  
  1796. Expires March 1998                                             [Page 30]
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1803.  
  1804.  
  1805.           tn3270eTcpConnResourceType       Tn3270ResourceType,
  1806.           tn3270eTcpConnDeviceType         Tn3270DeviceTypes,
  1807.           tn3270eTcpConnFunctions          Tn3270Functions
  1808.       }
  1809.  
  1810.   tn3270eTcpConnRemAddress OBJECT-TYPE
  1811.       SYNTAX      Tn3270eTAddress
  1812.       MAX-ACCESS  not-accessible
  1813.       STATUS      current
  1814.       DESCRIPTION
  1815.           "The remote address associated with a TN3270E client.
  1816.            tn3270eTcpConnRemAddrType indicates the address type
  1817.            (ipv4 or ipv6 for example)."
  1818.       ::= { tn3270eTcpConnEntry 1 }
  1819.  
  1820.   tn3270eTcpConnRemPort OBJECT-TYPE
  1821.       SYNTAX      Unsigned32 (0..65535)
  1822.       MAX-ACCESS  not-accessible
  1823.       STATUS      current
  1824.       DESCRIPTION
  1825.           "The remote port associated with a TN3270E client."
  1826.       ::= { tn3270eTcpConnEntry 2 }
  1827.  
  1828.   tn3270eTcpConnRemAddrType OBJECT-TYPE
  1829.       SYNTAX   Tn3270eAddrType
  1830.       MAX-ACCESS   not-accessible
  1831.       STATUS   current
  1832.       DESCRIPTION
  1833.           "Indicates whether the index element tcpConnRemAddress
  1834.            is a ipv4(1) or a ipv6(2) address."
  1835.       ::= { tn3270eTcpConnEntry 3 }
  1836.  
  1837.   tn3270eTcpConnLocalAddress OBJECT-TYPE
  1838.       SYNTAX      Tn3270eTAddress
  1839.       MAX-ACCESS  not-accessible
  1840.       STATUS      current
  1841.       DESCRIPTION
  1842.           "The local address associated with a TN3270E client.
  1843.            tn3270eTcpConnRemAddrType indicates the address type
  1844.            (ipv4 or ipv6 for example)."
  1845.       ::= { tn3270eTcpConnEntry 4 }
  1846.  
  1847.   tn3270eTcpConnLocalPort OBJECT-TYPE
  1848.       SYNTAX      Unsigned32 (0..65535)
  1849.       MAX-ACCESS  not-accessible
  1850.       STATUS      current
  1851.       DESCRIPTION
  1852.           "The remote port associated with a TN3270E client."
  1853.  
  1854.  
  1855.  
  1856. Expires March 1998                                             [Page 31]
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1863.  
  1864.  
  1865.       ::= { tn3270eTcpConnEntry 5 }
  1866.  
  1867.   tn3270eTcpConnLocalAddrType OBJECT-TYPE
  1868.       SYNTAX   Tn3270eAddrType
  1869.       MAX-ACCESS   not-accessible
  1870.       STATUS   current
  1871.       DESCRIPTION
  1872.           "Indicates whether the index element tcpConnLocalAddress
  1873.            is a ipv4(1) or a ipv6(2) address."
  1874.       ::= { tn3270eTcpConnEntry 6 }
  1875.  
  1876.   tn3270eTcpConnLastActivity OBJECT-TYPE
  1877.       SYNTAX   TimeTicks
  1878.       MAX-ACCESS   read-only
  1879.       STATUS   current
  1880.       DESCRIPTION
  1881.           "The number of 100ths of seconds since any data was
  1882.            transferred for the associating TCP Connection."
  1883.       DEFVAL  { 0 }
  1884.       ::= { tn3270eTcpConnEntry 7 }
  1885.  
  1886.   tn3270eTcpConnBytesIn  OBJECT-TYPE
  1887.       SYNTAX   Counter32
  1888.       UNITS "octets"
  1889.       MAX-ACCESS   read-only
  1890.       STATUS   current
  1891.       DESCRIPTION
  1892.           "The number of bytes received by the server from TCP
  1893.            for this connection."
  1894.       ::= { tn3270eTcpConnEntry 8 }
  1895.  
  1896.   tn3270eTcpConnBytesOut OBJECT-TYPE
  1897.       SYNTAX   Counter32
  1898.       UNITS "octets"
  1899.       MAX-ACCESS   read-only
  1900.       STATUS   current
  1901.       DESCRIPTION
  1902.           "The number of bytes sent to TCP for this connection."
  1903.       ::= { tn3270eTcpConnEntry 9 }
  1904.  
  1905.   tn3270eTcpConnResourceElement OBJECT-TYPE
  1906.       SYNTAX   SnaResourceName
  1907.       MAX-ACCESS   read-only
  1908.       STATUS   current
  1909.       DESCRIPTION
  1910.           "LU/Print secondary name for connecting an IP client
  1911.            into an SNA network."
  1912.      ::= { tn3270eTcpConnEntry 10 }
  1913.  
  1914.  
  1915.  
  1916. Expires March 1998                                             [Page 32]
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1923.  
  1924.  
  1925.   tn3270eTcpConnResourceType OBJECT-TYPE
  1926.       SYNTAX   Tn3270ResourceType
  1927.       MAX-ACCESS   read-only
  1928.       STATUS   current
  1929.       DESCRIPTION
  1930.           "Indicates the type of resource identified by
  1931.            tn3270eTcpConnResourceElement."
  1932.      ::= { tn3270eTcpConnEntry 11 }
  1933.  
  1934.   tn3270eTcpConnDeviceType OBJECT-TYPE
  1935.      SYNTAX   Tn3270DeviceTypes
  1936.      MAX-ACCESS   read-only
  1937.      STATUS   current
  1938.      DESCRIPTION
  1939.          "Indicates the device type if negotiated with client.
  1940.           This object is also known as logmode."
  1941.      ::= { tn3270eTcpConnEntry 12 }
  1942.  
  1943.   tn3270eTcpConnFunctions OBJECT-TYPE
  1944.      SYNTAX   Tn3270Functions
  1945.      MAX-ACCESS   read-only
  1946.      STATUS   current
  1947.      DESCRIPTION
  1948.          "This object will indicates which of the TN3270 and TN3270E
  1949.           functions that are supported by the server was negioted
  1950.           with a client. Refer to tn3270eSrvrFunctionsSupported."
  1951.      ::= { tn3270eTcpConnEntry 13 }
  1952.  
  1953.  
  1954.   -- Conformance Definitions
  1955.  
  1956.   tn3270eGroups      OBJECT IDENTIFIER ::= { tn3270eConformance 1 }
  1957.   tn3270eCompliances OBJECT IDENTIFIER ::= { tn3270eConformance 2 }
  1958.  
  1959.   -- compliance statements
  1960.  
  1961.   tn3270eCompliance MODULE-COMPLIANCE
  1962.       STATUS  current
  1963.       DESCRIPTION
  1964.           "The compliance statement for agents that support the
  1965.           TN3270E-MIB."
  1966.       MODULE -- this module
  1967.           MANDATORY-GROUPS { tn3270eBasicGroup,
  1968.                              tn3270eSessionGroup
  1969.                            }
  1970.           GROUP       tn3270eResMapGroup
  1971.           DESCRIPTION
  1972.               "This group is optional and provides a method of
  1973.  
  1974.  
  1975.  
  1976. Expires March 1998                                             [Page 33]
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  1983.  
  1984.  
  1985.               performing tn3270eClientGroup to tn3270eResPool
  1986.               mapping."
  1987.           OBJECT tn3270eSrvrConfActivityCheck
  1988.              MIN-ACCESS  read-only
  1989.              DESCRIPTION
  1990.                 "The agent is not required to support a set to this
  1991.                  object if the associating TN3270E server doesn't
  1992.                  support either TIMEMARK or NOP processing. In
  1993.                  this case an agent should return noCheck on
  1994.                  retrieval."
  1995.           OBJECT tn3270eSrvrConfActivityTimeout
  1996.              MIN-ACCESS  read-only
  1997.              DESCRIPTION
  1998.                 "The agent is not required to support a set to this
  1999.                  object if the functions enabled by
  2000.                  tn3270eSrvrConfActivityCheck are not supported.
  2001.                  An agent in this case should return a value of 0."
  2002.           OBJECT tn3270eSrvrConfActivityInterval
  2003.              MIN-ACCESS  read-only
  2004.              DESCRIPTION
  2005.                 "The agent is not required to support a set to this
  2006.                  object if the functions enabled by
  2007.                  tn3270eSrvrConfActivityCheck are not supported.
  2008.                  An agent in this case should return a value of 0."
  2009.           OBJECT  tn3270eSrvrConfAdminStatus
  2010.              DESCRIPTION
  2011.                 "A TN3270E server is not required to support a
  2012.                  stopImmediate state transition."
  2013.       ::= { tn3270eCompliances 1 }
  2014.  
  2015.   -- units of conformance
  2016.  
  2017.   tn3270eBasicGroup OBJECT-GROUP
  2018.       OBJECTS {
  2019.           tn3270eSrvrConfInactivityTimeout,
  2020.           tn3270eSrvrConfActivityCheck,
  2021.           tn3270eSrvrConfActivityTimeout,
  2022.           tn3270eSrvrConfActivityInterval,
  2023.           tn3270eSrvrFunctionsSupported,
  2024.           tn3270eSrvrConfAdminStatus,
  2025.           tn3270eSrvrConfOperStatus,
  2026.           tn3270eSrvrConfSessionTermState,
  2027.           tn3270eSrvrConfSrvrType,
  2028.           tn3270eSrvrConfContact,
  2029.           tn3270eSrvrConfRowStatus,
  2030.           tn3270eSrvrPortRowStatus,
  2031.           tn3270eSrvrStatsUpTime,
  2032.           tn3270eSrvrStatsMaxLus,
  2033.  
  2034.  
  2035.  
  2036. Expires March 1998                                             [Page 34]
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  2043.  
  2044.  
  2045.           tn3270eSrvrStatsLusInUse,
  2046.           tn3270eSrvrStatsSpareLus,
  2047.           tn3270eSrvrStatsMaxPtrs,
  2048.           tn3270eSrvrStatsPtrsInUse,
  2049.           tn3270eSrvrStatsSparePtrs,
  2050.           tn3270eSrvrStatsConnectsIn,
  2051.           tn3270eSrvrStatsConnRejects,
  2052.           tn3270eSrvrStatsDisconnects,
  2053.           tn3270eSrvrStatsOctetsIn,
  2054.           tn3270eSrvrStatsOctetsInLow,
  2055.           tn3270eSrvrStatsOctetsOut,
  2056.           tn3270eSrvrStatsOctetsOutLow,
  2057.           tn3270eClientGroupSubnetMask,
  2058.           tn3270eClientGroupPfxLength,
  2059.           tn3270eClientGroupRowStatus,
  2060.           tn3270eSnaMapLocalName
  2061.       }
  2062.       STATUS  current
  2063.       DESCRIPTION
  2064.           "This group is mandatory for all hosts supporting the
  2065.            TN3270E-MIB."
  2066.       ::= { tn3270eGroups 1 }
  2067.  
  2068.   tn3270eSessionGroup OBJECT-GROUP
  2069.       OBJECTS {
  2070.           tn3270eResMapAddrType,
  2071.           tn3270eResMapAddress,
  2072.           tn3270eResMapPort,
  2073.           tn3270eResMapElementType,
  2074.           tn3270eTcpConnLastActivity,
  2075.           tn3270eTcpConnBytesIn,
  2076.           tn3270eTcpConnBytesOut,
  2077.           tn3270eTcpConnResourceElement,
  2078.           tn3270eTcpConnResourceType,
  2079.           tn3270eTcpConnDeviceType,
  2080.           tn3270eTcpConnFunctions
  2081.         }
  2082.       STATUS  current
  2083.       DESCRIPTION
  2084.           "This group is mandatory for all hosts supporting the
  2085.            TN3270E-MIB."
  2086.       ::= { tn3270eGroups 2 }
  2087.  
  2088.   tn3270eResMapGroup OBJECT-GROUP
  2089.       OBJECTS {
  2090.           tn3270eResPoolElementType,
  2091.           tn3270eResPoolRowStatus,
  2092.           tn3270eClientResMapRowStatus
  2093.  
  2094.  
  2095.  
  2096. Expires March 1998                                             [Page 35]
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  2103.  
  2104.  
  2105.         }
  2106.       STATUS  current
  2107.       DESCRIPTION
  2108.           "This group is optional for all hosts supporting the
  2109.            TN3270E-MIB."
  2110.       ::= { tn3270eGroups 3 } END
  2111.  
  2112.  
  2113. 5.  Security Considerations
  2114.  
  2115.   Certain management information defined in this MIB may be considered
  2116.   sensitive in some network environments.  Therefore, authentication of
  2117.   received SNMP requests and controlled access to management information
  2118.   should be employed in such environments.  The method for this
  2119.   authentication is a function of the SNMP Administrative Framework, and
  2120.   has not been expanded by this MIB.
  2121.  
  2122.   Several objects in this MIB allow write access or provide for remote
  2123.   creation. Allowing this support in a non-secure environment can have a
  2124.   negative effect on network operations.  It is recommended that
  2125.   implementers seriously consider whether set operations should be
  2126.   allowed without providing, at a minimum, authentication of request
  2127.   origin. It it recommended that without such support that the following
  2128.   objects be implemented as read-only:
  2129.  
  2130.       o tn3270eSrvrConfInactivityTimout
  2131.       o tn3270eSrvrConfActivityCheck
  2132.       o tn3270eSrvrConfActivityTimeout
  2133.       o tn3270eSrvrConfActivityInterval
  2134.       o tn3270eSrvrConfAdminStatus
  2135.       o tn3270eSrvrConfSessionTermState
  2136.       o tn3270eSrvrConfContact
  2137.       o tn3270eClientGroupSubnetMask
  2138.       o tn3270eResPoolElementType
  2139.  
  2140.   The following objects should either be implemented as read-only or not
  2141.   implemented when security is an issue as previously discussed:
  2142.  
  2143.       o tn3270eSrvrConfRowStatus
  2144.       o tn3270eSrvrPortRowStatus
  2145.       o tn3270eClientGroupRowStatus
  2146.       o tn3270eResPoolRowStatus
  2147.       o tn3270eResMapRowStatus
  2148.  
  2149.  
  2150. 6.  Acknowledgments
  2151.  
  2152.   This document is a product of the TN3270E Working Group.
  2153.  
  2154.  
  2155.  
  2156. Expires March 1998                                             [Page 36]
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  2163.  
  2164.  
  2165. 7.  References
  2166.  
  2167.  
  2168. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  2169.      Waldbusser S., "Structure of Management Information for version 2
  2170.      of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  2171.      January 1996.
  2172.  
  2173.  
  2174. [2]  Network Working Group, Postel, J., and Reynolds, J., "Telnet
  2175.      Protocol Specification", RFC 854, May 1983.
  2176.  
  2177.  
  2178. [3]  Network Working Group, Postel, J., and Reynolds, J., "Telnet Timing
  2179.      Mark Option", RFC 860, May 1983.
  2180.  
  2181.  
  2182. [4]  Network Working Group and Rekhter J., "Telnet 3270 Regime Option",
  2183.      RFC 1041, January 1988.
  2184.  
  2185.  
  2186. [5]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  2187.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  2188.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  2189.      March 1991.
  2190.  
  2191.  
  2192. [6]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  2193.      Waldbusser, "Textual Conventions for version 2 of the Simple
  2194.      Network Management Protocol (SNMPv2)", RFC 1903, January 1996.
  2195.  
  2196.  
  2197. [7]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  2198.      Waldbusser, "Protocol Operations for version 2 of the Simple
  2199.      Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  2200.  
  2201.  
  2202. [8]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  2203.      Waldbusser, "Conformance Statements for version 2 of the Simple
  2204.      Network Management Protocol (SNMPv2)", RFC 1904, January 1996.
  2205.  
  2206.  
  2207. [9]  Case, J., M. Fedor, M. Schoffstall, J. Davin, "Simple Network
  2208.      Management Protocol", RFC 1157, SNMP Research, Performance Systems
  2209.      International, MIT Laboratory for Computer Science, May 1990.
  2210.  
  2211.  
  2212. [10] IETF SNMPv2 Working Group and McCloghrie, K., "TCP-MIB
  2213.  
  2214.  
  2215.  
  2216. Expires March 1998                                             [Page 37]
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222. White      TN3270E Management Information Base (TN3270E-MIB)     13 September 1997
  2223.  
  2224.  
  2225.      Definitions", November 1994.
  2226.  
  2227.  
  2228. [11] Hinden, R., Deering, S., "IP Version 6 Addressing Architecture",
  2229.      <draft-ietf-ipngwg-addr-arch-v2-02.txt>, July 16, 1997
  2230.  
  2231.  
  2232. [12] Krupczak, Cheryl, Saperia, Jonathan, "Definitions of System-Level
  2233.      Managed Objects for Applications", April 15, 1997.
  2234.  
  2235.  
  2236. 8.  Authors' Address
  2237.  
  2238.   Kenneth D. White
  2239.   Dept. G80/Bldg 503
  2240.   IBM Corporation
  2241.   Research Triangle Park, NC 27709, USA
  2242.   E-mail: kennethw@vnet.ibm.com
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276. Expires March 1998                                             [Page 38]
  2277.  
  2278.  
  2279.