draft-ietf-tn3270e-tn3270-mib-07.txt   draft-ietf-tn3270e-tn3270-mib-08.txt 
TN3270E Working Group Kenneth White TN3270E Working Group Kenneth White
INTERNET DRAFT: <draft-ietf-tn3270e-tn3270-mib-07.txt> IBM Corp. INTERNET DRAFT: <draft-ietf-tn3270e-tn3270-mib-08.txt> IBM Corp.
Expiration Date: November, 1998 Robert Moore Expiration Date: November, 1998 Robert Moore
IBM Corp. IBM Corp.
Base Definitions of Managed Objects for Base Definitions of Managed Objects for
TN3270E Using SMIv2 TN3270E Using SMIv2
<draft-ietf-tn3270e-tn3270-mib-07.txt> <draft-ietf-tn3270e-tn3270-mib-08.txt>
Status of this Memo Status of this Memo
This document is an Internet Draft. Internet Drafts are working This document is an Internet Draft. Internet Drafts are working
documents of the Internet Engineering Task Force (IETF), its Areas, and documents of the Internet Engineering Task Force (IETF), its Areas, and
its Working Groups. Note that other groups may also distribute working its Working Groups. Note that other groups may also distribute working
documents as Internet Drafts. documents as Internet Drafts.
Internet Drafts are draft documents valid for a maximum of six months. Internet Drafts are draft documents valid for a maximum of six months.
Internet Drafts may be updated, replaced, or obsoleted by other Internet Drafts may be updated, replaced, or obsoleted by other
skipping to change at page 2, line 42 skipping to change at page 2, line 42
3.3 Resource Name / Client Address Mappings . . . . . . . . . . . 7 3.3 Resource Name / Client Address Mappings . . . . . . . . . . . 7
3.3.1 tn3270eSnaMapTable . . . . . . . . . . . . . . . . . . . . 7 3.3.1 tn3270eSnaMapTable . . . . . . . . . . . . . . . . . . . . 7
3.3.2 tn3270eResMapTable . . . . . . . . . . . . . . . . . . . . 7 3.3.2 tn3270eResMapTable . . . . . . . . . . . . . . . . . . . . 7
3.3.3 tn3270eTcpConnTable . . . . . . . . . . . . . . . . . . . 8 3.3.3 tn3270eTcpConnTable . . . . . . . . . . . . . . . . . . . 8
3.4 Advisory Spin Lock Usage . . . . . . . . . . . . . . . . . . . 8 3.4 Advisory Spin Lock Usage . . . . . . . . . . . . . . . . . . . 8
3.5 Row Persistence . . . . . . . . . . . . . . . . . . . . . . . 8 3.5 Row Persistence . . . . . . . . . . . . . . . . . . . . . . . 8
3.6 IANA Considerations . . . . . . . . . . . . . . . . . . . . . 9 3.6 IANA Considerations . . . . . . . . . . . . . . . . . . . . . 9
4.0 Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 9 4.0 Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 9
5.0 Security Considerations . . . . . . . . . . . . . . . . . . . 45 5.0 Security Considerations . . . . . . . . . . . . . . . . . . . 46
6.0 Intellectual Property . . . . . . . . . . . . . . . . . . . . 46 6.0 Intellectual Property . . . . . . . . . . . . . . . . . . . . 46
7.0 Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 47 7.0 Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 47
8.0 References . . . . . . . . . . . . . . . . . . . . . . . . . . 47 8.0 References . . . . . . . . . . . . . . . . . . . . . . . . . . 47
9.0 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . 48 9.0 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . 48
10.0 Full Copyright Statement . . . . . . . . . . . . . . . . . . 48 10.0 Full Copyright Statement . . . . . . . . . . . . . . . . . . 49
1.0 Introduction 1.0 Introduction
This document is a product of the TN3270E Working Group. Its purpose is This document is a product of the TN3270E Working Group. Its purpose is
to define a MIB module for support by a TCP/IP implementation for to define a MIB module for support by a TCP/IP implementation for
configuration and management of TN3270E servers. configuration and management of TN3270E servers.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119, reference [18]. document are to be interpreted as described in RFC 2119, reference [18].
skipping to change at page 5, line 30 skipping to change at page 5, line 30
tn3270eSrvrConfIndex. This primary index element enables support of tn3270eSrvrConfIndex. This primary index element enables support of
multiple TN3270E servers by a single SNMP agent. Within the set of MIB multiple TN3270E servers by a single SNMP agent. Within the set of MIB
objects returned by one SNMP agent, tn3270eSrvrConfIndex values MUST be objects returned by one SNMP agent, tn3270eSrvrConfIndex values MUST be
unique, and need not be contiguous. unique, and need not be contiguous.
The tn3270eSrvrConfInactivityTimer object defines the inactivity period The tn3270eSrvrConfInactivityTimer object defines the inactivity period
for user traffic on TN3270 and TN3270E sessions. for user traffic on TN3270 and TN3270E sessions.
The four objects: The four objects:
o tn3270eSrvrConfActivityCheck o tn3270eSrvrConfConnectivityChk
o tn3270eSrvrConfTmNopInterval o tn3270eSrvrConfTmNopInterval
o tn3270eSrvrConfTmNopInactTime o tn3270eSrvrConfTmNopInactTime
o tn3270eSrvrConfTmTimeout o tn3270eSrvrConfTmTimeout
define the parameters for performing the "Telnet Timing Mark Option" as define the parameters for performing the "Telnet Timing Mark Option" as
defined by RFC 860 [13]. The object tn3270eSrvrConfActivityCheck allows defined by RFC 860 [13]. The object tn3270eSrvrConfConnectivityChk
a Management Station to select either a NOP command or a TIMING-MARK allows a Management Station to select either a NOP command or a
command. Sending a NOP command results in less overhead then a TIMING-MARK command. Sending a NOP command results in less overhead
TIMING-MARK command, since a client doesn't send a reply. then a TIMING-MARK command, since a client doesn't send a reply.
The objects tn3270eSrvrConfAdminStatus and tn3270eSrvrConfOperStatus The objects tn3270eSrvrConfAdminStatus and tn3270eSrvrConfOperStatus
enable remote starting and stopping of a TN3270E server, and report the enable remote starting and stopping of a TN3270E server, and report the
current state of the server. The object current state of the server. The object
tn3270eSrvrConfFunctionsSupported indicates which of the TN3270 and tn3270eSrvrConfFunctionsSupported indicates which of the TN3270 and
TN3270E options a server supports. The object TN3270E options a server supports. The object
tn3270eSrvrConfSessionTermState defines as a TN3270E server-wide option tn3270eSrvrConfSessionTermState defines as a TN3270E server-wide option
what SHOULD occur when the SNA portion of a TN3270 or TN3270E session what SHOULD occur when the SNA portion of a TN3270 or TN3270E session
terminates with respect to the associated TCP connection. The object terminates with respect to the associated TCP connection. The object
tn3270eSrvrConfSrvrType indicates whether the TN3270E server represented tn3270eSrvrConfSrvrType indicates whether the TN3270E server represented
skipping to change at page 10, line 8 skipping to change at page 10, line 8
FROM SNA-NAU-MIB FROM SNA-NAU-MIB
Utf8String Utf8String
FROM SYSAPPL-MIB FROM SYSAPPL-MIB
SnmpAdminString SnmpAdminString
FROM SNMP-FRAMEWORK-MIB FROM SNMP-FRAMEWORK-MIB
IANATn3270eAddrType, IANATn3270eClientType, IANATn3270eAddrType, IANATn3270eClientType,
IANATn3270eLogData, IANATn3270Functions IANATn3270eLogData, IANATn3270Functions
FROM IANATn3270eTC-MIB; FROM IANATn3270eTC-MIB;
tn3270eMIB MODULE-IDENTITY tn3270eMIB MODULE-IDENTITY
LAST-UPDATED "9805120000Z" -- May 12, 1998 LAST-UPDATED "9805180000Z" -- May 18, 1998
ORGANIZATION "TN3270E Working Group" ORGANIZATION "TN3270E Working Group"
CONTACT-INFO CONTACT-INFO
"Kenneth White (kennethw@vnet.ibm.com) "Kenneth White (kennethw@vnet.ibm.com)
IBM Corp. - Dept. BRQA/Bldg. 501/G114 IBM Corp. - Dept. BRQA/Bldg. 501/G114
P.O. Box 12195 P.O. Box 12195
3039 Cornwallis 3039 Cornwallis
RTP, NC 27709-2195 RTP, NC 27709-2195
USA USA
Robert Moore (remoore@us.ibm.com) Robert Moore (remoore@us.ibm.com)
skipping to change at page 12, line 33 skipping to change at page 12, line 33
type = one-octet code point characterizing the data; type = one-octet code point characterizing the data;
defined values are: defined values are:
X'01' telnet PDU from the server to the client X'01' telnet PDU from the server to the client
X'02' telnet PDU from the client to the server X'02' telnet PDU from the client to the server
X'03' SNA data from the server to the SNA host X'03' SNA data from the server to the SNA host
X'04' SNA data from the SNA host to the server X'04' SNA data from the SNA host to the server
data = initial part of a PDU. data = initial part of a PDU.
It is left to implementations to determine how It is implementation-dependent where the 'initial part of
much of each PDU to return in a trace element. a PDU' starts. For SNA data, however, the starting point
SHOULD be the first byte of the TH. For IP data the
starting point SHOULD be the first byte of the IP header.
It is left to implementations to determine how much of
each PDU to return in a trace element.
The zero-length string indicates that no trace The zero-length string indicates that no trace
data is available." data is available."
SYNTAX OCTET STRING (SIZE (0 | 3..4096)) SYNTAX OCTET STRING (SIZE (0 | 3..4096))
-- Top-level structure of the MIB -- Top-level structure of the MIB
tn3270eNotifications OBJECT IDENTIFIER ::= { tn3270eMIB 0 } tn3270eNotifications OBJECT IDENTIFIER ::= { tn3270eMIB 0 }
tn3270eObjects OBJECT IDENTIFIER ::= { tn3270eMIB 1 } tn3270eObjects OBJECT IDENTIFIER ::= { tn3270eMIB 1 }
tn3270eConformance OBJECT IDENTIFIER ::= { tn3270eMIB 3 } tn3270eConformance OBJECT IDENTIFIER ::= { tn3270eMIB 3 }
skipping to change at page 13, line 25 skipping to change at page 13, line 30
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Definition of the configuration elements for a single "Definition of the configuration elements for a single
TN3270E server." TN3270E server."
INDEX { tn3270eSrvrConfIndex } INDEX { tn3270eSrvrConfIndex }
::= { tn3270eSrvrConfTable 1 } ::= { tn3270eSrvrConfTable 1 }
Tn3270eSrvrConfEntry ::= SEQUENCE { Tn3270eSrvrConfEntry ::= SEQUENCE {
tn3270eSrvrConfIndex Unsigned32, tn3270eSrvrConfIndex Unsigned32,
tn3270eSrvrConfInactivityTimeout Unsigned32, tn3270eSrvrConfInactivityTimeout Unsigned32,
tn3270eSrvrConfActivityCheck INTEGER, tn3270eSrvrConfConnectivityChk INTEGER,
tn3270eSrvrConfTmNopInactTime Unsigned32, tn3270eSrvrConfTmNopInactTime Unsigned32,
tn3270eSrvrConfTmNopInterval Unsigned32, tn3270eSrvrConfTmNopInterval Unsigned32,
tn3270eSrvrFunctionsSupported IANATn3270Functions, tn3270eSrvrFunctionsSupported IANATn3270Functions,
tn3270eSrvrConfAdminStatus INTEGER, tn3270eSrvrConfAdminStatus INTEGER,
tn3270eSrvrConfOperStatus INTEGER, tn3270eSrvrConfOperStatus INTEGER,
tn3270eSrvrConfSessionTermState INTEGER, tn3270eSrvrConfSessionTermState INTEGER,
tn3270eSrvrConfSrvrType INTEGER, tn3270eSrvrConfSrvrType INTEGER,
tn3270eSrvrConfContact SnmpAdminString, tn3270eSrvrConfContact SnmpAdminString,
tn3270eSrvrConfRowStatus RowStatus, tn3270eSrvrConfRowStatus RowStatus,
tn3270eSrvrConfLastActTime DateAndTime, tn3270eSrvrConfLastActTime DateAndTime,
skipping to change at page 14, line 12 skipping to change at page 14, line 17
connection has been inactive for the number of seconds connection has been inactive for the number of seconds
specified by this object it is closed. Only user traffic specified by this object it is closed. Only user traffic
is considered when determining whether there has been is considered when determining whether there has been
activity on a connection. activity on a connection.
The default value 0 means that no inactivity time-out is The default value 0 means that no inactivity time-out is
in effect." in effect."
DEFVAL { 0 } DEFVAL { 0 }
::= { tn3270eSrvrConfEntry 2 } ::= { tn3270eSrvrConfEntry 2 }
tn3270eSrvrConfActivityCheck OBJECT-TYPE tn3270eSrvrConfConnectivityChk OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
noCheck(0), noCheck(0),
timingMark(1), timingMark(1),
nop(2) nop(2)
} }
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object enables TIMING-MARK processing, NOP "This object enables TIMING-MARK processing, NOP
processing, or neither for a TN3270E server." processing, or neither for a TN3270E server."
skipping to change at page 30, line 45 skipping to change at page 30, line 50
a corresponding (same tn3270eSrvrConfIndex) entry in a corresponding (same tn3270eSrvrConfIndex) entry in
the tn3270eSrvrConfTable existing." the tn3270eSrvrConfTable existing."
::= { tn3270eObjects 6 } ::= { tn3270eObjects 6 }
tn3270eSnaMapEntry OBJECT-TYPE tn3270eSnaMapEntry OBJECT-TYPE
SYNTAX Tn3270eSnaMapEntry SYNTAX Tn3270eSnaMapEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Definition of a single mapping from an SSCP-supplied "Definition of a single mapping from an SSCP-supplied
SLU name to a local SLU name." SLU name to a local SLU name.
Note: In certain pathological cases, it is possible
that an SSCP will send on an ACTLU for a local LU an
SLU name currently represented by an entry in this
table that associates it with a different local LU.
In these cases the association from the newer ACTLU
SHOULD be the one represented in this table."
INDEX { tn3270eSrvrConfIndex, INDEX { tn3270eSrvrConfIndex,
tn3270eSnaMapSscpSuppliedName } tn3270eSnaMapSscpSuppliedName }
::= { tn3270eSnaMapTable 1 } ::= { tn3270eSnaMapTable 1 }
Tn3270eSnaMapEntry ::= SEQUENCE { Tn3270eSnaMapEntry ::= SEQUENCE {
tn3270eSnaMapSscpSuppliedName SnaResourceName, tn3270eSnaMapSscpSuppliedName SnaResourceName,
tn3270eSnaMapLocalName SnaResourceName, tn3270eSnaMapLocalName SnaResourceName,
tn3270eSnaMapPrimaryLuName SnaResourceName tn3270eSnaMapPrimaryLuName SnaResourceName
} }
skipping to change at page 42, line 32 skipping to change at page 42, line 44
DESCRIPTION DESCRIPTION
"This group is optional and provides a method of "This group is optional and provides a method of
performing tn3270eClientGroup to tn3270eResPool performing tn3270eClientGroup to tn3270eResPool
mapping." mapping."
GROUP tn3270eHiCapacityGroup GROUP tn3270eHiCapacityGroup
DESCRIPTION DESCRIPTION
"This group is optional and provides for support "This group is optional and provides for support
of high capacity counters." of high capacity counters."
OBJECT tn3270eSrvrConfActivityCheck OBJECT tn3270eSrvrConfConnectivityChk
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"The agent is not required to support a set to this "The agent is not required to support a set to this
object if the associated TN3270E server doesn't object if the associated TN3270E server doesn't
support either TIMING-MARK or NOP processing. In support either TIMING-MARK or NOP processing. In
this case an agent should return noCheck on this case an agent should return noCheck on
retrieval." retrieval."
OBJECT tn3270eSrvrConfTmNopInactTime OBJECT tn3270eSrvrConfTmNopInactTime
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"The agent is not required to support a set to this "The agent is not required to support a set to this
object if the functions enabled by object if the functions enabled by
tn3270eSrvrConfActivityCheck are not supported. tn3270eSrvrConfConnectivityChk are not supported.
An agent in this case should return a value of 0." An agent in this case should return a value of 0."
OBJECT tn3270eSrvrConfTmNopInterval OBJECT tn3270eSrvrConfTmNopInterval
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"The agent is not required to support a set to this "The agent is not required to support a set to this
object if the functions enabled by object if the functions enabled by
tn3270eSrvrConfActivityCheck are not supported. tn3270eSrvrConfConnectivityChk are not supported.
An agent in this case should return a value of 0." An agent in this case should return a value of 0."
OBJECT tn3270eSrvrConfAdminStatus OBJECT tn3270eSrvrConfAdminStatus
DESCRIPTION DESCRIPTION
"A TN3270E server is not required to support a "A TN3270E server is not required to support a
stopImmediate state transition." stopImmediate state transition."
OBJECT tn3270eSrvrConfRowStatus OBJECT tn3270eSrvrConfRowStatus
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"Write access is not required." "Write access is not required."
OBJECT tn3270eSrvrConfTmTimeout OBJECT tn3270eSrvrConfTmTimeout
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"The agent is not required to support a set to this "The agent is not required to support a set to this
object if the functions enabled by object if the functions enabled by
tn3270eSrvrConfActivityCheck are not supported. tn3270eSrvrConfConnectivityChk are not supported.
An agent in this case should return a value of 0." An agent in this case should return a value of 0."
OBJECT tn3270eSrvrPortRowStatus OBJECT tn3270eSrvrPortRowStatus
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"Write access is not required." "Write access is not required."
OBJECT tn3270eClientGroupRowStatus OBJECT tn3270eClientGroupRowStatus
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
skipping to change at page 43, line 47 skipping to change at page 44, line 4
DESCRIPTION DESCRIPTION
"Write access is not required." "Write access is not required."
::= { tn3270eCompliances 1 } ::= { tn3270eCompliances 1 }
-- units of conformance -- units of conformance
tn3270eBasicGroup OBJECT-GROUP tn3270eBasicGroup OBJECT-GROUP
OBJECTS { OBJECTS {
tn3270eSrvrConfInactivityTimeout, tn3270eSrvrConfInactivityTimeout,
tn3270eSrvrConfActivityCheck, tn3270eSrvrConfConnectivityChk,
tn3270eSrvrConfTmNopInactTime, tn3270eSrvrConfTmNopInactTime,
tn3270eSrvrConfTmNopInterval, tn3270eSrvrConfTmNopInterval,
tn3270eSrvrFunctionsSupported, tn3270eSrvrFunctionsSupported,
tn3270eSrvrConfAdminStatus, tn3270eSrvrConfAdminStatus,
tn3270eSrvrConfOperStatus, tn3270eSrvrConfOperStatus,
tn3270eSrvrConfSessionTermState, tn3270eSrvrConfSessionTermState,
tn3270eSrvrConfSrvrType, tn3270eSrvrConfSrvrType,
tn3270eSrvrConfContact, tn3270eSrvrConfContact,
tn3270eSrvrConfRowStatus, tn3270eSrvrConfRowStatus,
tn3270eSrvrConfLastActTime, tn3270eSrvrConfLastActTime,
skipping to change at page 46, line 4 skipping to change at page 46, line 15
5.0 Security Considerations 5.0 Security Considerations
Certain management information defined in this MIB may be considered Certain management information defined in this MIB may be considered
sensitive in some network environments. Therefore, authentication of sensitive in some network environments. Therefore, authentication of
received SNMP requests and controlled access to management information received SNMP requests and controlled access to management information
SHOULD be employed in such environments. An authentication protocol is SHOULD be employed in such environments. An authentication protocol is
defined in [10]. A protocol for access control is defined in [11]. defined in [10]. A protocol for access control is defined in [11].
Several objects in this MIB allow write access or provide for row Several objects in this MIB allow write access or provide for row
creation. Allowing this support in a non-secure environment can have a creation. Allowing this support in a non-secure environment can have a
negative effect on network operations. It is RECOMMENDED that negative effect on network operations. It is RECOMMENDED that
implementers seriously consider whether set operations or row creation implementers seriously consider whether set operations or row creation
should be allowed without providing, at a minimum, authentication of should be allowed without providing, at a minimum, authentication of
request origin. It is RECOMMENDED that without such support, the request origin. It is RECOMMENDED that without such support, the
following objects be implemented as read-only: following objects be implemented as read-only:
o tn3270eSrvrConfInactivityTimout o tn3270eSrvrConfInactivityTimout
o tn3270eSrvrConfActivityCheck o tn3270eSrvrConfConnectivityChk
o tn3270eSrvrConfActivityTimeout o tn3270eSrvrConfActivityTimeout
o tn3270eSrvrConfActivityInterval o tn3270eSrvrConfActivityInterval
o tn3270eSrvrConfAdminStatus o tn3270eSrvrConfAdminStatus
o tn3270eSrvrConfSessionTermState o tn3270eSrvrConfSessionTermState
o tn3270eSrvrConfContact o tn3270eSrvrConfContact
o tn3270eClientGroupSubnetMask o tn3270eClientGroupSubnetMask
o tn3270eResPoolElementType o tn3270eResPoolElementType
o tn3270eSrvrConfRowStatus o tn3270eSrvrConfRowStatus
o tn3270eSrvrPortRowStatus o tn3270eSrvrPortRowStatus
o tn3270eClientGroupRowStatus o tn3270eClientGroupRowStatus
 End of changes. 18 change blocks. 
22 lines changed or deleted 34 lines changed or added

This html diff was produced by rfcdiff 1.34. The latest version is available from http://tools.ietf.org/tools/rfcdiff/