home *** CD-ROM | disk | FTP | other *** search
/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / RFCs / rfc2494.txt < prev    next >
Encoding:
Text File  |  1999-10-14  |  47.5 KB  |  1,404 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                               D. Fowler, Editor
  8. Request for Comments: 2494                         Newbridge Networks
  9. Category: Standards Track                                January 1999
  10.  
  11.  
  12.                      Definitions of Managed Objects
  13.                for the DS0 and DS0 Bundle Interface Type
  14.  
  15. Status of this Memo
  16.  
  17.    This document specifies an Internet standards track protocol for the
  18.    Internet community, and requests discussion and suggestions for
  19.    improvements.  Please refer to the current edition of the "Internet
  20.    Official Protocol Standards" (STD 1) for the standardization state
  21.    and status of this protocol.  Distribution of this memo is unlimited.
  22.  
  23. Copyright Notice
  24.  
  25.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  26.  
  27. Abstract
  28.  
  29.    This memo defines a portion of the Management Information Base (MIB)
  30.    for use with network management protocols in the Internet community.
  31.    In particular, it describes objects used for managing DS0 and DS0
  32.    Bundle interfaces.  This document is a companion document with
  33.    Definitions of Managed Objects for the DS1/E1/DS2/E2 (RFC 2495 [17]),
  34.    DS3/E3 (RFC 2496 [18]), and the work in progress, SONET/SDH Interface
  35.    Types.
  36.  
  37.    This memo specifies a MIB module in a manner that is both compliant
  38.    to the SNMPv2 SMI, and semantically identical to the peer SNMPv1
  39.    definitions.
  40.  
  41. Table of Contents
  42.  
  43.    1 The SNMP Management Framework ................................    2
  44.    2 Overview .....................................................    3
  45.    2.1 BONDing Terminology ........................................    3
  46.    2.2 Use of ifTable for DS0 Layer ...............................    3
  47.    2.3 Using ifStackTable .........................................    4
  48.    2.3.1 Usage of Channelization for DS3, DS1, DS0 ................    6
  49.    2.3.2 Usage of ifIndex Mapping for DS0Bundle ...................    7
  50.    3 Overview of the MIB ..........................................    7
  51.    3.1 DS0 MIB ....................................................    8
  52.    3.2 DS0Bundle MIB ..............................................    8
  53.    4 Object Definitions for DS0 ...................................    8
  54.    4.1 The DS0 Config Group .......................................    9
  55.  
  56.  
  57.  
  58. Fowler, Ed.                 Standards Track                     [Page 1]
  59.  
  60. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  61.  
  62.  
  63.    4.1.1 The DS0 Configuration Table ..............................    9
  64.    4.1.2 The DS0 Channel Mapping Table ............................   12
  65.    5 Object Definitions for DS0 Bundle ............................   15
  66.    5.1 The DS0 Bundle Config Group ................................   15
  67.    5.1.1 The DS0 Bundle Table .....................................   15
  68.    5.2 The DS0 Bonding Group ......................................   18
  69.    5.2.1 The DS0 Bonding Table ....................................   18
  70.    6 Intellectual Property ........................................   21
  71.    7 Acknowledgments ..............................................   22
  72.    8 References ...................................................   22
  73.    9 Security Considerations ......................................   23
  74.    10 Author's Address ............................................   24
  75.    11 Full Copyright Statement ....................................   25
  76.  
  77. 1.  The SNMP Management Framework
  78.  
  79.    The SNMP Management Framework presently consists of five major
  80.    components:
  81.  
  82.     o   An overall architecture, described in RFC 2271 [1].
  83.  
  84.     o   Mechanisms for describing and naming objects and events for the
  85.         purpose of management. The first version of this Structure of
  86.         Management Information (SMI) is called SMIv1 and described in
  87.         STD 16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4]. The
  88.         second version, called SMIv2, is described in RFC 1902 [5], RFC
  89.         1903 [6] and RFC 1904 [7].
  90.  
  91.     o   Message protocols for transferring management information. The
  92.         first version of the SNMP message protocol is called SNMPv1 and
  93.         described in STD 15, RFC 1157 [8]. A second version of the SNMP
  94.         message protocol, which is not an Internet standards track
  95.         protocol, is called SNMPv2c and described in RFC 1901 [9] and
  96.         RFC 1906 [10].  The third version of the message protocol is
  97.         called SNMPv3 and described in RFC 1906 [10], RFC 2272 [11] and
  98.         RFC 2274 [12].
  99.  
  100.     o   Protocol operations for accessing management information. The
  101.         first set of protocol operations and associated PDU formats is
  102.         described in STD 15, RFC 1157 [8]. A second set of protocol
  103.         operations and associated PDU formats is described in RFC 1905
  104.         [13].
  105.  
  106.     o   A set of fundamental applications described in RFC 2273 [14] and
  107.         the view-based access control mechanism described in RFC 2275
  108.         [15].  Managed objects are accessed via a virtual information
  109.         store, termed the Management Information Base or MIB.  Objects
  110.         in the MIB are defined using the mechanisms defined in the SMI.
  111.  
  112.  
  113.  
  114. Fowler, Ed.                 Standards Track                     [Page 2]
  115.  
  116. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  117.  
  118.  
  119.         This memo specifies a MIB module that is compliant to the SMIv2.
  120.         A MIB conforming to the SMIv1 can be produced through the
  121.         appropriate translations. The resulting translated MIB must be
  122.         semantically equivalent, except where objects or events are
  123.         omitted because no translation is possible (use of Counter64).
  124.         Some machine readable information in SMIv2 will be converted
  125.         into textual descriptions in SMIv1 during the translation
  126.         process. However, this loss of machine readable information is
  127.         not considered to change the semantics of the MIB.
  128.  
  129. 2.  Overview
  130.  
  131.    These objects are used when the particular media being used to
  132.    realize an interface is a DS0 interface.  At present, this applies to
  133.    these values of the ifType variable in the Internet-standard MIB:
  134.  
  135.         ds0 (81)
  136.         ds0Bundle (82)
  137.  
  138. 2.1.  BONDing Terminology
  139.  
  140.    Please reference The BONDing Spec [20] for definitions of terms used
  141.    to describe bonding modes.
  142.  
  143. 2.2.  Use of ifTable for DS0 Layer
  144.  
  145.    The following items are defined in RFC 2233 [16].
  146.  
  147.    Only the ifGeneralInformationGroup and ifCounterDiscontinuityGroup
  148.    need to be supported.
  149.  
  150.               ifTable Object           Use for DS0 Layer
  151.    ======================================================================
  152.               ifIndex                  Interface index.
  153.  
  154.               ifDescr                  See interfaces MIB [16].
  155.  
  156.               ifType                   ds0(81) or ds0Bundle(82).
  157.  
  158.               ifSpeed                  64000 for ds0 (regardless of the
  159.                                        setting of robbed bit signalling)
  160.                                        or N*64000 for ds0Bundle.
  161.  
  162.               ifPhysAddress            The value of the Circuit
  163.                                        Identifier.  If no Circuit
  164.                                        Identifier has been assigned
  165.                                        this object should have an octet
  166.                                        string with zero length.
  167.  
  168.  
  169.  
  170. Fowler, Ed.                 Standards Track                     [Page 3]
  171.  
  172. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  173.  
  174.  
  175.               ifAdminStatus            See interfaces MIB [16].
  176.  
  177.               ifOperStatus             See interfaces MIB [16].
  178.  
  179.               ifLastChange             See interfaces MIB [16].
  180.  
  181.               ifName                   See interfaces MIB [16].
  182.  
  183.               ifLinkUpDownTrapEnable   Set to disabled(2).
  184.                                        Supports read-only access.
  185.  
  186.               ifHighSpeed              Set to rounded ifSpeed/1000000.
  187.  
  188.               ifConnectorPresent       Set to false(2).
  189.  
  190. 2.3.  Using ifStackTable
  191.  
  192.    This section describes by example how to use ifStackTable to
  193.    represent the relationship of ds0 and ds0Bundles with ds1 interfaces.
  194.    Implementors of the stack table for ds0 and ds0Bundle interfaces
  195.    should look at the appropriate RFC for the service being stacked on
  196.    ds0s and ds0Bundles.  Examples given below are for illustration
  197.    purposes only.
  198.  
  199.    Example: A Frame Relay Service is being carried on 4 ds0s of a ds1.
  200.  
  201.            +---------------------+
  202.            | Frame Relay Service |
  203.            +---------------------+
  204.                       |
  205.            +---------------------+
  206.            | ds0Bundle           |
  207.            +---------------------+
  208.              |     |     |     |
  209.            +---+ +---+ +---+ +---+
  210.            |ds0| |ds0| |ds0| |ds0|
  211.            +---+ +---+ +---+ +---+
  212.              |     |     |     |
  213.            +---------------------+
  214.            | ds1                 |
  215.            +---------------------+
  216.  
  217.    The assignment of the index values could for example be:
  218.  
  219.            ifIndex  Description
  220.            1        FrameRelayService (type 44)
  221.            2        ds0Bundle         (type 82)
  222.            3        ds0 #1            (type 81)
  223.  
  224.  
  225.  
  226. Fowler, Ed.                 Standards Track                     [Page 4]
  227.  
  228. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  229.  
  230.  
  231.            4        ds0 #2            (type 81)
  232.            5        ds0 #3            (type 81)
  233.            6        ds0 #4            (type 81)
  234.            7        ds1               (type 18)
  235.  
  236.    The ifStackTable is then used to show the relationships between the
  237.    various interfaces.
  238.  
  239.            ifStackTable Entries
  240.  
  241.            HigherLayer   LowerLayer
  242.            0             1
  243.            1             2
  244.            2             3
  245.            2             4
  246.            2             5
  247.            2             6
  248.            3             7
  249.            4             7
  250.            5             7
  251.            6             7
  252.            7             0
  253.  
  254.  
  255.    In the case where the frameRelayService is using a single ds0, then
  256.    the ds0Bundle is not required.
  257.  
  258.            +---------------------+
  259.            | Frame Relay Service |
  260.            +---------------------+
  261.              |
  262.            +---+
  263.            |ds0|
  264.            +---+
  265.              |
  266.            +---------------------+
  267.            | ds1                 |
  268.            +---------------------+
  269.  
  270.    The assignment of the index values could for example be:
  271.  
  272.            ifIndex  Description
  273.            1        FrameRelayService (type 44)
  274.            2        ds0               (type 81)
  275.            3        ds1               (type 18)
  276.  
  277.    The ifStackTable is then used to show the relationships between the
  278.    various interfaces.
  279.  
  280.  
  281.  
  282. Fowler, Ed.                 Standards Track                     [Page 5]
  283.  
  284. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  285.  
  286.  
  287.            ifStackTable Entries
  288.  
  289.            HigherLayer   LowerLayer
  290.            0             1
  291.            1             2
  292.            2             3
  293.            3             0
  294.  
  295. 2.3.1.  Usage of Channelization for DS3, DS1, DS0
  296.  
  297.    An example is given here to explain the channelization objects in the
  298.    DS3, DS1, and DS0 MIBs to help the implementor use the objects
  299.    correctly.  Treatment of E3 and E1 would be similar, with the number
  300.    of DS0s being different depending on the framing of the E1.  Timeslot
  301.    16 is not created for framing types that do not pass data over it.
  302.  
  303.    Assume that a DS3 (with ifIndex 1) is channelized into DS1s (without
  304.    DS2s).  The object dsx3Channelization is set to enabledDs1.  There
  305.    will be 28 DS1s in the ifTable.  Assume the entries in the ifTable
  306.    for the DS1s are created in channel order and the ifIndex values are
  307.    2 through 29.  In the DS1 MIB, there will be an entry in the
  308.    dsx1ChanMappingTable for each ds1.  The entries will be as follows:
  309.  
  310.            dsx1ChanMappingTable Entries
  311.  
  312.            ifIndex  dsx1Ds1ChannelNumber   dsx1ChanMappedIfIndex
  313.            1        1                      2
  314.            1        2                      3
  315.            ......
  316.            1        28                     29
  317.  
  318.    In addition, the DS1s are channelized into DS0s.  The object
  319.    dsx1Channelization is set to enabledDs0 for each DS1.  When this
  320.    object is set to this value, 24 DS0s are created by the agent. There
  321.    will be 24 DS0s in the ifTable for each DS1.  If the
  322.    dsx1Channelization is set to disabled, the 24 DS0s are destroyed.
  323.  
  324.    Assume the entries in the ifTable are created in channel order and
  325.    the ifIndex values for the DS0s in the first DS1 are 30 through 53.
  326.    In the DS0 MIB, there will be an entry in the dsx0ChanMappingTable
  327.    for each DS0.  The entries will be as follows:
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. Fowler, Ed.                 Standards Track                     [Page 6]
  339.  
  340. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  341.  
  342.  
  343.            dsx0ChanMappingTable Entries
  344.  
  345.            ifIndex   dsx0Ds0ChannelNumber  dsx0ChanMappedIfIndex
  346.            2         1                     30
  347.            2         2                     31
  348.            ......
  349.            2         24                    53
  350.  
  351. 2.3.2.  Usage of ifIndex Mapping for DS0Bundle
  352.  
  353.    An example is given here to explain the ifIndex mapping objects in
  354.    the DS0Bundle MIB to help the implementor use the objects correctly.
  355.  
  356.    Assume that a DS1 (with ifIndex 1) is channelized into DS0s.  There
  357.    will be 24 DS0s in the ifTable.  Assume the entries in the ifTable
  358.    for the DS0s are created in channel order and the ifIndex values are
  359.    2 through 25.  Now, assume that there are two bundles on the DS1.
  360.    The first one uses channels 1 and 2.  The second uses channels 3 and
  361.    4.  There will be two ifTable entries for these bundles, with values
  362.    of 26 and 27 for ifIndex.  There will be an entry in the
  363.    dsx0BundleTable for each bundle.  The entries will be as follows:
  364.  
  365.            dsx0BundleTable Entries
  366.  
  367.            dsx0BundleIndex    dsx0BundleIfIndex
  368.            1                  26
  369.            2                  27
  370.  
  371.    There will be an entry in the dsx0ConfigTable for each DS0.  The
  372.    entries will be as follows:
  373.  
  374.            dsx0ConfigTable Entries
  375.  
  376.            ifIndex  dsx0Ds0ChannelNumber   dsx0Ds0BundleMappedIfIndex
  377.            2        1                      26
  378.            3        2                      26
  379.            4        3                      27
  380.            5        4                      27
  381.            6        5                      0
  382.            7        6                      0
  383.            ......
  384.            25       24                     0
  385.  
  386. 3.  Overview of the MIB
  387.  
  388.    This document contains 2 MIB modules, the DS0 MIB and the DS0Bundle
  389.    MIB.
  390.  
  391.  
  392.  
  393.  
  394. Fowler, Ed.                 Standards Track                     [Page 7]
  395.  
  396. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  397.  
  398.  
  399. 3.1.  DS0 MIB
  400.  
  401.    The DS0 MIB is used to represent individual DS0s in a DS1 or E1.
  402.    Variables in this MIB would be created for each DS0 in the ifTable.
  403.    This MIB contains the following group:
  404.  
  405.    The DS0 Config Group - This group contains configuration information
  406.    about a particular DS0.
  407.  
  408. 3.2.  DS0Bundle MIB
  409.  
  410.    The DS0Bundle MIB is used to represent collections of DS0s that are
  411.    used together to carry data within a DS1/E1 at speeds greater than
  412.    that of a single DS0.  DS0Bundles are created on top of DS0s and are
  413.    represented that way in the ifStackTable.  This MIB contains the
  414.    following groups:
  415.  
  416.    The DS0 Bundle Group - This group contains objects used for creating
  417.    new ds0Bundles.  This group is mandatory.
  418.  
  419.    The DS0 Bonding Group - This group contains information about bonding
  420.    for a ds0Bundle, if bonding is enabled.  This group is optional.
  421.  
  422. 4.  Object Definitions for DS0
  423.  
  424.    DS0-MIB DEFINITIONS ::= BEGIN
  425.  
  426.    IMPORTS
  427.         MODULE-IDENTITY, OBJECT-TYPE,
  428.         transmission                     FROM SNMPv2-SMI
  429.         MODULE-COMPLIANCE, OBJECT-GROUP  FROM SNMPv2-CONF
  430.         DisplayString, TruthValue        FROM SNMPv2-TC
  431.         ifIndex, InterfaceIndex,
  432.         InterfaceIndexOrZero             FROM IF-MIB;
  433.  
  434.    --  This is the MIB module for the DS0 Interface objects.
  435.  
  436.    ds0 MODULE-IDENTITY
  437.        LAST-UPDATED "9807161630Z"
  438.        ORGANIZATION "IETF Trunk MIB Working Group"
  439.        CONTACT-INFO
  440.          "        David Fowler
  441.  
  442.           Postal: Newbridge Networks Corporation
  443.                   600 March Road
  444.                   Kanata, Ontario, Canada K2K 2E6
  445.  
  446.                   Tel: +1 613 591 3600
  447.  
  448.  
  449.  
  450. Fowler, Ed.                 Standards Track                     [Page 8]
  451.  
  452. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  453.  
  454.  
  455.                   Fax: +1 613 599 3619
  456.  
  457.           E-mail: davef@newbridge.com"
  458.        DESCRIPTION
  459.             "The MIB module to describe
  460.              DS0 interfaces objects."
  461.        REVISION "9805242010Z"
  462.        DESCRIPTION
  463.             "Initial version of the DS0-MIB."
  464.  
  465.        ::= { transmission 81 }
  466.  
  467.    -- The DS0 Config Group
  468.  
  469.    -- Implementation of this group is mandatory for all
  470.    -- systems that use a DS0 Interface.
  471.  
  472.    -- The DS0 Config Group consists of two tables:
  473.    --    DS0 Configuration Table
  474.    --    DS0 Channel Mapping Table
  475.  
  476.    -- The DS0 Configuration Table
  477.  
  478.    dsx0ConfigTable OBJECT-TYPE
  479.        SYNTAX  SEQUENCE OF Dsx0ConfigEntry
  480.        MAX-ACCESS  not-accessible
  481.        STATUS  current
  482.        DESCRIPTION
  483.                "The DS0 Configuration table."
  484.        ::= { ds0 1 }
  485.  
  486.    dsx0ConfigEntry OBJECT-TYPE
  487.        SYNTAX  Dsx0ConfigEntry
  488.        MAX-ACCESS  not-accessible
  489.        STATUS  current
  490.        DESCRIPTION
  491.                "An entry in the DS0 Configuration table.  There
  492.                is an entry in this table for each DS0 interface."
  493.        INDEX   { ifIndex }
  494.        ::= { dsx0ConfigTable 1 }
  495.  
  496.    Dsx0ConfigEntry ::=
  497.        SEQUENCE {
  498.            dsx0Ds0ChannelNumber        INTEGER,
  499.            dsx0RobbedBitSignalling     TruthValue,
  500.            dsx0CircuitIdentifier       DisplayString,
  501.            dsx0IdleCode                INTEGER,
  502.            dsx0SeizedCode              INTEGER,
  503.  
  504.  
  505.  
  506. Fowler, Ed.                 Standards Track                     [Page 9]
  507.  
  508. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  509.  
  510.  
  511.            dsx0ReceivedCode            INTEGER,
  512.            dsx0TransmitCodesEnable     TruthValue,
  513.            dsx0Ds0BundleMappedIfIndex  InterfaceIndexOrZero
  514.    }
  515.  
  516.    dsx0Ds0ChannelNumber OBJECT-TYPE
  517.        SYNTAX  INTEGER(0..31)
  518.        MAX-ACCESS  read-only
  519.        STATUS  current
  520.        DESCRIPTION
  521.                "This object indicates the channel number of the
  522.                ds0 on its DS1/E1."
  523.        ::= { dsx0ConfigEntry 1 }
  524.  
  525.    dsx0RobbedBitSignalling OBJECT-TYPE
  526.        SYNTAX  TruthValue
  527.        MAX-ACCESS  read-write
  528.        STATUS  current
  529.        DESCRIPTION
  530.                "This object indicates if Robbed Bit Signalling is
  531.                turned on or off for a given ds0.  This only
  532.                applies to DS0s on a DS1 link.  For E1 links the
  533.                value is always off (false)."
  534.        ::= { dsx0ConfigEntry 2 }
  535.  
  536.    dsx0CircuitIdentifier OBJECT-TYPE
  537.         SYNTAX  DisplayString (SIZE (0..255))
  538.         MAX-ACCESS  read-write
  539.         STATUS  current
  540.         DESCRIPTION
  541.                "This object contains the transmission vendor's
  542.                circuit identifier, for the purpose of
  543.                facilitating troubleshooting."
  544.        ::= { dsx0ConfigEntry 3 }
  545.  
  546.    dsx0IdleCode OBJECT-TYPE
  547.         SYNTAX  INTEGER(0..15)
  548.         MAX-ACCESS  read-write
  549.         STATUS  current
  550.         DESCRIPTION
  551.                "This object contains the code transmitted in the
  552.                ABCD bits when the ds0 is not connected and
  553.                dsx0TransmitCodesEnable is enabled.  The object is
  554.                a bitmap and the various bit positions are:
  555.                      1     D bit
  556.                      2     C bit
  557.                      4     B bit
  558.                      8     A bit"
  559.  
  560.  
  561.  
  562. Fowler, Ed.                 Standards Track                    [Page 10]
  563.  
  564. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  565.  
  566.  
  567.        ::= { dsx0ConfigEntry 4 }
  568.  
  569.    dsx0SeizedCode OBJECT-TYPE
  570.         SYNTAX  INTEGER(0..15)
  571.         MAX-ACCESS  read-write
  572.         STATUS  current
  573.         DESCRIPTION
  574.                "This object contains the code transmitted in the
  575.                ABCD bits when the ds0 is connected and
  576.                dsx0TransmitCodesEnable is enabled.  The object is
  577.                a bitmap and the various bit positions are:
  578.                      1     D bit
  579.                      2     C bit
  580.                      4     B bit
  581.                      8     A bit"
  582.        ::= { dsx0ConfigEntry 5 }
  583.  
  584.    dsx0ReceivedCode OBJECT-TYPE
  585.         SYNTAX  INTEGER(0..15)
  586.         MAX-ACCESS  read-only
  587.         STATUS  current
  588.         DESCRIPTION
  589.                "This object contains the code being received in
  590.                the ABCD bits.  The object is a bitmap and the
  591.                various bit positions are:
  592.                      1     D bit
  593.                      2     C bit
  594.                      4     B bit
  595.                      8     A bit"
  596.        ::= { dsx0ConfigEntry 6 }
  597.  
  598.    dsx0TransmitCodesEnable OBJECT-TYPE
  599.         SYNTAX TruthValue
  600.         MAX-ACCESS  read-write
  601.         STATUS  current
  602.         DESCRIPTION
  603.                "This object determines if the idle and seized
  604.                codes are transmitted. If the value of this object
  605.                is true then the codes are transmitted."
  606.        ::= { dsx0ConfigEntry 7 }
  607.  
  608.    dsx0Ds0BundleMappedIfIndex OBJECT-TYPE
  609.         SYNTAX InterfaceIndexOrZero
  610.         MAX-ACCESS  read-only
  611.         STATUS  current
  612.         DESCRIPTION
  613.                "This object indicates the ifIndex value assigned
  614.                by the agent for the ds0Bundle(82) ifEntry to
  615.  
  616.  
  617.  
  618. Fowler, Ed.                 Standards Track                    [Page 11]
  619.  
  620. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  621.  
  622.  
  623.                which the given ds0(81) ifEntry may belong.
  624.  
  625.                If the given ds0(81) ifEntry does not belong to
  626.                any ds0Bundle(82) ifEntry, then this object has a
  627.                value of zero.
  628.  
  629.                While this object provides information that can
  630.                also be found in the ifStackTable, it provides
  631.                this same information with a single table lookup,
  632.                rather than by walking the ifStackTable to find
  633.                the possibly non-existent ds0Bundle(82) ifEntry
  634.                that may be stacked above the given ds0(81)
  635.                ifTable entry."
  636.        ::= { dsx0ConfigEntry 8 }
  637.  
  638.    -- The DS0 Channel Mapping Table
  639.  
  640.    dsx0ChanMappingTable OBJECT-TYPE
  641.         SYNTAX  SEQUENCE OF Dsx0ChanMappingEntry
  642.         MAX-ACCESS  not-accessible
  643.         STATUS  current
  644.         DESCRIPTION
  645.                "The DS0 Channel Mapping table.  This table maps a
  646.                DS0 channel number on a particular DS1/E1 into an
  647.                ifIndex."
  648.         ::= { ds0 3 }
  649.  
  650.    dsx0ChanMappingEntry OBJECT-TYPE
  651.         SYNTAX  Dsx0ChanMappingEntry
  652.         MAX-ACCESS  not-accessible
  653.         STATUS  current
  654.         DESCRIPTION
  655.                "An entry in the DS0 Channel Mapping table.  There
  656.                is an entry in this table corresponding to each
  657.                ds0 ifEntry within any interface that is
  658.                channelized to the individual ds0 ifEntry level.
  659.  
  660.                This table is intended to facilitate mapping from
  661.                channelized interface / channel number to DS0
  662.                ifEntry.  (e.g. mapping (DS1 ifIndex, DS0 Channel
  663.                Number) -> ifIndex)
  664.  
  665.                While this table provides information that can
  666.                also be found in the ifStackTable and
  667.                dsx0ConfigTable, it provides this same information
  668.                with a single table lookup, rather than by walking
  669.                the ifStackTable to find the various constituent
  670.                ds0 ifTable entries, and testing various
  671.  
  672.  
  673.  
  674. Fowler, Ed.                 Standards Track                    [Page 12]
  675.  
  676. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  677.  
  678.  
  679.                dsx0ConfigTable entries to check for the entry
  680.                with the applicable DS0 channel number."
  681.         INDEX   { ifIndex, dsx0Ds0ChannelNumber }
  682.         ::= { dsx0ChanMappingTable 1 }
  683.  
  684.    Dsx0ChanMappingEntry ::=
  685.         SEQUENCE {
  686.             dsx0ChanMappedIfIndex  InterfaceIndex
  687.    }
  688.  
  689.    dsx0ChanMappedIfIndex OBJECT-TYPE
  690.         SYNTAX  InterfaceIndex
  691.         MAX-ACCESS  read-only
  692.         STATUS  current
  693.         DESCRIPTION
  694.                "This object indicates the ifIndex value assigned
  695.                by the agent for the individual ds0 ifEntry that
  696.                corresponds to the given DS0 channel number
  697.                (specified by the INDEX element
  698.                dsx0Ds0ChannelNumber) of the given channelized
  699.                interface (specified by INDEX element ifIndex)."
  700.         ::= { dsx0ChanMappingEntry 1 }
  701.  
  702.    -- conformance information
  703.  
  704.    ds0Conformance OBJECT IDENTIFIER ::= { ds0 2 }
  705.  
  706.    ds0Groups      OBJECT IDENTIFIER ::= { ds0Conformance 1 }
  707.    ds0Compliances OBJECT IDENTIFIER ::= { ds0Conformance 2 }
  708.  
  709.  
  710.  
  711.    -- compliance statements
  712.  
  713.    ds0Compliance MODULE-COMPLIANCE
  714.        STATUS  current
  715.        DESCRIPTION
  716.                "The compliance statement for DS0 interfaces."
  717.        MODULE  -- this module
  718.            MANDATORY-GROUPS { ds0ConfigGroup }
  719.  
  720.            OBJECT dsx0RobbedBitSignalling
  721.            MIN-ACCESS read-only
  722.            DESCRIPTION
  723.                "The ability to set RBS is not required."
  724.            OBJECT dsx0CircuitIdentifier
  725.            MIN-ACCESS read-only
  726.            DESCRIPTION
  727.  
  728.  
  729.  
  730. Fowler, Ed.                 Standards Track                    [Page 13]
  731.  
  732. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  733.  
  734.  
  735.                "The ability to set the circuit identifier is not
  736.                required."
  737.  
  738.            OBJECT dsx0IdleCode
  739.            MIN-ACCESS read-only
  740.            DESCRIPTION
  741.                "The ability to set the idle code is not
  742.                required."
  743.  
  744.            OBJECT dsx0SeizedCode
  745.            MIN-ACCESS read-only
  746.            DESCRIPTION
  747.                "The ability to set the seized code is not
  748.                required."
  749.  
  750.            OBJECT dsx0TransmitCodesEnable
  751.            MIN-ACCESS read-only
  752.            DESCRIPTION
  753.                "The ability to enable and disable the
  754.                transmitting of idle and seized codes is not
  755.                required."
  756.  
  757.        ::= { ds0Compliances 1 }
  758.  
  759.    -- units of conformance
  760.  
  761.    ds0ConfigGroup  OBJECT-GROUP
  762.        OBJECTS { dsx0Ds0ChannelNumber,
  763.                  dsx0RobbedBitSignalling,
  764.                  dsx0CircuitIdentifier,
  765.                  dsx0IdleCode,
  766.                  dsx0SeizedCode,
  767.                  dsx0ReceivedCode,
  768.                  dsx0TransmitCodesEnable,
  769.                  dsx0Ds0BundleMappedIfIndex,
  770.                  dsx0ChanMappedIfIndex }
  771.        STATUS  current
  772.        DESCRIPTION
  773.                "A collection of objects providing configuration
  774.                information applicable to all DS0 interfaces."
  775.        ::= { ds0Groups 1 }
  776.  
  777.    END
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786. Fowler, Ed.                 Standards Track                    [Page 14]
  787.  
  788. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  789.  
  790.  
  791. 5.  Object Definitions for DS0 Bundle
  792.  
  793.    DS0BUNDLE-MIB DEFINITIONS ::= BEGIN
  794.  
  795.    IMPORTS
  796.         MODULE-IDENTITY, OBJECT-TYPE,
  797.         transmission                      FROM SNMPv2-SMI
  798.         MODULE-COMPLIANCE, OBJECT-GROUP   FROM SNMPv2-CONF
  799.         DisplayString, RowStatus,
  800.         TestAndIncr                       FROM SNMPv2-TC
  801.         ifIndex, InterfaceIndex           FROM IF-MIB;
  802.  
  803.    --  This is the MIB module for the DS0Bundle Interface
  804.    --  objects.
  805.  
  806.    ds0Bundle MODULE-IDENTITY
  807.        LAST-UPDATED "9807161630Z"
  808.        ORGANIZATION "IETF Trunk MIB Working Group"
  809.        CONTACT-INFO
  810.          "        David Fowler
  811.  
  812.           Postal: Newbridge Networks Corporation
  813.                   600 March Road
  814.                   Kanata, Ontario, Canada K2K 2E6
  815.  
  816.                   Tel: +1 613 591 3600
  817.                   Fax: +1 613 599 3619
  818.  
  819.           E-mail: davef@newbridge.com"
  820.        DESCRIPTION
  821.             "The MIB module to describe
  822.              DS0 Bundle interfaces objects."
  823.        REVISION "9805242010Z"
  824.        DESCRIPTION
  825.             "Initial version of the DS0BUNDLE-MIB."
  826.  
  827.        ::= { transmission 82 }
  828.  
  829.    --
  830.    -- The DS0 Bundle Config Group
  831.    --
  832.    -- Implementation of this group is mandatory for all
  833.    -- systems that use a DS0Bundle Interface.
  834.    --
  835.    -- The DS0 Bundle Config Group consists of one table:
  836.    --    DS0 Bundle Table
  837.  
  838.    --  The DS0 Bundle Table
  839.  
  840.  
  841.  
  842. Fowler, Ed.                 Standards Track                    [Page 15]
  843.  
  844. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  845.  
  846.  
  847.    dsx0BundleNextIndex OBJECT-TYPE
  848.        SYNTAX  TestAndIncr
  849.        MAX-ACCESS  read-write
  850.        STATUS  current
  851.        DESCRIPTION
  852.                "This object is used to assist the manager in
  853.                selecting a value for dsx0BundleIndex.  Because
  854.                this object is of syntax TestAndIncr (see the
  855.                SNMPv2-TC document, RFC 1903) it can also be used
  856.                to avoid race conditions with multiple managers
  857.                trying to create rows in the table.
  858.  
  859.                If the result of the SET for dsx0BundleNextIndex
  860.                is not success, this means the value has been
  861.                changed from index (i.e. another manager used the
  862.                value), so a new value is required.
  863.  
  864.                The algorithm is:
  865.                done = false
  866.                while done == false
  867.                    index = GET (dsx0BundleNextIndex.0)
  868.                    SET (dsx0BundleNextIndex.0=index)
  869.                    if (set failed)
  870.                      done = false
  871.                    else
  872.                      SET(dsx0BundleRowStatus.index=createAndGo)
  873.                      if (set failed)
  874.                        done = false
  875.                      else
  876.                        done = true
  877.                        other error handling"
  878.        ::= { ds0Bundle 2 }
  879.  
  880.    dsx0BundleTable OBJECT-TYPE
  881.        SYNTAX  SEQUENCE OF Dsx0BundleEntry
  882.        MAX-ACCESS  not-accessible
  883.        STATUS  current
  884.        DESCRIPTION
  885.                "There is an row in this table for each ds0Bundle
  886.                in the system.  This table can be used to
  887.                (indirectly) create rows in the ifTable with
  888.                ifType = 'ds0Bundle(82)'."
  889.        ::= { ds0Bundle 3 }
  890.  
  891.    dsx0BundleEntry OBJECT-TYPE
  892.        SYNTAX  Dsx0BundleEntry
  893.        MAX-ACCESS  not-accessible
  894.        STATUS  current
  895.  
  896.  
  897.  
  898. Fowler, Ed.                 Standards Track                    [Page 16]
  899.  
  900. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  901.  
  902.  
  903.        DESCRIPTION
  904.                "There is a row in entry in this table for each
  905.                ds0Bundle interface."
  906.        INDEX   { dsx0BundleIndex }
  907.        ::= { dsx0BundleTable 1 }
  908.  
  909.    Dsx0BundleEntry ::=
  910.        SEQUENCE {
  911.            dsx0BundleIndex              INTEGER,
  912.            dsx0BundleIfIndex            InterfaceIndex,
  913.            dsx0BundleCircuitIdentifier  DisplayString,
  914.            dsx0BundleRowStatus          RowStatus
  915.    }
  916.  
  917.    dsx0BundleIndex OBJECT-TYPE
  918.        SYNTAX  INTEGER (0..2147483647)
  919.        MAX-ACCESS  not-accessible
  920.        STATUS  current
  921.        DESCRIPTION
  922.                "A unique identifier for a ds0Bundle.  This is not
  923.                the same value as ifIndex.  This table is not
  924.                indexed by ifIndex because the manager has to
  925.                choose the index in a createable row and the agent
  926.                must be allowed to select ifIndex values."
  927.        ::= { dsx0BundleEntry 1 }
  928.  
  929.    dsx0BundleIfIndex OBJECT-TYPE
  930.        SYNTAX  InterfaceIndex
  931.        MAX-ACCESS  read-only
  932.        STATUS  current
  933.        DESCRIPTION
  934.                "The ifIndex value the agent selected for the
  935.                (new) ds0Bundle interface."
  936.        ::= { dsx0BundleEntry 2 }
  937.  
  938.    dsx0BundleCircuitIdentifier OBJECT-TYPE
  939.         SYNTAX  DisplayString (SIZE (0..255))
  940.         MAX-ACCESS  read-create
  941.         STATUS  current
  942.         DESCRIPTION
  943.                "This variable contains the transmission vendor's
  944.                circuit identifier, for the purpose of
  945.                facilitating troubleshooting."
  946.         ::= { dsx0BundleEntry 3 }
  947.  
  948.    dsx0BundleRowStatus OBJECT-TYPE
  949.        SYNTAX  RowStatus
  950.        MAX-ACCESS  read-create
  951.  
  952.  
  953.  
  954. Fowler, Ed.                 Standards Track                    [Page 17]
  955.  
  956. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  957.  
  958.  
  959.        STATUS  current
  960.        DESCRIPTION
  961.                "This object is used to create and delete rows in
  962.                this table."
  963.        ::= { dsx0BundleEntry 4 }
  964.  
  965.    -- The DS0 Bonding Group
  966.  
  967.    -- Implementation of this group is optional for all
  968.    -- systems that use a DS0Bundle Interface.
  969.  
  970.    -- The DS0 Bonding Group consists of one table:
  971.    --    DS0 Bonding Table
  972.  
  973.    -- The DS0 Bonding Table
  974.  
  975.    dsx0BondingTable OBJECT-TYPE
  976.        SYNTAX  SEQUENCE OF Dsx0BondingEntry
  977.        MAX-ACCESS  not-accessible
  978.        STATUS  current
  979.        DESCRIPTION
  980.                "The DS0 Bonding table."
  981.        ::= { ds0Bundle 1 }
  982.  
  983.    dsx0BondingEntry OBJECT-TYPE
  984.        SYNTAX  Dsx0BondingEntry
  985.        MAX-ACCESS  not-accessible
  986.        STATUS  current
  987.        DESCRIPTION
  988.                "An entry in the DS0 Bonding table.  There is a
  989.                row in this table for each DS0Bundle interface."
  990.        INDEX   { ifIndex }
  991.        ::= { dsx0BondingTable 1 }
  992.  
  993.    Dsx0BondingEntry ::=
  994.        SEQUENCE {
  995.            dsx0BondMode            INTEGER,
  996.            dsx0BondStatus          INTEGER,
  997.            dsx0BondRowStatus       RowStatus
  998.    }
  999.  
  1000.    dsx0BondMode OBJECT-TYPE
  1001.        SYNTAX  INTEGER {
  1002.                    none(1),
  1003.                    other(2),
  1004.                    mode0(3),
  1005.                    mode1(4),
  1006.                    mode2(5),
  1007.  
  1008.  
  1009.  
  1010. Fowler, Ed.                 Standards Track                    [Page 18]
  1011.  
  1012. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  1013.  
  1014.  
  1015.                    mode3(6)
  1016.        }
  1017.        MAX-ACCESS  read-create
  1018.        STATUS  current
  1019.        DESCRIPTION
  1020.                "This object indicates which BONDing mode is used,
  1021.                if any, for a ds0Bundle.  Mode0 provides parameter
  1022.                and number exchange with no synchronization.  Mode
  1023.                1 provides parameter and number exchange.  Mode 1
  1024.                also provides synchronization during
  1025.                initialization but does not include inband
  1026.                monitoring.  Mode 2 provides all of the above plus
  1027.                inband monitoring.  Mode 2 also steals 1/64th of
  1028.                the bandwidth of each channel (thus not supporting
  1029.                n x 56/64 kbit/s data channels for most values of
  1030.                n). Mode 3 provides all of the above, but also
  1031.                provides n x 56/64 kbit/s data channels.  Most
  1032.                common implementations of Mode 3 add an extra
  1033.                channel to support the inband monitoring overhead.
  1034.                ModeNone should be used when the interface is not
  1035.                performing bandwidth-on-demand."
  1036.        ::= { dsx0BondingEntry 1 }
  1037.  
  1038.    dsx0BondStatus OBJECT-TYPE
  1039.        SYNTAX  INTEGER {
  1040.                    idle(1),
  1041.                    callSetup(2),
  1042.                    dataTransfer(3)
  1043.        }
  1044.        MAX-ACCESS  read-only
  1045.        STATUS  current
  1046.        DESCRIPTION
  1047.                "This object indicates the current status of the
  1048.                bonding call using this ds0Bundle. idle(1) should
  1049.                be used when the bonding mode is set to none(1)."
  1050.        ::= { dsx0BondingEntry 2 }
  1051.  
  1052.    dsx0BondRowStatus OBJECT-TYPE
  1053.        SYNTAX  RowStatus
  1054.        MAX-ACCESS  read-create
  1055.        STATUS  current
  1056.        DESCRIPTION
  1057.                "This object is used to create new rows in this
  1058.                table, modify existing rows, and to delete
  1059.                existing rows."
  1060.        ::= { dsx0BondingEntry 3 }
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066. Fowler, Ed.                 Standards Track                    [Page 19]
  1067.  
  1068. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  1069.  
  1070.  
  1071.    -- conformance information
  1072.  
  1073.    ds0BundleConformance OBJECT IDENTIFIER ::= { ds0Bundle 4 }
  1074.  
  1075.    ds0BundleGroups      OBJECT IDENTIFIER
  1076.        ::= { ds0BundleConformance 1 }
  1077.  
  1078.    ds0BundleCompliances OBJECT IDENTIFIER
  1079.        ::= { ds0BundleConformance 2 }
  1080.  
  1081.  
  1082.  
  1083.    -- compliance statements
  1084.  
  1085.    ds0BundleCompliance MODULE-COMPLIANCE
  1086.        STATUS  current
  1087.        DESCRIPTION
  1088.                "The compliance statement for DS0Bundle
  1089.                interfaces."
  1090.        MODULE  -- this module
  1091.            MANDATORY-GROUPS {ds0BundleConfigGroup }
  1092.  
  1093.            GROUP       ds0BondingGroup
  1094.            DESCRIPTION
  1095.                "Implementation of this group is optional for all
  1096.                systems that attach to a DS0Bundle Interface."
  1097.  
  1098.            OBJECT      dsx0BundleRowStatus
  1099.            SYNTAX      INTEGER {
  1100.                            active(1),
  1101.                            createAndGo(4),
  1102.                            destroy(6)
  1103.                        }
  1104.            MIN-ACCESS  read-only
  1105.            DESCRIPTION
  1106.                "The agent is not required to support a SET
  1107.                operation to this object, and only three of the
  1108.                six enumerated values for the RowStatus textual
  1109.                convention need be supported.  Only supporting
  1110.                createAndGo for a creation process prevents the
  1111.                manager from creating an inactive row in the
  1112.                ds0BundleTable.  Inactive rows in the
  1113.                ds0BundleTable do not make sense."
  1114.  
  1115.            OBJECT      dsx0BundleCircuitIdentifier
  1116.            MIN-ACCESS  read-only
  1117.            DESCRIPTION
  1118.                "The agent is not required to support a SET
  1119.  
  1120.  
  1121.  
  1122. Fowler, Ed.                 Standards Track                    [Page 20]
  1123.  
  1124. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  1125.  
  1126.  
  1127.                operation to this object."
  1128.  
  1129.                    ::= { ds0BundleCompliances 1 }
  1130.  
  1131.                -- units of conformance
  1132.  
  1133.                ds0BondingGroup  OBJECT-GROUP
  1134.                    OBJECTS { dsx0BondMode,
  1135.                              dsx0BondStatus,
  1136.                              dsx0BondRowStatus }
  1137.                    STATUS  current
  1138.                    DESCRIPTION
  1139.                            "A collection of objects providing
  1140.                            configuration information applicable
  1141.                            to all DS0 interfaces."
  1142.        ::= { ds0BundleGroups 1 }
  1143.    ds0BundleConfigGroup  OBJECT-GROUP
  1144.        OBJECTS { dsx0BundleNextIndex,
  1145.                  dsx0BundleIfIndex,
  1146.                  dsx0BundleCircuitIdentifier,
  1147.                  dsx0BundleRowStatus }
  1148.        STATUS  current
  1149.        DESCRIPTION
  1150.                "A collection of objects providing the ability to
  1151.                create a new ds0Bundle in the ifTable as well as
  1152.                configuration information about the ds0Bundle."
  1153.        ::= { ds0BundleGroups 2 }
  1154.    END
  1155.  
  1156. 6.  Intellectual Property
  1157.  
  1158.    The IETF takes no position regarding the validity or scope of any
  1159.    intellectual property or other rights that might be claimed to
  1160.    pertain to the implementation or use of the technology described in
  1161.    this document or the extent to which any license under such rights
  1162.    might or might not be available; neither does it represent that it
  1163.    has made any effort to identify any such rights.  Information on the
  1164.    IETF's procedures with respect to rights in standards-track and
  1165.    standards-related documentation can be found in BCP-11.  Copies of
  1166.    claims of rights made available for publication and any assurances of
  1167.    licenses to be made available, or the result of an attempt made to
  1168.    obtain a general license or permission for the use of such
  1169.    proprietary rights by implementors or users of this specification can
  1170.    be obtained from the IETF Secretariat.
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Fowler, Ed.                 Standards Track                    [Page 21]
  1179.  
  1180. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  1181.  
  1182.  
  1183.    The IETF invites any interested party to bring to its attention any
  1184.    copyrights, patents or patent applications, or other proprietary
  1185.    rights which may cover technology that may be required to practice
  1186.    this standard.  Please address the information to the IETF Executive
  1187.    Director.
  1188.  
  1189. 7.  Acknowledgments
  1190.  
  1191.    This document was produced by the Trunk MIB Working Group.
  1192.  
  1193. 8.  References
  1194.  
  1195.    [1]  Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for
  1196.         Describing SNMP Management Frameworks", RFC 2271, January 1998.
  1197.  
  1198.    [2]  Rose, M., and K. McCloghrie, "Structure and Identification of
  1199.         Management Information for TCP/IP-based Internets", STD 16, RFC
  1200.         1155, May 1990.
  1201.  
  1202.    [3]  Rose, M., and K. McCloghrie, "Concise MIB Definitions", STD 16,
  1203.         RFC 1212, March 1991.
  1204.  
  1205.    [4]  Rose, M., "A Convention for Defining Traps for use with the
  1206.         SNMP", RFC 1215, March 1991.
  1207.  
  1208.    [5]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1209.         "Structure of Management Information for Version 2 of the Simple
  1210.         Network Management Protocol (SNMPv2)", RFC 1902, January 1996.
  1211.  
  1212.    [6]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual
  1213.         Conventions for Version 2 of the Simple Network Management
  1214.         Protocol (SNMPv2)", RFC 1903, January 1996.
  1215.  
  1216.    [7]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1217.         "Conformance Statements for Version 2 of the Simple Network
  1218.         Management Protocol (SNMPv2)", RFC 1904, January 1996.
  1219.  
  1220.    [8]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  1221.         Network Management Protocol", STD 15, RFC 1157, May 1990.
  1222.  
  1223.    [9]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1224.         "Introduction to Community-based SNMPv2", RFC 1901, January
  1225.         1996.
  1226.  
  1227.    [10] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1228.         "Transport Mappings for Version 2 of the Simple Network
  1229.         Management Protocol (SNMPv2)", RFC 1906, January 1996.
  1230.  
  1231.  
  1232.  
  1233.  
  1234. Fowler, Ed.                 Standards Track                    [Page 22]
  1235.  
  1236. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  1237.  
  1238.  
  1239.    [11] Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message
  1240.         Processing and Dispatching for the Simple Network Management
  1241.         Protocol (SNMP)", RFC 2272, January 1998.
  1242.  
  1243.    [12] Blumenthal, U., and B. Wijnen, "User-based Security Model (USM)
  1244.         for version 3 of the Simple Network Management Protocol
  1245.         (SNMPv3)", RFC 2274, January 1998.
  1246.  
  1247.    [13] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
  1248.         Operations for Version 2 of the Simple Network Management
  1249.         Protocol (SNMPv2)", RFC 1905, January 1996.
  1250.  
  1251.    [14] Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC
  1252.         2273, January 1998.
  1253.  
  1254.    [15] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access
  1255.         Control Model (VACM) for the Simple Network Management Protocol
  1256.         (SNMP)", RFC 2275, January 1998.
  1257.  
  1258.    [16] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB
  1259.         using SMIv2", RFC 2233, November 1997.
  1260.  
  1261.    [17] Fowler D., "Definitions of Managed Objects for the DS1, E1, DS2,
  1262.         and E2 Interface Types", RFC 2495, January 1999.
  1263.  
  1264.    [18] Fowler, D., "Definitions of Managed Objects for the DS3/E3
  1265.         Interface Types", RFC 2496, January 1999.
  1266.  
  1267.    [19] Brown, T., and K. Tesink, "Definitions of Managed Objects for
  1268.         the SONET/SDH Interface Type", Work in Progress.
  1269.  
  1270.    [20] Sharp, H. (Editor), "Interoperability Requirements for Nx56/64
  1271.         kbit/s Calls", BONDING Spec Version 1.0, BONDING Consortium,
  1272.         Sept 1992.
  1273.  
  1274. 9.  Security Considerations
  1275.  
  1276.    SNMPv1 by itself is such an insecure environment.  Even if the
  1277.    network itself is secure (for example by using IPSec), even then,
  1278.    there is no control as to who on the secure network is allowed to
  1279.    access and GET (read) the objects in this MIB.
  1280.  
  1281.    It is recommended that the implementors consider the security
  1282.    features as provided by the SNMPv3 framework.  Specifically, the use
  1283.    of the User-based Security Model RFC 2274 [12] and the View-based
  1284.    Access Control Model RFC 2275 [15] is recommended.
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290. Fowler, Ed.                 Standards Track                    [Page 23]
  1291.  
  1292. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  1293.  
  1294.  
  1295.    It is then a customer/user responsibility to ensure that the SNMP
  1296.    entity giving access to an instance of this MIB, is properly
  1297.    configured to give access to those objects only to those principals
  1298.    (users) that have legitimate rights to access them.
  1299.  
  1300.    Setting the following objects to an inappropriate value can cause
  1301.    loss of traffic.  In the case of dsx0RobbedBitSignalling, for
  1302.    example, the nature of the traffic flowing on the DS0 can be
  1303.    affected.
  1304.       dsx0RobbedBitSignalling
  1305.       dsx0IdleCode
  1306.       dsx0SeizedCode
  1307.       dsx0TransmitCodesEnable
  1308.       dsx0BundleRowStatus
  1309.       dsx0BondMode
  1310.       dsx0BondRowStatus
  1311.  
  1312.    Setting the following objects is mischievous, but not harmful to
  1313.    traffic.
  1314.       dsx0CircuitIdentifier
  1315.       dsx0BundleNextIndex
  1316.  
  1317. 10.  Author's Address
  1318.  
  1319.    David Fowler
  1320.    Newbridge Networks
  1321.    600 March Road
  1322.    Kanata, Ontario, Canada K2K 2E6
  1323.  
  1324.    Phone: (613) 599-3600, ext 6559
  1325.    EMail: davef@newbridge.com
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346. Fowler, Ed.                 Standards Track                    [Page 24]
  1347.  
  1348. RFC 2494                DSO MIB / DSOBUNDLE MIB             January 1999
  1349.  
  1350.  
  1351. 11.  Full Copyright Statement
  1352.  
  1353.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  1354.  
  1355.    This document and translations of it may be copied and furnished to
  1356.    others, and derivative works that comment on or otherwise explain it
  1357.    or assist in its implementation may be prepared, copied, published
  1358.    and distributed, in whole or in part, without restriction of any
  1359.    kind, provided that the above copyright notice and this paragraph are
  1360.    included on all such copies and derivative works.  However, this
  1361.    document itself may not be modified in any way, such as by removing
  1362.    the copyright notice or references to the Internet Society or other
  1363.    Internet organizations, except as needed for the purpose of
  1364.    developing Internet standards in which case the procedures for
  1365.    copyrights defined in the Internet Standards process must be
  1366.    followed, or as required to translate it into languages other than
  1367.    English.
  1368.  
  1369.    The limited permissions granted above are perpetual and will not be
  1370.    revoked by the Internet Society or its successors or assigns.
  1371.  
  1372.    This document and the information contained herein is provided on an
  1373.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  1374.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  1375.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  1376.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  1377.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402. Fowler, Ed.                 Standards Track                    [Page 25]
  1403.  
  1404.