home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 1 / rfc0211.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  58.5 KB  |  1,796 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                       C. Brown
  8. Request for Comments: 2115                      Cadia Networks, Inc.
  9. Obsoletes: 1315                                             F. Baker
  10. Category: Standards Track                              Cisco Systems
  11.                                                       September 1997
  12.  
  13.  
  14.  
  15.             Management Information Base for Frame Relay DTEs
  16.                               Using SMIv2
  17.  
  18. 1.  Status of this Memo
  19.  
  20.    This document specifies an Internet standards track protocol for the
  21.    Internet community, and requests discussion and suggestions for
  22.    improvements.  Please refer to the current edition of the "Internet
  23.    Official Protocol Standards" (STD 1) for the standardization state
  24.    and status of this protocol.  Distribution of this memo is unlimited.
  25.  
  26.  
  27. 2.  Abstract
  28.  
  29.    This memo defines a portion of the Management Information Base (MIB)
  30.    for use with network management protocols in TCP/IP- based internets.
  31.    In particular, it defines objects for managing Frame Relay interfaces
  32.    on DTEs.
  33.  
  34. Table of Contents
  35.  
  36.    1 Status of this Memo ...................................    1
  37.    2 Abstract ..............................................    1
  38.    3 The SNMPv2 Network Management Framework ...............    2
  39.    4 Overview ..............................................    2
  40.    4.1 Frame Relay Operational Model .......................    2
  41.    4.2 Textual Conventions .................................    6
  42.    4.3 Structure of MIB ....................................    6
  43.    5 Changes from RFC 1315 .................................    6
  44.    6 Definitions ...........................................    8
  45.    6.1 Data Link Connection Management Interface ...........    9
  46.    6.2 Circuit Table .......................................   14
  47.    6.3 Error Table .........................................   22
  48.    6.4 Trap Management .....................................   25
  49.    7 Security Issues .......................................   30
  50.    8 Acknowledgments .......................................   30
  51.    9 Authors' Addresses ....................................   31
  52.    10 References ...........................................   31
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Brown & Baker               Standards Track                     [Page 1]
  59.  
  60. RFC 2115                  Frame Relay DTE MIB             September 1997
  61.  
  62.  
  63. 3.  The SNMPv2 Network Management Framework
  64.  
  65.    The major components of the SNMPv2 Network Management framework are
  66.    described in the documents listed below.
  67.  
  68.    o    RFC 1902 [1] defines the Structure of Management
  69.         Information (SMI), the mechanisms used for describing and
  70.         naming objects for the purpose of management.
  71.  
  72.    o    STD 17, RFC 1213 [2] defines MIB-II, the core set of
  73.         managed objects (MO) for the Internet suite of protocols.
  74.  
  75.    o    RFC 1905 [3] defines the protocol used for network access
  76.         to managed objects.
  77.  
  78.    The framework is adaptable/extensible by defining new MIBs to suit
  79.    the requirements of specific applications/protocols/situations.
  80.  
  81.    Managed objects are accessed via a virtual information store, the
  82.    MIB.  Objects in the MIB are defined using the subset of Abstract
  83.    Syntax Notation One (ASN.1) defined in the SMI. In particular, each
  84.    object type is named by an OBJECT IDENTIFIER, which is an
  85.    administratively assigned name. The object type together with an
  86.    object instance serves to uniquely identify a specific instantiation
  87.    of the object. For human convenience, often a textual string, termed
  88.    the descriptor, is used to refer to the object type.
  89.  
  90. 4.  Overview
  91.  
  92. 4.1.  Frame Relay Operational Model
  93.  
  94.    For the purposes of understanding this document, Frame Relay is
  95.    viewed as a multi-access media, not as a group of point- to-point
  96.    connections. This model proposes that Frame Relay is a single
  97.    interface to the network (physical connection) with many destinations
  98.    or neighbors (virtual connections). This view enables a network
  99.    manager the ability to group all virtual connections with their
  100.    corresponding physical connection thereby allowing simpler
  101.    diagnostics and trouble shooting.
  102.  
  103.    With the extension of the interfaces MIB, it is possible to configure
  104.    frame relay DLCs as individual interfaces and create ifTable entries
  105.    for each. This is not recommended and is not directly supported by
  106.    this MIB. Additionally, in the presence of demand circuits creation
  107.    of individual ifEntries for each is not possible.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Brown & Baker               Standards Track                     [Page 2]
  115.  
  116. RFC 2115                  Frame Relay DTE MIB             September 1997
  117.  
  118.  
  119.    Should the user wish to group DLCs together to associate them with a
  120.    higher layer, or to associate a DLC with an unnumbered point-to-point
  121.    service, the frame relay DTE MIB provides an entry in the
  122.    frCircuitEntry record. For example, suppose one were to configure a
  123.    company proprietary protocol to run above several of the frame relay
  124.    VCs. The basic layering would look something like the following:
  125.  
  126.       IP (ipaddrEntry 1 )  IP (ipaddrEntry 2)  IP (ipaddrEntry 3)
  127.          |                    |                     |
  128.          |                    |                     |
  129.          |                    |              proprietary protocol
  130.          |                    |              layer   (ifIndex 3)
  131.          |                    |                     |
  132.          |                    |                     |
  133.       DLCI 20            DLCI 30            DLCI 40/41/42
  134.       (ifIndex 2)        (ifIndex 2)         (ifIndex 2,
  135.                                               logical ifIndex 3)
  136.          |                    |                     |
  137.          |                    |                     |
  138.          |____________________|_____________________|
  139.                               |
  140.                               |
  141.                       FR  DLMCI (ifIndex.2)
  142.                               |
  143.                               |
  144.                    Physical Interface (ifIndex.1)
  145.  
  146.  
  147.  
  148. A configuration which specified that DLCI 40, 41,and 42 were associated
  149. with a proprietary protocol layer, while DLCI 20 and 30 were to run IP
  150. directly can now be expressed using a combination of frCircuitIfIndex
  151. and frCircuitLogicalIfIndex.  In this particular case DLCIs 40, 41 and
  152. 42 would use frCircuitIfIndex equal to the frame relay interface level
  153. (2) while their frCircuitLogicalIfIndex would indicate the proprietary
  154. protocol (3). DLCIs 20 and 30 would have both instances set to the frame
  155. relay interface (2).
  156.  
  157.       Object           Meaning for Frame Relay Interface
  158.       ______           _____________________________________
  159.  
  160.       ifDescr          As per DESCRIPTION in RFC 1573.
  161.       ifType           The value allocated for Frame Relay
  162.                        Interfaces - frameRelay (32).
  163.  
  164.       ifMtu            Set to maximum frame size in octets for
  165.                        this frame relay interface.
  166.  
  167.  
  168.  
  169.  
  170. Brown & Baker               Standards Track                     [Page 3]
  171.  
  172. RFC 2115                  Frame Relay DTE MIB             September 1997
  173.  
  174.  
  175.       ifSpeed          The access rate for the frame relay
  176.                        interface.  This could be different from
  177.                        the speed of the underlying physical
  178.                        interface, e.g. in a fractional T1 case
  179.                        the access rate could be 384 kbits/s (the
  180.                        value reported in this object) whereas the
  181.                        speed of the underlying interface would be
  182.                        1.544 Mbits/s (the value reported in the
  183.                        instance of ifSpeed for the ifEntry with
  184.                        type ds1).
  185.  
  186.       ifPhysAddress    The primary address for this interface
  187.                        assigned by the Frame Relay interface
  188.                        provider.  An octet string of zero length
  189.                        if no address is used for this interface.
  190.  
  191.       ifAdminStatus    As per DESCRIPTION in RFC 1573.
  192.  
  193.       ifOperStatus     As per DESCRIPTION in RFC 1573.
  194.  
  195.       ifLastChange     As per DESCRIPTION in RFC 1573.
  196.  
  197.       ifInOctets       The number of received octets.  This
  198.                        includes not only the information field
  199.                        (user data) but also the frame relay header
  200.                        and CRC.
  201.  
  202.       ifInUcastPkts    The number of frames received on non-
  203.                        multicast DLCIs
  204.  
  205.       ifInDiscards     The number of frames that were successfully
  206.                        received but were discarded because of
  207.                        format errors or because the VC was not
  208.                        known.  Format errors, in this case, are
  209.                        any errors which would prevent the system
  210.                        from recognizing the DLCI and placing the
  211.                        error in the frCircuitDiscard category.
  212.  
  213.       ifInErrors       The number of received frames that are
  214.                        discarded, because of an error.
  215.                        Possible errors can be the following: the
  216.                        frame relay frames were too long or were
  217.                        too short, the frames had an invalid or
  218.                        unrecognized DLCI values, or incorrect
  219.                        header values.
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Brown & Baker               Standards Track                     [Page 4]
  227.  
  228. RFC 2115                  Frame Relay DTE MIB             September 1997
  229.  
  230.  
  231.       ifInUnknownProtos  Number of unknown or unsupported
  232.                        upper layer protocol frames received
  233.                        and discarded.
  234.  
  235.       ifOutOctets      The number of received octets.  This
  236.                        includes not only the information field
  237.                        (user data) but also the frame relay header
  238.                        and CRC.
  239.  
  240.       ifOutUcastpkts   The number of frames sent.
  241.  
  242.       ifOutDiscards    The number of frames discarded in the
  243.                        transmit direction.
  244.  
  245.       ifOutErrors      The number of frames discarded in the
  246.                        egress direction, because of errors.
  247.  
  248.       ifName           As per DESCRIPTION in RFC 1573.
  249.  
  250.       ifInMulticastPkts   The number of unerrored frames received
  251.                           on a multicast DLCI.
  252.  
  253.       ifInBroadcastPkts   Always zero (0) as there are no broadcast
  254.                           frames.
  255.  
  256.       ifOutMulticastPkts  The number of frames transmitted over a
  257.                           multicast DLCI.
  258.  
  259.       ifOutBroadcastPkts  Always zero (0) as there are no broadcast
  260.                           frames.
  261.  
  262.       ifHCInOctets     Only required when ifSpeed >= 155 Mbits/s.
  263.      See
  264.                        details for ifInOctets.
  265.  
  266.       ifHCOutOctets    Only required when ifSpeed >= 155 Mbits/s.
  267.      See
  268.                        details for ifInOctets.
  269.  
  270.       ifLinkUpDownTrapEnble  As per DESCRIPTION in RFC 1573.
  271.  
  272.       ifHighSpeed      The access rate of the frame relay interface
  273.                        measured in Mbits/s.  If the access rate is
  274.                        less than 1 Mbits/s, this object returns 0.
  275.  
  276.       ifPromiscuousMode   Set to false(2).
  277.  
  278.       ifConnectorPresent  Set to false(2).
  279.  
  280.  
  281.  
  282. Brown & Baker               Standards Track                     [Page 5]
  283.  
  284. RFC 2115                  Frame Relay DTE MIB             September 1997
  285.  
  286.  
  287.  
  288. 4.2.  Textual Conventions
  289.  
  290.    One new data type is introduced as a textual convention in this MIB
  291.    document.  This textual convention enhances the readability of the
  292.    specification and can ease comparison with other specifications if
  293.    appropriate.  It should be noted that the introduction of this
  294.    textual conventions has no effect on either the syntax nor the
  295.    semantics of any managed objects.  The use of this is merely an
  296.    artifact of the explanatory method used.  Objects defined in terms of
  297.    one of these methods are always encoded by means of the rules that
  298.    define the primitive type.  Hence, no changes to the SMI or the SNMP
  299.    are necessary to accommodate this textual conventions which is
  300.    adopted merely for the convenience of readers and writers in pursuit
  301.    of the elusive goal of clear, concise, and unambiguous MIB documents.
  302.  
  303.    The new data type is DLCI.  DLCI refers to the range 0..DLCINumber,
  304.    and is used to refer to the valid Data Link Connection Indices.
  305.    DLCINumber is, by definition, the largest possible DLCI value
  306.    possible under the configured Q.922 Address Format.
  307.  
  308. 4.3.  Structure of MIB
  309.  
  310.    The MIB is composed of three groups, one defining the Data Link
  311.    Connection Management Interface (DLCMI), one describing the Circuits,
  312.    and a third describing errors.
  313.  
  314.    During normal operation, Frame Relay virtual circuits will be added,
  315.    deleted and change availability. The occurrence of such changes is of
  316.    interest to the network manager and therefore, one trap is defined,
  317.    intended to be corollary to the SNMP "Link Up" and "Link Down" traps.
  318.  
  319. 5.  Changes from RFC 1315
  320.  
  321.    Below are listed the changes from the previously published version
  322.    this document, which was RFC 1315:
  323.  
  324.    o    The MIB module was converted from SMIv1 to SMIv2 format.
  325.         Note: due to this, the table indices have access of
  326.         "read-only" instead of "not-accessible", which is the
  327.         typical value for index objects in SMIv2.
  328.  
  329.    o    The module name was changed from RFC1315-MIB to FRAME-
  330.         RELAY-DTE-MIB.
  331.  
  332.    o    The textual convention "Index" was dropped from the MIB
  333.         module and "InterfaceIndex" from the interfaces MIB
  334.         module, IF-MIB, was used in its place.
  335.  
  336.  
  337.  
  338. Brown & Baker               Standards Track                     [Page 6]
  339.  
  340. RFC 2115                  Frame Relay DTE MIB             September 1997
  341.  
  342.  
  343.  
  344.    o    Objects frDlcmiStatus and frDlcmiRowStatus were added to
  345.         table frDlcmiTable.
  346.  
  347.    o    Added values "itut933A(5)" (from CCITT Q933 Annex A) and
  348.         "ansiT1617D1994(6)" (from ANSI T1.617a-1994 Annex D) to
  349.         the enumerations for object frDlcmiState.
  350.  
  351.    o    The labels for the enumerated values for object
  352.         frDlcmiAddressLen were renamed to remove their hyphens as
  353.         required by SMIv2.
  354.  
  355.    o    Added clarification that the "management virtual circuit"
  356.         (i.e. DLCI 0) is a member of the circuit table.
  357.  
  358.    o    Added the following objects to table frCircuitTable:
  359.         frCircuitMulticast, frCircuitType, frCircuitDiscards,
  360.         frCircuitReceivedDEs, frCircuitSentDEs,
  361.         frCircuitLogicalIfIndex, and  frCircuitRowStatus.
  362.  
  363.    o    The definition of object frCircuitReceivedOctets was
  364.         clarified as to which octets were counted.
  365.  
  366.    o    Added the objects frErrFaults and frErrFaultTime to table
  367.         frErrTable.
  368.  
  369.    o    Added clarification to the values of object frErrType.
  370.  
  371.    o    Added size on definition of object frErrData and
  372.         clarified what data to capture.
  373.  
  374.    o    Changed identififier for OID value { frameDelayDTE 4 }
  375.         from frame-relay-globals to frameRelayTrapControl.
  376.  
  377.    o    Added object frTrapMaxRate.
  378.  
  379.  
  380.    o    Created object groups frPortGroup, frCircuitGroup,
  381.         frTrapGroup, frErrGroup, frPortGroup0, frCircuitGroup0,
  382.         frTrapGroup0, and frErrGroup0.
  383.  
  384.    o    Created notification group frNotificationGroup.
  385.  
  386.    o    Created module compliances frCompliance and
  387.         frCompliance0.
  388.  
  389.    o    Added ranges to objects frCircuitCommittedBurst,
  390.         frCircuitExcessBurst, and frCircuitThroughput.
  391.  
  392.  
  393.  
  394. Brown & Baker               Standards Track                     [Page 7]
  395.  
  396. RFC 2115                  Frame Relay DTE MIB             September 1997
  397.  
  398.  
  399.  
  400. 6.  Definitions
  401.  
  402.      FRAME-RELAY-DTE-MIB DEFINITIONS ::= BEGIN
  403.  
  404.      IMPORTS
  405.                  MODULE-IDENTITY, OBJECT-TYPE, Counter32,
  406.                  Integer32, NOTIFICATION-TYPE            FROM SNMPv2-SMI
  407.                  TEXTUAL-CONVENTION, RowStatus, TimeStamp FROM SNMPv2-TC
  408.                  MODULE-COMPLIANCE, OBJECT-GROUP,
  409.                  NOTIFICATION-GROUP                     FROM SNMPv2-CONF
  410.                  transmission                           FROM RFC1213-MIB
  411.                  InterfaceIndex                           FROM IF-MIB;
  412.  
  413.      --  Frame Relay DTE MIB
  414.  
  415.      frameRelayDTE MODULE-IDENTITY
  416.          LAST-UPDATED "9705010229Z" -- Thu May  1 02:29:46 PDT 1997
  417.          ORGANIZATION "IETF IPLPDN Working Group"
  418.          CONTACT-INFO
  419.             "       Caralyn Brown
  420.             Postal: Cadia Networks, Inc.
  421.                     1 Corporate Drive
  422.                     Andover, Massachusetts  01810
  423.             Tel:    +1 508 689 2400 x133
  424.             E-Mail: cbrown@cadia.com
  425.  
  426.                     Fred Baker
  427.             Postal: Cisco Systems
  428.                     519 Lado Drive
  429.                     Santa Barbara, California 93111
  430.             Tel:    +1 408 526 425
  431.             E-Mail: fred@cisco.com"
  432.          DESCRIPTION
  433.             "The MIB module to describe the use of a Frame Relay
  434.             interface by a DTE."
  435.          REVISION "9705010229Z" -- Thu May  1 02:29:46 PDT 1997
  436.          DESCRIPTION
  437.             "Converted from SMIv1 to SMIv2. (Thus, indices are
  438.             read-only rather than being not-accessible.) Added
  439.             objects and made clarifications based on implementation
  440.             experience."
  441.  
  442.          REVISION "9204010000Z"
  443.          DESCRIPTION
  444.             "Published as RFC 1315, the initial version of this MIB
  445.             module."
  446.          ::= { transmission 32 }
  447.  
  448.  
  449.  
  450. Brown & Baker               Standards Track                     [Page 8]
  451.  
  452. RFC 2115                  Frame Relay DTE MIB             September 1997
  453.  
  454.  
  455.  
  456.  
  457.      --
  458.      --      the range of a Data Link Connection Identifier
  459.      --
  460.      DLCI ::= TEXTUAL-CONVENTION
  461.          STATUS      current
  462.          DESCRIPTION
  463.             "The range of DLCI values.  Note that this varies by
  464.             interface configuration; normally, interfaces may use
  465.             0..1023, but may be configured to use ranges as large
  466.             as 0..2^23."
  467.          SYNTAX      Integer32(0..8388607)
  468.  
  469.  
  470.  
  471.      --
  472.  
  473.      --  Data Link Connection Management Interface
  474.  
  475.      --      The variables that configure the DLC Management Interface.
  476.  
  477.      frDlcmiTable OBJECT-TYPE
  478.          SYNTAX   SEQUENCE OF FrDlcmiEntry
  479.          MAX-ACCESS   not-accessible
  480.          STATUS   current
  481.          DESCRIPTION
  482.             "The Parameters for the Data Link Connection Management
  483.             Interface for the frame relay service on this
  484.             interface."
  485.          REFERENCE
  486.             "American National Standard T1.617-1991, Annex D"
  487.          ::= { frameRelayDTE 1 }
  488.  
  489.      frDlcmiEntry OBJECT-TYPE
  490.          SYNTAX   FrDlcmiEntry
  491.          MAX-ACCESS   not-accessible
  492.          STATUS   current
  493.          DESCRIPTION
  494.             "The Parameters for a particular Data Link Connection
  495.             Management Interface."
  496.          INDEX { frDlcmiIfIndex }
  497.          ::= { frDlcmiTable 1 }
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506. Brown & Baker               Standards Track                     [Page 9]
  507.  
  508. RFC 2115                  Frame Relay DTE MIB             September 1997
  509.  
  510.  
  511.      FrDlcmiEntry ::=
  512.          SEQUENCE {
  513.              frDlcmiIfIndex                  InterfaceIndex,
  514.              frDlcmiState                    INTEGER,
  515.              frDlcmiAddress                  INTEGER,
  516.              frDlcmiAddressLen               INTEGER,
  517.              frDlcmiPollingInterval          Integer32,
  518.              frDlcmiFullEnquiryInterval      Integer32,
  519.              frDlcmiErrorThreshold           Integer32,
  520.              frDlcmiMonitoredEvents          Integer32,
  521.              frDlcmiMaxSupportedVCs          DLCI,
  522.              frDlcmiMulticast                INTEGER,
  523.              frDlcmiStatus                   INTEGER,
  524.              frDlcmiRowStatus                RowStatus
  525.      }
  526.  
  527.  
  528.      frDlcmiIfIndex OBJECT-TYPE
  529.  
  530.          SYNTAX   InterfaceIndex
  531.          MAX-ACCESS   read-only
  532.          STATUS   current
  533.          DESCRIPTION
  534.             "The ifIndex value of the corresponding ifEntry."
  535.          ::= { frDlcmiEntry 1 }
  536.  
  537.  
  538.      frDlcmiState OBJECT-TYPE
  539.          SYNTAX INTEGER      {
  540.              noLmiConfigured (1),
  541.              lmiRev1         (2),
  542.              ansiT1617D      (3),  -- ANSI T1.617 Annex D
  543.              ansiT1617B      (4),  -- ANSI T1.617 Annex B
  544.              itut933A        (5),  -- CCITT Q933 Annex A
  545.              ansiT1617D1994  (6)   -- ANSI T1.617a-1994 Annex D
  546.          }
  547.          MAX-ACCESS   read-create
  548.          STATUS   current
  549.          DESCRIPTION
  550.             "This variable states which Data Link Connection
  551.             Management scheme is active (and by implication, what
  552.             DLCI it uses) on the Frame Relay interface."
  553.          REFERENCE
  554.             "American National Standard T1.617-1991, American
  555.             National Standard T1.617a-1994, ITU-T Recommendation
  556.             Q.933 (03/93)."
  557.  
  558.          ::= { frDlcmiEntry 2 }
  559.  
  560.  
  561.  
  562. Brown & Baker               Standards Track                    [Page 10]
  563.  
  564. RFC 2115                  Frame Relay DTE MIB             September 1997
  565.  
  566.  
  567.  
  568.  
  569.      frDlcmiAddress OBJECT-TYPE
  570.          SYNTAX      INTEGER {
  571.                      q921           (1),  -- 13 bit DLCI
  572.                      q922March90    (2),  -- 11 bit DLCI
  573.                      q922November90 (3),  -- 10 bit DLCI
  574.                      q922           (4)   -- Final Standard
  575.          }
  576.          MAX-ACCESS  read-create
  577.          STATUS  current
  578.          DESCRIPTION
  579.             "This variable states which address format is in use on
  580.             the Frame Relay interface."
  581.          ::= { frDlcmiEntry 3 }
  582.  
  583.  
  584.      frDlcmiAddressLen OBJECT-TYPE
  585.          SYNTAX  INTEGER     {
  586.                  twoOctets (2),
  587.                  threeOctets (3),
  588.                  fourOctets (4)
  589.          }
  590.          MAX-ACCESS  read-create
  591.          STATUS  current
  592.          DESCRIPTION
  593.             "This variable states the address length in octets.  In
  594.             the case of Q922 format, the length indicates the
  595.             entire length of the address including the control
  596.             portion."
  597.          ::= { frDlcmiEntry 4 }
  598.  
  599.  
  600.      frDlcmiPollingInterval OBJECT-TYPE
  601.          SYNTAX   Integer32 (5..30)
  602.          UNITS    "seconds"
  603.          MAX-ACCESS   read-create
  604.          STATUS   current
  605.          DESCRIPTION
  606.             "This is the number of seconds between successive
  607.             status enquiry messages."
  608.          REFERENCE
  609.             "American National Standard T1.617-1991, Section D.7
  610.             Timer T391."
  611.          DEFVAL { 10 }
  612.          ::= { frDlcmiEntry 5 }
  613.  
  614.  
  615.  
  616.  
  617.  
  618. Brown & Baker               Standards Track                    [Page 11]
  619.  
  620. RFC 2115                  Frame Relay DTE MIB             September 1997
  621.  
  622.  
  623.      frDlcmiFullEnquiryInterval OBJECT-TYPE
  624.          SYNTAX   Integer32 (1..255)
  625.          MAX-ACCESS   read-create
  626.          STATUS   current
  627.          DESCRIPTION
  628.             "Number of status enquiry intervals that pass before
  629.             issuance of a full status enquiry message."
  630.          REFERENCE
  631.             "American National Standard T1.617-1991, Section D.7
  632.             Counter N391."
  633.          DEFVAL { 6 }
  634.          ::= { frDlcmiEntry 6 }
  635.  
  636.  
  637.      frDlcmiErrorThreshold OBJECT-TYPE
  638.          SYNTAX   Integer32 (1..10)
  639.          MAX-ACCESS   read-create
  640.          STATUS   current
  641.          DESCRIPTION
  642.             "This is the maximum number of unanswered Status
  643.             Enquiries the equipment shall accept before declaring
  644.             the interface down."
  645.          REFERENCE
  646.             "American National Standard T1.617-1991, Section D.5.1
  647.             Counter N392."
  648.          DEFVAL { 3 }
  649.          ::= { frDlcmiEntry 7 }
  650.  
  651.  
  652.      frDlcmiMonitoredEvents OBJECT-TYPE
  653.          SYNTAX   Integer32 (1..10)
  654.          MAX-ACCESS   read-create
  655.          STATUS   current
  656.          DESCRIPTION
  657.             "This is the number of status polling intervals over
  658.             which the error threshold is counted.  For example, if
  659.             within 'MonitoredEvents' number of events the station
  660.             receives 'ErrorThreshold' number of errors, the
  661.             interface is marked as down."
  662.          REFERENCE
  663.             "American National Standard T1.617-1991, Section D.5.2
  664.             Counter N393."
  665.          DEFVAL { 4 }
  666.          ::= { frDlcmiEntry 8 }
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674. Brown & Baker               Standards Track                    [Page 12]
  675.  
  676. RFC 2115                  Frame Relay DTE MIB             September 1997
  677.  
  678.  
  679.      frDlcmiMaxSupportedVCs OBJECT-TYPE
  680.          SYNTAX   DLCI
  681.          MAX-ACCESS   read-create
  682.          STATUS   current
  683.          DESCRIPTION
  684.             "The maximum number of Virtual Circuits allowed for
  685.             this interface.  Usually dictated by the Frame Relay
  686.             network.
  687.  
  688.             In response to a SET, if a value less than zero or
  689.             higher than the agent's maximal capability is
  690.             configured, the agent should respond badValue"
  691.          ::= { frDlcmiEntry 9 }
  692.  
  693.  
  694.      frDlcmiMulticast OBJECT-TYPE
  695.          SYNTAX   INTEGER    {
  696.                      nonBroadcast (1),
  697.                      broadcast (2)
  698.                      }
  699.          MAX-ACCESS   read-create
  700.          STATUS   current
  701.          DESCRIPTION
  702.             "This indicates whether the Frame Relay interface is
  703.             using a multicast service."
  704.          ::= { frDlcmiEntry 10 }
  705.  
  706.  
  707.  
  708.      frDlcmiStatus OBJECT-TYPE
  709.          SYNTAX   INTEGER    {
  710.                      running      (1),    -- init complete, system running
  711.                      fault        (2),    -- error threshold exceeded
  712.                      initializing (3)     -- system start up
  713.                      }
  714.          MAX-ACCESS   read-only
  715.          STATUS   current
  716.          DESCRIPTION
  717.             "This indicates the status of the Frame Relay interface
  718.             as determined by the performance of the dlcmi.  If no
  719.             dlcmi is running, the Frame Relay interface will stay
  720.             in the running state indefinitely."
  721.          ::= { frDlcmiEntry 11 }
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Brown & Baker               Standards Track                    [Page 13]
  731.  
  732. RFC 2115                  Frame Relay DTE MIB             September 1997
  733.  
  734.  
  735.      frDlcmiRowStatus OBJECT-TYPE
  736.          SYNTAX   RowStatus
  737.          MAX-ACCESS   read-create
  738.          STATUS   current
  739.          DESCRIPTION
  740.             "SNMP Version 2 Row Status Variable.  Writable objects
  741.             in the table may be written in any RowStatus state."
  742.          ::= { frDlcmiEntry 12 }
  743.  
  744.  
  745.      --
  746.      -- A Frame Relay service is a multiplexing service.  Data
  747.      -- Link Connection Identifiers enumerate virtual circuits
  748.      -- (permanent or dynamic) which are layered onto the underlying
  749.      -- circuit, represented by ifEntry.  Therefore, each of the entries
  750.      -- in the Standard MIB's Interface Table with an IfType of
  751.      -- Frame Relay represents a Q.922 interface.  Zero or more
  752.      -- virtual circuits are layered onto this interface and provide
  753.      -- interconnection with various remote destinations.
  754.      -- Each such virtual circuit is represented by an entry in the
  755.      -- circuit table.  The management virtual circuit (i.e. DLCI 0)
  756.      -- is a virtual circuit by this definition and will be represented
  757.      -- with an entry in the circuit table.
  758.  
  759.      --   Circuit Table
  760.  
  761.      -- The table describing the use of the DLCIs attached to
  762.      -- each Frame Relay Interface.
  763.  
  764.      frCircuitTable OBJECT-TYPE
  765.          SYNTAX   SEQUENCE OF FrCircuitEntry
  766.          MAX-ACCESS   not-accessible
  767.          STATUS   current
  768.          DESCRIPTION
  769.             "A table containing information about specific Data
  770.             Link Connections (DLC) or virtual circuits."
  771.          ::= { frameRelayDTE 2 }
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786. Brown & Baker               Standards Track                    [Page 14]
  787.  
  788. RFC 2115                  Frame Relay DTE MIB             September 1997
  789.  
  790.  
  791.      frCircuitEntry OBJECT-TYPE
  792.          SYNTAX   FrCircuitEntry
  793.          MAX-ACCESS   not-accessible
  794.          STATUS   current
  795.          DESCRIPTION
  796.             "The information regarding a single Data Link
  797.             Connection.  Discontinuities in the counters contained
  798.             in this table are indicated by the value in
  799.             frCircuitCreationTime."
  800.          INDEX { frCircuitIfIndex, frCircuitDlci }
  801.          ::= { frCircuitTable 1 }
  802.  
  803.  
  804.      FrCircuitEntry ::=
  805.          SEQUENCE {
  806.              frCircuitIfIndex                InterfaceIndex,
  807.              frCircuitDlci                   DLCI,
  808.              frCircuitState                  INTEGER,
  809.              frCircuitReceivedFECNs          Counter32,
  810.              frCircuitReceivedBECNs          Counter32,
  811.              frCircuitSentFrames             Counter32,
  812.              frCircuitSentOctets             Counter32,
  813.              frCircuitReceivedFrames         Counter32,
  814.              frCircuitReceivedOctets         Counter32,
  815.              frCircuitCreationTime           TimeStamp,
  816.              frCircuitLastTimeChange         TimeStamp,
  817.              frCircuitCommittedBurst         Integer32,
  818.              frCircuitExcessBurst            Integer32,
  819.              frCircuitThroughput             Integer32,
  820.              frCircuitMulticast              INTEGER,
  821.              frCircuitType                   INTEGER,
  822.              frCircuitDiscards               Counter32,
  823.              frCircuitReceivedDEs            Counter32,
  824.              frCircuitSentDEs                Counter32,
  825.              frCircuitLogicalIfIndex         InterfaceIndex,
  826.              frCircuitRowStatus              RowStatus
  827.      }
  828.  
  829.  
  830.      frCircuitIfIndex OBJECT-TYPE
  831.          SYNTAX   InterfaceIndex
  832.          MAX-ACCESS   read-only
  833.          STATUS   current
  834.          DESCRIPTION
  835.             "The ifIndex Value of the ifEntry this virtual circuit
  836.             is layered onto."
  837.          ::= { frCircuitEntry 1 }
  838.  
  839.  
  840.  
  841.  
  842. Brown & Baker               Standards Track                    [Page 15]
  843.  
  844. RFC 2115                  Frame Relay DTE MIB             September 1997
  845.  
  846.  
  847.  
  848.      frCircuitDlci OBJECT-TYPE
  849.          SYNTAX   DLCI
  850.          MAX-ACCESS   read-only
  851.          STATUS   current
  852.          DESCRIPTION
  853.             "The Data Link Connection Identifier for this virtual
  854.             circuit."
  855.          REFERENCE
  856.             "American National Standard T1.618-1991, Section 3.3.6"
  857.          ::= { frCircuitEntry 2 }
  858.  
  859.  
  860.      frCircuitState OBJECT-TYPE
  861.          SYNTAX   INTEGER    {
  862.  
  863.                      invalid (1),
  864.                      active (2),
  865.                      inactive (3)
  866.                   }
  867.          MAX-ACCESS   read-create
  868.          STATUS   current
  869.          DESCRIPTION
  870.             "Indicates whether the particular virtual circuit is
  871.             operational.  In the absence of a Data Link Connection
  872.             Management Interface, virtual circuit entries (rows)
  873.             may be created by setting virtual circuit state to
  874.             'active', or deleted by changing Circuit state to
  875.             'invalid'.
  876.  
  877.             Whether or not the row actually disappears is left to
  878.             the implementation, so this object may actually read as
  879.             'invalid' for some arbitrary length of time.  It is
  880.             also legal to set the state of a virtual circuit to
  881.             'inactive' to temporarily disable a given circuit.
  882.  
  883.             The use of 'invalid' is deprecated in this SNMP Version
  884.             2 MIB, in favor of frCircuitRowStatus."
  885.          DEFVAL { active }
  886.          ::= { frCircuitEntry 3 }
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898. Brown & Baker               Standards Track                    [Page 16]
  899.  
  900. RFC 2115                  Frame Relay DTE MIB             September 1997
  901.  
  902.  
  903.      frCircuitReceivedFECNs OBJECT-TYPE
  904.          SYNTAX   Counter32
  905.          MAX-ACCESS   read-only
  906.          STATUS   current
  907.          DESCRIPTION
  908.             "Number of frames received from the network indicating
  909.             forward congestion since the virtual circuit was
  910.             created.  This occurs when the remote DTE sets the FECN
  911.             flag, or when a switch in the network enqueues the
  912.             frame to a trunk whose transmission queue is
  913.             congested."
  914.          REFERENCE
  915.             "American National Standard T1.618-1991, Section 3.3.3"
  916.          ::= { frCircuitEntry 4 }
  917.  
  918.  
  919.      frCircuitReceivedBECNs OBJECT-TYPE
  920.          SYNTAX   Counter32
  921.          MAX-ACCESS   read-only
  922.  
  923.  
  924.          STATUS   current
  925.          DESCRIPTION
  926.             "Number of frames received from the network indicating
  927.             backward congestion since the virtual circuit was
  928.             created.  This occurs when the remote DTE sets the BECN
  929.             flag, or when a switch in the network receives the
  930.             frame from a trunk whose transmission queue is
  931.             congested."
  932.          REFERENCE
  933.             "American National Standard T1.618-1991, Section 3.3.4"
  934.          ::= { frCircuitEntry 5 }
  935.  
  936.  
  937.      frCircuitSentFrames OBJECT-TYPE
  938.          SYNTAX   Counter32
  939.          MAX-ACCESS   read-only
  940.          STATUS   current
  941.          DESCRIPTION
  942.             "The number of frames sent from this virtual circuit
  943.             since it was created."
  944.          ::= { frCircuitEntry 6 }
  945.  
  946.  
  947.      frCircuitSentOctets OBJECT-TYPE
  948.          SYNTAX   Counter32
  949.          MAX-ACCESS   read-only
  950.          STATUS   current
  951.  
  952.  
  953.  
  954. Brown & Baker               Standards Track                    [Page 17]
  955.  
  956. RFC 2115                  Frame Relay DTE MIB             September 1997
  957.  
  958.  
  959.          DESCRIPTION
  960.             "The number of octets sent from this virtual circuit
  961.             since it was created.  Octets counted are the full
  962.             frame relay header and the payload, but do not include
  963.             the flag characters or CRC."
  964.          ::= { frCircuitEntry 7 }
  965.  
  966.  
  967.      frCircuitReceivedFrames OBJECT-TYPE
  968.          SYNTAX   Counter32
  969.          MAX-ACCESS   read-only
  970.          STATUS   current
  971.          DESCRIPTION
  972.             "Number of frames received over this virtual circuit
  973.             since it was created."
  974.          ::= { frCircuitEntry 8 }
  975.  
  976.  
  977.      frCircuitReceivedOctets OBJECT-TYPE
  978.          SYNTAX   Counter32
  979.          MAX-ACCESS   read-only
  980.          STATUS   current
  981.          DESCRIPTION
  982.             "Number of octets received over this virtual circuit
  983.             since it was created.  Octets counted include the full
  984.             frame relay header, but do not include the flag
  985.             characters or the CRC."
  986.          ::= { frCircuitEntry 9 }
  987.  
  988.  
  989.      frCircuitCreationTime OBJECT-TYPE
  990.          SYNTAX   TimeStamp
  991.          MAX-ACCESS   read-only
  992.          STATUS   current
  993.          DESCRIPTION
  994.             "The value of sysUpTime when the virtual circuit was
  995.             created, whether by the Data Link Connection Management
  996.             Interface or by a SetRequest."
  997.          ::= { frCircuitEntry 10 }
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010. Brown & Baker               Standards Track                    [Page 18]
  1011.  
  1012. RFC 2115                  Frame Relay DTE MIB             September 1997
  1013.  
  1014.  
  1015.      frCircuitLastTimeChange OBJECT-TYPE
  1016.          SYNTAX   TimeStamp
  1017.          MAX-ACCESS   read-only
  1018.          STATUS   current
  1019.          DESCRIPTION
  1020.             "The value of sysUpTime when last there was a change in
  1021.             the virtual circuit state"
  1022.          ::= { frCircuitEntry 11 }
  1023.  
  1024.  
  1025.      frCircuitCommittedBurst OBJECT-TYPE
  1026.          SYNTAX   Integer32(0..2147483647)
  1027.          MAX-ACCESS   read-create
  1028.          STATUS   current
  1029.          DESCRIPTION
  1030.             "This variable indicates the maximum amount of data, in
  1031.             bits, that the network agrees to transfer under normal
  1032.             conditions, during the measurement interval."
  1033.          REFERENCE
  1034.             "American National Standard T1.617-1991, Section
  1035.             6.5.19"
  1036.          DEFVAL   { 0 }  -- the default indicates no commitment
  1037.          ::= { frCircuitEntry 12 }
  1038.  
  1039.  
  1040.      frCircuitExcessBurst OBJECT-TYPE
  1041.          SYNTAX   Integer32(0..2147483647)
  1042.          MAX-ACCESS   read-create
  1043.          STATUS   current
  1044.          DESCRIPTION
  1045.             "This variable indicates the maximum amount of
  1046.             uncommitted data bits that the network will attempt to
  1047.             deliver over the measurement interval.
  1048.  
  1049.             By default, if not configured when creating the entry,
  1050.             the Excess Information Burst Size is set to the value
  1051.             of ifSpeed."
  1052.          REFERENCE
  1053.             "American National Standard T1.617-1991, Section
  1054.             6.5.19"
  1055.          ::= { frCircuitEntry 13 }
  1056.  
  1057.  
  1058.      frCircuitThroughput OBJECT-TYPE
  1059.          SYNTAX   Integer32(0..2147483647)
  1060.          MAX-ACCESS   read-create
  1061.          STATUS   current
  1062.          DESCRIPTION
  1063.  
  1064.  
  1065.  
  1066. Brown & Baker               Standards Track                    [Page 19]
  1067.  
  1068. RFC 2115                  Frame Relay DTE MIB             September 1997
  1069.  
  1070.  
  1071.             "Throughput is the average number of 'Frame Relay
  1072.             Information Field' bits transferred per second across a
  1073.             user network interface in one direction, measured over
  1074.             the measurement interval.
  1075.  
  1076.             If the configured committed burst rate and throughput
  1077.             are both non-zero, the measurement interval, T, is
  1078.                 T=frCircuitCommittedBurst/frCircuitThroughput.
  1079.  
  1080.             If the configured committed burst rate and throughput
  1081.             are both zero, the measurement interval, T, is
  1082.                        T=frCircuitExcessBurst/ifSpeed."
  1083.          REFERENCE
  1084.             "American National Standard T1.617-1991, Section
  1085.             6.5.19"
  1086.          DEFVAL {0}  -- the default value of Throughput is
  1087.                      -- "no commitment".
  1088.          ::= { frCircuitEntry 14 }
  1089.  
  1090.  
  1091.      frCircuitMulticast OBJECT-TYPE
  1092.          SYNTAX   INTEGER    {
  1093.                      unicast   (1),
  1094.                      oneWay    (2),
  1095.                      twoWay    (3),
  1096.                      nWay      (4)
  1097.                      }
  1098.          MAX-ACCESS   read-create
  1099.          STATUS   current
  1100.          DESCRIPTION
  1101.             "This indicates whether this VC is used as a unicast VC
  1102.             (i.e. not multicast) or the type of multicast service
  1103.             subscribed to"
  1104.          REFERENCE
  1105.             "Frame Relay PVC Multicast Service and Protocol
  1106.             Description Implementation: FRF.7 Frame Relay Forum
  1107.             Technical Committe October 21, 1994"
  1108.               DEFVAL {unicast}
  1109.                           -- the default value of frCircuitMulticast is
  1110.                           -- "unicast" (not a multicast VC).
  1111.               ::= { frCircuitEntry 15 }
  1112.  
  1113.  
  1114.      frCircuitType OBJECT-TYPE
  1115.          SYNTAX   INTEGER    {
  1116.                      static  (1),
  1117.                      dynamic (2)
  1118.                   }
  1119.  
  1120.  
  1121.  
  1122. Brown & Baker               Standards Track                    [Page 20]
  1123.  
  1124. RFC 2115                  Frame Relay DTE MIB             September 1997
  1125.  
  1126.  
  1127.          MAX-ACCESS   read-only
  1128.          STATUS   current
  1129.          DESCRIPTION
  1130.             "Indication of whether the VC was manually created
  1131.             (static), or dynamically created (dynamic) via the data
  1132.             link control management interface."
  1133.          ::= { frCircuitEntry 16 }
  1134.  
  1135.  
  1136.      frCircuitDiscards OBJECT-TYPE
  1137.          SYNTAX   Counter32
  1138.          MAX-ACCESS   read-only
  1139.          STATUS   current
  1140.          DESCRIPTION
  1141.             "The number of inbound frames dropped because of format
  1142.             errors, or because the VC is inactive."
  1143.          ::= { frCircuitEntry 17 }
  1144.  
  1145.  
  1146.      frCircuitReceivedDEs OBJECT-TYPE
  1147.          SYNTAX   Counter32
  1148.          MAX-ACCESS   read-only
  1149.          STATUS   current
  1150.          DESCRIPTION
  1151.             "Number of frames received from the network indicating
  1152.             that they were eligible for discard since the virtual
  1153.             circuit was created.  This occurs when the remote DTE
  1154.             sets the DE flag, or when in remote DTE's switch
  1155.             detects that the frame was received as Excess Burst
  1156.             data."
  1157.          REFERENCE
  1158.             "American National Standard T1.618-1991, Section 3.3.4"
  1159.          ::= { frCircuitEntry 18 }
  1160.  
  1161.  
  1162.      frCircuitSentDEs OBJECT-TYPE
  1163.          SYNTAX   Counter32
  1164.          MAX-ACCESS   read-only
  1165.          STATUS   current
  1166.          DESCRIPTION
  1167.             "Number of frames sent to the network indicating that
  1168.             they were eligible for discard since the virtual
  1169.             circuit was created.   This occurs when the local DTE
  1170.             sets the DE flag, indicating that during Network
  1171.             congestion situations those frames should be discarded
  1172.             in preference of other frames sent without the DE bit
  1173.             set."
  1174.          REFERENCE
  1175.  
  1176.  
  1177.  
  1178. Brown & Baker               Standards Track                    [Page 21]
  1179.  
  1180. RFC 2115                  Frame Relay DTE MIB             September 1997
  1181.  
  1182.  
  1183.             "American National  Standard  T1.618-1991, Section
  1184.             3.3.4"
  1185.         ::= { frCircuitEntry 19 }
  1186.  
  1187.      frCircuitLogicalIfIndex OBJECT-TYPE
  1188.          SYNTAX  InterfaceIndex
  1189.          MAX-ACCESS read-create
  1190.          STATUS  current
  1191.          DESCRIPTION
  1192.             "Normally the same value as frDlcmiIfIndex, but
  1193.             different when an implementation associates a virtual
  1194.             ifEntry with a DLC or set of DLCs in order to associate
  1195.             higher layer objects such as the ipAddrEntry with a
  1196.             subset of the virtual circuits on a Frame Relay
  1197.             interface. The type of such ifEntries is defined by the
  1198.             higher layer object; for example, if PPP/Frame Relay is
  1199.             implemented, the ifType of this ifEntry would be PPP.
  1200.             If it is not so defined, as would be the case with an
  1201.             ipAddrEntry, it should be of type Other."
  1202.         ::= { frCircuitEntry 20 }
  1203.  
  1204.      frCircuitRowStatus OBJECT-TYPE
  1205.          SYNTAX   RowStatus
  1206.          MAX-ACCESS   read-create
  1207.          STATUS   current
  1208.          DESCRIPTION
  1209.             "This object is used to create a new row or modify or
  1210.             destroy an existing row in the manner described in the
  1211.             definition of the RowStatus textual convention.
  1212.             Writable objects in the table may be written in any
  1213.             RowStatus state."
  1214.          ::= { frCircuitEntry 21 }
  1215.  
  1216.  
  1217.      --
  1218.      --  Error Table
  1219.  
  1220.      -- The table describing errors encountered on each Frame
  1221.      -- Relay Interface.
  1222.  
  1223.      frErrTable OBJECT-TYPE
  1224.          SYNTAX   SEQUENCE OF FrErrEntry
  1225.          MAX-ACCESS   not-accessible
  1226.          STATUS   current
  1227.          DESCRIPTION
  1228.             "A table containing information about Errors on the
  1229.             Frame Relay interface.  Discontinuities in the counters
  1230.             contained in this table are the same as apply to the
  1231.  
  1232.  
  1233.  
  1234. Brown & Baker               Standards Track                    [Page 22]
  1235.  
  1236. RFC 2115                  Frame Relay DTE MIB             September 1997
  1237.  
  1238.  
  1239.             ifEntry associated with the Interface."
  1240.          ::= { frameRelayDTE 3 }
  1241.  
  1242.      frErrEntry OBJECT-TYPE
  1243.          SYNTAX   FrErrEntry
  1244.          MAX-ACCESS   not-accessible
  1245.          STATUS   current
  1246.          DESCRIPTION
  1247.             "The error information for a single frame relay
  1248.             interface."
  1249.          INDEX { frErrIfIndex }
  1250.          ::= { frErrTable 1 }
  1251.  
  1252.  
  1253.      FrErrEntry ::=
  1254.          SEQUENCE {
  1255.              frErrIfIndex            InterfaceIndex,
  1256.              frErrType               INTEGER,
  1257.              frErrData               OCTET STRING,
  1258.              frErrTime               TimeStamp,
  1259.              frErrFaults             Counter32,
  1260.              frErrFaultTime          TimeStamp
  1261.      }
  1262.  
  1263.  
  1264.      frErrIfIndex OBJECT-TYPE
  1265.          SYNTAX   InterfaceIndex
  1266.          MAX-ACCESS   read-only
  1267.          STATUS   current
  1268.          DESCRIPTION
  1269.             "The ifIndex Value of the corresponding ifEntry."
  1270.          ::= { frErrEntry 1 }
  1271.  
  1272.  
  1273.          frErrType OBJECT-TYPE
  1274.              SYNTAX   INTEGER    {
  1275.                          unknownError(1),
  1276.                          receiveShort(2),
  1277.                          receiveLong(3),
  1278.                          illegalAddress(4),
  1279.                          unknownAddress(5),
  1280.                          dlcmiProtoErr(6),
  1281.                          dlcmiUnknownIE(7),
  1282.                          dlcmiSequenceErr(8),
  1283.                          dlcmiUnknownRpt(9),
  1284.                          noErrorSinceReset(10)
  1285.                       }
  1286.  
  1287.  
  1288.  
  1289.  
  1290. Brown & Baker               Standards Track                    [Page 23]
  1291.  
  1292. RFC 2115                  Frame Relay DTE MIB             September 1997
  1293.  
  1294.  
  1295.          MAX-ACCESS   read-only
  1296.          STATUS   current
  1297.          DESCRIPTION
  1298.      "The type of error that was last seen  on  this interface:
  1299.  
  1300.      receiveShort: frame was not long enough to allow
  1301.              demultiplexing - the address field was incomplete,
  1302.              or for virtual circuits using Multiprotocol over
  1303.              Frame Relay, the protocol identifier was missing
  1304.              or incomplete.
  1305.  
  1306.      receiveLong: frame exceeded maximum length configured for this
  1307.                   interface.
  1308.  
  1309.      illegalAddress: address field did not match configured format.
  1310.  
  1311.      unknownAddress: frame received on a virtual circuit which was not
  1312.                      active or administratively disabled.
  1313.  
  1314.      dlcmiProtoErr: unspecified error occurred when attempting to
  1315.                     interpret link maintenance frame.
  1316.  
  1317.      dlcmiUnknownIE: link maintenance frame contained an Information
  1318.                      Element type which is not valid for the
  1319.                      configured link maintenance protocol.
  1320.  
  1321.      dlcmiSequenceErr: link maintenance frame contained a sequence
  1322.                        number other than the expected value.
  1323.  
  1324.      dlcmiUnknownRpt: link maintenance frame contained a Report Type
  1325.                       Information Element whose value was not valid
  1326.                       for the configured link maintenance protocol.
  1327.  
  1328.      noErrorSinceReset: no errors have been detected since the last
  1329.                         cold start or warm start."
  1330.          ::= { frErrEntry 2 }
  1331.  
  1332.  
  1333.      frErrData OBJECT-TYPE
  1334.          SYNTAX   OCTET STRING (SIZE(1..1600))
  1335.          MAX-ACCESS   read-only
  1336.          STATUS   current
  1337.          DESCRIPTION
  1338.             "An octet string containing as much of the error packet
  1339.             as possible.  As a minimum, it must contain the Q.922
  1340.             Address or as much as was delivered.  It is desirable
  1341.             to include all header and demultiplexing information."
  1342.          ::= { frErrEntry 3 }
  1343.  
  1344.  
  1345.  
  1346. Brown & Baker               Standards Track                    [Page 24]
  1347.  
  1348. RFC 2115                  Frame Relay DTE MIB             September 1997
  1349.  
  1350.  
  1351.  
  1352.  
  1353.      frErrTime OBJECT-TYPE
  1354.          SYNTAX   TimeStamp
  1355.          MAX-ACCESS   read-only
  1356.          STATUS   current
  1357.          DESCRIPTION
  1358.             "The value of sysUpTime at which the error was
  1359.             detected."
  1360.          ::= { frErrEntry 4 }
  1361.  
  1362.  
  1363.      frErrFaults OBJECT-TYPE
  1364.          SYNTAX   Counter32
  1365.          MAX-ACCESS   read-only
  1366.          STATUS   current
  1367.          DESCRIPTION
  1368.             "The number of times the interface has gone down since
  1369.             it was initialized."
  1370.          ::= { frErrEntry 5 }
  1371.  
  1372.  
  1373.      frErrFaultTime OBJECT-TYPE
  1374.          SYNTAX   TimeStamp
  1375.          MAX-ACCESS   read-only
  1376.          STATUS   current
  1377.          DESCRIPTION
  1378.             "The value of sysUpTime at the time when the interface
  1379.             was taken down due to excessive errors.  Excessive
  1380.             errors is defined as the time when a DLCMI exceeds the
  1381.             frDlcmiErrorThreshold number of errors within
  1382.             frDlcmiMonitoredEvents. See FrDlcmiEntry for further
  1383.             details."
  1384.          ::= { frErrEntry 6 }
  1385.  
  1386.  
  1387.      --
  1388.  
  1389.      -- Frame Relay Trap Control
  1390.  
  1391.      frameRelayTrapControl OBJECT IDENTIFIER ::= { frameRelayDTE 4 }
  1392.  
  1393.      -- the following highly unusual OID is as it is for compatibility
  1394.      -- with RFC 1315, the SNMP V1 predecessor of this document.
  1395.      frameRelayTraps OBJECT IDENTIFIER ::= { frameRelayDTE 0 }
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402. Brown & Baker               Standards Track                    [Page 25]
  1403.  
  1404. RFC 2115                  Frame Relay DTE MIB             September 1997
  1405.  
  1406.  
  1407.      frTrapState OBJECT-TYPE
  1408.          SYNTAX  INTEGER     { enabled(1), disabled(2) }
  1409.          MAX-ACCESS   read-write
  1410.          STATUS   current
  1411.          DESCRIPTION
  1412.             "This variable indicates whether the system produces
  1413.             the frDLCIStatusChange trap."
  1414.          DEFVAL { disabled }
  1415.          ::= { frameRelayTrapControl 1 }
  1416.  
  1417.      frTrapMaxRate OBJECT-TYPE
  1418.          SYNTAX  Integer32 (0..3600000)
  1419.          MAX-ACCESS   read-write
  1420.          STATUS   current
  1421.          DESCRIPTION
  1422.             "This variable indicates the number of milliseconds
  1423.             that must elapse between trap emissions.  If events
  1424.             occur more rapidly, the impementation may simply fail
  1425.             to trap, or may queue traps until an appropriate time."
  1426.          DEFVAL { 0 }        -- no minimum elapsed period is specified
  1427.          ::= { frameRelayTrapControl 2 }
  1428.  
  1429.  
  1430.  
  1431.      --  Data Link Connection Management Interface Related Traps
  1432.  
  1433.      frDLCIStatusChange NOTIFICATION-TYPE
  1434.          OBJECTS  { frCircuitState }
  1435.          STATUS      current
  1436.  
  1437.  
  1438.          DESCRIPTION
  1439.             "This trap indicates that the indicated Virtual Circuit
  1440.             has changed state.  It has either been created or
  1441.             invalidated, or has toggled between the active and
  1442.             inactive states.  If, however, the reason for the state
  1443.             change is due to the DLCMI going down, per-DLCI traps
  1444.             should not be generated."
  1445.      ::= { frameRelayTraps 1 }
  1446.      -- conformance information
  1447.  
  1448.      frConformance OBJECT IDENTIFIER ::= { frameRelayDTE 6 }
  1449.  
  1450.      frGroups      OBJECT IDENTIFIER ::= { frConformance 1 }
  1451.      frCompliances OBJECT IDENTIFIER ::= { frConformance 2 }
  1452.  
  1453.      -- compliance statements
  1454.  
  1455.  
  1456.  
  1457.  
  1458. Brown & Baker               Standards Track                    [Page 26]
  1459.  
  1460. RFC 2115                  Frame Relay DTE MIB             September 1997
  1461.  
  1462.  
  1463.      frCompliance MODULE-COMPLIANCE
  1464.          STATUS  current
  1465.          DESCRIPTION
  1466.             "The compliance statement "
  1467.          MODULE  -- this module
  1468.          MANDATORY-GROUPS { frPortGroup, frCircuitGroup }
  1469.  
  1470.          GROUP       frErrGroup
  1471.          DESCRIPTION
  1472.             "This optional group is used for debugging Frame Relay
  1473.             Systems."
  1474.  
  1475.          GROUP       frTrapGroup
  1476.          DESCRIPTION
  1477.             "This optional group is used for the management of
  1478.             asynchronous notifications by Frame Relay Systems."
  1479.  
  1480.          GROUP       frNotificationGroup
  1481.          DESCRIPTION
  1482.             "This optional group defines the asynchronous
  1483.             notifications generated by Frame Relay Systems."
  1484.  
  1485.          OBJECT      frDlcmiRowStatus
  1486.          MIN-ACCESS  read-only
  1487.          DESCRIPTION
  1488.             "Row creation is not required for the frDlcmiTable."
  1489.  
  1490.          OBJECT      frCircuitRowStatus
  1491.  
  1492.          MIN-ACCESS  read-only
  1493.          DESCRIPTION
  1494.             "Row creation is not required for the frCircuitTable."
  1495.  
  1496.          ::= { frCompliances 1 }
  1497.  
  1498.      frCompliance0 MODULE-COMPLIANCE
  1499.          STATUS  current
  1500.          DESCRIPTION
  1501.             "The compliance statement for objects and the trap
  1502.             defined in RFC 1315."
  1503.          MODULE  -- this module
  1504.          MANDATORY-GROUPS { frPortGroup0, frCircuitGroup0 }
  1505.  
  1506.          GROUP       frErrGroup0
  1507.          DESCRIPTION
  1508.             "This optional group is used for debugging Frame Relay
  1509.             Systems."
  1510.  
  1511.  
  1512.  
  1513.  
  1514. Brown & Baker               Standards Track                    [Page 27]
  1515.  
  1516. RFC 2115                  Frame Relay DTE MIB             September 1997
  1517.  
  1518.  
  1519.          GROUP       frTrapGroup0
  1520.          DESCRIPTION
  1521.             "This optional group is used for the management of
  1522.             asynchronous notifications by Frame Relay Systems."
  1523.  
  1524.          GROUP       frNotificationGroup
  1525.          DESCRIPTION
  1526.             "This optional group defines the asynchronous
  1527.             notifications generated by Frame Relay Systems."
  1528.  
  1529.          ::= { frCompliances 2 }
  1530.  
  1531.      -- units of conformance
  1532.  
  1533.      frPortGroup    OBJECT-GROUP
  1534.          OBJECTS {
  1535.                    frDlcmiIfIndex, frDlcmiState, frDlcmiAddress,
  1536.                    frDlcmiAddressLen, frDlcmiPollingInterval,
  1537.                    frDlcmiFullEnquiryInterval, frDlcmiErrorThreshold,
  1538.                    frDlcmiMonitoredEvents, frDlcmiMaxSupportedVCs,
  1539.                    frDlcmiMulticast, frDlcmiStatus, frDlcmiRowStatus
  1540.                 }
  1541.          STATUS  current
  1542.          DESCRIPTION
  1543.             "The objects necessary to control the Link Management
  1544.             Interface for a Frame Relay Interface as well as
  1545.             maintain the error statistics on this interface."
  1546.          ::= { frGroups 1 }
  1547.  
  1548.      frCircuitGroup    OBJECT-GROUP
  1549.          OBJECTS {
  1550.                    frCircuitIfIndex, frCircuitDlci, frCircuitState,
  1551.                    frCircuitReceivedFECNs, frCircuitReceivedBECNs,
  1552.                    frCircuitSentFrames, frCircuitSentOctets,
  1553.                    frCircuitReceivedFrames, frCircuitReceivedOctets,
  1554.                    frCircuitCreationTime, frCircuitLastTimeChange,
  1555.                    frCircuitCommittedBurst, frCircuitExcessBurst,
  1556.                    frCircuitThroughput, frCircuitMulticast,
  1557.                    frCircuitType, frCircuitDiscards,
  1558.                    frCircuitReceivedDEs, frCircuitSentDEs,
  1559.                    frCircuitLogicalIfIndex, frCircuitRowStatus
  1560.                  }
  1561.          STATUS  current
  1562.          DESCRIPTION
  1563.             "The objects necessary to control the Virtual Circuits
  1564.             layered onto a Frame Relay Interface."
  1565.          ::= { frGroups 2 }
  1566.  
  1567.  
  1568.  
  1569.  
  1570. Brown & Baker               Standards Track                    [Page 28]
  1571.  
  1572. RFC 2115                  Frame Relay DTE MIB             September 1997
  1573.  
  1574.  
  1575.      frTrapGroup    OBJECT-GROUP
  1576.          OBJECTS { frTrapState, frTrapMaxRate }
  1577.          STATUS  current
  1578.          DESCRIPTION
  1579.             "The objects necessary to control a Frame Relay
  1580.             Interface's notification messages."
  1581.          ::= { frGroups 3 }
  1582.  
  1583.      frErrGroup    OBJECT-GROUP
  1584.          OBJECTS {
  1585.                    frErrIfIndex, frErrType, frErrData, frErrTime,
  1586.                    frErrFaults, frErrFaultTime
  1587.                 }
  1588.          STATUS  current
  1589.          DESCRIPTION
  1590.             "Objects designed to assist in debugging Frame Relay
  1591.             Interfaces."
  1592.          ::= { frGroups 4 }
  1593.  
  1594.      frNotificationGroup NOTIFICATION-GROUP
  1595.          NOTIFICATIONS { frDLCIStatusChange }
  1596.          STATUS  current
  1597.          DESCRIPTION
  1598.             "Traps which may be used to enhance event driven
  1599.             management of the interface."
  1600.          ::= { frGroups 5 }
  1601.  
  1602.      frPortGroup0    OBJECT-GROUP
  1603.          OBJECTS {
  1604.                    frDlcmiIfIndex, frDlcmiState, frDlcmiAddress,
  1605.                    frDlcmiAddressLen, frDlcmiPollingInterval,
  1606.                    frDlcmiFullEnquiryInterval, frDlcmiErrorThreshold,
  1607.                    frDlcmiMonitoredEvents, frDlcmiMaxSupportedVCs,
  1608.                    frDlcmiMulticast
  1609.                 }
  1610.          STATUS  current
  1611.          DESCRIPTION
  1612.             "The objects necessary to control the Link Management
  1613.             Interface for a Frame Relay Interface as well as
  1614.             maintain the error statistics on this interface from
  1615.             RFC 1315."
  1616.          ::= { frGroups 6 }
  1617.  
  1618.      frCircuitGroup0    OBJECT-GROUP
  1619.          OBJECTS {
  1620.                    frCircuitIfIndex, frCircuitDlci, frCircuitState,
  1621.                    frCircuitReceivedFECNs, frCircuitReceivedBECNs,
  1622.                    frCircuitSentFrames, frCircuitSentOctets,
  1623.  
  1624.  
  1625.  
  1626. Brown & Baker               Standards Track                    [Page 29]
  1627.  
  1628. RFC 2115                  Frame Relay DTE MIB             September 1997
  1629.  
  1630.  
  1631.                    frCircuitReceivedFrames, frCircuitReceivedOctets,
  1632.                    frCircuitCreationTime, frCircuitLastTimeChange,
  1633.                    frCircuitCommittedBurst, frCircuitExcessBurst,
  1634.                    frCircuitThroughput
  1635.                  }
  1636.          STATUS  current
  1637.          DESCRIPTION
  1638.             "The objects necessary to control the Virtual Circuits
  1639.             layered onto a Frame Relay Interface from RFC 1315."
  1640.          ::= { frGroups 7 }
  1641.  
  1642.      frErrGroup0    OBJECT-GROUP
  1643.          OBJECTS {
  1644.                    frErrIfIndex, frErrType, frErrData, frErrTime
  1645.                 }
  1646.          STATUS  current
  1647.          DESCRIPTION
  1648.             "Objects designed to assist in debugging Frame Relay
  1649.             Interfaces from RFC 1315."
  1650.          ::= { frGroups 8 }
  1651.  
  1652.  
  1653.      frTrapGroup0    OBJECT-GROUP
  1654.          OBJECTS { frTrapState }
  1655.          STATUS  current
  1656.          DESCRIPTION
  1657.             "The objects necessary to control a Frame Relay
  1658.             Interface's notification messages from RFC 1315."
  1659.          ::= { frGroups 9 }
  1660.  
  1661.      END
  1662.  
  1663.  
  1664. 7.  Security Issues
  1665.  
  1666.    Security issues for this MIB are entirely covered by the SNMP
  1667.    Security Architecture, and have not been expanded within the contents
  1668.    of this MIB.
  1669.  
  1670. 8.  Acknowledgments
  1671.  
  1672.    This document was originally produced by the IP Over Large Public
  1673.    Data Networks (IPLPDN) Working Group, and has since been carried on
  1674.    in the PPP Working Group, sort of. Currently, the Ion Working Group
  1675.    is its host.
  1676.  
  1677.    Special thanks to James Watt of Newbridge Networks for his fine
  1678.    suggestions and pastable text.
  1679.  
  1680.  
  1681.  
  1682. Brown & Baker               Standards Track                    [Page 30]
  1683.  
  1684. RFC 2115                  Frame Relay DTE MIB             September 1997
  1685.  
  1686.  
  1687. 9.  Authors' Addresses
  1688.  
  1689.    Caralyn Brown
  1690.    Cadia Networks, Inc.
  1691.    1 Corporate Dirve
  1692.    Andover, Massachusetts  01810
  1693.    Telephone:  +1 508 689 2400 x133
  1694.    E-Mail: cbrown@cadia.com
  1695.  
  1696.    Fred Baker
  1697.    Cisco Systems
  1698.    519 Lado Drive
  1699.    Santa Barbara, California 93111
  1700.    Telephone  +1 408 526 4257
  1701.    E-Mail: fred@cisco.com
  1702.  
  1703. 10.  References
  1704.  
  1705.    [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  1706.         and S. Waldbusser, "Structure of Management Information
  1707.         for Version 2 of the Simple Network Management Protocol
  1708.         (SNMPv2)", RFC 1902, January 1996.
  1709.  
  1710.    [2]  McCloghrie, K., and M. Rose, Editors, "Management
  1711.         Information Base for Network Management of TCP/IP-based
  1712.         internets: MIB-II", STD 17, RFC 1213, Hughes LAN Systems,
  1713.         Performance Systems International, March 1991.
  1714.  
  1715.    [3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin. " A
  1716.         Simple Network Management Protocol (SNMP)", STD 15, RFC
  1717.         1157, SNMP Research, Performance Systems International,
  1718.         MIT Lab for Computer Science, May 1990.
  1719.  
  1720.    [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
  1721.         and S. Waldbusser, "Protocol Operations for Version 2 of
  1722.         the Simple Network Management Protocol (SNMPv2)", RFC
  1723.         1905, January 1996.
  1724.  
  1725.    [5]  McCloghrie, K. and F. Kastenholz, "Evolution of the
  1726.         Interfaces Group of MIB-II", RFC 1573, Hughes LAN
  1727.         Systems, FTP Software, January 1994.
  1728.  
  1729.    [6]  T. Bradley, C. Brown, A. Malis, "Multiprotocol
  1730.         Interconnect over Frame Relay", RFC 1490, 07/26/1993.
  1731.  
  1732.    [7]  International Telegraph and Telephone Consultative
  1733.         Committee, "ISDN Data Link Layer Specification for Frame
  1734.         Mode Bearer Services", CCITT Recommendation Q.922, 19
  1735.  
  1736.  
  1737.  
  1738. Brown & Baker               Standards Track                    [Page 31]
  1739.  
  1740. RFC 2115                  Frame Relay DTE MIB             September 1997
  1741.  
  1742.  
  1743.         April 1991.
  1744.  
  1745.    [8]  American National Standard For Telecommunications -
  1746.         Integrated Services Digital Network - Frame Relay Bearer
  1747.         Service - Architectural Framework and Service
  1748.         Description, ANSI T1.606-1991, 18 June 1991.
  1749.  
  1750.    [9]  American National Standard For Telecommunications -
  1751.         Integrated Services Digital Network - Digital Subscriber
  1752.         Signalling System No. 1 - Signaling Specification for
  1753.         Frame Relay Bearer Service, ANSI T1.617-1991, 18 June
  1754.         1991.
  1755.  
  1756.    [10] American National Standard For Telecommunications -
  1757.         Integrated Services Digital Network - Core Aspects of
  1758.         Frame Protocol for Use with Frame Relay Bearer Service,
  1759.         ANSI T1.618-1991, 18 June 1991.
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794. Brown & Baker               Standards Track                    [Page 32]
  1795.  
  1796.