mibs/ietf/TN3270E-MIB

   1 TN3270E-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4     MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, TimeTicks,
   5     IpAddress, Counter32, Gauge32, Counter64
   6         FROM SNMPv2-SMI
   7     TEXTUAL-CONVENTION, RowStatus, TestAndIncr, DateAndTime,
   8     TimeStamp
   9         FROM SNMPv2-TC
  10     MODULE-COMPLIANCE, OBJECT-GROUP
  11         FROM SNMPv2-CONF
  12     snanauMIB
  13         FROM SNA-NAU-MIB
  14     Utf8String
  15         FROM SYSAPPL-MIB
  16     SnmpAdminString
  17         FROM SNMP-FRAMEWORK-MIB
  18     IANATn3270eAddrType, IANATn3270eAddress,
  19     IANATn3270eClientType, IANATn3270Functions,
  20     IANATn3270ResourceType, IANATn3270DeviceType,
  21     IANATn3270eLogData
  22         FROM IANATn3270eTC-MIB;
  23
  24   tn3270eMIB MODULE-IDENTITY
  25       LAST-UPDATED "9807270000Z" -- July 27, 1998
  26       ORGANIZATION "TN3270E Working Group"
  27       CONTACT-INFO
  28           "Kenneth White (kennethw@vnet.ibm.com)
  29            IBM Corp. - Dept. BRQA/Bldg. 501/G114
  30            P.O. Box 12195
  31            3039 Cornwallis
  32            RTP, NC 27709-2195
  33            USA
  34
  35            Robert Moore (remoore@us.ibm.com)
  36            IBM Corp. - Dept. BRQA/Bldg. 501/G114
  37            P.O. Box 12195
  38            3039 Cornwallis
  39            RTP, NC 27709-2195
  40            USA
  41            +1-919-254-4436"
  42       DESCRIPTION
  43           "This module defines a portion of the management
  44           information base (MIB) for managing TN3270E servers."
  45       REVISION  "9807270000Z" -- July 27, 1998
  46       DESCRIPTION
  47           "RFC nnnn (Proposed Standard)" -- RFC Editor to fill in
  48       ::= { snanauMIB 8 }
  49
  50 -- Textual Conventions
  51
  52 SnaResourceName ::= TEXTUAL-CONVENTION
  53     STATUS      current
  54     DESCRIPTION
  55         "The textual convention for defining an SNA resource
  56          name. A fully qualified SNA resource name, consisting
  57          of a 1 to 8 character network identifier (NetId), a
  58          period ('.'), and a 1 to 8 character resource name
  59          (ResName).
  60
  61          The NetId and ResName are constructed from the
  62          uppercase letters 'A' - 'Z' and the numerics '0' - '9',
  63          all encoded in ASCII, with the restriction that the
  64          first character of each must be a letter.  Blanks are
  65          not allowed.
  66
  67          Earlier versions of SNA permitted three additional
  68          characters in NetIds and ResNames:  '#', '@', and '$'.
  69          While this use of these characters has been retired,
  70          a Management Station should still accept them for
  71          backward compatibility.
  72
  73          Note: This Textual Convention is not subject to
  74          internationalization, and does not use the character
  75          encodings used by the Utf8String Textual Convention."
  76     SYNTAX     OCTET STRING (SIZE(0..17))
  77
  78 Tn3270eTraceData ::= TEXTUAL-CONVENTION
  79     STATUS      current
  80     DESCRIPTION
  81         "An octet string representing trace data from the
  82         Telnet half of a TN3270E session, from the SNA half,
  83         or from both.  The octet string contains a sequence
  84         of trace elements, with the trace elements in the
  85         string ordered from earliest to latest.
  86
  87         Each trace element has the following form:
  88
  89                 +---+---+----+----------------------+
  90                 !length !type!data                  !
  91                 +---+---+----+----------------------+
  92           where:
  93
  94           length = two-octet length of the data portion of the
  95                    trace element, not including the length and
  96                    type octets
  97
  98           type   = one-octet code point characterizing the data;
  99                    defined values are:
 100
 101                    X'01' telnet PDU from the server to the client
 102                    X'02' telnet PDU from the client to the server
 103                    X'03' SNA data from the server to the SNA host
 104                    X'04' SNA data from the SNA host to the server
 105
 106           data   = initial part of a PDU.
 107
 108         It is implementation-dependent where the 'initial part of
 109         a PDU' starts.  For SNA data, however, the starting point
 110         SHOULD be the first byte of the TH.  For IP data the
 111         starting point SHOULD be the first byte of the IP header.
 112
 113         It is left to implementations to determine how much of
 114         each PDU to return in a trace element.
 115
 116         The zero-length string indicates that no trace
 117         data is available."
 118     SYNTAX OCTET STRING (SIZE (0 | 3..4096))
 119
 120 -- Top-level structure of the MIB
 121
 122 tn3270eNotifications  OBJECT IDENTIFIER ::= { tn3270eMIB 0 }
 123 tn3270eObjects        OBJECT IDENTIFIER ::= { tn3270eMIB 1 }
 124 tn3270eConformance    OBJECT IDENTIFIER ::= { tn3270eMIB 3 }
 125
 126 -- MIB Objects
 127
 128 tn3270eSrvrConfTable OBJECT-TYPE
 129     SYNTAX      SEQUENCE OF Tn3270eSrvrConfEntry
 130     MAX-ACCESS  not-accessible
 131     STATUS      current
 132     DESCRIPTION
 133         "This table defines the configuration elements for
 134         TN3270E servers.  The number of entries in this table
 135         is expected to vary depending on the location of the
 136         table.  A particular TN3270E server is expected to
 137         have a single entry.  Modeling of the configuration
 138         elements as a table allows multiple TN3270E
 139         servers to be serviced by the same SNMP agent.
 140         An implementation SHOULD NOT retain an SNMP-created
 141         entry in this table across re-IPLs (Initial Program
 142         Loads) of the corresponding TN3270E server."
 143
 144     ::= { tn3270eObjects 1 }
 145
 146 tn3270eSrvrConfEntry OBJECT-TYPE
 147     SYNTAX      Tn3270eSrvrConfEntry
 148     MAX-ACCESS  not-accessible
 149     STATUS      current
 150     DESCRIPTION
 151         "Definition of the configuration elements for a single
 152         TN3270E server."
 153     INDEX       { tn3270eSrvrConfIndex }
 154     ::= { tn3270eSrvrConfTable 1 }
 155
 156 Tn3270eSrvrConfEntry ::= SEQUENCE {
 157     tn3270eSrvrConfIndex             Unsigned32,
 158     tn3270eSrvrConfInactivityTimeout Unsigned32,
 159     tn3270eSrvrConfConnectivityChk   INTEGER,
 160     tn3270eSrvrConfTmNopInactTime    Unsigned32,
 161     tn3270eSrvrConfTmNopInterval     Unsigned32,
 162     tn3270eSrvrFunctionsSupported    IANATn3270Functions,
 163     tn3270eSrvrConfAdminStatus       INTEGER,
 164     tn3270eSrvrConfOperStatus        INTEGER,
 165     tn3270eSrvrConfSessionTermState  INTEGER,
 166     tn3270eSrvrConfSrvrType          INTEGER,
 167     tn3270eSrvrConfContact           SnmpAdminString,
 168     tn3270eSrvrConfRowStatus         RowStatus,
 169     tn3270eSrvrConfLastActTime       DateAndTime,
 170     tn3270eSrvrConfTmTimeout         Unsigned32
 171   }
 172
 173 tn3270eSrvrConfIndex  OBJECT-TYPE
 174     SYNTAX      Unsigned32 (1..4294967295)
 175     MAX-ACCESS  not-accessible
 176     STATUS      current
 177     DESCRIPTION
 178        "Identifier for a single TN3270E server.
 179
 180        tn3270eSrvrConfIndex values need not be
 181        contiguous."
 182     ::= { tn3270eSrvrConfEntry 1 }
 183
 184 tn3270eSrvrConfInactivityTimeout OBJECT-TYPE
 185     SYNTAX      Unsigned32 (0..99999999)
 186     UNITS "seconds"
 187     MAX-ACCESS  read-create
 188     STATUS      current
 189     DESCRIPTION
 190        "The inactivity time-out specified in seconds.  When a
 191         connection has been inactive for the number of seconds
 192         specified by this object it is closed.  Only user traffic
 193         is considered when determining whether there has been
 194         activity on a connection.
 195
 196         The default value 0 means that no inactivity time-out is
 197         in effect."
 198     DEFVAL { 0 }
 199     ::= { tn3270eSrvrConfEntry 2 }
 200
 201 tn3270eSrvrConfConnectivityChk OBJECT-TYPE
 202     SYNTAX      INTEGER {
 203                           timingMark(1),
 204                           nop(2),
 205                           noCheck(3)
 206                         }
 207     MAX-ACCESS  read-create
 208     STATUS      current
 209     DESCRIPTION
 210        "This object enables TIMING-MARK processing, NOP
 211         processing, or neither for a TN3270E server."
 212     DEFVAL { noCheck }
 213     ::= { tn3270eSrvrConfEntry 3 }
 214
 215 tn3270eSrvrConfTmNopInactTime OBJECT-TYPE
 216     SYNTAX      Unsigned32 (1..86400) -- 1 second to 24 hours
 217     UNITS "seconds"
 218     MAX-ACCESS  read-create
 219     STATUS      current
 220     DESCRIPTION
 221        "The amount of time a connection must have had no
 222        traffic on it in order for a TIMING-MARK or NOP request
 223        to be sent on the connection.  This value applies only
 224        when connections are being examined for recent activity
 225        on a scan interval controlled by the value of the
 226        tn3270eSrvrConfTmNopInterval object."
 227     DEFVAL { 600 }   -- 10 minutes
 228     ::= { tn3270eSrvrConfEntry 4 }
 229
 230 tn3270eSrvrConfTmNopInterval OBJECT-TYPE
 231     SYNTAX      Unsigned32 (1..86400) -- 1 second to 24 hours
 232     UNITS "seconds"
 233     MAX-ACCESS  read-create
 234     STATUS      current
 235     DESCRIPTION
 236        "The scan interval to be used by a TN3270E server when
 237        it examines its Telnet connections for recent activity.
 238        The server scans its Telnet connections on the interval
 239        provided by this object, looking for ones that have been
 240        idle for more than the value provided by the
 241        tn3270eSrvrConfTmNopInactTime object.  A TIMING-MARK or
 242        NOP request is sent for each connection that has
 243        exhibited no activity for this period of time."
 244     DEFVAL { 120 }   -- 2 minutes
 245     ::= { tn3270eSrvrConfEntry 5 }
 246
 247 tn3270eSrvrFunctionsSupported OBJECT-TYPE
 248     SYNTAX    IANATn3270Functions
 249     MAX-ACCESS  read-only
 250     STATUS      current
 251     DESCRIPTION
 252        "This object indicates the functions supported by a
 253         TN3270E server."
 254     DEFVAL { { scsCtlCodes, dataStreamCtl,
 255                responses, bindImage, sysreq } }
 256     ::= { tn3270eSrvrConfEntry 6 }
 257
 258 tn3270eSrvrConfAdminStatus OBJECT-TYPE
 259     SYNTAX  INTEGER {
 260                       up(1),
 261                       down(2),
 262                       stopImmediate(3)
 263                     }
 264     MAX-ACCESS  read-create
 265     STATUS      current
 266     DESCRIPTION
 267         "The desired state of the TN3270E server represented
 268          by this entry in the table:
 269
 270          up(1)            - Activate this TN3270E server.
 271          down(2)          - Informs the associated TN3270E
 272                             server to gracefully terminate
 273                             its processing.
 274          stopImmediate(3) - Informs the associated TN3270E
 275                             server to terminate itself
 276                             immediately.
 277
 278          When a managed system creates an entry in this table,
 279          tn3270eSrvrConfAdminStatus and tn3270eSrvrConfOperStatus
 280          are initialized as up(1) by default.
 281
 282          The exact behavior of a server in response to a down(2)
 283          or stopImmediate(3) command is left implementation-
 284          dependent.  A TN3270E server that is capable of it
 285          SHOULD close all of its TN3270 and TN3270E sessions
 286          during a graceful termination.
 287
 288          Often the function enabled via stopImmediate(3) is used
 289          as a last resort by a system administrator, to attempt
 290          to either bring down a hung TN3270E server or free up
 291          its resources immediately to aid in general system
 292          availability, or to shut down a TN3270E server that is
 293          not recognizing a down(2) request.
 294
 295          A TN3270E server that does not distinguish between
 296          down(2) or stopImmediate(3) transitions should not
 297          support stopImmediate(3)."
 298     DEFVAL { up }
 299     ::= { tn3270eSrvrConfEntry 7 }
 300
 301 tn3270eSrvrConfOperStatus OBJECT-TYPE
 302     SYNTAX  INTEGER {
 303                      up(1),
 304                      down(2),
 305                      busy(3),
 306                      shuttingDown(4)
 307                     }
 308     MAX-ACCESS  read-only
 309     STATUS      current
 310     DESCRIPTION
 311        "The current operational state of a TN3270E server.
 312        The following values are defined:
 313
 314         up(1)            - the server is active and accepting
 315                            new client connections
 316         down(2)          - the server is not active
 317         busy(3)          - the server is active, but is not
 318                            accepting new client connections
 319                            because it lacks the resources to
 320                            do so
 321         shuttingDown(4)  - the server is active, but is not
 322                            accepting new client connections
 323                            because it is in the process of
 324                            performing a graceful shutdown."
 325     DEFVAL { up }
 326     ::= { tn3270eSrvrConfEntry 8 }
 327
 328 tn3270eSrvrConfSessionTermState OBJECT-TYPE
 329     SYNTAX  INTEGER {
 330                       terminate(1),
 331                       luSessionPend(2),
 332                       queueSession(3)
 333                     }
 334     MAX-ACCESS  read-create
 335     STATUS      current
 336     DESCRIPTION
 337        "This object determines what a TN3270E server
 338         should do when a TN3270 Session terminates:
 339        terminate(1)     => Terminate the TCP connection.
 340        luSessionPend(2) => Do not drop the TCP connection
 341                            associated with a client when its
 342                            TN3270 session ends.  Processing
 343                            should redrive session initialization
 344                            as if the client were first connecting.
 345        queueSession(3)  => This value relates to the Close
 346                            Destination PASS (CLSDST PASS) operation
 347                            in VTAM.  An example provides the
 348                            easiest explanation.  Suppose a TN3270E
 349                            client is in session with APPL1, and
 350                            APPL1 does a CLSDST PASS of the client's
 351                            session to APPL2.  queueSession(3)
 352                            specifies that the TN3270E server must
 353                            keep the TCP connection with the client
 354                            active after it receives the UNBIND from
 355                            APPL1, waiting for the BIND from APPL2."
 356     DEFVAL { terminate }
 357     ::= { tn3270eSrvrConfEntry 9 }
 358
 359 tn3270eSrvrConfSrvrType OBJECT-TYPE
 360     SYNTAX      INTEGER {
 361                           host(1),
 362                           gateway(2)
 363                         }
 364     MAX-ACCESS  read-only
 365     STATUS      current
 366     DESCRIPTION
 367         "This object indicates the type of TN3270E server.
 368         The existence of MIB tables and objects that will be
 369         defined by follow-on MIBs may be predicated on whether
 370         the TN3270E server can be local to the same host as a
 371         target application (host(1)) or will always be remote
 372         (gateway(2)).
 373
 374         A host TN3270E server refers to an implementation where
 375         the TN3270E server is collocated with the Systems
 376         Network Architecture (SNA) System Services Control Point
 377         (SSCP) for the dependent Secondary Logical Units (SLUs)
 378         that the server makes available to its clients for
 379         connecting into an SNA network.
 380         A gateway TN3270E server resides on an SNA node other
 381         than an SSCP, either an SNA type 2.0 node or an APPN node
 382         acting in the role of a Dependent LU Requester (DLUR).
 383
 384         Host and gateway TN3270E server implementations typically
 385         differ greatly as to their internal implementation and
 386         system definition (SYSDEF) requirements."
 387     ::= { tn3270eSrvrConfEntry 10 }
 388
 389 tn3270eSrvrConfContact OBJECT-TYPE
 390     SYNTAX      SnmpAdminString
 391     MAX-ACCESS  read-create
 392     STATUS      current
 393     DESCRIPTION
 394         "This object provides a scratch pad for a TN3270E
 395         server administrator for storing information for
 396         later retrieval."
 397     DEFVAL { ''H }   -- the empty string
 398     ::= { tn3270eSrvrConfEntry 11 }
 399
 400 tn3270eSrvrConfRowStatus OBJECT-TYPE
 401     SYNTAX      RowStatus
 402     MAX-ACCESS  read-create
 403     STATUS      current
 404     DESCRIPTION
 405         "This object allows entries to be created and deleted
 406         in the tn3270eSrvrConfTable.  Entries may also be
 407         created and deleted as a result of implementation-
 408         dependent operations.
 409
 410         With the exception of tn3270eSrvrConfSrvrType, which
 411         an implementation can easily fill in for itself, all
 412         the columnar objects in this table have DEFVALs
 413         associated with them.  Consequently, a Management
 414         Station can create a conceptual row via a SET
 415         operation that specifies a value only for this object.
 416
 417         When a tn3270eSrvrConfEntry is deleted (by setting
 418         this object to destroy(6)), this has the side-effect
 419         of removing all the associated entries (i.e., those
 420         having the same tn3270eSrvrConfIndex) from the
 421         tn3270eSrvrPortTable, the tn3270eSrvrStatsTable, the
 422         tn3270eClientGroupTable, the tn3270eResPoolTable,
 423         the tn3270eSnaMapTable, the tn3270eClientResMapTable,
 424         and the tn3270eResMapTable.  All entries in the
 425         tn3270eTcpConnTable that belong to a TN3270E server
 426         that has been deleted MUST also be removed.
 427         In other words, a tn3270eSrvrConfEntry must exist for
 428         a TN3270E server in order for it to have entries in
 429         any of the other tables defined by this MIB."
 430     REFERENCE
 431         "RFC 1903, 'Textual Conventions for version 2 of the
 432         Simple Network Management Protocol (SNMPv2).'"
 433     ::= { tn3270eSrvrConfEntry 12 }
 434
 435 tn3270eSrvrConfLastActTime OBJECT-TYPE
 436     SYNTAX      DateAndTime
 437     MAX-ACCESS  read-only
 438     STATUS      current
 439     DESCRIPTION
 440         "This object reports the DateAndTime when a TN3270E
 441         server was most recently activated.
 442
 443         The special value of all '00'Hs indicates that the
 444         server has never been active, i.e., that the value of
 445         tn3270eSrvrOperStatus has never been anything other
 446         than down(2)."
 447     DEFVAL { '0000000000000000'H }
 448     ::= { tn3270eSrvrConfEntry 13 }
 449
 450 tn3270eSrvrConfTmTimeout OBJECT-TYPE
 451     SYNTAX      Unsigned32 (1..600) -- 1 second to 10 minutes
 452     UNITS "seconds"
 453     MAX-ACCESS  read-create
 454     STATUS      current
 455     DESCRIPTION
 456        "The TIMING-MARK time-out, specified in seconds."
 457     DEFVAL { 5 }   -- 5 seconds
 458     ::= { tn3270eSrvrConfEntry 14 }
 459
 460 tn3270eSrvrPortTable OBJECT-TYPE
 461     SYNTAX      SEQUENCE OF Tn3270eSrvrPortEntry
 462     MAX-ACCESS  not-accessible
 463     STATUS      current
 464     DESCRIPTION
 465         "This table defines the TCP ports associated with
 466         TN3270E servers.  No entry in this table shall exist
 467         without a corresponding (same tn3270eSrvrConfIndex)
 468         entry in the tn3270eSrvrConfTable existing.
 469
 470         An implementation SHOULD NOT retain SNMP-created
 471         entries in this table across re-IPLs (Initial Program
 472         Loads) of the corresponding TN3270E server."
 473     ::= { tn3270eObjects 2 }
 474
 475 tn3270eSrvrPortEntry OBJECT-TYPE
 476     SYNTAX      Tn3270eSrvrPortEntry
 477     MAX-ACCESS  not-accessible
 478     STATUS      current
 479     DESCRIPTION
 480         "Definition of a single TCP port assignment to a
 481          TN3270E server.  Assignment of a port on a local
 482          address basis is enabled though use of
 483          tn3270eSrvrPortAddrType and tn3270eSrvrPortAddress.
 484
 485          A TCP port assignment that is not restricted to
 486          a local address SHALL specify a tn3270eSrvrPortAddrType
 487          of unknown(0), and SHALL use a zero-length octet string
 488          for the tn3270eSrvrPortAddress."
 489     INDEX       {
 490                   tn3270eSrvrConfIndex,
 491                   tn3270eSrvrPort,
 492                   tn3270eSrvrPortAddrType,
 493                   tn3270eSrvrPortAddress
 494                 }
 495     ::= { tn3270eSrvrPortTable 1 }
 496
 497 Tn3270eSrvrPortEntry ::= SEQUENCE {
 498     tn3270eSrvrPort                 Unsigned32,
 499     tn3270eSrvrPortAddrType         IANATn3270eAddrType,
 500     tn3270eSrvrPortAddress          IANATn3270eAddress,
 501     tn3270eSrvrPortRowStatus        RowStatus
 502   }
 503
 504 tn3270eSrvrPort OBJECT-TYPE
 505     SYNTAX      Unsigned32 (0..65535)
 506     MAX-ACCESS  not-accessible
 507     STATUS      current
 508     DESCRIPTION
 509        "Indicates a port assigned to a server."
 510     ::= { tn3270eSrvrPortEntry 1 }
 511
 512 tn3270eSrvrPortAddrType OBJECT-TYPE
 513     SYNTAX      IANATn3270eAddrType
 514     MAX-ACCESS  not-accessible
 515     STATUS      current
 516     DESCRIPTION
 517         "Indicates the type of an address local to the host on
 518         which the TN3270E server resides that is represented
 519         in tn3270eSrvrPortAddress.  A value of unknown(0)
 520         SHALL be used for this object when the port is not
 521         to be restricted to a local address."
 522     ::= { tn3270eSrvrPortEntry 2 }
 523
 524 tn3270eSrvrPortAddress OBJECT-TYPE
 525     SYNTAX      IANATn3270eAddress
 526     MAX-ACCESS  not-accessible
 527     STATUS      current
 528     DESCRIPTION
 529         "A local address on the host that a TN3270E server
 530          resides on that is associated with a TCP port that
 531          is to be used or is in use by a TN3270E server.
 532          tn3270eClientGroupAddrType indicates the
 533          address type (IPv4 or IPv6, for example).
 534
 535          A zero-length octet string SHALL be used as the
 536          value of this object when a local address isn't
 537          being specified."
 538     ::= { tn3270eSrvrPortEntry 3 }
 539
 540 tn3270eSrvrPortRowStatus OBJECT-TYPE
 541     SYNTAX      RowStatus
 542     MAX-ACCESS  read-create
 543     STATUS      current
 544     DESCRIPTION
 545         "This object allows entries to be created and deleted
 546         in the tn3270eSrvrPortTable.  Entries may also be
 547         created and deleted as a result of implementation-
 548         dependent operations.
 549
 550         Since this is the only accessible object in this table,
 551         a Management Station can create a conceptual row via a SET
 552         operation that specifies a value only for this object.
 553
 554         An entry in this table is deleted by setting this object
 555         to destroy(6).  Deletion of a tn3270eSrvrPortEntry has
 556         no effect on any other table entry defined by this MIB."
 557     REFERENCE
 558         "RFC 1903, 'Textual Conventions for version 2 of the
 559         Simple Network Management Protocol (SNMPv2).'"
 560     ::= { tn3270eSrvrPortEntry 4 }
 561
 562 tn3270eSrvrStatsTable OBJECT-TYPE
 563     SYNTAX      SEQUENCE OF Tn3270eSrvrStatsEntry
 564     MAX-ACCESS  not-accessible
 565     STATUS      current
 566     DESCRIPTION
 567         "This table defines a set of statistics concerning
 568         TN3270E server performance.
 569
 570         No entry in this table shall exist without
 571         a corresponding (same tn3270eSrvrConfIndex) entry in
 572         the tn3270eSrvrConfTable existing."
 573     ::= { tn3270eObjects 3 }
 574
 575 tn3270eSrvrStatsEntry OBJECT-TYPE
 576     SYNTAX      Tn3270eSrvrStatsEntry
 577     MAX-ACCESS  not-accessible
 578     STATUS      current
 579     DESCRIPTION
 580         "A collection of statistical and maximum usage objects
 581         for a single TN3270 server.  An entry can represent the total
 582         activity of the server, or it can represent the activity
 583         occurring at the server on either a port or a
 584         port-and-local-address basis.
 585
 586         Collection of the statistics represented by the objects
 587         in this table is not mandatory.   An implementation
 588         of this table MUST use only one of the three levels of
 589         refinement that this table supports for the entries
 590         associated with each TN3270E server.
 591
 592         The indexing for a row that represents total server
 593         statistics is as follows:
 594
 595              tn3270eSrvrConfIndex      value identifying the server
 596              tn3270eSrvrPort           0
 597              tn3270eSrvrPortAddrType   unknown(0)
 598              tn3270eSrvrPortAddress    zero-length octet string.
 599
 600         On a port basis:
 601
 602              tn3270eSrvrConfIndex      value identifying the server
 603              tn3270eSrvrPort           > 0
 604              tn3270eSrvrPortAddrType   unknown(0)
 605              tn3270eSrvrPortAddress    zero-length octet string.
 606
 607         On a port-and-local-address basis:
 608
 609              tn3270eSrvrConfIndex      value identifying the server
 610              tn3270eSrvrPort           > 0
 611              tn3270eSrvrPortAddrType   valid value other than unknown(0)
 612              tn3270eSrvrPortAddress    non-zero-length octet string.
 613
 614        "
 615     INDEX       {
 616                   tn3270eSrvrConfIndex,
 617                   tn3270eSrvrPort,
 618                   tn3270eSrvrPortAddrType,
 619                   tn3270eSrvrPortAddress
 620                 }
 621     ::= { tn3270eSrvrStatsTable 1 }
 622
 623 Tn3270eSrvrStatsEntry ::= SEQUENCE {
 624     tn3270eSrvrStatsUpTime          TimeStamp,
 625     tn3270eSrvrStatsMaxTerms        Unsigned32,
 626     tn3270eSrvrStatsInUseTerms      Gauge32,
 627     tn3270eSrvrStatsSpareTerms      Gauge32,
 628     tn3270eSrvrStatsMaxPtrs         Unsigned32,
 629     tn3270eSrvrStatsInUsePtrs       Gauge32,
 630     tn3270eSrvrStatsSparePtrs       Gauge32,
 631     tn3270eSrvrStatsInConnects      Counter32,
 632     tn3270eSrvrStatsConnResrceRejs  Counter32,
 633     tn3270eSrvrStatsDisconnects     Counter32,
 634     tn3270eSrvrStatsHCInOctets      Counter64,
 635     tn3270eSrvrStatsInOctets        Counter32,
 636     tn3270eSrvrStatsHCOutOctets     Counter64,
 637     tn3270eSrvrStatsOutOctets       Counter32,
 638     tn3270eSrvrStatsConnErrorRejs   Counter32
 639   }
 640
 641 tn3270eSrvrStatsUpTime OBJECT-TYPE
 642     SYNTAX      TimeStamp
 643     MAX-ACCESS  read-only
 644     STATUS      current
 645     DESCRIPTION
 646         "The value of the sysUpTime object the last time
 647         the TN3270E server was re-initialized.
 648
 649         Server re-initialization is the only discontinuity
 650         event for the counters in this table.  Even if table
 651         entries are on a port or port-and-local-address
 652         basis, port deactivation and reactivation do not
 653         result in counter discontinuities."
 654     ::= { tn3270eSrvrStatsEntry 2 }
 655
 656 tn3270eSrvrStatsMaxTerms OBJECT-TYPE
 657     SYNTAX      Unsigned32
 658     UNITS       "LUs"
 659     MAX-ACCESS  read-only
 660     STATUS      current
 661     DESCRIPTION
 662        "Indicates the maximum number of terminal LUs available
 663        for use at a TN3270E server for the granularity of this
 664        conceptual row (server-wide, port, or
 665        port-and-local-address)."
 666     ::= { tn3270eSrvrStatsEntry 3 }
 667
 668 tn3270eSrvrStatsInUseTerms OBJECT-TYPE
 669     SYNTAX      Gauge32
 670     UNITS       "LUs"
 671     MAX-ACCESS  read-only
 672     STATUS      current
 673     DESCRIPTION
 674        "Indicates the number of terminal LUs currently in
 675        use at a TN3270E server for the granularity of this
 676        conceptual row (server-wide, port, or
 677        port-and-local-address)."
 678     ::= { tn3270eSrvrStatsEntry 4 }
 679
 680 tn3270eSrvrStatsSpareTerms OBJECT-TYPE
 681     SYNTAX      Gauge32
 682     UNITS       "LUs"
 683     MAX-ACCESS  read-only
 684     STATUS      current
 685     DESCRIPTION
 686        "Indicates the number of free terminal LUs at a TN3270E
 687        server for the granularity of this conceptual row
 688        (server-wide, port, or port-and-local-address).
 689
 690        It is possible that the difference between
 691        tn3270eSrvrStatsMaxTerms and tn3270eSrvrStatsInUseTerms
 692        in a conceptual row does not equal the value of
 693        tn3270eSrvrStatsSpareTerms in that row:  an LU may
 694        exist but not be usable by a client connection.
 695
 696        Alternatively, the administrative ceiling represented
 697        by tn3270eSrvrStatsMaxTerms may have been lowered to
 698        a point where it is less than the current value of
 699        tn3270eSrvrStatsInUseTerms.  In this case
 700        tn3270eSrvrStatsSpareTerms returns the value 0."
 701
 702     ::= { tn3270eSrvrStatsEntry 5 }
 703
 704 tn3270eSrvrStatsMaxPtrs OBJECT-TYPE
 705     SYNTAX      Unsigned32
 706     UNITS       "Printer Resources"
 707     MAX-ACCESS  read-only
 708     STATUS      current
 709     DESCRIPTION
 710        "Indicates the maximum number of printer resources
 711        available for use by a TN3270E server for the
 712        granularity of this conceptual row (server-wide,
 713        port, or port-and-local-address)."
 714     ::= { tn3270eSrvrStatsEntry 6 }
 715
 716 tn3270eSrvrStatsInUsePtrs OBJECT-TYPE
 717     SYNTAX      Gauge32
 718     UNITS       "Printer Resources"
 719     MAX-ACCESS  read-only
 720     STATUS      current
 721     DESCRIPTION
 722        "Indicates the number of printer resources
 723        currently in use by a TN3270E server for the
 724        granularity of this conceptual row (server-wide,
 725        port, or port-and-local-address)."
 726     ::= { tn3270eSrvrStatsEntry 7 }
 727
 728 tn3270eSrvrStatsSparePtrs OBJECT-TYPE
 729     SYNTAX      Gauge32
 730     UNITS       "Spare Printer Resources"
 731     MAX-ACCESS  read-only
 732     STATUS      current
 733     DESCRIPTION
 734        "Indicates the number of free printer resources at
 735        a TN3270E server for the granularity of this conceptual
 736        row (server-wide, port, or port-and-local-address).
 737
 738        It is possible that the difference between
 739        tn3270eSrvrStatsMaxPtrs and tn3270eSrvrStatsInUsePtrs
 740        in a conceptual row does not equal the value of
 741        tn3270eSrvrStatsSparePtrs in that row:  a printer
 742        resource may exist but not be usable by a client
 743        connection.
 744
 745        Alternatively, the administrative ceiling represented
 746        by tn3270eSrvrStatsMaxPtrs may have been lowered to
 747        a point where it is less than the current value of
 748        tn3270eSrvrStatsInUsePtrs.  In this case
 749        tn3270eSrvrStatsSparePtrs returns the value 0."
 750     ::= { tn3270eSrvrStatsEntry 8 }
 751
 752 tn3270eSrvrStatsInConnects OBJECT-TYPE
 753     SYNTAX      Counter32
 754     UNITS       "connections"
 755     MAX-ACCESS  read-only
 756     STATUS      current
 757     DESCRIPTION
 758        "Indicates the number of client (TCP) connections
 759        that succeeded at a TN3270E server for the
 760        granularity of this conceptual row (server-wide,
 761        port, or port-and-local-address).
 762
 763        The tn3270eSrvrStatsConnResrceRejs and
 764        tn3270eSrvrStatsConnErrorRejs objects provide a count
 765        of failed connection attempts.
 766
 767        A Management Station can detect discontinuities in
 768        this counter by monitoring the tn3270eSrvrStatsUpTime
 769        object."
 770     ::= { tn3270eSrvrStatsEntry 9 }
 771
 772 tn3270eSrvrStatsConnResrceRejs OBJECT-TYPE
 773     SYNTAX      Counter32
 774     UNITS       "connection attempts"
 775     MAX-ACCESS  read-only
 776     STATUS      current
 777     DESCRIPTION
 778        "Indicates the number of (TCP) connections rejected
 779        during connection setup at a TN3270E server for the
 780        granularity of this conceptual row (server-wide,
 781        port, or port-and-local-address) due to a lack of
 782        resources at the server.  An example of when this
 783        counter would be incremented is when no terminal
 784        or printer resource is available to associate with a
 785        client's TCP connection.
 786
 787        A Management Station can detect discontinuities in
 788        this counter by monitoring the tn3270eSrvrStatsUpTime
 789        object."
 790     ::= { tn3270eSrvrStatsEntry 10 }
 791
 792 tn3270eSrvrStatsDisconnects OBJECT-TYPE
 793     SYNTAX      Counter32
 794     UNITS       "disconnections"
 795     MAX-ACCESS  read-only
 796     STATUS      current
 797     DESCRIPTION
 798        "Indicates the number of (TCP) connections that were
 799        disconnected at a TN3270E server for the
 800        granularity of this conceptual row (server-wide,
 801        port, or port-and-local-address).
 802
 803        A Management Station can detect discontinuities in
 804        this counter by monitoring the tn3270eSrvrStatsUpTime
 805        object."
 806     ::= { tn3270eSrvrStatsEntry 11 }
 807
 808 tn3270eSrvrStatsHCInOctets OBJECT-TYPE
 809     SYNTAX      Counter64
 810     UNITS       "octets"
 811     MAX-ACCESS  read-only
 812     STATUS      current
 813     DESCRIPTION
 814        "Indicates the number of octets received from TN3270
 815        and TN3270E clients for the granularity of this
 816        conceptual row (server-wide, port, or
 817        port-and-local-address).
 818
 819        A Management Station can detect discontinuities in
 820        this counter by monitoring the tn3270eSrvrStatsUpTime
 821        object."
 822     ::= { tn3270eSrvrStatsEntry 12 }
 823
 824 tn3270eSrvrStatsInOctets OBJECT-TYPE
 825     SYNTAX      Counter32
 826     UNITS       "octets"
 827     MAX-ACCESS  read-only
 828     STATUS      current
 829     DESCRIPTION
 830        "Low-order 32 bits of tn3270eSrvrStatsHCInOctets for
 831        this conceptual row.
 832
 833        A Management Station can detect discontinuities in
 834        this counter by monitoring the tn3270eSrvrStatsUpTime
 835        object."
 836     ::= { tn3270eSrvrStatsEntry 13 }
 837
 838 tn3270eSrvrStatsHCOutOctets OBJECT-TYPE
 839     SYNTAX      Counter64
 840     UNITS       "octets"
 841     MAX-ACCESS  read-only
 842     STATUS      current
 843     DESCRIPTION
 844        "Indicates the number of octets sent to TN3270
 845        and TN3270E clients for the granularity of this
 846        conceptual row (server-wide, port, or
 847        port-and-local-address).
 848
 849        A Management Station can detect discontinuities in
 850        this counter by monitoring the tn3270eSrvrStatsUpTime
 851        object."
 852     ::= { tn3270eSrvrStatsEntry 14 }
 853
 854 tn3270eSrvrStatsOutOctets OBJECT-TYPE
 855     SYNTAX      Counter32
 856     UNITS       "octets"
 857     MAX-ACCESS  read-only
 858     STATUS      current
 859     DESCRIPTION
 860        "Low-order 32 bits of tn3270eSrvrStatsHCOutOctets for
 861        this conceptual row.
 862
 863        A Management Station can detect discontinuities in
 864        this counter by monitoring the tn3270eSrvrStatsUpTime
 865        object."
 866     ::= { tn3270eSrvrStatsEntry 15 }
 867
 868 tn3270eSrvrStatsConnErrorRejs OBJECT-TYPE
 869     SYNTAX      Counter32
 870     UNITS       "connection attempts"
 871     MAX-ACCESS  read-only
 872     STATUS      current
 873     DESCRIPTION
 874        "Indicates the number of (TCP) connections rejected
 875        during connection setup at a TN3270E server for the
 876        granularity of this conceptual row (server-wide,
 877        port, or port-and-local-address) due to an error
 878        of some type.  An example of when this counter would
 879        be incremented is when the client and the server
 880        cannot agree on a common set of TN3270E functions for
 881        the connection.
 882
 883        A Management Station can detect discontinuities in
 884        this counter by monitoring the tn3270eSrvrStatsUpTime
 885        object."
 886     ::= { tn3270eSrvrStatsEntry 16 }
 887
 888 tn3270eClientGroupTable OBJECT-TYPE
 889     SYNTAX      SEQUENCE OF Tn3270eClientGroupEntry
 890     MAX-ACCESS  not-accessible
 891     STATUS      current
 892     DESCRIPTION
 893         "This table defines client address groupings for use
 894         by a TN3270E server.
 895
 896         No entry in this table shall exist without
 897         a corresponding (same tn3270eSrvrConfIndex) entry in
 898         the tn3270eSrvrConfTable existing.
 899
 900         An implementation SHOULD NOT retain SNMP-created
 901         entries in this table across re-IPLs (Initial Program
 902         Loads) of the corresponding TN3270E server."
 903     ::= { tn3270eObjects 4 }
 904
 905 tn3270eClientGroupEntry OBJECT-TYPE
 906     SYNTAX      Tn3270eClientGroupEntry
 907     MAX-ACCESS  not-accessible
 908     STATUS      current
 909     DESCRIPTION
 910         "Definition of a single client address entry.  All
 911         entries with the same first two indexes,
 912         tn3270eSrvrConfIndex and tn3270eClientGroupName, are
 913         considered to be in the same client group."
 914     INDEX       { tn3270eSrvrConfIndex,
 915                   tn3270eClientGroupName,
 916                   tn3270eClientGroupAddrType,
 917                   tn3270eClientGroupAddress }
 918     ::= { tn3270eClientGroupTable 1 }
 919
 920 Tn3270eClientGroupEntry ::= SEQUENCE {
 921     tn3270eClientGroupName           Utf8String,
 922     tn3270eClientGroupAddrType       IANATn3270eAddrType,
 923     tn3270eClientGroupAddress        IANATn3270eAddress,
 924     tn3270eClientGroupSubnetMask     IpAddress,
 925     tn3270eClientGroupPfxLength      Unsigned32,
 926     tn3270eClientGroupRowStatus      RowStatus
 927 }
 928
 929 tn3270eClientGroupName OBJECT-TYPE
 930     SYNTAX      Utf8String (SIZE(1..24))
 931     MAX-ACCESS  not-accessible
 932     STATUS      current
 933     DESCRIPTION
 934         "The name of a client group.  Note: client group
 935         names are required to be unique only with respect
 936         to a single TN3270E server."
 937     ::= { tn3270eClientGroupEntry 1 }
 938
 939 tn3270eClientGroupAddrType OBJECT-TYPE
 940     SYNTAX      IANATn3270eAddrType
 941     MAX-ACCESS  not-accessible
 942     STATUS      current
 943     DESCRIPTION
 944         "Indicates the type of the address represented in
 945          tn3270eClientGroupAddress."
 946     ::= { tn3270eClientGroupEntry 2 }
 947
 948 tn3270eClientGroupAddress OBJECT-TYPE
 949     SYNTAX      IANATn3270eAddress
 950     MAX-ACCESS  not-accessible
 951     STATUS      current
 952     DESCRIPTION
 953         "The client address of a member of a client group.
 954         The value of tn3270eClientGroupAddrType indicates
 955         the address type (IPv4 or IPv6, for example)."
 956     ::= { tn3270eClientGroupEntry 3 }
 957
 958 tn3270eClientGroupSubnetMask OBJECT-TYPE
 959     SYNTAX      IpAddress
 960     MAX-ACCESS  read-create
 961     STATUS      current
 962     DESCRIPTION
 963         "The corresponding subnet mask associated with
 964          tn3270eClientGroupAddress.  A single IP address is
 965          represented by having this object contain the value
 966          of 255.255.255.255.
 967
 968          This object's value is meaningful only if
 969          tn3270eClientGroupAddrType has a value of ipv4(1)."
 970     DEFVAL { 'FFFFFFFF'H }
 971     ::= { tn3270eClientGroupEntry 4 }
 972
 973 tn3270eClientGroupPfxLength OBJECT-TYPE
 974     SYNTAX      Unsigned32 (0..128)
 975     UNITS       "bits"
 976     MAX-ACCESS  read-create
 977     STATUS      current
 978     DESCRIPTION
 979         "The corresponding IPv6 network prefix length.
 980
 981         This object's value is meaningful only if
 982         tn3270eClientGroupAddrType  has a value of ipv6(2)."
 983     DEFVAL { 0 }
 984     ::= { tn3270eClientGroupEntry 5 }
 985
 986 tn3270eClientGroupRowStatus 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
 992         in the tn3270eClientGroupTable.  Entries may also be
 993         created and deleted as a result of implementation-
 994         dependent operations.
 995
 996         An entry in this table is deleted by setting this object
 997         to destroy(6).  When the number of entries in this table
 998         for a given client group becomes 0, this has the side-
 999         effect of removing any entries for the group in the
1000         tn3270eClientResMapTable."
1001     REFERENCE
1002         "RFC 1903, 'Textual Conventions for version 2 of the
1003         Simple Network Management Protocol (SNMPv2).'"
1004     ::= { tn3270eClientGroupEntry 6 }
1005
1006 tn3270eResPoolTable OBJECT-TYPE
1007     SYNTAX      SEQUENCE OF Tn3270eResPoolEntry
1008     MAX-ACCESS  not-accessible
1009     STATUS      current
1010     DESCRIPTION
1011         "This table defines resource groupings; the term
1012         'pool' is used as it is defined by RFC 2355.
1013
1014         No entry in this table shall exist without
1015         a corresponding (same tn3270eSrvrConfIndex) entry in
1016         the tn3270eSrvrConfTable existing.
1017
1018         An implementation SHOULD NOT retain SNMP-created
1019         entries in this table across re-IPLs (Initial Program
1020         Loads) of the corresponding TN3270E server."
1021     ::= { tn3270eObjects 5 }
1022
1023 tn3270eResPoolEntry OBJECT-TYPE
1024     SYNTAX      Tn3270eResPoolEntry
1025     MAX-ACCESS  not-accessible
1026     STATUS      current
1027     DESCRIPTION
1028         "Definition of a single resource pool member.  All entries
1029         with the same first two indexes, tn3270eSrvrConfIndex and
1030         tn3270eResPoolName, are considered to be in the same pool."
1031     INDEX  { tn3270eSrvrConfIndex,
1032              tn3270eResPoolName,
1033              tn3270eResPoolElementName }
1034     ::= { tn3270eResPoolTable 1 }
1035
1036 Tn3270eResPoolEntry ::= SEQUENCE {
1037     tn3270eResPoolName           Utf8String,
1038     tn3270eResPoolElementName    SnaResourceName,
1039     tn3270eResPoolElementType    IANATn3270ResourceType,
1040     tn3270eResPoolRowStatus      RowStatus
1041 }
1042
1043 tn3270eResPoolName OBJECT-TYPE
1044     SYNTAX      Utf8String (SIZE(1..24))
1045     MAX-ACCESS  not-accessible
1046     STATUS      current
1047     DESCRIPTION
1048         "The name of a resource pool."
1049     ::= { tn3270eResPoolEntry 1 }
1050
1051 tn3270eResPoolElementName OBJECT-TYPE
1052     SYNTAX      SnaResourceName
1053     MAX-ACCESS  not-accessible
1054     STATUS      current
1055     DESCRIPTION
1056         "The name of a member of a resource pool."
1057     ::= { tn3270eResPoolEntry 2 }
1058
1059 tn3270eResPoolElementType OBJECT-TYPE
1060     SYNTAX      IANATn3270ResourceType
1061     MAX-ACCESS  read-create
1062     STATUS      current
1063     DESCRIPTION
1064         "The type of the entity in a resource pool."
1065     ::= { tn3270eResPoolEntry 3 }
1066
1067 tn3270eResPoolRowStatus OBJECT-TYPE
1068     SYNTAX      RowStatus
1069     MAX-ACCESS  read-create
1070     STATUS      current
1071     DESCRIPTION
1072         "This object allows entries to be created and deleted
1073         in the tn3270eResPoolTable.  Entries may also be
1074         created and deleted as a result of implementation-
1075         dependent operations.
1076
1077         An entry in this table is deleted by setting this object
1078         to destroy(6).  When all entries in this table associated
1079         with the same tn3270eResPoolElementName have been removed,
1080         then any associated (tn3270eResPoolElementName matching
1081         tn3270eClientResMapPoolName with same tn3270eSrvrConfIndex
1082         values) entries in the tn3270eClientResMapTable SHALL
1083         also be removed."
1084     REFERENCE
1085         "RFC 1903, 'Textual Conventions for version 2 of the
1086         Simple Network Management Protocol (SNMPv2).'"
1087     ::= { tn3270eResPoolEntry 4 }
1088
1089 tn3270eSnaMapTable OBJECT-TYPE
1090     SYNTAX      SEQUENCE OF Tn3270eSnaMapEntry
1091     MAX-ACCESS  not-accessible
1092     STATUS      current
1093     DESCRIPTION
1094         "This table provide a mapping from the name by which
1095         a secondary LU is known in the SNA network to the
1096         name by which it is known locally at the TN3270e
1097         server.  This latter name serves as an index into
1098         the tn3270eResPoolTable and the tn3270eResMapTable.
1099         No entry in this table shall exist without
1100         a corresponding (same tn3270eSrvrConfIndex) entry in
1101         the tn3270eSrvrConfTable existing."
1102     ::= { tn3270eObjects 6 }
1103
1104 tn3270eSnaMapEntry OBJECT-TYPE
1105     SYNTAX      Tn3270eSnaMapEntry
1106     MAX-ACCESS  not-accessible
1107     STATUS      current
1108     DESCRIPTION
1109         "Definition of a single mapping from an SSCP-supplied
1110         SLU name to a local SLU name.
1111
1112         Note:  In certain pathological cases, it is possible
1113         that an SSCP will send on an ACTLU for a local LU an
1114         SLU name currently represented by an entry in this
1115         table that associates it with a different local LU.
1116         In these cases the association from the newer ACTLU
1117         SHOULD be the one represented in this table."
1118     INDEX  { tn3270eSrvrConfIndex,
1119              tn3270eSnaMapSscpSuppliedName }
1120     ::= { tn3270eSnaMapTable 1 }
1121
1122 Tn3270eSnaMapEntry ::= SEQUENCE {
1123     tn3270eSnaMapSscpSuppliedName     SnaResourceName,
1124     tn3270eSnaMapLocalName            SnaResourceName,
1125     tn3270eSnaMapPrimaryLuName        SnaResourceName
1126 }
1127
1128 tn3270eSnaMapSscpSuppliedName OBJECT-TYPE
1129     SYNTAX      SnaResourceName
1130     MAX-ACCESS  not-accessible
1131     STATUS      current
1132     DESCRIPTION
1133         "The name of the secondary LU (SLU) as it is known in
1134          the SNA network.  This name is sent by the SSCP on
1135          the Activate Logical Unit (ACTLU) request."
1136     ::= { tn3270eSnaMapEntry 1 }
1137
1138 tn3270eSnaMapLocalName OBJECT-TYPE
1139     SYNTAX      SnaResourceName
1140     MAX-ACCESS  read-only
1141     STATUS      current
1142     DESCRIPTION
1143         "The local name of the secondary LU (SLU)."
1144     ::= { tn3270eSnaMapEntry 2 }
1145
1146 tn3270eSnaMapPrimaryLuName  OBJECT-TYPE
1147     SYNTAX   SnaResourceName
1148     MAX-ACCESS  read-only
1149     STATUS      current
1150     DESCRIPTION
1151         "When there is a currently active LU-LU session for
1152         this connection, this object returns the primary LU
1153         (PLU) name from the BIND.  When there is no active
1154         LU-LU session, or when the PLU name is unavailable
1155         for some other reason, this object returns a
1156         zero-length octet string."
1157     ::= { tn3270eSnaMapEntry 3 }
1158
1159 tn3270eClientResMapTable OBJECT-TYPE
1160     SYNTAX      SEQUENCE OF Tn3270eClientResMapEntry
1161     MAX-ACCESS  not-accessible
1162     STATUS      current
1163     DESCRIPTION
1164         "This table defines resource-pool to client-group
1165         mappings.  Since both the resource pool name and client
1166         group name are included in the index clause of this
1167         table, multiple resource pools can be assigned to the
1168         same client group.  This enables use of multiple
1169         resource pools for use in client to resource mapping.
1170         Assigning multiple client groups to the same resource
1171         pool is also allowed, but is not the primary purpose
1172         for how the indexing is structured.
1173
1174         Assignment of a resource pool to client group can be
1175         restricted based on TCP port.  An index value of 0 for
1176         tn3270eClientResMapClientPort disables restriction of
1177         resource assignment based on client target port
1178         selection.
1179
1180         No entry in this table shall exist without
1181         a corresponding (same tn3270eSrvrConfIndex) entry in
1182         the tn3270eSrvrConfTable existing.
1183
1184         An implementation SHOULD NOT retain SNMP-created
1185         entries in this table across re-IPLs (Initial Program
1186         Loads) of the corresponding TN3270E server."
1187     ::= { tn3270eObjects 7 }
1188
1189 tn3270eClientResMapEntry OBJECT-TYPE
1190     SYNTAX      Tn3270eClientResMapEntry
1191     MAX-ACCESS  not-accessible
1192     STATUS      current
1193     DESCRIPTION
1194         "Definition of a single resource pool to client group
1195         mapping."
1196     INDEX  { tn3270eSrvrConfIndex,
1197              tn3270eClientResMapPoolName,
1198              tn3270eClientResMapClientGroupName,
1199              tn3270eClientResMapClientPort }
1200     ::= { tn3270eClientResMapTable 1 }
1201
1202 Tn3270eClientResMapEntry ::= SEQUENCE {
1203     tn3270eClientResMapPoolName           Utf8String,
1204     tn3270eClientResMapClientGroupName    Utf8String,
1205     tn3270eClientResMapClientPort         Unsigned32,
1206     tn3270eClientResMapRowStatus          RowStatus
1207 }
1208
1209 tn3270eClientResMapPoolName OBJECT-TYPE
1210     SYNTAX      Utf8String (SIZE(1..24))
1211     MAX-ACCESS  not-accessible
1212     STATUS      current
1213     DESCRIPTION
1214         "The name of a resource pool."
1215     ::= { tn3270eClientResMapEntry 1 }
1216
1217 tn3270eClientResMapClientGroupName OBJECT-TYPE
1218     SYNTAX      Utf8String (SIZE(1..24))
1219     MAX-ACCESS  not-accessible
1220     STATUS      current
1221     DESCRIPTION
1222         "The name of the client group that is mapped to a
1223          resource pool."
1224     ::= { tn3270eClientResMapEntry 2 }
1225
1226 tn3270eClientResMapClientPort OBJECT-TYPE
1227     SYNTAX      Unsigned32 (0..65535)
1228     MAX-ACCESS  not-accessible
1229     STATUS      current
1230     DESCRIPTION
1231         "A port number restricting the scope of a mapping
1232         from a resource pool to a client group.  The
1233         value 0 for this object indicates that the scope
1234         of the mapping is not restricted."
1235     ::= { tn3270eClientResMapEntry 3 }
1236
1237 tn3270eClientResMapRowStatus OBJECT-TYPE
1238     SYNTAX      RowStatus
1239     MAX-ACCESS  read-create
1240     STATUS      current
1241     DESCRIPTION
1242         "This object allows entries to be created and deleted
1243         in the tn3270eClientResMapTable.  Entries may also be
1244         created and deleted as a result of implementation-
1245         dependent operations.
1246
1247         An entry in this table is deleted by setting this object
1248         to destroy(6).  Removing an entry from this table doesn't
1249         affect any other table entry defined in this MIB."
1250     REFERENCE
1251         "RFC 1903, 'Textual Conventions for version 2 of the
1252         Simple Network Management Protocol (SNMPv2).'"
1253     ::= { tn3270eClientResMapEntry 4 }
1254
1255 tn3270eResMapTable OBJECT-TYPE
1256     SYNTAX      SEQUENCE OF Tn3270eResMapEntry
1257     MAX-ACCESS  not-accessible
1258     STATUS      current
1259     DESCRIPTION
1260         "This table defines the actual mapping of a resource
1261         to a client address.
1262
1263         No entry in this table shall exist without
1264         a corresponding (same tn3270eSrvrConfIndex) entry in
1265         the tn3270eSrvrConfTable existing."
1266     ::= { tn3270eObjects 8 }
1267
1268 tn3270eResMapEntry OBJECT-TYPE
1269     SYNTAX      Tn3270eResMapEntry
1270     MAX-ACCESS  not-accessible
1271     STATUS      current
1272     DESCRIPTION
1273         "Definition of the mapping of a Resource Element to
1274          a client address."
1275     INDEX  { tn3270eSrvrConfIndex,
1276              tn3270eResMapElementName }
1277     ::= { tn3270eResMapTable 1 }
1278
1279 Tn3270eResMapEntry ::= SEQUENCE {
1280     tn3270eResMapElementName       SnaResourceName,
1281     tn3270eResMapAddrType          IANATn3270eAddrType,
1282     tn3270eResMapAddress           IANATn3270eAddress,
1283     tn3270eResMapPort              Unsigned32,
1284     tn3270eResMapElementType       IANATn3270ResourceType,
1285     tn3270eResMapSscpSuppliedName  SnaResourceName
1286 }
1287
1288 tn3270eResMapElementName OBJECT-TYPE
1289     SYNTAX      SnaResourceName
1290     MAX-ACCESS  not-accessible
1291     STATUS      current
1292     DESCRIPTION
1293         "The name of a resource element.  This is the name by
1294         which the server implementing this table knows the
1295         resource.  It may be different from the name by which
1296         the resource is known in the SNA network.  This latter
1297         name is returned in the tn3270eResMapSscpSuppliedName
1298         object."
1299     ::= { tn3270eResMapEntry 1 }
1300
1301 tn3270eResMapAddrType OBJECT-TYPE
1302     SYNTAX      IANATn3270eAddrType
1303     MAX-ACCESS  read-only
1304     STATUS      current
1305     DESCRIPTION
1306         "Indicates the type of the client address represented
1307         in tn3270eResMapAddress."
1308     ::= { tn3270eResMapEntry 2 }
1309
1310 tn3270eResMapAddress OBJECT-TYPE
1311     SYNTAX      IANATn3270eAddress
1312     MAX-ACCESS  read-only
1313     STATUS      current
1314     DESCRIPTION
1315         "A client address."
1316     ::= { tn3270eResMapEntry 3 }
1317
1318 tn3270eResMapPort OBJECT-TYPE
1319     SYNTAX      Unsigned32 (0..65535)
1320     MAX-ACCESS  read-only
1321     STATUS      current
1322     DESCRIPTION
1323         "A client port."
1324     ::= { tn3270eResMapEntry 4 }
1325
1326 tn3270eResMapElementType OBJECT-TYPE
1327     SYNTAX      IANATn3270ResourceType
1328     MAX-ACCESS  read-only
1329     STATUS      current
1330     DESCRIPTION
1331         "The type of the associated resource element."
1332     ::= { tn3270eResMapEntry 5 }
1333
1334 tn3270eResMapSscpSuppliedName OBJECT-TYPE
1335     SYNTAX      SnaResourceName
1336     MAX-ACCESS  read-only
1337     STATUS      current
1338     DESCRIPTION
1339         "The name of the secondary LU (SLU) as it is known
1340         in a SNA network.  This name is sent by the SSCP on
1341         the Activate Logical Unit (ACTLU) request.  If this
1342         name is not known, this object returns a zero-length
1343         octet string."
1344     ::= { tn3270eResMapEntry 6 }
1345
1346 -- Define the set of objects to supplement the TCP Connection Table
1347
1348 tn3270eTcpConnTable OBJECT-TYPE
1349     SYNTAX SEQUENCE OF Tn3270eTcpConnEntry
1350     MAX-ACCESS  not-accessible
1351     STATUS      current
1352     DESCRIPTION
1353          "This table has an entry for each TN3270(E) client
1354          connection that is currently active at a TN3270E server.
1355          An implementation MAY retain entries for connections
1356          that have been terminated, but which entries are
1357          retained, how many entries are retained, and how long
1358          they are retained is entirely implementation-dependent.
1359
1360          The indexing for this table is designed to support the
1361          use of an SNMP GET-NEXT operation using only the remote
1362          address type, remote address, and remote port, as a way
1363          for a Management Station to retrieve the table entries
1364          related to a particular TN3270(E) client."
1365     ::= { tn3270eObjects 9 }
1366
1367 tn3270eTcpConnEntry OBJECT-TYPE
1368     SYNTAX Tn3270eTcpConnEntry
1369     MAX-ACCESS  not-accessible
1370     STATUS      current
1371     DESCRIPTION
1372         "Provides information about a single TN3270/TN3270E
1373         session.  Note: a tn3270eSrvrConfIndex is not needed
1374         in this table, since the combination of remote and
1375         local addresses and ports is sufficient to
1376         guarantee uniqueness across the TN3270E servers
1377         serviced by an SNMP agent.  Because of this indexing
1378         structure, however, this table does not support
1379         view-based access control policies that provide
1380         access to table rows on a per-server basis."
1381     INDEX { tn3270eTcpConnRemAddrType,
1382             tn3270eTcpConnRemAddress,
1383             tn3270eTcpConnRemPort,
1384             tn3270eTcpConnLocalAddrType,
1385             tn3270eTcpConnLocalAddress,
1386             tn3270eTcpConnLocalPort
1387           }
1388     ::= { tn3270eTcpConnTable 1 }
1389
1390 Tn3270eTcpConnEntry ::=
1391     SEQUENCE
1392     {
1393     tn3270eTcpConnRemAddrType          IANATn3270eAddrType,
1394     tn3270eTcpConnRemAddress           IANATn3270eAddress,
1395     tn3270eTcpConnRemPort              Unsigned32,
1396     tn3270eTcpConnLocalAddrType        IANATn3270eAddrType,
1397     tn3270eTcpConnLocalAddress         IANATn3270eAddress,
1398     tn3270eTcpConnLocalPort            Unsigned32,
1399     tn3270eTcpConnLastActivity         TimeTicks,
1400     tn3270eTcpConnBytesIn              Counter32,
1401     tn3270eTcpConnBytesOut             Counter32,
1402     tn3270eTcpConnResourceElement      SnaResourceName,
1403     tn3270eTcpConnResourceType         IANATn3270ResourceType,
1404     tn3270eTcpConnDeviceType           IANATn3270DeviceType,
1405     tn3270eTcpConnFunctions            IANATn3270Functions,
1406     tn3270eTcpConnId                   Unsigned32,
1407     tn3270eTcpConnClientIdFormat       IANATn3270eClientType,
1408     tn3270eTcpConnClientId             OCTET STRING,
1409     tn3270eTcpConnTraceData            Tn3270eTraceData,
1410     tn3270eTcpConnLogInfo              IANATn3270eLogData,
1411     tn3270eTcpConnLuLuBindImage        OCTET STRING,
1412     tn3270eTcpConnSnaState             INTEGER,
1413     tn3270eTcpConnStateLastDiscReason  INTEGER,
1414     tn3270eTcpConnSrvrConfIndex        Unsigned32,
1415     tn3270eTcpConnActivationTime       TimeStamp
1416     }
1417
1418 tn3270eTcpConnRemAddrType OBJECT-TYPE
1419     SYNTAX   IANATn3270eAddrType
1420     MAX-ACCESS  not-accessible
1421     STATUS      current
1422     DESCRIPTION
1423         "Indicates the type of the value of the
1424         tn3270eTcpConnRemAddress object.  For example,
1425         ipv4(1) or ipv6(2)."
1426     ::= { tn3270eTcpConnEntry 1 }
1427
1428 tn3270eTcpConnRemAddress OBJECT-TYPE
1429     SYNTAX      IANATn3270eAddress
1430     MAX-ACCESS  not-accessible
1431     STATUS      current
1432     DESCRIPTION
1433         "The remote address associated with a TN3270E client.
1434          tn3270eTcpConnRemAddrType indicates the address type
1435          (IPv4 or IPv6, for example).
1436
1437          If a TN3270(E) client is connected to its
1438          server via a proxy client the address represented by
1439          the value of this object shall be the remote client's
1440          address, not the proxy client's address."
1441     ::= { tn3270eTcpConnEntry 2 }
1442
1443 tn3270eTcpConnRemPort OBJECT-TYPE
1444     SYNTAX      Unsigned32 (0..65535)
1445     MAX-ACCESS  not-accessible
1446     STATUS      current
1447     DESCRIPTION
1448         "The remote port associated with a TN3270E client.  The value 0
1449         is used if the tn3270eTcpConnRemAddrType identifies an address
1450         type that does not support ports.
1451
1452         If a TN3270(E) client is connected to its server via a proxy
1453         client, the port represented by the value of this object shall
1454         be the remote client's port, not the proxy client's port."
1455     ::= { tn3270eTcpConnEntry 3 }
1456
1457 tn3270eTcpConnLocalAddrType OBJECT-TYPE
1458     SYNTAX   IANATn3270eAddrType
1459     MAX-ACCESS  not-accessible
1460     STATUS      current
1461     DESCRIPTION
1462         "Indicates the type of the value of the
1463         tn3270eTcpConnLocalAddress object.  For example,
1464         ipv4(1) or ipv6(2)."
1465     ::= { tn3270eTcpConnEntry 4 }
1466
1467 tn3270eTcpConnLocalAddress OBJECT-TYPE
1468     SYNTAX      IANATn3270eAddress
1469     MAX-ACCESS  not-accessible
1470     STATUS      current
1471     DESCRIPTION
1472         "The local address associated with a TN3270E client.
1473          tn3270eTcpConnRemAddrType indicates the address type
1474          (IPv4 or IPv6, for example)."
1475     ::= { tn3270eTcpConnEntry 5 }
1476
1477 tn3270eTcpConnLocalPort OBJECT-TYPE
1478     SYNTAX      Unsigned32 (1..65535)
1479     MAX-ACCESS  not-accessible
1480     STATUS      current
1481     DESCRIPTION
1482         "The remote port associated with a TN3270E client."
1483     ::= { tn3270eTcpConnEntry 6 }
1484
1485 tn3270eTcpConnLastActivity OBJECT-TYPE
1486     SYNTAX   TimeTicks
1487     MAX-ACCESS  read-only
1488     STATUS      current
1489     DESCRIPTION
1490         "The number of 100ths of seconds since any data was
1491          transferred for the associated TCP Connection."
1492     DEFVAL  { 0 }
1493     ::= { tn3270eTcpConnEntry 7 }
1494
1495 tn3270eTcpConnBytesIn OBJECT-TYPE
1496     SYNTAX   Counter32
1497     UNITS "octets"
1498     MAX-ACCESS  read-only
1499     STATUS      current
1500     DESCRIPTION
1501         "The number of bytes received by the server from TCP
1502         for this connection.
1503
1504         A Management Station can detect discontinuities in
1505         this counter by monitoring the
1506         tn3270eTcpConnActivationTime object."
1507     ::= { tn3270eTcpConnEntry 8 }
1508
1509 tn3270eTcpConnBytesOut OBJECT-TYPE
1510     SYNTAX   Counter32
1511     UNITS "octets"
1512     MAX-ACCESS  read-only
1513     STATUS      current
1514     DESCRIPTION
1515         "The number of bytes sent to TCP for this connection.
1516
1517         A Management Station can detect discontinuities in
1518         this counter by monitoring the
1519         tn3270eTcpConnActivationTime object."
1520     ::= { tn3270eTcpConnEntry 9 }
1521
1522 tn3270eTcpConnResourceElement OBJECT-TYPE
1523     SYNTAX   SnaResourceName
1524     MAX-ACCESS  read-only
1525     STATUS      current
1526     DESCRIPTION
1527         "LU/Print secondary name for connecting an client
1528          into an SNA network."
1529     ::= { tn3270eTcpConnEntry 10 }
1530
1531 tn3270eTcpConnResourceType OBJECT-TYPE
1532     SYNTAX   IANATn3270ResourceType
1533     MAX-ACCESS  read-only
1534     STATUS      current
1535     DESCRIPTION
1536         "Indicates the type of resource identified by
1537          tn3270eTcpConnResourceElement."
1538     ::= { tn3270eTcpConnEntry 11 }
1539
1540 tn3270eTcpConnDeviceType OBJECT-TYPE
1541     SYNTAX   IANATn3270DeviceType
1542     MAX-ACCESS  read-only
1543     STATUS      current
1544     DESCRIPTION
1545         "Indicates the device type if negotiated with the
1546         client.  A value of unknown(100) should be used as
1547         the value of this object when a device type is not
1548         negotiated.  Refer to RFC 2355 for how device types
1549         can be negotiated."
1550     ::= { tn3270eTcpConnEntry 12 }
1551
1552 tn3270eTcpConnFunctions OBJECT-TYPE
1553     SYNTAX   IANATn3270Functions
1554     MAX-ACCESS  read-only
1555     STATUS      current
1556     DESCRIPTION
1557         "This object indicates which of the TN3270 and TN3270E
1558         functions were negotiated by the server and the client
1559         for this TCP connection.
1560
1561         Refer to tn3270eSrvrFunctionsSupported for the list of
1562         these functions supported by the server."
1563     ::= { tn3270eTcpConnEntry 13 }
1564
1565 tn3270eTcpConnId OBJECT-TYPE
1566     SYNTAX      Unsigned32
1567     MAX-ACCESS  read-only
1568     STATUS      current
1569     DESCRIPTION
1570         "The connection identifier associated with a TN3270 or
1571          a TN3270E session's TCP connection.  TCP implementations
1572          often assign a unique (with respect to itself) unsigned
1573          integer as an identifier for a TCP connection.
1574
1575          The value 0 indicates that a connection does not have
1576          a valid connection identifier."
1577     ::= { tn3270eTcpConnEntry 14 }
1578
1579 tn3270eTcpConnClientIdFormat OBJECT-TYPE
1580     SYNTAX      IANATn3270eClientType
1581     MAX-ACCESS  read-only
1582     STATUS      current
1583     DESCRIPTION
1584         "The format of a corresponding tn3270eTcpConnClientId
1585         object as defined by the IANSTn3270eClientType textual
1586         convention imported from the IANATn3270eTC-MIB."
1587     ::= { tn3270eTcpConnEntry 15 }
1588
1589 tn3270eTcpConnClientId OBJECT-TYPE
1590     SYNTAX      OCTET STRING (SIZE (0..512))
1591     MAX-ACCESS  read-only
1592     STATUS      current
1593     DESCRIPTION
1594         "Additional client identification information.  The
1595         type of this information is indicated by the value of
1596         the corresponding tn3270eTcpConnClientIdFormat object.
1597         All values are returned in network-byte order.
1598
1599         The purpose of this object is to provide an alternate
1600         means of identifying a client, other than though the
1601         remote address returned in tn3270eTcpConnRemAddress."
1602     ::= { tn3270eTcpConnEntry 16 }
1603
1604 tn3270eTcpConnTraceData OBJECT-TYPE
1605     SYNTAX   Tn3270eTraceData
1606     MAX-ACCESS  read-only
1607     STATUS      current
1608     DESCRIPTION
1609         "Trace data for this session."
1610     ::= { tn3270eTcpConnEntry 17 }
1611
1612 tn3270eTcpConnLogInfo OBJECT-TYPE
1613     SYNTAX      IANATn3270eLogData
1614     MAX-ACCESS  read-only
1615     STATUS      current
1616     DESCRIPTION
1617         "Log information, encoded as specified in the
1618         IANATn3270eLogData textual convention from the
1619         IANAtn3270eTC-MIB."
1620     ::= { tn3270eTcpConnEntry 18 }
1621
1622 tn3270eTcpConnLuLuBindImage  OBJECT-TYPE
1623     SYNTAX   OCTET STRING (SIZE (0..256))
1624     MAX-ACCESS  read-only
1625     STATUS      current
1626     DESCRIPTION
1627         "When there is a currently active LU-LU session for
1628         this connection, this object returns the BIND Image
1629         (defined to be bytes 1-p of the complete BIND Request
1630         Unit -- see 'SNA Formats' for more information)
1631         that was received from the PLU during session
1632         activation.  When there is no active LU-LU session,
1633         or when a BIND image is unavailable for some other
1634         reason, this object returns a zero-length octet
1635         string."
1636     REFERENCE
1637         "'Systems Network Architecture Formats', IBM
1638         Publication GA27-3136."
1639     ::= { tn3270eTcpConnEntry 19 }
1640
1641 tn3270eTcpConnSnaState  OBJECT-TYPE
1642     SYNTAX   INTEGER {
1643                    unknown(1),
1644                    noSluSession(2),
1645                    sscpLuSession(3),  -- but no LU-LU session
1646                    luLuSession(4),    -- but no SSCP-LU session
1647                    sscpLuSessionAndLuLuSession(5)
1648                       }
1649     MAX-ACCESS  read-only
1650     STATUS      current
1651     DESCRIPTION
1652         "The current state of the SNA side of the end-to-end
1653         TN3270 connection.  The following states are defined:
1654
1655             unknown(1)          - The true state is not known.
1656             noSluSession(2)     - The SLU has neither an SSCP-LU
1657                                   nor an LU-LU session active.
1658             sscpLuSession(3)    - The SSCP-LU session for the SLU
1659                                   is active, but the SLU is not
1660                                   currently in session with a PLU.
1661             luLuSession(4)      - The SLU is currently in session
1662                                   with a PLU, but the SSCP-LU
1663                                   session for the LU is not active.
1664             sscpLuSessionAndLuLuSession(5) - The SLU currently has
1665                                   an active session with a PLU,
1666                                   and the SSCP-LU session for the
1667                                   SLU is active."
1668
1669     ::= { tn3270eTcpConnEntry 20 }
1670
1671 tn3270eTcpConnStateLastDiscReason OBJECT-TYPE
1672     SYNTAX   INTEGER {
1673                   unknown(1),
1674                   hostSendsUnbind(2),
1675                   hostDontAcceptConnection(3),
1676                   outOfResource(4),
1677                   clientProtocolError(5),
1678                   invalidDeviceName(6),
1679                   deviceInUse(7),
1680                   inactivityTimeout(8),
1681                   hostNotResponding(9),
1682                   clientNotResponding(10),
1683                   serverClose(11),
1684                   sysreqLogoff(12),
1685                   serverSpecificHexCode(13)
1686                      }
1687     MAX-ACCESS  read-only
1688     STATUS      current
1689     DESCRIPTION
1690         "The last disconnect reason.  A session that has not
1691         experienced a disconnect shall use the value unknown(1)
1692         for this object.  Depending on when an implementation
1693         removes entries from this table, certain states may
1694         never be returned."
1695     ::= { tn3270eTcpConnEntry 21 }
1696
1697 tn3270eTcpConnSrvrConfIndex OBJECT-TYPE
1698     SYNTAX      Unsigned32 (1..4294967295)
1699     MAX-ACCESS  read-only
1700     STATUS      current
1701     DESCRIPTION
1702         "tn3270eSrvrConfIndex of the tn3270eSrvrConfEntry
1703         belonging to the TN3270E server to which this entry
1704         belongs."
1705     ::= { tn3270eTcpConnEntry 22 }
1706
1707 tn3270eTcpConnActivationTime OBJECT-TYPE
1708     SYNTAX      TimeStamp
1709     MAX-ACCESS  read-only
1710     STATUS      current
1711     DESCRIPTION
1712         "The value of the sysUpTime object the last time
1713         this TCP connection became active."
1714     ::= { tn3270eTcpConnEntry 23 }
1715
1716 tn3270eConfSpinLock OBJECT-TYPE
1717     SYNTAX      TestAndIncr
1718     MAX-ACCESS  read-write
1719     STATUS      current
1720     DESCRIPTION
1721       "An advisory lock used to allow cooperating
1722       TN3270E-MIB applications to coordinate their use
1723       of the tn3270eSrvrConfTable, the tn3270eSrvrPortTable,
1724       the tn3270eClientGroupTable, the tn3270eResPoolTable,
1725       and the tn3270eClientResMapTable.
1726
1727       When creating a new entry or altering an existing entry
1728       in the any of the tables mentioned above, an application
1729       should make use of tn3270eRtSpinLock to serialize
1730       application changes or additions.
1731
1732       Since this is an advisory lock, the use of this lock is
1733       not enforced."
1734     ::= { tn3270eObjects 10 }
1735
1736 -- Conformance Definitions
1737
1738 tn3270eGroups      OBJECT IDENTIFIER ::= { tn3270eConformance 1 }
1739
1740 tn3270eCompliances OBJECT IDENTIFIER ::= { tn3270eConformance 2 }
1741
1742 -- compliance statements
1743
1744 tn3270eCompliance MODULE-COMPLIANCE
1745     STATUS      current
1746     DESCRIPTION
1747         "The compliance statement for agents that support the
1748         TN3270E-MIB."
1749     MODULE -- this module
1750         MANDATORY-GROUPS { tn3270eBasicGroup,
1751                            tn3270eSessionGroup
1752                          }
1753         GROUP       tn3270eResMapGroup
1754         DESCRIPTION
1755             "This group is optional and provides a method of
1756             performing tn3270eClientGroup to tn3270eResPool
1757             mapping."
1758
1759         GROUP       tn3270eHiCapacityGroup
1760         DESCRIPTION
1761             "This group is optional and provides for support
1762             of high capacity counters."
1763
1764         OBJECT tn3270eSrvrConfConnectivityChk
1765            MIN-ACCESS  read-only
1766            DESCRIPTION
1767               "The agent is not required to support a set to this
1768                object if the associated TN3270E server doesn't
1769                support either TIMING-MARK or NOP processing.  In
1770                this case an agent should return noCheck on
1771                retrieval."
1772
1773         OBJECT tn3270eSrvrConfTmNopInactTime
1774            MIN-ACCESS  read-only
1775            DESCRIPTION
1776               "The agent is not required to support a set to this
1777                object if the functions enabled by
1778                tn3270eSrvrConfConnectivityChk are not supported.
1779                An agent in this case should return a value of 0."
1780
1781         OBJECT tn3270eSrvrConfTmNopInterval
1782            MIN-ACCESS  read-only
1783            DESCRIPTION
1784               "The agent is not required to support a set to this
1785                object if the functions enabled by
1786                tn3270eSrvrConfConnectivityChk are not supported.
1787                An agent in this case should return a value of 0."
1788
1789        OBJECT  tn3270eSrvrConfAdminStatus
1790            DESCRIPTION
1791               "A TN3270E server is not required to support a
1792                stopImmediate state transition."
1793
1794         OBJECT tn3270eSrvrConfRowStatus
1795            MIN-ACCESS read-only
1796            DESCRIPTION
1797                "Write access is not required."
1798
1799         OBJECT tn3270eSrvrConfTmTimeout
1800            MIN-ACCESS  read-only
1801            DESCRIPTION
1802               "The agent is not required to support a set to this
1803                object if the functions enabled by
1804                tn3270eSrvrConfConnectivityChk are not supported.
1805                An agent in this case should return a value of 0."
1806
1807         OBJECT tn3270eSrvrPortRowStatus
1808            MIN-ACCESS read-only
1809            DESCRIPTION
1810                "Write access is not required."
1811
1812         OBJECT tn3270eClientGroupRowStatus
1813            MIN-ACCESS read-only
1814            DESCRIPTION
1815                "Write access is not required."
1816
1817         OBJECT tn3270eResPoolRowStatus
1818            MIN-ACCESS read-only
1819            DESCRIPTION
1820                "Write access is not required."
1821
1822         OBJECT tn3270eClientResMapRowStatus
1823            MIN-ACCESS read-only
1824            DESCRIPTION
1825                "Write access is not required."
1826
1827     ::= { tn3270eCompliances 1 }
1828
1829 -- units of conformance
1830
1831 tn3270eBasicGroup OBJECT-GROUP
1832     OBJECTS {
1833         tn3270eSrvrConfInactivityTimeout,
1834         tn3270eSrvrConfConnectivityChk,
1835         tn3270eSrvrConfTmNopInactTime,
1836         tn3270eSrvrConfTmNopInterval,
1837         tn3270eSrvrFunctionsSupported,
1838         tn3270eSrvrConfAdminStatus,
1839         tn3270eSrvrConfOperStatus,
1840         tn3270eSrvrConfSessionTermState,
1841         tn3270eSrvrConfSrvrType,
1842         tn3270eSrvrConfContact,
1843         tn3270eSrvrConfRowStatus,
1844         tn3270eSrvrConfLastActTime,
1845         tn3270eSrvrConfTmTimeout,
1846         tn3270eSrvrPortRowStatus,
1847         tn3270eSrvrStatsUpTime,
1848         tn3270eSrvrStatsMaxTerms,
1849         tn3270eSrvrStatsInUseTerms,
1850         tn3270eSrvrStatsSpareTerms,
1851         tn3270eSrvrStatsMaxPtrs,
1852         tn3270eSrvrStatsInUsePtrs,
1853         tn3270eSrvrStatsSparePtrs,
1854         tn3270eSrvrStatsInConnects,
1855         tn3270eSrvrStatsConnResrceRejs,
1856         tn3270eSrvrStatsDisconnects,
1857         tn3270eSrvrStatsInOctets,
1858         tn3270eSrvrStatsOutOctets,
1859         tn3270eSrvrStatsConnErrorRejs,
1860         tn3270eClientGroupSubnetMask,
1861         tn3270eClientGroupPfxLength,
1862         tn3270eClientGroupRowStatus,
1863         tn3270eSnaMapLocalName,
1864         tn3270eSnaMapPrimaryLuName,
1865         tn3270eConfSpinLock
1866     }
1867     STATUS  current
1868     DESCRIPTION
1869         "This group is mandatory for all hosts supporting the
1870          TN3270E-MIB."
1871     ::= { tn3270eGroups 1 }
1872
1873 tn3270eSessionGroup OBJECT-GROUP
1874     OBJECTS {
1875         tn3270eResMapAddrType,
1876         tn3270eResMapAddress,
1877         tn3270eResMapPort,
1878         tn3270eResMapElementType,
1879         tn3270eResMapSscpSuppliedName,
1880         tn3270eTcpConnLastActivity,
1881         tn3270eTcpConnBytesIn,
1882         tn3270eTcpConnBytesOut,
1883         tn3270eTcpConnResourceElement,
1884         tn3270eTcpConnResourceType,
1885         tn3270eTcpConnDeviceType,
1886         tn3270eTcpConnFunctions,
1887         tn3270eTcpConnSrvrConfIndex,
1888         tn3270eTcpConnActivationTime
1889       }
1890     STATUS  current
1891     DESCRIPTION
1892         "This group is mandatory for all hosts supporting the
1893          TN3270E-MIB."
1894     ::= { tn3270eGroups 2 }
1895
1896 tn3270eResMapGroup OBJECT-GROUP
1897     OBJECTS {
1898         tn3270eResPoolElementType,
1899         tn3270eResPoolRowStatus,
1900         tn3270eClientResMapRowStatus,
1901         tn3270eTcpConnId,
1902         tn3270eTcpConnClientIdFormat,
1903         tn3270eTcpConnClientId,
1904         tn3270eTcpConnTraceData,
1905         tn3270eTcpConnLogInfo,
1906         tn3270eTcpConnLuLuBindImage,
1907         tn3270eTcpConnSnaState,
1908         tn3270eTcpConnStateLastDiscReason
1909       }
1910     STATUS  current
1911     DESCRIPTION
1912         "This group is optional for all hosts supporting the
1913          TN3270E-MIB."
1914     ::= { tn3270eGroups 3 }
1915
1916 tn3270eHiCapacityGroup OBJECT-GROUP
1917     OBJECTS {
1918         tn3270eSrvrStatsHCInOctets,
1919         tn3270eSrvrStatsHCOutOctets
1920       }
1921     STATUS  current
1922     DESCRIPTION
1923          "Support of these objects is REQUIRED when the
1924          Counter32 versions can potentially wrap too
1925          frequently.  This group is optional for all other
1926          hosts supporting the TN3270E-MIB.
1927
1928          The IF-MIB (RFC 2233) requires that the 64-bit
1929          versions of its counters be implemented when an
1930          interface can support rates of around 20 million
1931          bits per second or greater.  This implies a minimum
1932          wrap rate of just over 28 minutes.  It is recommended
1933          that this same guideline be used for determining
1934          whether an implementation implements these objects.
1935
1936          This group contains two objects with the syntax
1937          Counter64.  An implementation that doesn't support
1938          these objects should return noSuchObject, since
1939          returning a zero is misleading."
1940
1941     ::= { tn3270eGroups 4 }
1942
1943 END