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-02.txt < prev    next >
Text File  |  1997-08-28  |  55KB  |  1,737 lines
  1.  
  2.  
  3. TN3270E Working Group
  4. INTERNET DRAFT: <draft-ietf-tn3270e-tn3270-mib-02.txt>     Kenneth White
  5. Expiration Date: January, 1998
  6.                                                                IBM Corp.
  7.  
  8.                                                                July 1997
  9.  
  10.                 Base Definitions of Managed Objects for
  11.                           TN3270E Using SMIv2
  12.  
  13.                  <draft-ietf-tn3270e-tn3270-mib-02.txt>
  14.  
  15.  
  16. Status of this Memo
  17.  
  18.   This document is an Internet Draft. Internet Drafts are working
  19.   documents of the Internet Engineering Task Force (IETF), its Areas,
  20.   and its Working Groups. Note that other groups may also distribute
  21.   working documents as Internet Drafts.
  22.  
  23.   Internet Drafts are draft documents valid for a maximum of six
  24.   months. Internet Drafts may be updated, replaced, or obsoleted by
  25.   other documents at any time. It is not appropriate to use Internet
  26.   Drafts as reference material or to cite them other than as a "working
  27.   draft" or "work in progress."
  28.  
  29.   Please check the I-D abstract listing contained in each Internet
  30.   Draft directory to learn the current status of this or any Internet
  31.   Draft. Distribution of this document is unlimited.
  32.  
  33. Abstract
  34.  
  35.   The purpose of this memo is to define a Management Information Base
  36.   (MIB) for configuring and managing TN3270E Servers.
  37.   The MIB defined by this memo is intended to provide generic
  38.   support for both Host and Gateway TN3270E Server implementations.
  39.   It is the intent that the MIB defined herein be extended
  40.   by subsequent memos to provide non-generic configuration support
  41.   and to enable TN3270E Response Time Collection.
  42.  
  43.   It is the intent of this MIB to fully adhere to all prerequisite MIBs
  44.   unless explicitly stated. Deviations will be documented in
  45.   corresponding conformance statements. The specification of this MIB
  46.   will utilize the Structure of Management Information (SMI) for
  47.   Version 2 of the Simple Network Management Protocol Version (refer to
  48.   RFC1902, reference [1]).
  49.  
  50.   Table of Contents
  51.  
  52.  
  53.  
  54. Expires January 1998                                            [Page 1]
  55.  
  56.  
  57.  
  58.  
  59.  
  60. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  61.  
  62.  
  63.  
  64.   1.0 Introduction............................................. 2
  65.   2.0 The SNMPv2 Network Management Framework.................. 2
  66.   2.1 Object Definitions....................................... 3
  67.   3.0 Structure of the MIB..................................... 3
  68.   3.1 TN3270E Server Control................................... 3
  69.   3.1.1 tn3270eSrvrConfTable................................... 4
  70.   3.1.2 tn3270eSrvrPortTable................................... 4
  71.   3.1.3 tn3270eSrvrStatsTable.................................. 5
  72.   3.2 TN3270E Server Resource Configuration.................... 5
  73.   3.3 Resource/IP Address Mappings............................. 5
  74.   3.3.1 tn3270eResMapTable..................................... 5
  75.   3.3.2 TCP Connection Table Additions......................... 5
  76.   4.0 Definitions.............................................. 6
  77.   5.0 Security Considerations..................................27
  78.   6.0 Acknowledgments..........................................27
  79.   7.0 References...............................................28
  80.   8.0 Authors' Address.........................................29
  81.  
  82.  
  83. 1.  Introduction
  84.  
  85.   This document is a product of the TN3270E Working Group. Its purpose
  86.   is to define a MIB module for extending the traditional MIBs supported
  87.   by a TCP/IP implementation for configuration and management of TN3270E
  88.   Servers.
  89.  
  90.   This memo considers IPv6 addressability to be out of scope with
  91.   respect to the MIB module defined herein. It is the intent of the
  92.   author of this document to address IPv6 addressing in an additional
  93.   submission.
  94.  
  95.  
  96. 2.  The SNMPv2 Network Management Framework
  97.  
  98.   The SNMP Network Management Framework presently consists of three
  99.   major components.  They are:
  100.  
  101.   o the SMI, described in RFC 1902 [1], - the mechanisms used for
  102.     describing and naming objects for the purpose of management.
  103.  
  104.   o the MIB-II, STD 17, RFC 1213 [5], - the core set of managed
  105.     objects for the Internet suite of protocols.
  106.  
  107.   o the protocol, RFC 1157 [9] and/or RFC 1905 [7] - the protocol
  108.     for accessing managed information.
  109.  
  110.   Textual conventions are defined in RFC 1903 [6], and conformance
  111.  
  112.  
  113.  
  114. Expires January 1998                                            [Page 2]
  115.  
  116.  
  117.  
  118.  
  119.  
  120. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  121.  
  122.  
  123.   statements are defined in RFC 1904 [8].
  124.  
  125.   The Framework permits new objects to be defined for the purpose of
  126.   experimentation and evaluation.
  127.  
  128.   This memo specifies a MIB module that is compliant to the SNMPv2 SMI.
  129.   A semantically identical MIB conforming to the SNMPv1 SMI can be
  130.   produced through the appropriate translation.
  131.  
  132.  
  133. 2.1.  Object Definitions
  134.  
  135.   Managed objects are accessed via a virtual information store, termed
  136.   the Management Information Base or MIB.  Objects in the MIB are
  137.   defined using the subset of Abstract Syntax Notation One (ASN.1)
  138.   defined in the SMI.  In particular, each object object type is named
  139.   by an OBJECT IDENTIFIER, an administratively assigned name.  The
  140.   object type together with an object instance serves to uniquely
  141.   identify a specific instantiation of the object.  For human
  142.   convenience, we often use a textual string, termed the descriptor, to
  143.   refer to the object type.
  144.  
  145.  
  146.  
  147. 3.  Structure of the MIB
  148.  
  149.   The TN3270E-MIB is split into the following components:
  150.  
  151.     o TN3270E Server Control
  152.     o TN3270E Server Resource Configuration
  153.     o Resource/IP Address Mappings
  154.  
  155.   The TN3270E-MIB is defined for support primarily by TN3270E Servers.
  156.   Use of this MIB by TN3270 Servers that do not support the TN3270E
  157.   protocol is not explicitly addressed by this memo. A significant
  158.   portion of the objects do apply in the TN3270 only case.  Addressing
  159.   the TN3270 only case was not done since it is unlikely that this MIB
  160.   would be implemented by TN3270 only servers.
  161.  
  162.  
  163. 3.1.  TN3270E Server Control
  164.  
  165.   This group of objects provides for TN3270E Server configuration and
  166.   consists of:
  167.  
  168.       o tn3270eSrvrConfTable
  169.       o tn3270eSrvrPortTable
  170.       o tn3270eSrvrStatsTable
  171.  
  172.  
  173.  
  174. Expires January 1998                                            [Page 3]
  175.  
  176.  
  177.  
  178.  
  179.  
  180. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  181.  
  182.  
  183. 3.1.1.  tn3270eSrvrConfTable
  184.  
  185.   The tn3270eSrvrConfTable contains a set of objects primarily for
  186.   configuring and managing a TN3270E Server. This table, as well most of
  187.   the tables in the TN3270E-MIB, are structured to be indexed by a
  188.   unsigned integer, tn3270eSrvrConfIndex.  The primary index element,
  189.   tn3270eSrvrConfigIndex, enables support of multiple TN3270E Servers on
  190.   the same host.
  191.  
  192.   An earlier version of this memo had used the local IP Address
  193.   associated with a TN3270E Server along with tn3270eSrvrConfIndex as
  194.   the primary indexes into most of its tables.  Use of a local IP
  195.   Address was thought to enable representation of these tables by
  196.   management applications.  This approach was dropped since it
  197.   introduces a level of complexity with respect to MIB table indexing
  198.   for little actually benefit.
  199.  
  200.   tn3270eSrvrConfInactivityTimer defines the inactivity period for
  201.   TN3270 and TN3270E Sessions. tn3270eSrvrConfSessionTermState defines
  202.   how a session should be terminated. The three objects:
  203.  
  204.       o tn3270eSrvrConfActivityCheck
  205.       o tn3270eSrvrConfActivityTimeout
  206.       o tn3270eSrvrConfActivityInterval
  207.  
  208.   defines the parameters for performing the "Telnet Timing Mark Option"
  209.   as defined by RFC 860 [3].  The object tn3270eSrvrConfActivityCheck is
  210.   defined to enable selection of either a NOP command or a TIMEMARK
  211.   command.  Sending a NOP command results in less overhead then a
  212.   TIMEMARK command since a client doesn't send a reply.
  213.  
  214.   The objects tn3270eSrvrConfAdminStatus and tn3270eSrvrConfOperStatus
  215.   exists in order to enable remote starting and stopping of a TN3270E
  216.   Server.  tn3270eSrvrConfFunctionsSupported indicates which of the
  217.   TN3270 and TN3270E options that a server supports.  The object
  218.   tn3270eSrvrConfSessionTermState defines as a global option what
  219.   processing steps that a TN3270E Server should perform when a TN3270E
  220.   Session terminates with respect to the associating TCP Connection.
  221.   The object tn3270eSrvrConfSrvrType indicates the implementation type
  222.   of TN3270E Server that the tn3270eSrvrConfEntry represents.  The
  223.   object tn3270eSrvrConfRowStatus provides the capability to perform
  224.   remote creation and deletion operations on this table.
  225.  
  226.  
  227. 3.1.2.  tn3270eSrvrPortTable
  228.  
  229.   The tn3270eSrvrPortTable exists in order to assign and retrieve the
  230.   local ports associated with a TN3270E Server. Some TN3270E Server
  231.  
  232.  
  233.  
  234. Expires January 1998                                            [Page 4]
  235.  
  236.  
  237.  
  238.  
  239.  
  240. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  241.  
  242.  
  243.   implementations support multiple local port usage.
  244.  
  245.  
  246. 3.1.3.  tn3270eSrvrStatsTable
  247.  
  248.   The tn3270eSrvrStatsTable defines a series of objects used to provide
  249.   general statistics on the use of a TN3270E Server.
  250.  
  251.  
  252. 3.2.  TN3270E Server Resource Configuration
  253.  
  254. The TN3270E Server Resource Configuration collection of objects consists
  255. of three tables:
  256.  
  257.     o tn3270eIpGroupTable
  258.     o tn3270eResPoolTable
  259.     o tn3270eIpResMapTable
  260.  
  261.  
  262. The tn3270eIpGroupTable and tn3270eResPoolTable enable
  263. implementations to define groupings of both IP Addresses and Resource
  264. Pools for mapping IP Addresses to resources. The mapping of a IP Group
  265. to a Resource Pool is enabled via the tn3270eIpResMapTable.
  266.  
  267.  
  268.  
  269. 3.3.  Resource/IP Address Mappings
  270.  
  271. Two tables are defined by this memo to enable mapping of Resource Name
  272. to IP Address and IP Address to Resource Name:
  273.  
  274.     o tn3270eResMapTable
  275.     o TCP Connection Table Additions
  276.  
  277.  
  278. 3.3.1.  tn3270eResMapTable
  279.  
  280. The tn3270eResMapTable is a read-only table that provides for mapping a
  281. resource name to a IP Client's IP Address. An entry in this table is
  282. added when a TCP Connection is received by a TN3270E Server and mapped
  283. to a resource. The entry is deleted with the resource to IP Address
  284. association is no longer valid.
  285.  
  286.  
  287. 3.3.2.  TCP Connection Table Additions
  288.  
  289.   The TCP Connection Table is defined by RFC 2012 (Refer to reference
  290.   10, TCP-MIB Definitions). Traditionally, the contents of the TCP
  291.  
  292.  
  293.  
  294. Expires January 1998                                            [Page 5]
  295.  
  296.  
  297.  
  298.  
  299.  
  300. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  301.  
  302.  
  303.   Connection Table has been implementation dependent.  Its formal
  304.   definition consists of the following objects:
  305.  
  306.      o tcpConnState (INTEGER)
  307.      o tcpConnLocalAddress (IpAddress)
  308.      o tcpConnLocalPort (INTEGER)
  309.      o tcpConnRemAddress (IpAddress)
  310.      o tcpConnRemPort (INTEGER)
  311.  
  312.   and is indexed by: tcpConnLocalAddress, tcpConnLocalPort,
  313.   tcpConnRemAddress and tcpConnRemPort. The tn3270eTcpConnTableGroup
  314.   contains the objects defined by the tn3270eTcpConnTable for keeping a
  315.   list of the current set of TN3270 and TN3270E sessions at a TN3270E
  316.   Server. The tn3270eTcpConnTable has the same index elements as the
  317.   tcpConnTable but doesn't AUGMENT it since the relationship is not
  318.   one-to-one.
  319.  
  320.  
  321. 4.  Definitions
  322.  
  323.   TN3270E-MIB DEFINITIONS ::= BEGIN
  324.  
  325.   IMPORTS
  326.       MODULE-IDENTITY, OBJECT-TYPE, BITS, Unsigned32,
  327.       experimental, IpAddress, TimeTicks,
  328.       Counter32, Gauge32
  329.           FROM SNMPv2-SMI
  330.       TEXTUAL-CONVENTION, RowStatus, DisplayString
  331.           FROM SNMPv2-TC
  332.       MODULE-COMPLIANCE, OBJECT-GROUP
  333.           FROM SNMPv2-CONF
  334.       tcpConnLocalAddress, tcpConnLocalPort,
  335.       tcpConnRemAddress, tcpConnRemPort
  336.           FROM TCP-MIB
  337.       ;
  338.  
  339.   tn3270eMIB MODULE-IDENTITY
  340.       LAST-UPDATED "9707280000Z" -- July 28, 1997
  341.       ORGANIZATION "TN3270E Working Group"
  342.       CONTACT-INFO
  343.           "Kenneth White (kennethw@vnet.ibm.com)
  344.            IBM Corp."
  345.       DESCRIPTION
  346.           "This module defines a portion of the management
  347.           information base (MIB) for managing TN3270E Servers"
  348.       -- Need an experimental OID from IANA
  349.       ::= { experimental 2001 }
  350.  
  351.  
  352.  
  353.  
  354. Expires January 1998                                            [Page 6]
  355.  
  356.  
  357.  
  358.  
  359.  
  360. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  361.  
  362.  
  363.   -- Textual Conventions
  364.  
  365.   Tn3270ResourceType ::= TEXTUAL-CONVENTION
  366.       STATUS      current
  367.       DESCRIPTION
  368.           "The type of resource defined by a Resource Pool. Refer
  369.           to tn3270eResPoolTable."
  370.       SYNTAX      INTEGER {
  371.                             other(0),
  372.                             lu(1),
  373.                             printer(2)
  374.                           }
  375.  
  376.   Tn3270Functions ::= TEXTUAL-CONVENTION
  377.       STATUS      current
  378.       DESCRIPTION
  379.           "This textual convention is intended to reflect the
  380.           current set of TN3270 and TN3270E functions that can
  381.           be negotiated between a server and its client:
  382.  
  383.           RFC856
  384.           transmitBinary    The sender of this command REQUESTS
  385.                             permission to begin transmitting, or
  386.                             confirms that it will now begin transmitting
  387.                             characters which are to be interpreted
  388.                             as 8 bits of binary data by
  389.                             the receiver of the data.
  390.           RFC820
  391.           timeMark         The sender of this command REQUESTS that
  392.                            the receiver of this command return a WILL
  393.                            TIMING-MARK in the data stream at the
  394.                            'appropriate place' ...
  395.           RFC885
  396.           endOfRecord      The sender of this command requests
  397.                            permission to begin transmission of the
  398.                            Telnet END-OF-RECORD (EOR) code when
  399.                            transmitting data characters, or
  400.                            the sender of this command confirms it will
  401.                            now begin transmission of EORs with
  402.                            transmitted data characters.
  403.           RFC1091
  404.           terminalType     Sender is willing to send terminal type
  405.                            information in a subsequent sub-negotiation.
  406.           RFC1041
  407.           tn3270Regime     Sender is willing to send list of supported
  408.                            3270 Regimes in a subsequent sub-negotiation.
  409.           RFC1647
  410.           scsCtlCodes     (Printer sessions only).  Allows the use
  411.  
  412.  
  413.  
  414. Expires January 1998                                            [Page 7]
  415.  
  416.  
  417.  
  418.  
  419.  
  420. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  421.  
  422.  
  423.                           of the SNA Character Stream (SCS) and SCS
  424.                           control codes on the session.  SCS is
  425.                           used with LU type 1 SNA sessions.
  426.           dataStreamCtl   (Printer sessions only).  Allows the use
  427.                           of the standard 3270 data stream.  This
  428.                           corresponds to LU type 3 SNA sessions.
  429.           responses       Provides support for positive and
  430.                           negative response handling.  Allows the
  431.                           server to reflect to the client any and
  432.                           all definite, exception, and no response
  433.                           requests sent by the host application.
  434.           bindImage       Allows the server to send the SNA Bind
  435.                           image and Unbind notification to the
  436.                           client.
  437.           sysreq          Allows the client and server to emulate
  438.                           some (or all, depending on the server) of
  439.                           the functions of the SYSREQ key in an SNA
  440.                           environment."
  441.       SYNTAX      BITS {
  442.                          transmitBinary(0),-- rfc856
  443.                          timemark(1),      -- rfc860
  444.                          endOfRecord(2),   -- rfc885
  445.                          terminalType(3),  -- rfc1091
  446.                          tn3270Regime(4),  -- rfc1041
  447.                          scsCtlCodes(5),   -- rfc1647
  448.                          dataStreamCtl(6), -- rfc1647
  449.                          responses(7),     -- rfc1647
  450.                          bindImage(8),     -- rfc1647
  451.                          sysreq(9)         -- rfc1647
  452.                        }
  453.  
  454.   Tn3270DeviceTypes ::= TEXTUAL-CONVENTION
  455.       STATUS      current
  456.       DESCRIPTION
  457.           "This textual convention defines the list of device types
  458.           that can be set as defined by RFC 1647."
  459.       SYNTAX      INTEGER { -- terminals
  460.                     unknown(0),
  461.                     ibm3278d2(1),    -- (24 row x 80 col display)
  462.                     ibm3278d2E(2),   -- (24 row x 80 col display)
  463.                     ibm3278d3(3),    -- (32 row x 80 col display)
  464.                     ibm3278d3E(4),   -- (32 row x 80 col display)
  465.                     ibm3278d4(5),    -- (43 row x 80 col display)
  466.                     ibm3278d4E(6),   -- (43 row x 80 col display)
  467.                     ibm3278d5(7),    -- (27 row x 132 col display)
  468.                     ibm3278d5E(8),   -- (27 row x 132 col display)
  469.                     ibmDynamic(9),   -- (no pre-defined display size)
  470.                     ibm3287d1(10)    -- printers
  471.  
  472.  
  473.  
  474. Expires January 1998                                            [Page 8]
  475.  
  476.  
  477.  
  478.  
  479.  
  480. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  481.  
  482.  
  483.            }
  484.  
  485.   -- Top-level structure of the MIB
  486.  
  487.   tn3270eNotifications  OBJECT IDENTIFIER ::= { tn3270eMIB 0 }
  488.   tn3270eObjects        OBJECT IDENTIFIER ::= { tn3270eMIB 1 }
  489.   tn3270eConformance    OBJECT IDENTIFIER ::= { tn3270eMIB 3 }
  490.  
  491.   -- MIB Objects
  492.  
  493.   tn3270eSrvrConfTable OBJECT-TYPE
  494.       SYNTAX      SEQUENCE OF Tn3270eSrvrConfEntry
  495.       MAX-ACCESS  not-accessible
  496.       STATUS      current
  497.       DESCRIPTION
  498.           "This table defines the configuration elements for
  499.           TN3270E Servers. The number of entries in this table
  500.           is expected to vary depending on the location of the
  501.           table. A particular TN3270E Server is expected to
  502.           have a single entry. Modeling of the configuration
  503.           elements as a table allows multiple
  504.           TN3270E Servers to exist at the same host."
  505.       ::= { tn3270eObjects 1 }
  506.  
  507.   tn3270eSrvrConfEntry OBJECT-TYPE
  508.       SYNTAX      Tn3270eSrvrConfEntry
  509.       MAX-ACCESS  not-accessible
  510.       STATUS      current
  511.       DESCRIPTION
  512.           "Definition of the configuration elements for a single
  513.           TN3270E Server."
  514.       INDEX       { tn3270eSrvrConfIndex }
  515.       ::= { tn3270eSrvrConfTable 1 }
  516.  
  517.   Tn3270eSrvrConfEntry ::= SEQUENCE {
  518.       tn3270eSrvrConfIndex             Unsigned32,
  519.       tn3270eSrvrConfInactivityTimeout Unsigned32,
  520.       tn3270eSrvrConfActivityCheck     INTEGER,
  521.       tn3270eSrvrConfActivityTimeout   Unsigned32,
  522.       tn3270eSrvrConfActivityInterval  Unsigned32,
  523.       tn3270eSrvrFunctionsSupported    Tn3270Functions,
  524.       tn3270eSrvrConfAdminStatus       INTEGER,
  525.       tn3270eSrvrConfOperStatus        INTEGER,
  526.       tn3270eSrvrConfSessionTermState  INTEGER,
  527.       tn3270eSrvrConfSrvrType          INTEGER,
  528.       tn3270eSrvrConfRowStatus         RowStatus
  529.     }
  530.  
  531.  
  532.  
  533.  
  534. Expires January 1998                                            [Page 9]
  535.  
  536.  
  537.  
  538.  
  539.  
  540. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  541.  
  542.  
  543.   tn3270eSrvrConfIndex  OBJECT-TYPE
  544.       SYNTAX      Unsigned32
  545.       MAX-ACCESS  not-accessible
  546.       STATUS      current
  547.       DESCRIPTION
  548.          "Indicates the instance of a TN3270E Server that
  549.           exists at a IP Host."
  550.       ::= { tn3270eSrvrConfEntry 1 }
  551.  
  552.   tn3270eSrvrConfInactivityTimeout OBJECT-TYPE
  553.       SYNTAX      Unsigned32 (0..99999999)
  554.       UNITS "seconds"
  555.       MAX-ACCESS  read-create
  556.       STATUS      current
  557.       DESCRIPTION
  558.          "The inactivity time-out specified in seconds. When a
  559.           connection has been inactive for the number of seconds
  560.           specified by this object it is closed. The default of
  561.           0 means no inactivity time-out."
  562.       DEFVAL { 0 }
  563.       ::= { tn3270eSrvrConfEntry 2 }
  564.  
  565.   tn3270eSrvrConfActivityCheck OBJECT-TYPE
  566.       SYNTAX      INTEGER {
  567.                             noCheck(0),
  568.                             timeMark(1),
  569.                             nop(2)
  570.                           }
  571.       MAX-ACCESS  read-create
  572.       STATUS      current
  573.       DESCRIPTION
  574.          "This object is intended to enable either timemark or
  575.           nop processing."
  576.       DEFVAL { noCheck }
  577.       ::= { tn3270eSrvrConfEntry 3 }
  578.  
  579.   tn3270eSrvrConfActivityTimeout OBJECT-TYPE
  580.       SYNTAX      Unsigned32 (1..99999999)
  581.       UNITS "seconds"
  582.       MAX-ACCESS  read-create
  583.       STATUS      current
  584.       DESCRIPTION
  585.          "The TIMEMARK or NOP processing time-out specified in seconds.
  586.           Note that a value of 0 is not allowed for this object since
  587.           the function that uses this object relies on
  588.           tn3270eSrvrConfActivityCheck for function enablement."
  589.       DEFVAL { 600 }   -- 10 minutes
  590.       ::= { tn3270eSrvrConfEntry 4 }
  591.  
  592.  
  593.  
  594. Expires January 1998                                           [Page 10]
  595.  
  596.  
  597.  
  598.  
  599.  
  600. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  601.  
  602.  
  603.   tn3270eSrvrConfActivityInterval OBJECT-TYPE
  604.       SYNTAX      Unsigned32 (1..99999999)
  605.       UNITS "seconds"
  606.       MAX-ACCESS  read-create
  607.       STATUS      current
  608.       DESCRIPTION
  609.          "The scan interval to be used by a TN3270E Server.
  610.           TIMEMARK or NOP processing scans the Telnet sessions
  611.           on the interval provided by this object looking for
  612.           sessions that have been idle for more than the value
  613.           provided by tn3270eSrvrConfActivityTimeout.
  614.           Note that a value of 0 is not allowed for this object since
  615.           the function that uses this object relies on
  616.           tn3270eSrvrConfActivityCheck for function enablement."
  617.       DEFVAL { 120 }   -- 2 minutes
  618.       ::= { tn3270eSrvrConfEntry 5 }
  619.  
  620.   tn3270eSrvrFunctionsSupported OBJECT-TYPE
  621.       SYNTAX    Tn3270Functions
  622.       MAX-ACCESS  read-only
  623.       STATUS      current
  624.       DESCRIPTION
  625.          "This object indicates the functions supported by a
  626.           TN3270E Server."
  627.       DEFVAL { { scsCtlCodes, dataStreamCtl,
  628.                  responses, bindImage, sysreq } }
  629.       ::= { tn3270eSrvrConfEntry 6 }
  630.  
  631.   tn3270eSrvrConfAdminStatus OBJECT-TYPE
  632.       SYNTAX  INTEGER {
  633.                         up(1),
  634.                         down(2),
  635.                         stopImmediate(3)
  636.                       }
  637.       MAX-ACCESS  read-create
  638.       STATUS      current
  639.       DESCRIPTION
  640.           "The desired state of the TN3270E Server:
  641.  
  642.            up(1)            - Activate a TN3270E Server.
  643.            down(2)          - Informs the associating TN3270E Server
  644.                               to gracefully terminate its processing.
  645.            stopImmediate(3) - Informs the associating TN3270E Server
  646.                               to terminate immediately.
  647.  
  648.            Implementation as to the exact symantics of either down(2)
  649.            or stopImmediate(3) processing is left as implementation
  650.            dependent. A TN3270E Server that does not distinquish
  651.  
  652.  
  653.  
  654. Expires January 1998                                           [Page 11]
  655.  
  656.  
  657.  
  658.  
  659.  
  660. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  661.  
  662.  
  663.            between down or stopImmediate transitions should not
  664.            support stopImmediate."
  665.       ::= { tn3270eSrvrConfEntry 7 }
  666.  
  667.   tn3270eSrvrConfOperStatus OBJECT-TYPE
  668.       SYNTAX  INTEGER {
  669.                         up(1),
  670.                         down(2)
  671.                       }
  672.       MAX-ACCESS  read-only
  673.       STATUS      current
  674.       DESCRIPTION
  675.          "The current operational state of a TN3270E Server:
  676.  
  677.           up(1)   - The corresponding TN3270E Server is active.
  678.           down(2) - The corresponding TN3270E Server is inactive."
  679.       ::= { tn3270eSrvrConfEntry 8 }
  680.  
  681.   tn3270eSrvrConfSessionTermState OBJECT-TYPE
  682.       SYNTAX  INTEGER {
  683.                         terminate(1),
  684.                         luSessionPend(2),
  685.                         queueSession(3)
  686.                       }
  687.       MAX-ACCESS  read-create
  688.       STATUS      current
  689.       DESCRIPTION
  690.          "The current state for determining what a TN3270E Server
  691.           should do when a TN3270 Session terminates:
  692.  
  693.          terminate(1)     => Terminate TCP connection.
  694.          luSessionPend(2) => Do not drop the TCP Connection
  695.                              associated with a IP Client when their
  696.                              TN3270 Session ends. Processing should
  697.                              redrive session initialization as if the
  698.                              client was first connecting.
  699.          queueSession(3)  => QUEUESESSION deals with CLSDST-Pass.
  700.                              An example is the easiest explanation.
  701.                              Assume APPL1 does a CLSDST-Pass
  702.                              to APPL2.  Then the client logs off APPL
  703.                              Without QUEUESESSION the connection
  704.                              would now be broken. With QUEUESESSION
  705.                              the TN3270E Server keeps the LU around
  706.                              after getting the APPL2 unbind waiting
  707.                              for a bind from APPL1."
  708.       DEFVAL { terminate }
  709.       ::= { tn3270eSrvrConfEntry 9 }
  710.  
  711.  
  712.  
  713.  
  714. Expires January 1998                                           [Page 12]
  715.  
  716.  
  717.  
  718.  
  719.  
  720. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  721.  
  722.  
  723.   tn3270eSrvrConfSrvrType OBJECT-TYPE
  724.       SYNTAX      INTEGER {
  725.                             unknown(0),
  726.                             host(1),
  727.                             gateway(2)
  728.                           }
  729.       MAX-ACCESS  read-only
  730.       STATUS      current
  731.       DESCRIPTION
  732.           "This object indicates the type of TN3270E Server.
  733.           The existence of MIB tables and objects that will be
  734.           defined by follow-on MIBs may be predicated on whether the
  735.           TN3270E Server can be local to the same host as a
  736.           Target Application (host(1)) or will always be remote
  737.           (gateway(2))."
  738.       ::= { tn3270eSrvrConfEntry 10 }
  739.  
  740.   tn3270eSrvrConfRowStatus OBJECT-TYPE
  741.       SYNTAX      RowStatus
  742.       MAX-ACCESS  read-create
  743.       STATUS      current
  744.       DESCRIPTION
  745.           "This object allows entries to be created and deleted in the
  746.           tn3270eSrvrConfTable.
  747.  
  748.           An entry in this table is deleted by setting this object
  749.           to destroy(6)."
  750.       REFERENCE
  751.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  752.           Network Management Protocol (SNMPv2).'"
  753.       ::= { tn3270eSrvrConfEntry 11 }
  754.  
  755.   tn3270eSrvrPortTable OBJECT-TYPE
  756.       SYNTAX      SEQUENCE OF Tn3270eSrvrPortEntry
  757.       MAX-ACCESS  not-accessible
  758.       STATUS      current
  759.       DESCRIPTION
  760.           "This table defines the TCP ports associated with TN3270E
  761.           Servers."
  762.       ::= { tn3270eObjects 2 }
  763.  
  764.   tn3270eSrvrPortEntry OBJECT-TYPE
  765.       SYNTAX      Tn3270eSrvrPortEntry
  766.       MAX-ACCESS  not-accessible
  767.       STATUS      current
  768.       DESCRIPTION
  769.           "Definition of a single TCP port assignment to a
  770.            TN3270E Server."
  771.  
  772.  
  773.  
  774. Expires January 1998                                           [Page 13]
  775.  
  776.  
  777.  
  778.  
  779.  
  780. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  781.  
  782.  
  783.       INDEX       { tn3270eSrvrConfIndex, tn3270eSrvrPort }
  784.       ::= { tn3270eSrvrPortTable 1 }
  785.  
  786.   Tn3270eSrvrPortEntry ::= SEQUENCE {
  787.       tn3270eSrvrPort                 Unsigned32,
  788.       tn3270eSrvrPortRowStatus        RowStatus
  789.     }
  790.  
  791.   tn3270eSrvrPort OBJECT-TYPE
  792.       SYNTAX      Unsigned32 (0..65535)
  793.       MAX-ACCESS  not-accessible
  794.       STATUS      current
  795.       DESCRIPTION
  796.          "Indicates a port assigned to a server."
  797.       ::= { tn3270eSrvrPortEntry 1 }
  798.  
  799.   tn3270eSrvrPortRowStatus OBJECT-TYPE
  800.       SYNTAX      RowStatus
  801.       MAX-ACCESS  read-create
  802.       STATUS      current
  803.       DESCRIPTION
  804.           "This object allows entries to be created and deleted in the
  805.           tn3270eSrvrPortTable.
  806.  
  807.           An entry in this table is deleted by setting this object
  808.           to destroy(6)."
  809.       REFERENCE
  810.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  811.           Network Management Protocol (SNMPv2).'"
  812.       ::= { tn3270eSrvrPortEntry 2 }
  813.  
  814.   tn3270eSrvrStatsTable OBJECT-TYPE
  815.       SYNTAX      SEQUENCE OF Tn3270eSrvrStatsEntry
  816.       MAX-ACCESS  not-accessible
  817.       STATUS      current
  818.       DESCRIPTION
  819.           "This table defines a set of statistics concerning
  820.           global TN3270E Server performance."
  821.       ::= { tn3270eObjects 3 }
  822.  
  823.   tn3270eSrvrStatsEntry OBJECT-TYPE
  824.       SYNTAX      Tn3270eSrvrStatsEntry
  825.       MAX-ACCESS  not-accessible
  826.       STATUS      current
  827.       DESCRIPTION
  828.           "Collection of a set of statistic objects for a single
  829.           TN3270 Server."
  830.       INDEX       { tn3270eSrvrConfIndex }
  831.  
  832.  
  833.  
  834. Expires January 1998                                           [Page 14]
  835.  
  836.  
  837.  
  838.  
  839.  
  840. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  841.  
  842.  
  843.       ::= { tn3270eSrvrStatsTable 1 }
  844.  
  845.   Tn3270eSrvrStatsEntry ::= SEQUENCE {
  846.       tn3270eSrvrStatsUpTime          TimeTicks,
  847.       tn3270eSrvrStatsMaxLus          Unsigned32,
  848.       tn3270eSrvrStatsLusInUse        Gauge32,
  849.       tn3270eSrvrStatsSpareLus        Gauge32,
  850.       tn3270eSrvrStatsMaxPtrs         Unsigned32,
  851.       tn3270eSrvrStatsPtrsInUse       Gauge32,
  852.       tn3270eSrvrStatsSparePtrs       Gauge32,
  853.       tn3270eSrvrStatsConnectsIn      Counter32,
  854.       tn3270eSrvrStatsConnRejects     Counter32,
  855.       tn3270eSrvrStatsDisconnects     Counter32
  856.     }
  857.  
  858.   tn3270eSrvrStatsUpTime OBJECT-TYPE
  859.       SYNTAX      TimeTicks
  860.       MAX-ACCESS  read-only
  861.       STATUS      current
  862.       DESCRIPTION
  863.          "Indicates the amount of time that a particular TN3270E
  864.           has be active. This is total time since the server was
  865.           started and is not reset on tn3270eSrvrConfOperStatus."
  866.       ::= { tn3270eSrvrStatsEntry 1 }
  867.  
  868.   tn3270eSrvrStatsMaxLus OBJECT-TYPE
  869.       SYNTAX      Unsigned32
  870.       MAX-ACCESS  read-only
  871.       STATUS      current
  872.       DESCRIPTION
  873.          "Indicates the maximum number of LUs for use by a
  874.           TN3270E Server."
  875.       ::= { tn3270eSrvrStatsEntry 2 }
  876.  
  877.   tn3270eSrvrStatsLusInUse OBJECT-TYPE
  878.       SYNTAX      Gauge32
  879.       MAX-ACCESS  read-only
  880.       STATUS      current
  881.       DESCRIPTION
  882.          "Indicates the current number of LUs in use by a
  883.           TN3270E Server."
  884.       ::= { tn3270eSrvrStatsEntry 3 }
  885.  
  886.   tn3270eSrvrStatsSpareLus OBJECT-TYPE
  887.       SYNTAX      Gauge32
  888.       MAX-ACCESS  read-only
  889.       STATUS      current
  890.       DESCRIPTION
  891.  
  892.  
  893.  
  894. Expires January 1998                                           [Page 15]
  895.  
  896.  
  897.  
  898.  
  899.  
  900. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  901.  
  902.  
  903.          "Indicates the number of free LUs for a particular TN3270E
  904.           Server. It is possible that the difference between
  905.           tn3270eSrvrStatsMaxLus and tn3270eSrvrStatsLusInUse does
  906.           not equal tn3270eSrvrStatsSpareLus. An LU may exist
  907.           but not be useable by a IP Client connection."
  908.       ::= { tn3270eSrvrStatsEntry 4 }
  909.  
  910.   tn3270eSrvrStatsMaxPtrs OBJECT-TYPE
  911.       SYNTAX      Unsigned32
  912.       MAX-ACCESS  read-only
  913.       STATUS      current
  914.       DESCRIPTION
  915.          "Indicates the maximum number of Printer Resources for use by a
  916.           TN3270E Server."
  917.       ::= { tn3270eSrvrStatsEntry 5 }
  918.  
  919.   tn3270eSrvrStatsPtrsInUse OBJECT-TYPE
  920.       SYNTAX      Gauge32
  921.       MAX-ACCESS  read-only
  922.       STATUS      current
  923.       DESCRIPTION
  924.          "Indicates the current number of Printer Resources in use by a
  925.           TN3270E Server."
  926.       ::= { tn3270eSrvrStatsEntry 6 }
  927.  
  928.   tn3270eSrvrStatsSparePtrs OBJECT-TYPE
  929.       SYNTAX      Gauge32
  930.       MAX-ACCESS  read-only
  931.       STATUS      current
  932.       DESCRIPTION
  933.          "Indicates the number of free Printer Resources for a
  934.           particular TN3270E Server. It is possible that the
  935.           difference between tn3270eSrvrStatsMaxPtrs and
  936.           tn3270eSrvrStatsPtrsInUse does not equal
  937.           tn3270eSrvrStatsSparePtrs. A Printer resource may
  938.           exist but not be useable by a IP Client connection."
  939.       ::= { tn3270eSrvrStatsEntry 7 }
  940.  
  941.   tn3270eSrvrStatsConnectsIn OBJECT-TYPE
  942.       SYNTAX      Counter32
  943.       MAX-ACCESS  read-only
  944.       STATUS      current
  945.       DESCRIPTION
  946.          "Indicates the number of client connections received by a
  947.           TN3270E Server."
  948.       ::= { tn3270eSrvrStatsEntry 8 }
  949.  
  950.   tn3270eSrvrStatsConnRejects OBJECT-TYPE
  951.  
  952.  
  953.  
  954. Expires January 1998                                           [Page 16]
  955.  
  956.  
  957.  
  958.  
  959.  
  960. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  961.  
  962.  
  963.       SYNTAX      Counter32
  964.       MAX-ACCESS  read-only
  965.       STATUS      current
  966.       DESCRIPTION
  967.          "Indicates the number of client connections rejected during
  968.           connection setup. An example of this is when no LU or
  969.           Printer resource is available to associate with the
  970.           TCP Connection of a IP Client."
  971.       ::= { tn3270eSrvrStatsEntry 9 }
  972.  
  973.   tn3270eSrvrStatsDisconnects OBJECT-TYPE
  974.       SYNTAX      Counter32
  975.       MAX-ACCESS  read-only
  976.       STATUS      current
  977.       DESCRIPTION
  978.          "Indicates the number of client connections disconnected by a
  979.           TN3270E Server."
  980.       ::= { tn3270eSrvrStatsEntry 10 }
  981.  
  982.   tn3270eIpGroupTable OBJECT-TYPE
  983.       SYNTAX      SEQUENCE OF Tn3270eIpGroupEntry
  984.       MAX-ACCESS  not-accessible
  985.       STATUS      current
  986.       DESCRIPTION
  987.           "This table defines IP Address groupings for use by a
  988.           TN3270E Server."
  989.       ::= { tn3270eObjects 4 }
  990.  
  991.   tn3270eIpGroupEntry OBJECT-TYPE
  992.       SYNTAX      Tn3270eIpGroupEntry
  993.       MAX-ACCESS  not-accessible
  994.       STATUS      current
  995.       DESCRIPTION
  996.           "Definition of a single IP Address entry. All entries with
  997.           the same first two indexes, tn3270eSrvrConfIndex and
  998.           tn3270eIpGroupName, are considered to be in the same
  999.           IP Group."
  1000.       INDEX       { tn3270eSrvrConfIndex,
  1001.                     tn3270eIpGroupName,
  1002.                     tn3270eIpGroupIpAddress }
  1003.       ::= { tn3270eIpGroupTable 1 }
  1004.  
  1005.   Tn3270eIpGroupEntry ::= SEQUENCE {
  1006.       tn3270eIpGroupName           DisplayString,
  1007.       tn3270eIpGroupIpAddress      IpAddress,
  1008.       tn3270eIpGroupSubnetMask     IpAddress,
  1009.       tn3270eIpGroupRowStatus      RowStatus }
  1010.  
  1011.  
  1012.  
  1013.  
  1014. Expires January 1998                                           [Page 17]
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1021.  
  1022.  
  1023.   tn3270eIpGroupName OBJECT-TYPE
  1024.       SYNTAX      DisplayString (SIZE(1..24))
  1025.       MAX-ACCESS  not-accessible
  1026.       STATUS      current
  1027.       DESCRIPTION
  1028.           "The name of a IP Group."
  1029.       ::= { tn3270eIpGroupEntry 1 }
  1030.  
  1031.   tn3270eIpGroupIpAddress OBJECT-TYPE
  1032.       SYNTAX      IpAddress
  1033.       MAX-ACCESS  not-accessible
  1034.       STATUS      current
  1035.       DESCRIPTION
  1036.           "The IP Address of a member of a IP Group."
  1037.       ::= { tn3270eIpGroupEntry 2 }
  1038.  
  1039.   tn3270eIpGroupSubnetMask OBJECT-TYPE
  1040.       SYNTAX      IpAddress
  1041.       MAX-ACCESS  read-create
  1042.       STATUS      current
  1043.       DESCRIPTION
  1044.           "The corresponding subnet mask associated with
  1045.            tn3270eIpGroupIpAddress. A single IP Address
  1046.            is represented by having this object contain
  1047.            the value of 255.255.255.255."
  1048.       DEFVAL { 'FFFFFFFF'H }
  1049.       ::= { tn3270eIpGroupEntry 3 }
  1050.  
  1051.   tn3270eIpGroupRowStatus OBJECT-TYPE
  1052.       SYNTAX      RowStatus
  1053.       MAX-ACCESS  read-create
  1054.       STATUS      current
  1055.       DESCRIPTION
  1056.           "This object allows entries to be created and deleted in the
  1057.           tn3270eIpGroupTable.
  1058.  
  1059.           An entry in this table is deleted by setting this object
  1060.           to destroy(6)."
  1061.       REFERENCE
  1062.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  1063.           Network Management Protocol (SNMPv2).'"
  1064.       ::= { tn3270eIpGroupEntry 4 }
  1065.  
  1066.   tn3270eResPoolTable OBJECT-TYPE
  1067.       SYNTAX      SEQUENCE OF Tn3270eResPoolEntry
  1068.       MAX-ACCESS  not-accessible
  1069.       STATUS      current
  1070.       DESCRIPTION
  1071.  
  1072.  
  1073.  
  1074. Expires January 1998                                           [Page 18]
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1081.  
  1082.  
  1083.           "This table defines Resource groupings and using the term
  1084.           pool as defined by RFC 1647."
  1085.       ::= { tn3270eObjects 5 }
  1086.  
  1087.   tn3270eResPoolEntry OBJECT-TYPE
  1088.       SYNTAX      Tn3270eResPoolEntry
  1089.       MAX-ACCESS  not-accessible
  1090.       STATUS      current
  1091.       DESCRIPTION
  1092.           "Definition of a single Resource Pool member. All entries
  1093.           with the same first two indexes, tn3270eSrvrConfIndex and
  1094.           tn3270eResPoolName, are considered to be in the same Pool."
  1095.       INDEX  { tn3270eSrvrConfIndex,
  1096.                tn3270eResPoolName,
  1097.                tn3270eResPoolElementName }
  1098.       ::= { tn3270eResPoolTable 1 }
  1099.  
  1100.   Tn3270eResPoolEntry ::= SEQUENCE {
  1101.       tn3270eResPoolName           DisplayString,
  1102.       tn3270eResPoolElementName    DisplayString,
  1103.       tn3270eResPoolElementType    Tn3270ResourceType,
  1104.       tn3270eResPoolRowStatus      RowStatus }
  1105.  
  1106.   tn3270eResPoolName OBJECT-TYPE
  1107.       SYNTAX      DisplayString (SIZE(1..24))
  1108.       MAX-ACCESS  not-accessible
  1109.       STATUS      current
  1110.       DESCRIPTION
  1111.           "The name of a Resource Pool.."
  1112.       ::= { tn3270eResPoolEntry 1 }
  1113.  
  1114.   tn3270eResPoolElementName OBJECT-TYPE
  1115.       SYNTAX      DisplayString (SIZE(1..8))
  1116.       MAX-ACCESS  not-accessible
  1117.       STATUS      current
  1118.       DESCRIPTION
  1119.           "The Name of a member of a Resource Pool."
  1120.       ::= { tn3270eResPoolEntry 2 }
  1121.  
  1122.   tn3270eResPoolElementType OBJECT-TYPE
  1123.       SYNTAX      Tn3270ResourceType
  1124.       MAX-ACCESS  read-create
  1125.       STATUS      current
  1126.       DESCRIPTION
  1127.           "The type of the entity in a Resource Pool."
  1128.       ::= { tn3270eResPoolEntry 3 }
  1129.  
  1130.   tn3270eResPoolRowStatus OBJECT-TYPE
  1131.  
  1132.  
  1133.  
  1134. Expires January 1998                                           [Page 19]
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1141.  
  1142.  
  1143.       SYNTAX      RowStatus
  1144.       MAX-ACCESS  read-create
  1145.       STATUS      current
  1146.       DESCRIPTION
  1147.           "This object allows entries to be created and deleted in the
  1148.           tn3270eResPoolTable.
  1149.  
  1150.           An entry in this table is deleted by setting this object
  1151.           to destroy(6)."
  1152.       REFERENCE
  1153.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  1154.           Network Management Protocol (SNMPv2).'"
  1155.       ::= { tn3270eResPoolEntry 4 }
  1156.  
  1157.   tn3270eIpResMapTable OBJECT-TYPE
  1158.       SYNTAX      SEQUENCE OF Tn3270eIpResMapEntry
  1159.       MAX-ACCESS  not-accessible
  1160.       STATUS      current
  1161.       DESCRIPTION
  1162.           "This table defines Resource Pool to IP Group mappings.
  1163.            Since both the Resource Pool Name and IP Group Name
  1164.            are included in the index clause of this table multiple
  1165.            Resource Pools can be assigned to the same IP Group. This
  1166.            enables use of multiple Resource Pools for use in IP to
  1167.            resource mapping. Assigning multiple IP Groups to the
  1168.            same Resource Pool is also allowed but is not the primary
  1169.            purpose for how the indexing is structured.
  1170.  
  1171.            Assignment of Resource Pool to IP Group can be restricted
  1172.            based on TCP Port. A index value of 0 for
  1173.            tn3270eIpResMapClientPort disables restriction of resource
  1174.            assignment based on IP Client target port selection."
  1175.       ::= { tn3270eObjects 6 }
  1176.  
  1177.   tn3270eIpResMapEntry OBJECT-TYPE
  1178.       SYNTAX      Tn3270eIpResMapEntry
  1179.       MAX-ACCESS  not-accessible
  1180.       STATUS      current
  1181.       DESCRIPTION
  1182.           "Definition of a single Resource Pool to IP Group mapping."
  1183.       INDEX  { tn3270eSrvrConfIndex,
  1184.                tn3270eIpResMapPoolName,
  1185.                tn3270eIpResMapIpGroupName,
  1186.                tn3270eIpResMapClientPort }
  1187.       ::= { tn3270eIpResMapTable 1 }
  1188.  
  1189.   Tn3270eIpResMapEntry ::= SEQUENCE {
  1190.       tn3270eIpResMapPoolName       DisplayString,
  1191.  
  1192.  
  1193.  
  1194. Expires January 1998                                           [Page 20]
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1201.  
  1202.  
  1203.       tn3270eIpResMapIpGroupName    DisplayString,
  1204.       tn3270eIpResMapClientPort     Unsigned32,
  1205.       tn3270eIpResMapRowStatus      RowStatus }
  1206.  
  1207.   tn3270eIpResMapPoolName OBJECT-TYPE
  1208.       SYNTAX      DisplayString (SIZE(1..24))
  1209.       MAX-ACCESS  not-accessible
  1210.       STATUS      current
  1211.       DESCRIPTION
  1212.           "The name of a Resource Pool."
  1213.       ::= { tn3270eIpResMapEntry 1 }
  1214.  
  1215.   tn3270eIpResMapIpGroupName OBJECT-TYPE
  1216.       SYNTAX      DisplayString (SIZE(1..24))
  1217.       MAX-ACCESS  not-accessible
  1218.       STATUS      current
  1219.       DESCRIPTION
  1220.           "The name of the IP Group that is mapped to a
  1221.            Resource Pool."
  1222.       ::= { tn3270eIpResMapEntry 2 }
  1223.  
  1224.   tn3270eIpResMapClientPort OBJECT-TYPE
  1225.       SYNTAX      Unsigned32 (0..65535)
  1226.       MAX-ACCESS  not-accessible
  1227.       STATUS      current
  1228.       DESCRIPTION
  1229.           "The port to restrict a Resource Pool to a IP Group
  1230.            mapping. A value of 0 for this objects implies that
  1231.            the mapping is not restricted."
  1232.       ::= { tn3270eIpResMapEntry 3 }
  1233.  
  1234.   tn3270eIpResMapRowStatus OBJECT-TYPE
  1235.       SYNTAX      RowStatus
  1236.       MAX-ACCESS  read-create
  1237.       STATUS      current
  1238.       DESCRIPTION
  1239.           "This object allows entries to be created and deleted in the
  1240.           tn3270eIpResMapTable.
  1241.  
  1242.           An entry in this table is deleted by setting this object
  1243.           to destroy(6)."
  1244.       REFERENCE
  1245.           "RFC 1903, 'Textual Conventions for version 2 of the Simple
  1246.           Network Management Protocol (SNMPv2).'"
  1247.       ::= { tn3270eIpResMapEntry 4 }
  1248.  
  1249.   tn3270eResMapTable OBJECT-TYPE
  1250.       SYNTAX      SEQUENCE OF Tn3270eResMapEntry
  1251.  
  1252.  
  1253.  
  1254. Expires January 1998                                           [Page 21]
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1261.  
  1262.  
  1263.       MAX-ACCESS  not-accessible
  1264.       STATUS      current
  1265.       DESCRIPTION
  1266.           "This table defines the actual mapping of a resource to
  1267.            a IP Address."
  1268.       ::= { tn3270eObjects 7 }
  1269.  
  1270.   tn3270eResMapEntry OBJECT-TYPE
  1271.       SYNTAX      Tn3270eResMapEntry
  1272.       MAX-ACCESS  not-accessible
  1273.       STATUS      current
  1274.       DESCRIPTION
  1275.           "Definition of the mapping of a Resource Element to
  1276.            a IP Address."
  1277.       INDEX  { tn3270eSrvrConfIndex,
  1278.                tn3270eResMapElementName,
  1279.                tn3270eResMapIpAddress }
  1280.       ::= { tn3270eResMapTable 1 }
  1281.  
  1282.   Tn3270eResMapEntry ::= SEQUENCE {
  1283.       tn3270eResMapElementName    DisplayString,
  1284.       tn3270eResMapIpAddress      IpAddress,
  1285.       tn3270eResMapElementType    Tn3270ResourceType }
  1286.  
  1287.   tn3270eResMapElementName OBJECT-TYPE
  1288.       SYNTAX      DisplayString (SIZE(1..8))
  1289.       MAX-ACCESS  not-accessible
  1290.       STATUS      current
  1291.       DESCRIPTION
  1292.           "The Name of a resource element."
  1293.       ::= { tn3270eResMapEntry 1 }
  1294.  
  1295.   tn3270eResMapIpAddress OBJECT-TYPE
  1296.       SYNTAX      IpAddress
  1297.       MAX-ACCESS  not-accessible
  1298.       STATUS      current
  1299.       DESCRIPTION
  1300.           "A client IP Address."
  1301.       ::= { tn3270eResMapEntry 2 }
  1302.  
  1303.   tn3270eResMapElementType OBJECT-TYPE
  1304.       SYNTAX      Tn3270ResourceType
  1305.       MAX-ACCESS  read-only
  1306.       STATUS      current
  1307.       DESCRIPTION
  1308.           "The type of the associating resource element/"
  1309.       ::= { tn3270eResMapEntry 3 }
  1310.  
  1311.  
  1312.  
  1313.  
  1314. Expires January 1998                                           [Page 22]
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1321.  
  1322.  
  1323.   -- Define the set of objects to add to the Tcp Connection Table
  1324.  
  1325.   tn3270eTcpConnTable OBJECT-TYPE
  1326.       SYNTAX SEQUENCE OF Tn3270eTcpConnEntry
  1327.       MAX-ACCESS not-accessible
  1328.       STATUS current
  1329.       DESCRIPTION
  1330.            "Extends tcpConnTable to support TN3270 and TN3270E
  1331.             performance monitoring."
  1332.       ::= { tn3270eObjects 8 }
  1333.  
  1334.   tn3270eTcpConnEntry OBJECT-TYPE
  1335.       SYNTAX Tn3270eTcpConnEntry
  1336.       MAX-ACCESS not-accessible
  1337.       STATUS current
  1338.       DESCRIPTION
  1339.            "Provides in formation about a single TN3270/TN3270E
  1340.             session."
  1341.       INDEX { tcpConnLocalAddress, tcpConnLocalPort,
  1342.               tcpConnRemAddress, tcpConnRemPort }
  1343.       ::= { tn3270eTcpConnTable 1 }
  1344.  
  1345.   Tn3270eTcpConnEntry ::=
  1346.       SEQUENCE
  1347.       {
  1348.           tn3270eTcpConnLastActivity       TimeTicks,
  1349.           tn3270eTcpConnBytesIn            Counter32,
  1350.           tn3270eTcpConnBytesOut           Counter32,
  1351.           tn3270eTcpConnResourceName       DisplayString,
  1352.           tn3270eTcpConnResourceType       Tn3270ResourceType,
  1353.           tn3270eTcpConnDeviceType         Tn3270DeviceTypes,
  1354.           tn3270eTcpConnFunctions          Tn3270Functions
  1355.       }
  1356.  
  1357.   tn3270eTcpConnLastActivity OBJECT-TYPE
  1358.       SYNTAX   TimeTicks
  1359.       MAX-ACCESS   read-only
  1360.       STATUS   current
  1361.       DESCRIPTION
  1362.           "The number of 100ths of seconds since any data was
  1363.            transferred for the associating TCP Connection."
  1364.       DEFVAL  { 0 }
  1365.       ::= { tn3270eTcpConnEntry 1 }
  1366.  
  1367.   tn3270eTcpConnBytesIn  OBJECT-TYPE
  1368.       SYNTAX   Counter32
  1369.       UNITS "octets"
  1370.       MAX-ACCESS   read-only
  1371.  
  1372.  
  1373.  
  1374. Expires January 1998                                           [Page 23]
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1381.  
  1382.  
  1383.       STATUS   current
  1384.       DESCRIPTION
  1385.           "The number of bytes received by the Server from TCP
  1386.            for this connection."
  1387.       ::= { tn3270eTcpConnEntry 2 }
  1388.  
  1389.   tn3270eTcpConnBytesOut OBJECT-TYPE
  1390.       SYNTAX   Counter32
  1391.       UNITS "octets"
  1392.       MAX-ACCESS   read-only
  1393.       STATUS   current
  1394.       DESCRIPTION
  1395.           "The number of bytes sent to TCP for this connection."
  1396.       ::= { tn3270eTcpConnEntry 3 }
  1397.  
  1398.   tn3270eTcpConnResourceName OBJECT-TYPE
  1399.       SYNTAX   DisplayString (SIZE(0..8))
  1400.       MAX-ACCESS   read-only
  1401.       STATUS   current
  1402.       DESCRIPTION
  1403.           "LU/Print secondary name for connecting a IP Client
  1404.            into a SNA network."
  1405.      ::= { tn3270eTcpConnEntry 4 }
  1406.  
  1407.   tn3270eTcpConnResourceType OBJECT-TYPE
  1408.       SYNTAX   Tn3270ResourceType
  1409.       MAX-ACCESS   read-only
  1410.       STATUS   current
  1411.       DESCRIPTION
  1412.           "Indicates the type of resource identified by
  1413.            tn3270eTcpConnResourceName."
  1414.      ::= { tn3270eTcpConnEntry 5 }
  1415.  
  1416.   tn3270eTcpConnDeviceType OBJECT-TYPE
  1417.      SYNTAX   Tn3270DeviceTypes
  1418.      MAX-ACCESS   read-only
  1419.      STATUS   current
  1420.      DESCRIPTION
  1421.          "Indicates the device type if negiotiated with client.
  1422.           This object is also known as logmode."
  1423.      ::= { tn3270eTcpConnEntry 6 }
  1424.  
  1425.   tn3270eTcpConnFunctions OBJECT-TYPE
  1426.      SYNTAX   Tn3270Functions
  1427.      MAX-ACCESS   read-only
  1428.      STATUS   current
  1429.      DESCRIPTION
  1430.          "This object will indicates which of the TN3270 and TN3270E
  1431.  
  1432.  
  1433.  
  1434. Expires January 1998                                           [Page 24]
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1441.  
  1442.  
  1443.           functions that are supported by the Server was negioted
  1444.           with a client. Refer to tn3270eSrvrFunctionsSupported."
  1445.      ::= { tn3270eTcpConnEntry 7 }
  1446.  
  1447.  
  1448.   -- Conformance Definitions
  1449.  
  1450.   tn3270eGroups      OBJECT IDENTIFIER ::= { tn3270eConformance 1 }
  1451.   tn3270eCompliances OBJECT IDENTIFIER ::= { tn3270eConformance 2 }
  1452.  
  1453.   -- compliance statements
  1454.   tn3270eCompliance MODULE-COMPLIANCE
  1455.       STATUS  current
  1456.       DESCRIPTION
  1457.           "The compliance statement for agents that support the
  1458.           TN3270E-MIB."
  1459.       MODULE -- this module
  1460.           MANDATORY-GROUPS { tn3270eBasicGroup,
  1461.                              tn3270eSessionGroup
  1462.                            }
  1463.           OBJECT tn3270eSrvrConfActivityCheck
  1464.              MIN-ACCESS  read-only
  1465.              DESCRIPTION
  1466.                 "The agent is not required to support a set to this
  1467.                  object if the associating TN3270E Server doesn't
  1468.                  support either TIMEMARK or NOP processing. In
  1469.                  this case an agent should return noCheck on
  1470.                  retrieval."
  1471.           OBJECT tn3270eSrvrConfActivityTimeout
  1472.              MIN-ACCESS  read-only
  1473.              DESCRIPTION
  1474.                 "The agent is not required to support a set to this
  1475.                  object if the functions enabled by
  1476.                  tn3270eSrvrConfActivityCheck are not supported.
  1477.                  An agent in this case should return a value of 0."
  1478.           OBJECT tn3270eSrvrConfActivityInterval
  1479.              MIN-ACCESS  read-only
  1480.              DESCRIPTION
  1481.                 "The agent is not required to support a set to this
  1482.                  object if the functions enabled by
  1483.                  tn3270eSrvrConfActivityCheck are not supported.
  1484.                  An agent in this case should return a value of 0."
  1485.           OBJECT  tn3270eSrvrConfAdminStatus
  1486.              DESCRIPTION
  1487.                 "A TN3270E Server is not required to support a
  1488.                  stopImmediate state transition."
  1489.       ::= { tn3270eCompliances 1 }
  1490.  
  1491.   -- units of conformance
  1492.  
  1493.  
  1494. Expires January 1998                                           [Page 25]
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1501.  
  1502.  
  1503.   tn3270eBasicGroup OBJECT-GROUP
  1504.       OBJECTS {
  1505.           tn3270eSrvrConfInactivityTimeout,
  1506.           tn3270eSrvrConfActivityCheck,
  1507.           tn3270eSrvrConfActivityTimeout,
  1508.           tn3270eSrvrConfActivityInterval,
  1509.           tn3270eSrvrFunctionsSupported,
  1510.           tn3270eSrvrConfAdminStatus,
  1511.           tn3270eSrvrConfOperStatus,
  1512.           tn3270eSrvrConfSessionTermState,
  1513.           tn3270eSrvrConfSrvrType,
  1514.           tn3270eSrvrConfRowStatus,
  1515.           tn3270eSrvrPortRowStatus,
  1516.           tn3270eSrvrStatsUpTime,
  1517.           tn3270eSrvrStatsMaxLus,
  1518.           tn3270eSrvrStatsLusInUse,
  1519.           tn3270eSrvrStatsSpareLus,
  1520.           tn3270eSrvrStatsMaxPtrs,
  1521.           tn3270eSrvrStatsPtrsInUse,
  1522.           tn3270eSrvrStatsSparePtrs,
  1523.           tn3270eSrvrStatsConnectsIn,
  1524.           tn3270eSrvrStatsConnRejects,
  1525.           tn3270eSrvrStatsDisconnects,
  1526.           tn3270eIpGroupSubnetMask,
  1527.           tn3270eIpGroupRowStatus,
  1528.           tn3270eResPoolElementType,
  1529.           tn3270eResPoolRowStatus,
  1530.           tn3270eIpResMapRowStatus
  1531.       }
  1532.       STATUS  current
  1533.       DESCRIPTION
  1534.           "This group is mandatory for all hosts supporting the
  1535.            TN3270E-MIB."
  1536.       ::= { tn3270eGroups 1 }
  1537.  
  1538.   tn3270eSessionGroup OBJECT-GROUP
  1539.       OBJECTS {
  1540.           tn3270eResMapElementType,
  1541.           tn3270eTcpConnLastActivity,
  1542.           tn3270eTcpConnBytesIn,
  1543.           tn3270eTcpConnBytesOut,
  1544.           tn3270eTcpConnResourceName,
  1545.           tn3270eTcpConnResourceType,
  1546.           tn3270eTcpConnDeviceType,
  1547.           tn3270eTcpConnFunctions
  1548.         }
  1549.       STATUS  current
  1550.       DESCRIPTION
  1551.  
  1552.  
  1553.  
  1554. Expires January 1998                                           [Page 26]
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1561.  
  1562.  
  1563.           "This group is mandatory for all hosts supporting the
  1564.            TN3270E-MIB."
  1565.       ::= { tn3270eGroups 2 }
  1566.  
  1567.   END
  1568.  
  1569.  
  1570. 5.  Security Considerations
  1571.  
  1572.   Certain management information defined in this MIB may be considered
  1573.   sensitive in some network environments.  Therefore, authentication of
  1574.   received SNMP requests and controlled access to management information
  1575.   should be employed in such environments.  The method for this
  1576.   authentication is a function of the SNMP Administrative Framework, and
  1577.   has not been expanded by this MIB.
  1578.  
  1579.   Several objects in this MIB allow write access or provide for remote
  1580.   creation. Allowing this support in a non-secure environment can have a
  1581.   negative effect on network operations.  It is recommended that
  1582.   implementers seriously consider whether set operations should be
  1583.   allowed without providing, at a minimum, authentication of request
  1584.   origin. It it recommended that without such support that the following
  1585.   objects be implemented as read-only:
  1586.  
  1587.       o tn3270eSrvrConfInactivityTimout
  1588.       o tn3270eSrvrConfActivityCheck
  1589.       o tn3270eSrvrConfActivityTimeout
  1590.       o tn3270eSrvrConfActivityInterval
  1591.       o tn3270eSrvrConfAdminStatus
  1592.       o tn3270eSrvrConfSessionTermState
  1593.       o tn3270eIpGroupSubnetMask
  1594.       o tn3270eResPoolElementType
  1595.  
  1596.   The following objects should either be implemented as read-only or not
  1597.   implemented when security is an issue as previously discussed:
  1598.  
  1599.       o tn3270eSrvrConfRowStatus
  1600.       o tn3270eSrvrPortRowStatus
  1601.       o tn3270eIpGroupRowStatus
  1602.       o tn3270eResPoolRowStatus
  1603.       o tn3270eResMapRowStatus
  1604.  
  1605.  
  1606. 6.  Acknowledgments
  1607.  
  1608.   This document is a product of the TN3270E Working Group.
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614. Expires January 1998                                           [Page 27]
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1621.  
  1622.  
  1623. 7.  References
  1624.  
  1625.  
  1626. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1627.      Waldbusser S., "Structure of Management Information for version 2
  1628.      of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  1629.      January 1996.
  1630.  
  1631.  
  1632. [2]  Network Working Group, Postel, J., and Reynolds, J., "Telnet
  1633.      Protocol Specification", RFC 854, May 1983.
  1634.  
  1635.  
  1636. [3]  Network Working Group, Postel, J., and Reynolds, J., "Telnet Timing
  1637.      Mark Option", RFC 860, May 1983.
  1638.  
  1639.  
  1640. [4]  Network Working Group and Rekhter J., "Telnet 3270 Regime Option",
  1641.      RFC 1041, January 1988.
  1642.  
  1643.  
  1644. [5]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  1645.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  1646.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  1647.      March 1991.
  1648.  
  1649.  
  1650. [6]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  1651.      Waldbusser, "Textual Conventions for version 2 of the Simple
  1652.      Network Management Protocol (SNMPv2)", RFC 1903, January 1996.
  1653.  
  1654.  
  1655. [7]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  1656.      Waldbusser, "Protocol Operations for version 2 of the Simple
  1657.      Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  1658.  
  1659.  
  1660. [8]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  1661.      Waldbusser, "Conformance Statements for version 2 of the Simple
  1662.      Network Management Protocol (SNMPv2)", RFC 1904, January 1996.
  1663.  
  1664.  
  1665. [9]  Case, J., M. Fedor, M. Schoffstall, J. Davin, "Simple Network
  1666.      Management Protocol", RFC 1157, SNMP Research, Performance Systems
  1667.      International, MIT Laboratory for Computer Science, May 1990.
  1668.  
  1669.  
  1670. [10] IETF SNMPv2 Working Group and McCloghrie, K., "TCP-MIB
  1671.  
  1672.  
  1673.  
  1674. Expires January 1998                                           [Page 28]
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680. White      TN3270E Management Information Base (TN3270E-MIB)28 July 1997
  1681.  
  1682.  
  1683.      Definitions", November 1994.
  1684.  
  1685.  
  1686. 8.  Authors' Address
  1687.  
  1688.   Kenneth D. White
  1689.   Dept. G80/Bldg 503
  1690.   IBM Corporation
  1691.   Research Triangle Park, NC 27709, USA
  1692.   E-mail: kennethw@vnet.ibm.com
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734. Expires January 1998                                           [Page 29]
  1735.  
  1736.  
  1737.