Internet Draft LAPB MIB May 1992 SNMP MIB extension for LAPB June 12, 1992 Dean D. Throop Fred Baker Data General Corporation 62 Alexander Dr. Research Triangle Park, NC 27709 Advanced Computer Communications 315 Bollay Drive Santa Barbara, CA 93101 throop@dg-rtp.dg.com fbaker@acc.com 1. Status of this Memo This document is an Internet Draft. Internet Drafts are working documents of the Internet Engineering Task Force (IETF), its Areas, and its Working Groups. Note that other groups may also distribute working documents as Internet Drafts). Internet Drafts are draft documents valid for a maximum of six months. Internet Drafts may be updated, replaced, or obsoleted by other documents at any time. It is not appropriate to use Internet Drafts as reference material or to cite them other than as a "working draft" or "work in progress." Please check the I-D abstract listing contained in each Internet Draft directory to learn the current status of this or any other Internet Draft. This is the final draft document produced by the x25mib working group. This MIB has been recommended by the working group for consideration as a proposed standard. Completion by D. Throop Invalid after Dec 20, 92 [Page 1] Internet Draft LAPB MIB May 1992 the working group does not means this is a standard as only the IAB can confer that status. However completion by the working group does indicate significant progress. Distribution of this memo is unlimited. While the working group has completed discussion of this document, comments are still welcome. Please send comments to the x25mib working group at: x25mib@dg-rtp.dg.com 1.1. Revision History June 12, 1992 The June 12, 1992 revision of this document (Editor's Internal Reference 2.9) incorporated some clarifications and updated the status. The range on PositiveInteger was changed to start at 0 rather than 1. The syntax of lapbXidIndex was changed to PositiveInteger. A value of dxe was added to lapbOperStationType. The range of lapbAdmnN2RxmitCount was change to (0..65535). The definition of ifInOctets, ifInUcastPkts, ifInErrors, ifInUnknownProtos, ifOutOctets, and ifoutUcastPkts was clarified. May 18, 1992 The May 18, 1992 revision of this document (Editor's Internal Reference 2.8) incorporated the following changes: The states of lapbFlowCurrentMode were redefined. The default value for lapbAdmnControlField was changed from module8 to modulo8. D. Throop Invalid after Dec 20, 92 [Page 2] Internet Draft LAPB MIB May 1992 April 8, 1992 The April 8, 1992 revision of this document (Editor's Internal Reference 2.4) incorporated the following changes: All reference comments in the MIB were moved to the REFERENCE field of the OBJECT-TYPE macro. A type of PositiveInteger was introduced and used for common integer values including all timers. This effectively made the maximum value for timers 2147483646 milliseconds. The type of the frame size was changed to positiveInteger. The reference to ISO 7776 has been broadened to say the MIB descriptions use the terminology of ISO 7776. A comment was added to the overview section discussing creation and deletion of tables. The objects in the lapbParmTable and lapbDefTable were redistributed to create a lapbOperTable, a lapbAdmnTable, and a lapbXidTable. The lapbParmTable and lapbDefTable were deleted. Objects were included in the Admn table for t3 and t4. An object identifier was added to identify the protocol version. A DEFVAL clause was added for all writable objects. Some more overview text was included. February 1992 The February 1992 revision of this document (Editor's Internal Reference 1.17) incorporated the following changes: The name was changed from HDLC to LAPB. This change was made because other flavors of HDLC such as LAPD, SDLC, and raw HDLC framing, are different enough that this MIB will not adequately manage them. The Historical Perspective section at the beginning of the document has been replaced with a more concise D. Throop Invalid after Dec 20, 92 [Page 3] Internet Draft LAPB MIB May 1992 Network Management Framework section. The name lapbParmKWindowSize was changed to lapbParmTransmitKWindowSize and the object lapbParmReceiveKWindowSize was added. This change was made because section 5.7.4 of ISO 7776 and Table 3 of ISO 8885 have provisions for different values for the transmit and receive window size. The name lapbParmN1FrameSize was changed to lapbParmTransmitN1FrameSize and the object lapbParmReceiveN1FrameSize was added. This change was made because section 5.7.3 of ISO 7776 and Table 3 of ISO 8886 have provisions for different values for the transmit and receive maximum frame size. The object lapbParmPortIndex was deleted and the description of lapbParmPortId was changed. The object lapbParmPortId now identifies an instance of the index object for the MIB of the physical device or interface below LAPB. The units for the timers were changed to Milliseconds to be consistent with ISO 8885; see table 3. The objects lapbParamT2AckDelayTimer and lapbParamT3DisconnectTimer both allow values of 0 to indicate the timer is not being used. The object lapbParamT4IdleTimer has a value to indicate timer not in use. The object lapbFlowXidReceived was added to the flow table. The lapbDefTable was added. Ranges and sizes were added for all INTEGERs and OCTET STRINGs that didn't have them. October 1991 The October 1991 revision of this document basically changed the name from LAPB to HDLC to make the objects more appropriate for a broader range of uses. A number of minor D. Throop Invalid after Dec 20, 92 [Page 4] Internet Draft LAPB MIB May 1992 changes were made to bring the objects in line with established conventions. These changes are as follows. The enumerated values of hdlcParmStationType were renumbered from 0 and 1 to 1 and 2. The object hdlcFlowBusyDefer was renamed hdlcFlowBusyDefers. The object hdlcFlowRejSent was rename hdlcFlowRejOutPkts. The object hdlcFlowRejReceived was renamed hdlcFlowRejInPkts. June 1991 The June revision of this document incorporated much of the E-mail discussion of the first draft. In particular it replaced the lapbStatTable (and all contents) with the lapbFlowTable. April 1991 The April 24 version of this document was the first release. At that time this document was basically a bunch of objects synthesized from various vendor MIBs and a quick reading of ISO 7776 [10]. On first reading it appeared to instrument too many LAPB normal functions and too few exceptional conditions. The lapbStatTable was too long and needed to be redone. 2. Abstract This memo defines an experimental portion of the Management Information Base (MIB) for use with network management protocols in TCP/IP-based internets. In particular, it defines objects for managing the Link Layer of X.25, LAPB. The objects defined here, along with the objects in the "SNMP MIB extension for the Packet Layer of X.25"[9] and the "Definitions of Managed Objects for RS-232-like Hardware Devices"[8], combine to allow management of an X.25 protocol stack. D. Throop Invalid after Dec 20, 92 [Page 5] Internet Draft LAPB MIB May 1992 3. The Network Management Framework The Internet-standard Network Management Framework consists of three components. These components give the rules for defining objects, the definitions of objects, and the protocol for manipulating objects. The network management framework structures objects in an abstract information tree. The branches of the tree name objects and the leaves of the tree contain the values manipulated to effect management. This tree is called the Management Information Base or MIB. The concepts of this tree are given in RFC 1155 "The Structure of Management Information" or SMI [1]. The SMI defines the trunk of the tree and the types of objects used when defining the leaves. RFC 1212, "Towards Concise MIB Definitions" [4], defines a more concise description mechanism that preserves all the principals of the SMI. The core MIB definitions for the Internet suite of protocols can be found in RFC 1156 [2] "Management Information Base for Network Management of TCP/IP-based internets". RFC 1213 [5] defines MIB-II, an evolution of MIB-I with changes to incorporate implementation experience and new operational requirements. RFC 1157 [3] defines the SNMP protocol itself. The protocol defines how to manipulate the objects in a remote MIB. The tree structure of the MIB allows new objects to be defined for the purpose of experimentation and evaluation. 4. Objects The definition of an object in the MIB requires an object name and type. Object names and types are defined using the subset of the Abstract Syntax Notation One (ASN.1) [6] defined in the SMI [1]. Objects are named using ASN.1 object identifiers, administratively assigned names, to specify object types. The object name, together with an optional object instance, uniquely identifies a specific instance of an object. For human convenience, we often use a textual string, termed the OBJECT DESCRIPTOR, to also refer to objects. D. Throop Invalid after Dec 20, 92 [Page 6] Internet Draft LAPB MIB May 1992 Objects also have a syntax that defines the abstract data structure corresponding to that object type. The ASN.1 language [6] provides the primitives used for this purpose. The SMI [1] purposely restricts the ASN.1 constructs which may be used for simplicity and ease of implementation. The encoding of an object type simply describes how to represent an object using ASN.1 encoding rules [7], for purposes of dealing with the SNMP protocol. 4.1. Format of Definitions Section 6 contains the specification of all object types defined in this MIB module. The object definitions use the conventions given in the SMI [1] as amended by the concise MIB definitions [4]. D. Throop Invalid after Dec 20, 92 [Page 7] Internet Draft LAPB MIB May 1992 5. Overview 5.1. Informal overview This section describes how the objects defined below relate with other MIBs. This section is only informational to help understand how the pieces fit together. The objects defined below are to be used in conjunction with MIB-II and other MIBs such as the X.25 packet level MIB [9]. A system with a complete X.25 stack running over a synchronous line will have at least two interfaces in the ifTable defined in MIB-II. There will be an interface for LAPB and another interface for the packet layer of X.25. There will also be objects defined in the RS-232-like MIB for the physical sync line. Each software interface identifies the layer below it used to send and receive packets. The X.25 MIB object, x25InfoDataLinkId, specifies an instance of lapbAdmnIndex for the LAPB interface under that X.25. The LAPB object, lapbOperPortId, defined below, identifies an instance of the rs232PortIndex for the the Sync line used by LAPB. For X.25 running over LAPB over Ethernet, the lapbAdmnPortId would identify the instance of ifIndex for the Ethernet interface. Each X.25 subnetwork will have separate entries in the ifTable. Thus a system with two X.25 lines would have two ifTable entries for the two X.25 packet layers and two other entries for the two LAPB interfaces. Each X.25 Packet Layer MIB would identify the instance of the LAPB MIB below it. Each LAPB MIB would identify the Sync line below it. The system would also have two entries for rs232PortTable and rs232SyncPortTable for the two physical lines. Since the ifTable as defined in MIB-II is device independent, it doesn't have anything specific for any type of interface. The objects below define the LAPB specific information for an interface of type LAPB. Different LAPB interfaces can also be differentiated by matching the values of ifIndex with lapbAdmnIndex. D. Throop Invalid after Dec 20, 92 [Page 8] Internet Draft LAPB MIB May 1992 5.2. Textual Conventions Several new data types are introduced as a textual convention in this MIB document. These textual conventions enhance the readability of the specification and can ease comparison with other specifications if appropriate. It should be noted that the introduction of the these textual conventions has no effect on either the syntax nor the semantics of any managed objects. The use of these is merely an artifact of the explanatory method used. Objects defined in terms of one of these methods are always encoded by means of the rules that define the primitive type. Hence, no changes to the SMI or the SNMP are necessary to accommodate these textual conventions which are adopted merely for the convenience of readers and writers in pursuit of the elusive goal of clear, concise, and unambiguous MIB documents. This MIB introduces the data type of: PositiveInteger 5.3. Formal overview Instances of the objects defined below represent attributes of a LAPB interface. LAPB interfaces are identified by an ifType object in the Internet-standard MIB [5] of lapb(16). For these interfaces, the value of the ifSpecific variable in the MIB-II [5] has the OBJECT IDENTIFIER value: lapb OBJECT IDENTIFIER ::= { To Be Assigned } The relationship between a LAPB interface and an interface in the context of the Internet-standard MIB [5] is one-to-one. As such, the value of an ifIndex object instance can be directly used to identify corresponding instances of the objects defined below. The objects defined below are defined in the context of ISO 7776 [10] and ISO 8885 [11]. Access to those documents maybe useful (but isn't essential) to understand the names and semantics of some objects. Where possible the object descriptions use the terminology of ISO 7776; for example, one D. Throop Invalid after Dec 20, 92 [Page 9] Internet Draft LAPB MIB May 1992 commonly used term refers to the peer LAPB as the DCE/remote DTE. This terminology does not restrict the instrumented LAPB to function only as a DTE. This MIB maybe applied to a LAPB configured as either a DCE or a DTE. To the extent that some attributes defined in the Internet standard MIB [5] are applicable to LAPB, those objects have not been duplicated here. In some instances some clarification of how to apply those objects to LAPB has been given. Some objects defined below include a DEFVAL clause. This clause provides reasonable (but not mandatory) default values to use when creating these objects. This does not imply this MIB defines any mechanism for creating or deleting LAPB interfaces. The creation and deletion of the objects of this MIB depend on the implementation method for creating and deleting LAPB interfaces. The DEFVAL clause provides reasonable defaults to allow further extension of the MIB to define methods for creating and deleting LAPB interfaces without having to depreciate these objects for the lack of a DEFVAL clause. 5.4. Tables This extension adds four tables to the MIB. These tables are: lapbAdmnTable, lapbOperTable, lapbFlowTable, and lapbXidTable. The lapbAdmnTable provides objects for common parameters used by LAPB such as the T1 retransmission timer or the N2 retransmission counter. Changes to objects in this table need not affect a running interface but provides access to the values used to initialize an interface. These values are read-write. The lapbOperTable provides objects to determine the parameters actually in use by an interface. These objects are read only. The values currently in use maybe different from the lapbAdmnTable values if the lapbAdmnTable was changed after interface initialization or if XID negotiation selected different values. D. Throop Invalid after Dec 20, 92 [Page 10] Internet Draft LAPB MIB May 1992 The lapbFlowTable provides objects that report how the LAPB interface performs. These are read-only objects used to monitor operation. The lapbXidTable is not required for systems that do not transmit XID frames. For systems that do transmit XID frames, this table provides the values for the fields of the XID frame that are not already present in the lapbAdmnTable. The objects in this table are read-write. 5.5. Traps Since all LAPB interfaces have entries in the ifTable, significant changes in the state of the interface should send a linkUp or linkDown trap. Thus an interface that receives or sends a Frame Reject frame should send a linkDown trap. If the interface later comes back up, it should then send a linkUP trap. D. Throop Invalid after Dec 20, 92 [Page 11] Internet Draft LAPB MIB May 1992 6. Object Definitions RFClapb-MIB DEFINITIONS ::= BEGIN -- (Editors internal reference 2.53) IMPORTS experimental, Counter FROM RFC1155-SMI OBJECT-TYPE FROM RFC-1212; -- LAPB MIB -- DO NOT USE THIS EXPERIMENTAL NUMBER. lapb OBJECT IDENTIFIER ::= { experimental 123456 } -- This experimental number is an -- invalid placeholder. -- DO NOT USE THIS EXPERIMENTAL NUMBER. PositiveInteger ::= INTEGER (0..2147483647) -- ########################################################### -- LAPB Admn Table -- ########################################################### lapbAdmnTable OBJECT-TYPE SYNTAX SEQUENCE OF LapbAdmnEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains objects that can be changed to manage a LAPB interface. Changing one of these parameters may take effect in the operating LAPB immediately or may wait until the interface is restarted depending on the details of the implementation. Most of the objects in this read-write table have corresponding read-only objects in the lapbOperTable that return the current D. Throop Invalid after Dec 20, 92 [Page 12] Internet Draft LAPB MIB May 1992 operating value. The operating values may be different from these configured values if changed by XID negotiation or if a configured parameter was changed after the interface was started." ::= { lapb 1 } lapbAdmnEntry OBJECT-TYPE SYNTAX LapbAdmnEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Configured parameter values for a specific LAPB." INDEX { lapbAdmnIndex } ::= { lapbAdmnTable 1 } LapbAdmnEntry ::= SEQUENCE { lapbAdmnIndex PositiveInteger, lapbAdmnStationType INTEGER, lapbAdmnControlField INTEGER, lapbAdmnTransmitN1FrameSize PositiveInteger, lapbAdmnReceiveN1FrameSize PositiveInteger, lapbAdmnTransmitKWindowSize INTEGER, lapbAdmnReceiveKWindowSize INTEGER, lapbAdmnN2RxmitCount INTEGER, lapbAdmnT1AckTimer PositiveInteger, lapbAdmnT2AckDelayTimer PositiveInteger, lapbAdmnT3DisconnectTimer PositiveInteger, lapbAdmnT4IdleTimer PositiveInteger, lapbAdmnActionInitiate INTEGER, D. Throop Invalid after Dec 20, 92 [Page 13] Internet Draft LAPB MIB May 1992 lapbAdmnActionRecvDM INTEGER } lapbAdmnIndex OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-only STATUS mandatory DESCRIPTION "An index value that uniquely identifies a LAPB interface. This value will match an ifIndex entry identifying the MIB-II ifTable objects for this same interface. The values of this object can range from 1 to ifNumber inclusive." ::= { lapbAdmnEntry 1 } lapbAdmnStationType OBJECT-TYPE SYNTAX INTEGER { dte (1), dce (2), xidDetection (3) } ACCESS read-write STATUS mandatory DESCRIPTION "Identifies the desired station type of this interface." REFERENCE "ISO 7776 section 3.1" DEFVAL { dte } ::= { lapbAdmnEntry 2 } lapbAdmnControlField OBJECT-TYPE SYNTAX INTEGER { modulo8 (1), modulo128 (2) } ACCESS read-write STATUS mandatory DESCRIPTION "The desired size of the sequence numbers used to number frames." REFERENCE "ISO 8885 Table 3, Name: HDLC Option - 10" DEFVAL { modulo8 } ::= { lapbAdmnEntry 3 } D. Throop Invalid after Dec 20, 92 [Page 14] Internet Draft LAPB MIB May 1992 lapbAdmnTransmitN1FrameSize OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-write STATUS mandatory DESCRIPTION "The default maximum N1 frame size desired in number of bits for a frame transmitted by this DTE. This excludes flags and 0 bits inserted for transparency." REFERENCE "ISO 8885 Table 3, Name: Information Field length" DEFVAL { 36000 } -- 4500 * 8; 802.5 Frame size ::= { lapbAdmnEntry 4 } lapbAdmnReceiveN1FrameSize OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-write STATUS mandatory DESCRIPTION "The default maximum N1 frame size desired in number of bits for a frame the DCE/remote DTE transmits to this DTE. This excludes flags and 0 bits inserted for transparency." DEFVAL { 36000 } -- 4500 * 8; 802.5 Frame size ::= { lapbAdmnEntry 5 } lapbAdmnTransmitKWindowSize OBJECT-TYPE SYNTAX INTEGER (1..127) ACCESS read-write STATUS mandatory DESCRIPTION "The default transmit window size for this Interface. This is the maximum number of unacknowledged sequenced PDUs that may be outstanding from this DTE at any one time." REFERENCE "ISO 8885 Table 3, Name: Window size" DEFVAL { 7 } ::= { lapbAdmnEntry 6 } lapbAdmnReceiveKWindowSize OBJECT-TYPE SYNTAX INTEGER (1..127) ACCESS read-write STATUS mandatory DESCRIPTION "The default receive window size for this D. Throop Invalid after Dec 20, 92 [Page 15] Internet Draft LAPB MIB May 1992 Interface. This is the maximum number of unacknowledged sequenced PDUs that may be outstanding from the DCE/remote DTE at any one time." REFERENCE "ISO 8885 Table 3, Name: Window size" DEFVAL { 7 } ::= { lapbAdmnEntry 7 } lapbAdmnN2RxmitCount OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "The default N2 retry counter for this interface. This specifies the number of times a PDU will be resent after the T1 timer expires without an acknowledgement for the PDU." REFERENCE "ISO 8885 Table 3, Name: Retransmission Attempts" DEFVAL { 20 } ::= { lapbAdmnEntry 8 } lapbAdmnT1AckTimer OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-write STATUS mandatory DESCRIPTION "The default T1 timer for this interface. This specifies the maximum time in Milliseconds to wait for acknowledgment of a PDU." REFERENCE "ISO 8885 Table 3, Name: Acknowledgement timer" DEFVAL { 3000 } ::= { lapbAdmnEntry 9 } lapbAdmnT2AckDelayTimer OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-write STATUS mandatory DESCRIPTION "The default T2 timer for this interface. This specifies the maximum time in Milliseconds to wait before sending an D. Throop Invalid after Dec 20, 92 [Page 16] Internet Draft LAPB MIB May 1992 acknowledgment for a sequenced PDU. A value of zero means there will be no delay in acknowledgement generation." REFERENCE "ISO 8885 Table 3, Name: Reply delay timer" DEFVAL { 0 } ::= { lapbAdmnEntry 10 } lapbAdmnT3DisconnectTimer OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-write STATUS mandatory DESCRIPTION "The T3 timer for this interface. This specifies the time in Milliseconds to wait before considering the link disconnected. A value of zero indicates the link will be considered disconnected upon completion of the frame exchange to disconnect the link." REFERENCE "ISO 7776 section 5.7.1.3" DEFVAL { 60000 } ::= { lapbAdmnEntry 11 } lapbAdmnT4IdleTimer OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-write STATUS mandatory DESCRIPTION "The T4 timer for this interface. This specifies the maximum time in Milliseconds to allow without frames being exchanged on the data link. A value of 2147483647 indicates no idle timer is being kept." REFERENCE "ISO 7776 section 5.7.1.4" DEFVAL { 2147483647 } ::= { lapbAdmnEntry 12 } lapbAdmnActionInitiate OBJECT-TYPE SYNTAX INTEGER { sendSABM (1), sendDISC (2), sendDM (3), none (4), other (5) } D. Throop Invalid after Dec 20, 92 [Page 17] Internet Draft LAPB MIB May 1992 ACCESS read-write STATUS mandatory DESCRIPTION "This identifies the action LAPB will take to initiate link set-up." DEFVAL { sendSABM } ::= { lapbAdmnEntry 13 } lapbAdmnActionRecvDM OBJECT-TYPE SYNTAX INTEGER { sendSABM (1), sendDISC (2), other (3) } ACCESS read-write STATUS mandatory DESCRIPTION "This identifies the action LAPB will take when it receives a DM response." DEFVAL { sendSABM } ::= { lapbAdmnEntry 14 } -- ########################################################### -- LAPB operating parameters. -- ########################################################### lapbOperTable OBJECT-TYPE SYNTAX SEQUENCE OF LapbOperEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains configuration information about interface parameters currently set in the interface. Many of these objects have corresponding objects in the lapbAdmnTable." ::= { lapb 2 } lapbOperEntry OBJECT-TYPE SYNTAX LapbOperEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "Currently set parameter values for a D. Throop Invalid after Dec 20, 92 [Page 18] Internet Draft LAPB MIB May 1992 specific LAPB." INDEX { lapbOperIndex } ::= { lapbOperTable 1 } LapbOperEntry ::= SEQUENCE { lapbOperIndex PositiveInteger, lapbOperStationType INTEGER, lapbOperControlField INTEGER, lapbOperTransmitN1FrameSize PositiveInteger, lapbOperReceiveN1FrameSize PositiveInteger, lapbOperTransmitKWindowSize INTEGER, lapbOperReceiveKWindowSize INTEGER, lapbOperN2RxmitCount INTEGER, lapbOperT1AckTimer PositiveInteger, lapbOperT2AckDelayTimer PositiveInteger, lapbOperT3DisconnectTimer PositiveInteger, lapbOperT4IdleTimer PositiveInteger, lapbOperPortId OBJECT IDENTIFIER, lapbOperProtocolVersionId OBJECT IDENTIFIER } lapbOperIndex OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-only STATUS mandatory DESCRIPTION "An index value that uniquely identifies a LAPB interface. This value will match an ifIndex entry identifying the MIB-II ifTable objects for this same interface. The value of this object can range from one to D. Throop Invalid after Dec 20, 92 [Page 19] Internet Draft LAPB MIB May 1992 ifNumber inclusive." ::= { lapbOperEntry 1 } lapbOperStationType OBJECT-TYPE SYNTAX INTEGER { dte (1), dce (2), dxe (3) } ACCESS read-only STATUS mandatory DESCRIPTION "Identifies the current operating station type of this interface. A value of dxe (3) indicates XID negotiation has not yet taken place." REFERENCE "ISO 7776 section 3.1" ::= { lapbOperEntry 2 } lapbOperControlField OBJECT-TYPE SYNTAX INTEGER { modulo8 (1), modulo128 (2) } ACCESS read-only STATUS mandatory DESCRIPTION "The current operating size of the sequence numbers used to number frames." REFERENCE "ISO 7776 section 3.3" ::= { lapbOperEntry 3 } lapbOperTransmitN1FrameSize OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-only STATUS mandatory DESCRIPTION "The current operating N1 frame size used for the maximum number of bits in a frame this DTE can transmit. This excludes flags and 0 bits inserted for transparency." REFERENCE "ISO 7776 section 5.7.3" ::= { lapbOperEntry 4 } lapbOperReceiveN1FrameSize OBJECT-TYPE D. Throop Invalid after Dec 20, 92 [Page 20] Internet Draft LAPB MIB May 1992 SYNTAX PositiveInteger ACCESS read-only STATUS mandatory -- See lapbOperTransmitN1FrameSize above DESCRIPTION "The current operating N1 frame size used for the maximum number of bits in a frame the DCE/remote DTE can transmit. This excludes flags and 0 bits inserted for transparency." ::= { lapbOperEntry 5 } lapbOperTransmitKWindowSize OBJECT-TYPE SYNTAX INTEGER (1..127) ACCESS read-only STATUS mandatory DESCRIPTION "The current PDU window size this Interface uses to transmit. This is the maximum number of unacknowledged sequenced PDUs that may be outstanding from this DTE at any one time." REFERENCE "ISO 7776 section 5.7.4" ::= { lapbOperEntry 6 } lapbOperReceiveKWindowSize OBJECT-TYPE SYNTAX INTEGER (1..127) ACCESS read-only STATUS mandatory DESCRIPTION "The current receive PDU window size for this Interface. This is the maximum number of unacknowledged sequenced PDUs that may be outstanding from the DCE/remote DTE at any one time." REFERENCE "ISO 7776 section 5.7.4" ::= { lapbOperEntry 7 } lapbOperN2RxmitCount OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current N2 retry counter used for this interface. This specifies the number of D. Throop Invalid after Dec 20, 92 [Page 21] Internet Draft LAPB MIB May 1992 times a PDU will be resent after the T1 timer expires without an acknowledgement for the PDU." REFERENCE "ISO 7776 section 5.7.2" ::= { lapbOperEntry 8 } lapbOperT1AckTimer OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-only STATUS mandatory DESCRIPTION "The current T1 timer for this interface. This specifies the maximum time in Milliseconds to wait for acknowledgment of a PDU." REFERENCE "ISO 7776 section 5.7.1.1" ::= { lapbOperEntry 9 } lapbOperT2AckDelayTimer OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-only STATUS mandatory DESCRIPTION "The current T2 timer for this interface. This specifies the maximum time in Milliseconds to wait before sending an acknowledgment for a sequenced PDU. A value of zero means there will be no delay in acknowledgement generation." REFERENCE "ISO 7776 section 5.7.1.2" ::= { lapbOperEntry 10 } lapbOperT3DisconnectTimer OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-only STATUS mandatory DESCRIPTION "The current T3 timer for this interface. This specifies the time in Milliseconds to wait before considering the link disconnected. A value of zero indicates the link will be considered disconnected upon completion of the frame exchange to disconnect the link." REFERENCE "ISO 7776 section 5.7.1.3" D. Throop Invalid after Dec 20, 92 [Page 22] Internet Draft LAPB MIB May 1992 ::= { lapbOperEntry 11 } lapbOperT4IdleTimer OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-write STATUS mandatory DESCRIPTION "The current T4 timer for this interface. This specifies the maximum time in Milliseconds to allow without frames being exchanged on the data link. A value of 2147483647 indicates no idle timer is being kept." REFERENCE "ISO 7776 section 5.7.1.4" ::= { lapbOperEntry 12 } lapbOperPortId OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies an instance of the index object in the first group of objects in the MIB specific to the physical device or interface used to send and receive frames. If an agent does not support any such objects, it should return nullSpec OBJECT IDENTIFIER {0 0}." ::= { lapbOperEntry 13 } lapbOperProtocolVersionId OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the version of the lapb protocol implemented by this interface." ::= { lapbOperEntry 14 } -- ########################################################### -- LAPB Flow Table -- ########################################################### D. Throop Invalid after Dec 20, 92 [Page 23] Internet Draft LAPB MIB May 1992 lapbFlowTable OBJECT-TYPE SYNTAX SEQUENCE OF LapbFlowEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table defines the objects recorded by LAPB to provide information about the traffic flow through the interface." ::= { lapb 3 } lapbFlowEntry OBJECT-TYPE SYNTAX LapbFlowEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The information regarding the effects of flow controls in LAPB." INDEX { lapbFlowIfIndex } ::= { lapbFlowTable 1 } LapbFlowEntry ::= SEQUENCE { lapbFlowIfIndex PositiveInteger, lapbFlowStateChanges Counter, lapbFlowChangeReason INTEGER, lapbFlowCurrentMode INTEGER, lapbFlowBusyDefers Counter, lapbFlowRejOutPkts Counter, lapbFlowRejInPkts Counter, lapbFlowT1Timeouts Counter, lapbFlowFrmrSent OCTET STRING, lapbFlowFrmrReceived OCTET STRING, lapbFlowXidReceived OCTET STRING } D. Throop Invalid after Dec 20, 92 [Page 24] Internet Draft LAPB MIB May 1992 lapbFlowIfIndex OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-only STATUS mandatory DESCRIPTION "The value of ifIndex corresponding to this LAPB Interface. The values of the object can range from one to ifNumber inclusive." ::= { lapbFlowEntry 1 } lapbFlowStateChanges OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "The number of LAPB State Changes, including resets." ::= { lapbFlowEntry 2 } lapbFlowChangeReason OBJECT-TYPE SYNTAX INTEGER { notStarted (1), -- Initial state abmEntered (2), -- SABM or UA abmeEntered (3), -- SABME or UA abmReset (4), -- SABM in ABM abmeReset (5), -- SABME in ABME dmReceived (6), -- DM Response dmSent (7), -- DM sent discReceived (8), -- DISC Response discSent (9), -- DISC Sent frmrReceived (10), -- FRMR Received frmrSent (11), -- FRMR Sent n2Timeout (12), -- N2 Timer Expired other (13) } ACCESS read-only STATUS mandatory DESCRIPTION "The reason for the most recent incrementing of lapbFlowStateChanges. A DM or DISC frame generated to initiate link set-up does not alter this object. When the MIB-II object ifOperStatus does not have a value of testing, there exists a correlation between this object and ifOperStatus. IfOperStatus D. Throop Invalid after Dec 20, 92 [Page 25] Internet Draft LAPB MIB May 1992 will have a value of up when this object contains: abmEntered, abmeEntered, abmReset, or abmeReset. IfOperStatus will have a value of down when this object has a value of notStarted, or dmReceived through n2Timeout. There is no correlation when this object has the value other." ::= { lapbFlowEntry 3 } lapbFlowCurrentMode OBJECT-TYPE SYNTAX INTEGER { disconnected (1), -- initial state or DISC received linkSetup (2), -- SABM sent frameReject (3), -- Invalid frame received and -- FRMR sent disconnectRequest (4), -- DISC sent informationTransfer (5), -- normal information transfer state -- SABM(E) sent and UA received, or -- SABM(E) received and UA sent rejFrameSent (6), -- invalid NS received and REJ sent waitingAcknowledgement (7), -- T1 expired and RR sent stationBusy (8), -- RNR sent remoteStationBusy (9), -- RNR received bothStationsBusy (10), -- RNR received and RNR sent waitingAckStationBusy (11), D. Throop Invalid after Dec 20, 92 [Page 26] Internet Draft LAPB MIB May 1992 -- T1 expired, RNR sent waitingAckRemoteBusy (12), -- T1 expired, RNR received waitingAckBothBusy (13), -- T1 expired, RNR sent, -- and RNR received rejFrameSentRemoteBusy (14), -- REJ sent and RNR received xidFrameSent (15), -- XID frame sent error (16), -- An error state other than -- a one defined above other (17) -- A state not listed above } ACCESS read-only STATUS mandatory DESCRIPTION "The current condition of the conversation." ::= { lapbFlowEntry 4 } lapbFlowBusyDefers OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "The number of times this device was unable to transmit a frame due to a perceived remote busy condition. Busy conditions can result from the receipt of an RNR from the remote device, the lack of valid sequence number space (window saturation), or other conditions." ::= { lapbFlowEntry 5 } lapbFlowRejOutPkts OBJECT-TYPE SYNTAX Counter ACCESS read-only D. Throop Invalid after Dec 20, 92 [Page 27] Internet Draft LAPB MIB May 1992 STATUS mandatory DESCRIPTION "The number of REJ or SREJ frames sent by this station." ::= { lapbFlowEntry 6 } lapbFlowRejInPkts OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "The number of REJ or SREJ frames received by this station." ::= { lapbFlowEntry 7 } lapbFlowT1Timeouts OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "The number of times a re-transmission was effected by the T1 Timer expiring." ::= { lapbFlowEntry 8 } lapbFlowFrmrSent OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..7)) ACCESS read-only STATUS mandatory DESCRIPTION "The Information Field of the FRMR most recently sent. If no FRMR has been sent (the normal case) or the information isn't available, this will be an OCTET STRING of zero length." REFERENCE "ISO 7776 Section 4.3.9, tables 7 and 8" ::= { lapbFlowEntry 9 } lapbFlowFrmrReceived OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..7)) ACCESS read-only STATUS mandatory DESCRIPTION "The Information Field of the FRMR most recently received. If no FRMR has been received (the normal case) or the D. Throop Invalid after Dec 20, 92 [Page 28] Internet Draft LAPB MIB May 1992 information isn't available, this will be an OCTET STRING of zero length." REFERENCE "ISO 7776 Section 4.3.9, tables 7 and 8" ::= { lapbFlowEntry 10 } lapbFlowXidReceived OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..8206)) ACCESS read-only STATUS mandatory DESCRIPTION "The Information Field of the XID frame most recently received. If no XID frame has been received, this will be an OCTET STRING of zero length." REFERENCE "ISO 8885" ::= { lapbFlowEntry 11 } -- ########################################################### -- LAPB XID Table -- ########################################################### lapbXidTable OBJECT-TYPE SYNTAX SEQUENCE OF LapbXidEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table defines values to use for XID negotiation that are not found in the lapbAdmnTable. This table is optional for implementations that don't support XID and mandatory for implementations that do initiate XID negotiation." ::= { lapb 4 } lapbXidEntry OBJECT-TYPE SYNTAX LapbXidEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "XId negotiation parameter values for a specific LAPB." INDEX { lapbXidIndex } ::= { lapbXidTable 1 } D. Throop Invalid after Dec 20, 92 [Page 29] Internet Draft LAPB MIB May 1992 LapbXidEntry ::= SEQUENCE { lapbXidIndex PositiveInteger, lapbXidAdRIdentifier OCTET STRING, lapbXidAdRAddress OCTET STRING, lapbXidParameterUniqueIdentifier OCTET STRING, lapbXidGroupAddress OCTET STRING, lapbXidPortNumber OCTET STRING, lapbXidUserDataSubfield OCTET STRING } lapbXidIndex OBJECT-TYPE SYNTAX PositiveInteger ACCESS read-only STATUS mandatory DESCRIPTION "An index value that uniquely identifies a LAPB interface. This value will match an ifIndex entry identifying the MIB-II ifTable objects for this same interface. The values of this object can range from one to ifNumber inclusive." ::= { lapbXidEntry 1 } lapbXidAdRIdentifier OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..255)) ACCESS read-write STATUS mandatory DESCRIPTION "The value of the Address Resolution Identifier. A zero length string indicates no Identifier value has been assigned." REFERENCE "ISO 8885 Table 2, Name: Identifier" DEFVAL { ''h } ::= { lapbXidEntry 2 } lapbXidAdRAddress OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..255)) ACCESS read-write D. Throop Invalid after Dec 20, 92 [Page 30] Internet Draft LAPB MIB May 1992 STATUS mandatory DESCRIPTION "The value of the Address Resolution Address. A zero length string indicates no Address value has been assigned." REFERENCE "ISO 8885 Table 2, Name: Address" DEFVAL { ''h } ::= { lapbXidEntry 3 } lapbXidParameterUniqueIdentifier OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..255)) ACCESS read-write STATUS mandatory DESCRIPTION "The value of the parameter unique Identifier. A zero length string indicates no Unique identifier value has been assigned." REFERENCE "ISO 8885 Table 3, Name: Identifier" DEFVAL { ''h } ::= { lapbXidEntry 4 } lapbXidGroupAddress OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..255)) ACCESS read-write STATUS mandatory DESCRIPTION "The value of the parameter Group address. A zero length string indicates no Group address value has been assigned." REFERENCE "ISO 8885 Table 3, Name: Group address" DEFVAL { ''h } ::= { lapbXidEntry 5 } lapbXidPortNumber OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..255)) ACCESS read-write STATUS mandatory DESCRIPTION "The port number assigned for this link. A zero length string indicates no local port number identifier has been assigned." REFERENCE "ISO 8885 Table 3, Name: Port number" DEFVAL { ''h } ::= { lapbXidEntry 6 } D. Throop Invalid after Dec 20, 92 [Page 31] Internet Draft LAPB MIB May 1992 lapbXidUserDataSubfield OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..8206)) ACCESS read-write STATUS mandatory DESCRIPTION "A user data subfield, if any, to be transmitted in an XID frame. A zero length frame indicates no user data subfield has been assigned. The octet string should include both the User data identifier and User data field as shown in Figures 1 and 4." REFERENCE "ISO 8885 section 4.3" DEFVAL { ''h } ::= { lapbXidEntry 7 } -- ########################################################### -- LAPB protocol versions -- ########################################################### lapbProtocolVersion OBJECT IDENTIFIER ::= { lapb 5 } lapbProtocolIso7776v1986 OBJECT IDENTIFIER ::= { lapbProtocolVersion 1 } lapbProtocolCcittV1980 OBJECT IDENTIFIER ::= { lapbProtocolVersion 2 } lapbProtocolCcittV1984 OBJECT IDENTIFIER ::= { lapbProtocolVersion 3 } -- The following describes some of the MIB-II interface -- objects and their relationship with the objects in this -- MIB extension. -- ifDescr: describes the interface. It should include -- identification information for the physical line and a -- description of the network. For connections to PDNs, -- it should name the PDN. -- ifMtu: the maximum number of octets an upper layer can D. Throop Invalid after Dec 20, 92 [Page 32] Internet Draft LAPB MIB May 1992 -- pass to this interface as a single frame. -- ifSpeed: -- ifAdminStatus: -- ifOperStatus: -- ifLastChange: the last time the state of the interface -- changed. A reset is considered an instantaneous change to -- the ndm state and back to abm or abme. This will be the -- last time that lapbFlowChangeReason and lapbFlowChanges -- changed. -- ifInOctets: contains the number of octets -- received from the peer LAPB including FCS. -- ifInUcastPkts: contains the number of I-frames delivered -- by this interface to a higher layer interface. -- ifInDiscards: contains the number of received -- frames discarded because of internal conditions -- (such as lack of buffering). -- ifInErrors: contains the number of Invalid frames received. -- This does not have any relationship with the number REJ, -- or RNR frames sent or received. -- ifInUnknownProtos: contains the number of frames -- that were correct but were dropped because they -- were inappropriate for the current state. This -- includes an invalid Poll bit, an unknown address, -- or other condition such as an RNR when connection -- not established. This also includes the number of -- DISC or other frames that were ignored because the -- link was not established and this interface was not -- configured to perform link setup on that type frame. -- ifOutOctets: number of octets sent to peer including -- FCS octets. -- ifOutUcastPkts: number of I-frames received from -- a higher layer for transmission to peer. -- ifOutDiscards: number of frames to be sent that were D. Throop Invalid after Dec 20, 92 [Page 33] Internet Draft LAPB MIB May 1992 -- dropped due to internal conditions such as buffering etc. -- ifOutErrors: number of transmissions that failed -- due to errors or were considered invalid by the receiver. -- This does not have any relationship with the number REJ, -- or RNR frames sent or received. -- ifOutQLen: number of frames waiting to be transmitted. -- This MIB does not provide any support for: -- Multilink procedure (MLP) in ISO 7776 section 6 -- LLC Pbit timer -- LLC REJ timer -- LLC Busy State Timer 7.8.1.4 -- ########################################################### END D. Throop Invalid after Dec 20, 92 [Page 34] Internet Draft LAPB MIB May 1992 7. Acknowledgements This document was produced by the x25mib working group: Fred Baker, ACC Art Berggreen, ACC Frank Bieser Gary Bjerke, Tandem Bill Bowman, HP Christopher Bucci, Datability Charles Carvalho, ACC Jeff Case, Snmp Research Angela Chen, HP Carson Cheung, BNR Tom Daniel, Spider Systems Chuck Davin, MIT Billy Durham, Honeywell Richard Fox, Synoptics Doug Geller, Data General Herve Goguely, LIR Corp Andy Goldthorpe, british-telecom Walter D. Guilarte David Gurevich Steve Huston, Process Software Corporation Jon Infante, ICL Frank Kastenholz, Clearpoint Zbigniew Kielczewski, Eicon Cheryl Krupezak, Georgia Tech Mats Lindstrom, Diab Data AB Andrew Malis, BBN Evan McGinnis, 3Com Gary (G.P.)Mussar, BNR Chandy Nilakantan, 3Com Randy Pafford, Data General Ragnar Paulson, The Software Group Limited Dave Perkins, Synoptics Walter Pinkarschewsky, DEC Karen Quidley, Data General Chris Ranch, Novell Paul S. Rarey, DHL Systems Inc. Jim Roche, Newbridge Research Philippe Roger, LIR Corp. Timon Sloane Mike Shand, DEC Brad Steina, Microcom D. Throop Invalid after Dec 20, 92 [Page 35] Internet Draft LAPB MIB May 1992 Bob Stewart, Xyplex Tom Sullivan, Data General Rodney Thayer, Sable Technology Corporation Mark Therieau, Microcom Jane Thorn, Data General Dean Throop, Data General Maurice Turcotte, Racal Datacom Mike Zendels, Data General In addition, the comments of the following individuals are also acknowledged: Keith McCloghrie D. Throop Invalid after Dec 20, 92 [Page 36] Internet Draft LAPB MIB May 1992 8. References [1] M.T. Rose and K. McCloghrie, "Structure and Identification of Management Information for TCP/IP-based internets", RFC 1155, Network Information Center, SRI International, Menlo Park, California, (May, 1990). [2] K. McCloghrie and M.T. Rose, "Management Information Base for Network Management of TCP/IP-based internets", RFC 1156, Network Information Center, SRI International, Menlo Park, California, (May, 1990). [3] J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin, "Simple Network Management Protocol", RFC 1157, Network Information Center, SRI International, Menlo Park, California, (May, 1990). [4] M.T. Rose, K. McCloghrie (editors), "Towards Concise MIB Definitions", RFC 1212, Network Information Center, SRI International, Menlo Park, California, (March, 1991) [5] M.T. Rose (editor), "Management Information Base for Network Management of TCP/IP-based internets", RFC 1213. Network Information Center, SRI International, Menlo Park, California, (March, 1991). [6] "Information processing systems - Open Systems Interconnection - Specification of Abstract Syntax Notation One (ASN.1)", International Organization for Standardization. International Standard 8824, (December, 1987). [7] "Information processing systems - Open Systems Interconnection - Specification of Basic Encoding Rules for Abstract Notation One (ASN.1)", International Organization for Standardization. International Standard 8825, (December, 1987). [8] B. Stewart (editor), "Definitions of Managed Objects for RS-232-like Hardware Devices", Internet Draft, Internet Engineering Task Force, (December, 1990) [9] D. Throop (editor), "SNMP MIB extension for the Packet Layer of X.25", Internet Draft, Internet Engineering Task Force, (December, 1991). D. Throop Invalid after Dec 20, 92 [Page 37] Internet Draft LAPB MIB May 1992 [10] "Information processing systems - Data communication - High-level data link control procedure - Description of the X.25 LAPB-compatible DTE data link procedures", International Organization for Standardization, International Standard 7776, (December, 1986). [11] "Information technology - Telecommunications and information exchange between systems - High-level data link control (HDLC) procedures - General purpose XID frame information field contents and format", International Organization for Standardization, International Standard 8885. D. Throop Invalid after Dec 20, 92 [Page 38] Internet Draft LAPB MIB May 1992 Table of Contents 1 Status of this Memo ................................... 1 1.1 Revision History .................................... 2 June 12, 1992 .......................................... 2 May 18, 1992 ........................................... 2 April 8, 1992 .......................................... 3 February 1992 .......................................... 3 October 1991 ........................................... 4 June 1991 .............................................. 5 April 1991 ............................................. 5 2 Abstract .............................................. 5 3 The Network Management Framework ...................... 6 4 Objects ............................................... 6 4.1 Format of Definitions ............................... 7 5 Overview .............................................. 8 5.1 Informal overview ................................... 8 5.2 Textual Conventions ................................. 9 5.3 Formal overview ..................................... 9 5.4 Tables .............................................. 10 5.5 Traps ............................................... 11 6 Object Definitions .................................... 12 7 Acknowledgements ...................................... 35 8 References ............................................ 37 D. Throop Invalid after Dec 20, 92 [Page 39] Dean Throop throop@dg-rtp.dg.com