home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_i / draft-ietf-ipcdn-rf-interface-mib-00.txt < prev    next >
Text File  |  1997-07-08  |  89KB  |  2,766 lines
  1.  
  2. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  3.  
  4.  
  5.        Radio Frequency (RF) Interface Management Information Base
  6.                     for MCNS compliant RF interfaces
  7.                 draft-ietf-ipcdn-rf-interface-mib-00.txt
  8.  
  9.                       Mon Jul  7 10:32:21 PDT 1997
  10.  
  11.  
  12.                          Guenter Roeck (editor)
  13.                              cisco Systems
  14.                             groeck@cisco.com
  15.  
  16.  
  17.  
  18.  
  19.  
  20. Status of this Memo
  21.  
  22. This document is an Internet-Draft.  Internet-Drafts are working
  23. documents of the Internet Engineering Task Force (IETF), its Areas, and
  24. its Working Groups.  Note that other groups may also distribute working
  25. documents as Internet-Drafts.
  26.  
  27. Internet-Drafts are draft documents valid for a maximum of six months
  28. and may be updated, replaced, or obsoleted by other documents at any
  29. time.  It is inappropriate to use Internet-Drafts as reference material
  30. or to cite them other than as a "work in progress".
  31.  
  32. To view the entire list of current Internet-Drafts, please check the
  33. "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow
  34. Directories on ftp.is.co.za (Africa), ftp.nordu.net (Europe),
  35. munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
  36. ftp.isi.edu (US West Coast).
  37.  
  38. Abstract
  39.  
  40. This memo defines an experimental portion of the Management Information
  41. Base (MIB) for use with network management protocols in the Internet
  42. community.  In particular, it defines a basic set of managed objects for
  43. SNMP-based management of MCNS compliant Radio Frequency (RF) interfaces.
  44.  
  45. This memo specifies a MIB module in a manner that is compliant to the
  46. SNMPv2 SMI.  The set of objects is consistent with the SNMP framework
  47. and existing SNMP standards.
  48.  
  49. This memo does not specify a standard for the Internet community.
  50.  
  51. This memo is a product of the IPCDN working group within the Internet
  52. Engineering Task Force.  Comments are solicited and should be addressed
  53. to the working group's mailing list at ipcdn@terayon.com and/or the
  54. author.
  55.  
  56.  
  57.  
  58. Expires January 1998                                            [Page 1]
  59.  
  60. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  61.  
  62.  
  63. Table of Contents
  64.  
  65.  
  66. 1 The SNMPv2 Network Management Framework .........................    3
  67. 2 Object Definitions ..............................................    3
  68. 3 Overview ........................................................    4
  69. 3.1 Structure of the MIB ..........................................    4
  70. 3.1.1 General Description .........................................    4
  71. 3.2 Relationship to the Interfaces MIB ............................    4
  72. 3.2.1 Layering Model ..............................................    4
  73. 3.2.2 ifTestTable .................................................    5
  74. 3.2.3 ifRcvAddressTable ...........................................    5
  75. 3.2.4 ifEntry .....................................................    5
  76. 3.2.4.1 ifEntry for Downstream interfaces .........................    5
  77. 3.2.4.2 ifEntry for Upstream interfaces ...........................    7
  78. 3.2.4.3 ifEntry for the MAC Layer .................................    9
  79. 4 Definitions .....................................................   11
  80. 5 Acknowledgments .................................................   46
  81. 6 References ......................................................   46
  82. 7 Security Considerations .........................................   46
  83. 8 Author's Address ................................................   47
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. Expires January 1998                                            [Page 2]
  117.  
  118. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  119.  
  120.  
  121. 1.  The SNMPv2 Network Management Framework
  122.  
  123. The SNMPv2 Network Management Framework presently consists of three
  124. major components.  They are:
  125.  
  126. o    the SMI, described in RFC 1902 [1] - the mechanisms used for
  127.      describing and naming objects for the purpose of management.
  128.  
  129. o    the MIB-II, STD 17, RFC 1213 [2] - the core set of managed objects
  130.      for the Internet suite of protocols.
  131.  
  132. o    the protocol, RFC 1157 [3] and/or RFC 1905 [4], - the protocol for
  133.      accessing managed objects.
  134.  
  135. The Framework permits new objects to be defined for the purpose of
  136. experimentation and evaluation.
  137.  
  138.  
  139. 2.  Object Definitions
  140.  
  141. Managed objects are accessed via a virtual information store, termed the
  142. Management Information Base or MIB.  Objects in the MIB are defined
  143. using the subset of Abstract Syntax Notation One (ASN.1) defined in the
  144. SMI.  In particular, each object type is named by an OBJECT IDENTIFIER,
  145. an administratively assigned name.  The object type together with an
  146. object instance serves to uniquely identify a specific instantiation of
  147. the object.  For human convenience, we often use a textual string,
  148. termed the descriptor, to refer to the object type.
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174. Expires January 1998                                            [Page 3]
  175.  
  176. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  177.  
  178.  
  179. 3.  Overview
  180.  
  181. This MIB provides a set of objects required for the management of MCNS
  182. compliant Cable Modem (CM) and Cable Modem Termination System (CMTS) RF
  183. interfaces.  The specification is derived from the MCNS Radio Frequency
  184. Interface specification [6].
  185.  
  186.  
  187. 3.1.  Structure of the MIB
  188.  
  189. This MIB is structured in three groups:
  190.  
  191. o    Information required both in Cable Modems and Cable Modem
  192.      Termination systems.
  193.  
  194. o    Information required in Cable Modems only.
  195.  
  196. o    Information required in Cable Modem Termination Systems only.
  197.  
  198.  
  199. 3.1.1.  General Description
  200.  
  201. 3.2.  Relationship to the Interfaces MIB
  202.  
  203. This section clarifies the relationship of this MIB to the Interfaces
  204. MIB [5].  Several areas of correlation are addressed in the following
  205. subsections.  The implementor is referred to the Interfaces MIB document
  206. in order to understand the general intent of these areas.
  207.  
  208.  
  209. 3.2.1.  Layering Model
  210.  
  211. An instance of ifEntry exists for each RF Downstream interface, for each
  212. RF Upstream interface, and for each RF MAC layer.  The ifStackTable [5]
  213. must be implemented to identify relationships among sub-interfaces.
  214.  
  215. The following example illustrates a MAC interface with one downstream
  216. and two upstream channels.
  217.  
  218.                                    | <== to network layer
  219.                      +-------------+--------------+
  220.                      |           RF MAC           |
  221.                      +----+---------+-----------+-+
  222.                           |         |           |
  223.                 +---------+---+ +---+-------+ +-+---------+
  224.                 | Downstream1 | | Upstream1 | | Upstream2 |
  225.                 +-------------+ +-----------+ +-----------+
  226.  
  227. As can be seen from this example, the RF MAC interface is layered on top
  228. of the downstream and upstream interfaces.
  229.  
  230.  
  231.  
  232. Expires January 1998                                            [Page 4]
  233.  
  234. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  235.  
  236.  
  237. In this example, the assignment of index values could be as follows:
  238.  
  239. ifIndex ifType                  Description
  240.  
  241.    1    docsCableMaclayer(xx)   CATV MAC Layer
  242.    2    docsCableDownstream(xx) CATV Downstream interface
  243.    3    docsCableUpstream(xx)   CATV Upstream interface
  244.    4    docsCableUpstream(xx)   CATV Upstream interface
  245.  
  246. The corresponding ifStack entries would then be:
  247.  
  248.         | IfStackHigherLayer | ifStackLowerLayer |
  249.         |         0          |         1         |
  250.         |         1          |         2         |
  251.         |         1          |         3         |
  252.         |         1          |         4         |
  253.         |         2          |         0         |
  254.         |         3          |         0         |
  255.         |         4          |         0         |
  256.  
  257.  
  258.  
  259. 3.2.2.  ifTestTable
  260.  
  261. The ifTestTable is not supported by this MIB.
  262.  
  263.  
  264. 3.2.3.  ifRcvAddressTable
  265.  
  266. The ifRcvAddressTable is not supported by this MIB.
  267.  
  268.  
  269. 3.2.4.  ifEntry
  270.  
  271. 3.2.4.1.  ifEntry for Downstream interfaces
  272.  
  273. The ifEntry for Downstream interfaces supports the ifGeneralGroup and
  274. the ifPacketGroup of the Interfaces MIB.
  275.  
  276. ifTable           Comments
  277. ==============    ===========================================
  278. ifIndex           Each RF Cable Downstream interface is represented
  279.                   by an ifEntry.
  280.  
  281. ifDescr           Textual port description.
  282.  
  283. ifType            The IANA value of docsCableDownstream(xx).
  284.  
  285. ifSpeed           Return the speed of this downstream channel.
  286.  
  287. ifPhysAddress     Return an empty string.
  288.  
  289.  
  290. Expires January 1998                                            [Page 5]
  291.  
  292. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  293.  
  294.  
  295. ifAdminStatus     The administrative status of this interface.
  296.  
  297. ifOperStatus      The current operational status of this interface.
  298.  
  299. ifLastChange      Refer to the Interfaces MIB.
  300.  
  301. ifLinkUpDownTrapEnable
  302.                   Refer to the Interfaces MIB.
  303.  
  304. ifConnectorPresent
  305.                   Refer to the Interfaces MIB.
  306.  
  307. ifHighSpeed       Return zero.
  308.  
  309. ifName            Refer to the Interfaces MIB.
  310.  
  311. ifMtu             The size of the largest frame which can be
  312.                   sent/received on this interface,
  313.                   specified in octets.
  314.  
  315. ifInOctets        Return zero.
  316.  
  317. ifInUcastPkts     Return zero.
  318.  
  319. ifInNUcastPkts    Deprecated.  Return zero.
  320.  
  321. ifInMulticastPkts Return zero.
  322.  
  323. ifInBroadcastPkts Return zero.
  324.  
  325. ifInDiscards      Return zero.
  326.  
  327. ifInErrors        Return zero.
  328.  
  329. ifInUnknownProtos Return zero.
  330.  
  331. ifOutOctets       The total number of octets transmitted on this
  332.                   interface. This includes MAC packets as well as
  333.                   data packets, and includes the length of the MAC
  334.                   header.
  335.  
  336. ifOutUcastPkts    The number of Unicast packets transmitted on this
  337.                   interface. This includes MAC packets as well as
  338.                   data packets, and includes the length of the MAC
  339.                   header.
  340.  
  341. ifOutNUcastPkts   Deprecated.  Return the number of Broadcast and
  342.                   Multicast packets transmitted on this interface.
  343.                   This includes MAC packets as well as data packets,
  344.                   and includes the length of the MAC header.
  345.  
  346. ifOutMulticastPkts
  347.  
  348.  
  349. Expires January 1998                                            [Page 6]
  350.  
  351. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  352.  
  353.  
  354.                   Return the number of Multicast packets transmitted
  355.                   on this interface.
  356.                   This includes MAC packets as well as data packets,
  357.                   and includes the length of the MAC header.
  358.  
  359. ifOutBroadcastPkts
  360.                   Return the number of broadcast packets transmitted
  361.                   on this interface.
  362.                   This includes MAC packets as well as data packets,
  363.                   and includes the length of the MAC header.
  364.  
  365. ifOutDiscards     The total number of outbound packets which
  366.                   were discarded. Possible reasons are:
  367.                   buffer shortage.
  368.  
  369. ifOutErrors       The number of packets which could not be
  370.                   transmitted due to errors.
  371.  
  372. ifOutQlen         Deprecated. Return zero.
  373.  
  374. ifSpecific        Deprecated. Return {0 0}.
  375.  
  376.  
  377. 3.2.4.2.  ifEntry for Upstream interfaces
  378.  
  379. The ifEntry for Upstream interfaces supports the ifGeneralGroup and the
  380. ifPacketGroup of the Interfaces MIB.
  381.  
  382. ifTable           Comments
  383. ==============    ===========================================
  384. ifIndex           Each RF Cable Upstream interface is represented
  385.                   by an ifEntry.
  386.  
  387. ifDescr           Textual port description.
  388.  
  389. ifType            The IANA value of docsCableUpstream(xx).
  390.  
  391. ifSpeed           Return the speed of this upstream channel.
  392.  
  393. ifPhysAddress     Return an empty string.
  394.  
  395. ifAdminStatus     The administrative status of this interface.
  396.  
  397. ifOperStatus      The current operational status of this interface.
  398.  
  399. ifLastChange      Refer to the Interfaces MIB.
  400.  
  401. ifLinkUpDownTrapEnable
  402.                   Refer to the Interfaces MIB.
  403.  
  404. ifConnectorPresent
  405.                   Refer to the Interfaces MIB.
  406.  
  407.  
  408. Expires January 1998                                            [Page 7]
  409.  
  410. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  411.  
  412.  
  413. ifHighSpeed       Return zero.
  414.  
  415. ifName            Refer to the Interfaces MIB.
  416.  
  417. ifMtu             The size of the largest frame which can be
  418.                   sent/received on this interface,
  419.                   specified in octets.
  420.  
  421. ifInOctets        The total number of octets received on this
  422.                   interface. This includes data packets as well as
  423.                   MAC layer packets, and includes the length of the
  424.                   MAC header.
  425.  
  426. ifInUcastPkts     The number of Unicast packets received on this
  427.                   interface. This includes data packets as well as
  428.                   MAC layer packets.
  429.  
  430. ifInNUcastPkts    Deprecated.  Return the number of Broadcast and
  431.                   Multicast packets received on this interface.
  432.                   This includes data packets as well as MAC layer
  433.                   packets.
  434.  
  435. ifInMulticastPkts Return the number of Multicast packets received
  436.                   on this interface. This includes data packets as
  437.                   well as MAC layer packets.
  438.  
  439. ifInBroadcastPkts Return the number of Broadcast packets received
  440.                   on this interface. This includes data packets
  441.                   as well as MAC layer packets.
  442.  
  443. ifInDiscards      The total number of received packets which have been
  444.                   discarded.
  445.                   The possible reasons are: buffer shortage.
  446.  
  447. ifInErrors        The number of inbound packets that contained
  448.                   errors preventing them from being deliverable
  449.                   to higher layers.
  450.  
  451. ifInUnknownProtos The number of frames with an unknown packet type.
  452.                   This are MAC frames with an unknown packet type.
  453.  
  454. ifOutOctets       Return zero.
  455.  
  456. ifOutUcastPkts    Return zero.
  457.  
  458. ifOutNUcastPkts   Deprecated.  Return zero.
  459.  
  460. ifOutMulticastPkts
  461.                   Return zero.
  462.  
  463. ifOutBroadcastPkts
  464.                   Return zero.
  465.  
  466.  
  467. Expires January 1998                                            [Page 8]
  468.  
  469. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  470.  
  471.  
  472. ifOutDiscards     Return zero.
  473.  
  474. ifOutErrors       Return zero.
  475.  
  476. ifOutQlen         Deprecated. Return zero.
  477.  
  478. ifSpecific        Deprecated. Return {0 0}.
  479.  
  480.  
  481. 3.2.4.3.  ifEntry for the MAC Layer
  482.  
  483. The ifEntry for the MAC Layer supports the ifGeneralGroup and the
  484. ifPacketGroup of the Interfaces MIB.
  485.  
  486. ifTable           Comments
  487. ==============    ===========================================
  488. ifIndex           Each RF Cable MAC layer entity is represented
  489.                   by an ifEntry.
  490.  
  491. ifDescr           Textual port description.
  492.  
  493. ifType            The IANA value of docsCableMaclayer(xx).
  494.  
  495. ifSpeed           Return zero.
  496.  
  497. ifPhysAddress     Return the physical address of this interface.
  498.  
  499. ifAdminStatus     The administrative status of this interface.
  500.  
  501. ifOperStatus      The current operational status of the MAC
  502.                   layer interface.
  503.  
  504. ifLastChange      Refer to the Interfaces MIB.
  505.  
  506. ifLinkUpDownTrapEnable
  507.                   Refer to the Interfaces MIB.
  508.  
  509. ifConnectorPresent
  510.                   Refer to the Interfaces MIB.
  511.  
  512. ifHighSpeed       Return zero.
  513.  
  514. ifName            Refer to the Interfaces MIB.
  515.  
  516. ifMtu             The size of the largest frame which can be
  517.                   sent/received on this interface, specified
  518.                   in octets.
  519.  
  520. ifInOctets        The total number of data octets received on this
  521.                   interface, targeted for upper protocol layers.
  522.  
  523. ifInUcastPkts     The number of Unicast packets received on this
  524.  
  525.  
  526. Expires January 1998                                            [Page 9]
  527.  
  528. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  529.  
  530.  
  531.                   interface, targeted for upper protocol layers.
  532.  
  533. ifInNUcastPkts    Deprecated.  Return the number of Broadcast and
  534.                   Multicast packets received on this interface,
  535.                   targeted for upper protocol layers.
  536.  
  537. ifInMulticastPkts Return the number of Multicast packets received
  538.                   on this interface, targeted for upper protocol
  539.                   layers.
  540.  
  541. ifInBroadcastPkts Return the number of Broadcast packets received
  542.                   on this interface, targeted for upper protocol
  543.                   layers.
  544.  
  545. ifInDiscards      The total number of received packets which have been
  546.                   discarded.
  547.                   The possible reasons are: buffer shortage.
  548.  
  549. ifInErrors        The number of inbound packets that contained
  550.                   errors preventing them from being deliverable
  551.                   to higher layers.
  552.  
  553. ifInUnknownProtos The number of frames with an unknown packet type.
  554.                   This is the number of data packets targeted for upper
  555.                   protocol layers with an unknown packet type.
  556.  
  557. ifOutOctets       The total number of octets, received from upper
  558.                   protocol layers and transmitted on this interface.
  559.  
  560. ifOutUcastPkts    The number of Unicast packets, received from upper
  561.                   protocol layers and transmitted on this interface.
  562.  
  563. ifOutNUcastPkts   Deprecated.  Return the number of Broadcast and
  564.                   Multicast packets received from upper protocol
  565.                   layers and transmitted on this interface.
  566.  
  567. ifOutMulticastPkts
  568.                   Return the number of Multicast packets received
  569.                   from upper protocol layers and transmitted on this
  570.                   interface.
  571.  
  572. ifOutBroadcastPkts
  573.                   Return the number of broadcast packets received
  574.                   from upper protocol layers and transmitted on this
  575.                   interface.
  576.  
  577. ifOutDiscards     The total number of outbound packets which
  578.                   were discarded. Possible reasons are:
  579.                   buffer shortage.
  580.  
  581. ifOutErrors       The number of packets which could not be
  582.                   transmitted due to errors.
  583.  
  584.  
  585. Expires January 1998                                           [Page 10]
  586.  
  587. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  588.  
  589.  
  590. ifOutQlen         Deprecated. Return zero.
  591.  
  592. ifSpecific        Deprecated. Return {0 0}.
  593.  
  594.  
  595. 4.  Definitions
  596.  
  597.  
  598. DOCS-IF-MIB DEFINITIONS ::= BEGIN
  599.  
  600. IMPORTS
  601.         MODULE-IDENTITY, OBJECT-TYPE, BITS,
  602.         Unsigned32, Integer32, Counter32, TimeTicks, IpAddress
  603.                     FROM SNMPv2-SMI
  604.         TEXTUAL-CONVENTION,
  605.         MacAddress,
  606.         RowStatus,
  607.         TruthValue
  608.                     FROM SNMPv2-TC
  609.         OBJECT-GROUP, MODULE-COMPLIANCE
  610.                     FROM SNMPv2-CONF
  611.         ifIndex, InterfaceIndexOrZero
  612.                     FROM IF-MIB
  613.         transmission
  614.                     FROM RFC1213-MIB;
  615.  
  616. docsIfMib MODULE-IDENTITY
  617.         LAST-UPDATED    "9707071024Z" -- Jul 07, 1997
  618.         ORGANIZATION    "IETF IPCDN Working Group"
  619.         CONTACT-INFO
  620.             "        Guenter Roeck
  621.              Postal: cisco Systems
  622.                      170 West Tasman Drive
  623.                      San Jose, CA 95134
  624.                      U.S.A.
  625.              Phone:  +1 408 527 3143
  626.              E-mail: groeck@cisco.com"
  627.         DESCRIPTION
  628.             "This is the MIB Module for MCNS compliant Radio Frequency
  629.              (RF) interfaces in Cable Modems (CM) and Cable Modem
  630.              Termination Systems (CMTS)."
  631.         ::= { transmission 999 }
  632. -- Editor's note: This is not a valid assignment. Final value
  633. -- will be the value of docsCableMaclayer(xx) once assigned.
  634.  
  635. -- Textual Conventions
  636.  
  637. TenthdBmV ::= TEXTUAL-CONVENTION
  638.         DISPLAY-HINT "d-1"
  639.         STATUS       current
  640.         DESCRIPTION
  641.             "This data type represents power levels that are normally
  642.  
  643.  
  644. Expires January 1998                                           [Page 11]
  645.  
  646. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  647.  
  648.  
  649.              expressed in dBmV. Units are in tenths of a dBmV;
  650.              for example, 5.1 dBmV will be represented as 51."
  651.         SYNTAX       Integer32
  652.  
  653. docsIfMibObjects  OBJECT IDENTIFIER ::= { docsIfMib 1 }
  654. docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 }
  655. docsIfCmObjects   OBJECT IDENTIFIER ::= { docsIfMibObjects 2 }
  656. docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 }
  657.  
  658. --
  659. -- BASE GROUP
  660. --
  661.  
  662. --
  663. -- The following table is implemented on both the Cable Modem (CM)
  664. -- and the Cable Modem Termination System (CMTS).
  665. --
  666.  
  667. docsIfDownstreamChannelTable OBJECT-TYPE
  668.         SYNTAX      SEQUENCE OF DocsIfDownstreamChannelEntry
  669.         MAX-ACCESS  not-accessible
  670.         STATUS      current
  671.         DESCRIPTION
  672.             "This table describes the attributes of downstream
  673.              channels (frequency bands)."
  674.         ::= { docsIfBaseObjects 1 }
  675.  
  676. docsIfDownstreamChannelEntry OBJECT-TYPE
  677.         SYNTAX      DocsIfDownstreamChannelEntry
  678.         MAX-ACCESS  not-accessible
  679.         STATUS      current
  680.         DESCRIPTION
  681.             "List of attributes for a single Downstream channel.
  682.              An entry in this table exists for each ifEntry with an
  683.              ifType of docsCableDownstream(xx)."
  684.         INDEX { ifIndex }
  685.         ::= { docsIfDownstreamChannelTable 1 }
  686.  
  687. DocsIfDownstreamChannelEntry ::= SEQUENCE {
  688.         docsIfDownChannelId               INTEGER,
  689.         docsIfDownChannelFrequency        INTEGER,
  690.         docsIfDownChannelWidth            INTEGER,
  691.         docsIfDownChannelModulation       INTEGER,
  692.         docsIfDownChannelInterleave       INTEGER,
  693.         docsIfDownChannelPower            TenthdBmV
  694. }
  695.  
  696. docsIfDownChannelId OBJECT-TYPE
  697.         SYNTAX      INTEGER (0..255)
  698.         MAX-ACCESS  read-only
  699.         STATUS      current
  700.         DESCRIPTION
  701.  
  702.  
  703. Expires January 1998                                           [Page 12]
  704.  
  705. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  706.  
  707.  
  708.             "The CMTS identification of the downstream channel within
  709.              this particular MAC interface. If the interface is down,
  710.              the object returns the most current value. If the
  711.              downstream channel ID is unknown, this object returns
  712.              a value of 0."
  713.         ::= { docsIfDownstreamChannelEntry 1 }
  714.  
  715. docsIfDownChannelFrequency  OBJECT-TYPE
  716.         SYNTAX      INTEGER (36000000..1000000000)
  717.         UNITS       "hertz"
  718.         MAX-ACCESS  read-write
  719.         STATUS      current
  720.         DESCRIPTION
  721.             "The center of the downstream frequency associated with
  722.              this channel. This object will return the current tuner
  723.              frequency. If a CMTS provides IF output, this object
  724.              will return the IF frequency."
  725. -- Editor's note: Is this what we want for systems creating IF output ?
  726. -- If not, what else ?
  727.         ::= { docsIfDownstreamChannelEntry 2 }
  728.  
  729. docsIfDownChannelWidth  OBJECT-TYPE
  730.         SYNTAX      INTEGER (0..16000000)
  731.         UNITS       "hertz"
  732.         MAX-ACCESS  read-write
  733.         STATUS      current
  734.         DESCRIPTION
  735.             "The bandwidth of this downstream channel. Most
  736.              implementations are expected to support a channel width
  737.              of 6 MHz (North America) and/or 8 MHz (Europe)."
  738.         ::= { docsIfDownstreamChannelEntry 3 }
  739.  
  740. docsIfDownChannelModulation OBJECT-TYPE
  741.         SYNTAX      INTEGER {
  742.             unknown(1),
  743.             other(2),
  744.             qam64(3),
  745.             qam256(4)
  746.         }
  747.         MAX-ACCESS  read-write
  748.         STATUS      current
  749.         DESCRIPTION
  750.             "The modulation type associated with this downstream
  751.              channel. If the interface is down, this object either
  752.              returns the configured value (CMTS), the most current
  753.              value (CM), or the value of unknown(1)."
  754.         ::= { docsIfDownstreamChannelEntry 4 }
  755.  
  756. docsIfDownChannelInterleave OBJECT-TYPE
  757.         SYNTAX      INTEGER {
  758.             unknown(1),
  759.             other(2),
  760.  
  761.  
  762. Expires January 1998                                           [Page 13]
  763.  
  764. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  765.  
  766.  
  767.             taps8Increment16(3),
  768.             taps16Increment8(4),
  769.             taps32Increment4(5),
  770.             taps64Increment2(6),
  771.             taps128Increment1(7)
  772.         }
  773.         MAX-ACCESS  read-write
  774.         STATUS      current
  775.         DESCRIPTION
  776.             "The Forward Error Correction (FEC) interleaving used
  777.              for this downstream channel.
  778.              Values are defined as follows:
  779.              taps8Increment16(3):   protection 5.9/4.1 usec,
  780.                                     latency .22/.15 mse
  781.              taps16Increment8(4):   protection 12/8.2 usec,
  782.                                     latency .48/.33 msec
  783.              taps32Increment4(5):   protection 24/16 usec,
  784.                                     latency .98/.68 msec
  785.              taps64Increment2(6):   protection 47/33 usec,
  786.                                     latency 2/1.4 msec
  787.              taps128Increment1(7):  protection 95/66 usec,
  788.                                     latency 4/2.8 msec
  789.              If the interface is down, this object either returns
  790.              the configured value (CMTS), the most current value (CM),
  791.              or the value of unknown(1).
  792.              The value of other(2) is returned if the interleave
  793.              is known but not defined in the above list."
  794.         ::= { docsIfDownstreamChannelEntry 5 }
  795.  
  796. docsIfDownChannelPower OBJECT-TYPE
  797.         SYNTAX      TenthdBmV
  798.         MAX-ACCESS  read-write
  799.         STATUS      current
  800.         DESCRIPTION
  801.             "At the CMTS, the operational transmit power. At the CM,
  802.              the received power level. May be set to zero at the CM
  803.              if power level measurement is not supported.
  804.              If the interface is down, this object either returns
  805.              the configured value (CMTS), the most current value (CM)
  806.              or the value of 0."
  807.         ::= { docsIfDownstreamChannelEntry 6 }
  808.  
  809. --
  810. -- The following table is implemented on both the CM and the CMTS.
  811. -- For the CM, only attached channels appear in the table.
  812. --
  813.  
  814. docsIfUpstreamChannelTable OBJECT-TYPE
  815.         SYNTAX      SEQUENCE OF DocsIfUpstreamChannelEntry
  816.         MAX-ACCESS  not-accessible
  817.         STATUS      current
  818.         DESCRIPTION
  819.  
  820.  
  821. Expires January 1998                                           [Page 14]
  822.  
  823. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  824.  
  825.  
  826.             "Describes the attributes of attached upstream channels
  827.              (frequency bands)."
  828.         ::= { docsIfBaseObjects 2 }
  829.  
  830. docsIfUpstreamChannelEntry OBJECT-TYPE
  831.         SYNTAX      DocsIfUpstreamChannelEntry
  832.         MAX-ACCESS  not-accessible
  833.         STATUS      current
  834.         DESCRIPTION
  835.             "List of attributes for a single upstream channel.
  836.              An entry in this table exists for each ifEntry with an
  837.              ifType of docsCableUpstream(xx)."
  838.         INDEX { ifIndex }
  839.         ::= { docsIfUpstreamChannelTable 1 }
  840.  
  841. DocsIfUpstreamChannelEntry ::= SEQUENCE {
  842.         docsIfUpChannelId                     INTEGER,
  843.         docsIfUpChannelFrequency              INTEGER,
  844.         docsIfUpChannelWidth                  INTEGER,
  845.         docsIfUpChannelModulationProfile      Unsigned32,
  846.         docsIfUpChannelSlotSize               Unsigned32,
  847.         docsIfUpChannelTxTimingOffset         Unsigned32,
  848.         docsIfUpChannelRangingBackoffStart    INTEGER,
  849.         docsIfUpChannelRangingBackoffEnd      INTEGER,
  850.         docsIfUpChannelTxBackoffStart         INTEGER,
  851.         docsIfUpChannelTxBackoffEnd           INTEGER
  852. }
  853.  
  854. docsIfUpChannelId OBJECT-TYPE
  855.         SYNTAX      INTEGER (0..255)
  856.         MAX-ACCESS  read-only
  857.         STATUS      current
  858.         DESCRIPTION
  859.             "The CMTS identification of the upstream channel."
  860.         ::= { docsIfUpstreamChannelEntry 1 }
  861.  
  862. docsIfUpChannelFrequency OBJECT-TYPE
  863.         SYNTAX      INTEGER (5000000..1000000000)
  864.         UNITS       "hertz"
  865.         MAX-ACCESS  read-write
  866.         STATUS      current
  867.         DESCRIPTION
  868.             "The center of the frequency band associated with this
  869.              upstream channel."
  870.         ::= { docsIfUpstreamChannelEntry 2 }
  871.  
  872. docsIfUpChannelWidth OBJECT-TYPE
  873.         SYNTAX      INTEGER (1..16000000)
  874.         UNITS       "hertz"
  875.         MAX-ACCESS  read-write
  876.         STATUS      current
  877.         DESCRIPTION
  878.  
  879.  
  880. Expires January 1998                                           [Page 15]
  881.  
  882. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  883.  
  884.  
  885.             "The bandwidth of this upstream channel."
  886.         ::= { docsIfUpstreamChannelEntry 3 }
  887.  
  888. docsIfUpChannelModulationProfile OBJECT-TYPE
  889.         SYNTAX      Unsigned32
  890.         MAX-ACCESS  read-write
  891.         STATUS      current
  892.         DESCRIPTION
  893.             "An entry identical to the docsIfModIndex in the
  894.              docsIfCmtsModulationTable that describes this channel.
  895.              This channel is further instantiated there by a grouping
  896.              of interval usage codes which together fully describe the
  897.              channel modulation. This object returns 0 if the
  898.              docsIfCmtsModulationTable does not exist or is empty."
  899.         ::= { docsIfUpstreamChannelEntry 4 }
  900.  
  901. docsIfUpChannelSlotSize OBJECT-TYPE
  902.         SYNTAX      Unsigned32
  903.         MAX-ACCESS  read-write
  904.         STATUS      current
  905.         DESCRIPTION
  906.             "The number of 6.25 microsecond ticks in each upstream mini-
  907.              slot."
  908.         ::= { docsIfUpstreamChannelEntry 5 }
  909.  
  910. docsIfUpChannelTxTimingOffset OBJECT-TYPE
  911.         SYNTAX      Unsigned32
  912.         MAX-ACCESS  read-only
  913.         STATUS      current
  914.         DESCRIPTION
  915.             "A measure of the current round trip time at the CM, or the
  916.              maximum round trip time seen by the CMTS.  Used for timing
  917.              of CM upstream transmissions to ensure synchronized
  918.              arrivals at the CMTS. Units are in terms of
  919.              (6.25 microseconds/64)."
  920.         ::= { docsIfUpstreamChannelEntry 8 }
  921.  
  922. docsIfUpChannelRangingBackoffStart OBJECT-TYPE
  923.         SYNTAX      INTEGER (0..16)
  924.         MAX-ACCESS  read-write
  925.         STATUS      current
  926.         DESCRIPTION
  927.             "The initial random backoff window to use when retrying
  928.              Ranging Requests. Expressed as a power of 2. A value of 16
  929.              at the CMTS indicates that a proprietary adaptive retry
  930.              mechanism is to be used."
  931.         ::= { docsIfUpstreamChannelEntry 9 }
  932.  
  933. docsIfUpChannelRangingBackoffEnd OBJECT-TYPE
  934.         SYNTAX      INTEGER (0..16)
  935.         MAX-ACCESS  read-write
  936.         STATUS      current
  937.  
  938.  
  939. Expires January 1998                                           [Page 16]
  940.  
  941. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  942.  
  943.  
  944.         DESCRIPTION
  945.             "The final random backoff window to use when retrying
  946.              Ranging Requests. Expressed as a power of 2. A value of 16
  947.              at the CMTS indicates that a proprietary adaptive retry
  948.              mechanism is to be used."
  949.         ::= { docsIfUpstreamChannelEntry 10 }
  950.  
  951. docsIfUpChannelTxBackoffStart OBJECT-TYPE
  952.         SYNTAX      INTEGER (0..16)
  953.         MAX-ACCESS  read-write
  954.         STATUS      current
  955.         DESCRIPTION
  956.             "The initial random backoff window to use when retrying
  957.              transmissions. Expressed as a power of 2. A value of 16
  958.              at the CMTS indicates that a proprietary adaptive retry
  959.              mechanism is to be used."
  960.         ::= { docsIfUpstreamChannelEntry 11 }
  961.  
  962. docsIfUpChannelTxBackoffEnd OBJECT-TYPE
  963.         SYNTAX      INTEGER (0..16)
  964.         MAX-ACCESS  read-write
  965.         STATUS      current
  966.         DESCRIPTION
  967.             "The final random backoff window to use when retrying
  968.              transmissions. Expressed as a power of 2. A value of 16
  969.              at the CMTS indicates that a proprietary adaptive retry
  970.              mechanism is to be used."
  971.         ::= { docsIfUpstreamChannelEntry 12 }
  972.  
  973. -- The following table describes the attributes of each class of
  974. -- service.
  975. -- The entries in this table are referenced from the
  976. -- docsIfServiceEntries.
  977. -- They exist as a separate table in order to reduce redundant
  978. -- information in docsIfServiceTable.
  979. --
  980. -- This table is implemented at both the CM and the CMTS.
  981. -- The CM need only maintain entries for the classes of service
  982. -- referenced by its docsIfServiceTable.
  983. --
  984.  
  985. docsIfQosProfileTable OBJECT-TYPE
  986.         SYNTAX      SEQUENCE OF DocsIfQosProfileEntry
  987.         MAX-ACCESS  not-accessible
  988.         STATUS      current
  989.         DESCRIPTION
  990.             "Describes the attributes for each class of service."
  991.         ::= { docsIfBaseObjects 3 }
  992.  
  993. docsIfQosProfileEntry OBJECT-TYPE
  994.         SYNTAX      DocsIfQosProfileEntry
  995.         MAX-ACCESS  not-accessible
  996.  
  997.  
  998. Expires January 1998                                           [Page 17]
  999.  
  1000. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1001.  
  1002.  
  1003.         STATUS      current
  1004.         DESCRIPTION
  1005.             "Describes the attributes for a single class of service.
  1006.              Entries in this table are created at CM registration time
  1007.              as required."
  1008.         INDEX { docsIfQosProfIndex }
  1009.         ::= { docsIfQosProfileTable 1 }
  1010.  
  1011. DocsIfQosProfileEntry ::= SEQUENCE {
  1012.         docsIfQosProfIndex                INTEGER,
  1013.         docsIfQosProfPriority             INTEGER,
  1014.         docsIfQosProfMaxUpBandwidth       INTEGER,
  1015.         docsIfQosProfGuarUpBandwidth      INTEGER,
  1016.         docsIfQosProfMaxDownBandwidth     INTEGER,
  1017.         docsIfQosProfMaxTxBurst           INTEGER
  1018.         }
  1019.  
  1020. docsIfQosProfIndex OBJECT-TYPE
  1021.         SYNTAX      INTEGER (1..2147483647)
  1022.         MAX-ACCESS  not-accessible
  1023.         STATUS      current
  1024.         DESCRIPTION
  1025.             "The index value which uniquely identifies an entry
  1026.              in the docsIfQosProfileTable."
  1027.         ::= { docsIfQosProfileEntry 1 }
  1028.  
  1029. docsIfQosProfPriority  OBJECT-TYPE
  1030.         SYNTAX      INTEGER (0..7)
  1031.         MAX-ACCESS  read-only
  1032.         STATUS      current
  1033.         DESCRIPTION
  1034.             "A relative priority assigned to this service when allocating
  1035.              bandwidth. Zero indicates lowest priority; seven highest.
  1036.              Interpretation of priority is device-specific."
  1037.         ::= { docsIfQosProfileEntry 2 }
  1038.  
  1039. docsIfQosProfMaxUpBandwidth OBJECT-TYPE
  1040.         SYNTAX      INTEGER (0..100000000)
  1041.         MAX-ACCESS  read-only
  1042.         STATUS      current
  1043.         DESCRIPTION
  1044.             "The maximum upstream bandwidth, in bits per second,
  1045.              allowed for a service with this service class.
  1046.              Zero if there is no restriction of upstream bandwidth."
  1047.         ::= { docsIfQosProfileEntry 3 }
  1048.  
  1049. docsIfQosProfGuarUpBandwidth OBJECT-TYPE
  1050.         SYNTAX      INTEGER (0..100000000)
  1051.         MAX-ACCESS  read-only
  1052.         STATUS      current
  1053.         DESCRIPTION
  1054.             "Minimum guaranteed upstream bandwidth, in bits per second,
  1055.  
  1056.  
  1057. Expires January 1998                                           [Page 18]
  1058.  
  1059. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1060.  
  1061.  
  1062.              allowed for a service with this service class."
  1063.         ::= { docsIfQosProfileEntry 4 }
  1064.  
  1065. docsIfQosProfMaxDownBandwidth OBJECT-TYPE
  1066.         SYNTAX      INTEGER (0..100000000)
  1067.         MAX-ACCESS  read-only
  1068.         STATUS      current
  1069.         DESCRIPTION
  1070.             "The maximum downstream bandwidth, in bits per second,
  1071.              allowed for a service with this service class.
  1072.              Zero if there is no restriction of downstream bandwidth."
  1073.         ::= { docsIfQosProfileEntry 5 }
  1074.  
  1075. docsIfQosProfMaxTxBurst OBJECT-TYPE
  1076.         SYNTAX      INTEGER (0..255)
  1077.         MAX-ACCESS  read-only
  1078.         STATUS      current
  1079.         DESCRIPTION
  1080.             "The maximum number of mini-slots that may be requested
  1081.              for a single upstream transmission.
  1082.              A value of zero means there is no limit."
  1083.         ::= { docsIfQosProfileEntry 6 }
  1084.  
  1085.  
  1086. docsIfSignalQualityTable OBJECT-TYPE
  1087.         SYNTAX      SEQUENCE OF DocsIfSignalQualityEntry
  1088.         MAX-ACCESS  not-accessible
  1089.         STATUS      current
  1090.         DESCRIPTION
  1091.             "At the CM, describes the PHY signal quality of downstream
  1092.              channels. At the CMTS, describes the PHY signal quality of
  1093.              upstream channels. At the CMTS, this table may exclude
  1094.              contention intervals."
  1095.         ::= { docsIfBaseObjects 4 }
  1096.  
  1097. docsIfSignalQualityEntry OBJECT-TYPE
  1098.         SYNTAX      DocsIfSignalQualityEntry
  1099.         MAX-ACCESS  not-accessible
  1100.         STATUS      current
  1101.         DESCRIPTION
  1102.             "At the CM, describes the PHY characteristics of a downstream
  1103.              channel. At the CMTS, describes the PHY signal quality of an
  1104.              upstream channel.
  1105.              An entry in this table exists for each ifEntry with an
  1106.              ifType of docsCableUpstream(xx) for Cable Modem Termination
  1107.              Systems and docsCableDownstream(xx) for Cable Modems."
  1108.         INDEX { ifIndex }
  1109.         ::= { docsIfSignalQualityTable 1 }
  1110.  
  1111. DocsIfSignalQualityEntry ::= SEQUENCE {
  1112.         docsIfSigQIncludesContention  TruthValue,
  1113.         docsIfSigQUnerroreds          Counter32,
  1114.  
  1115.  
  1116. Expires January 1998                                           [Page 19]
  1117.  
  1118. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1119.  
  1120.  
  1121.         docsIfSigQCorrecteds          Counter32,
  1122.         docsIfSigQUncorrectables      Counter32,
  1123.         docsIfSigQSignalNoise         TenthdBmV,
  1124.         docsIfSigQInChannelResponse   INTEGER,
  1125.         docsIfSigQMicroreflections    INTEGER
  1126. }
  1127.  
  1128. docsIfSigQIncludesContention OBJECT-TYPE
  1129.         SYNTAX      TruthValue
  1130.         MAX-ACCESS  read-only
  1131.         STATUS      current
  1132.         DESCRIPTION
  1133.             "true(1) if this CMTS includes contention intervals in
  1134.              the counters in this table. Always false(2) for CMs."
  1135.         ::= { docsIfSignalQualityEntry 1 }
  1136.  
  1137. docsIfSigQUnerroreds OBJECT-TYPE
  1138.         SYNTAX      Counter32
  1139.         MAX-ACCESS  read-only
  1140.         STATUS      current
  1141.         DESCRIPTION
  1142.             "Number of codewords received on this channel without error.
  1143.              This includes all codewords, whether or not they were part of
  1144.              frames destined for this device."
  1145.         ::= { docsIfSignalQualityEntry 2 }
  1146.  
  1147. docsIfSigQCorrecteds OBJECT-TYPE
  1148.         SYNTAX      Counter32
  1149.         MAX-ACCESS  read-only
  1150.         STATUS      current
  1151.         DESCRIPTION
  1152.             "Number of codewords received on this channel with correctable
  1153.              errors. This includes all codewords, whether or not they were
  1154.              part of frames destined for this device."
  1155.         ::= { docsIfSignalQualityEntry 3 }
  1156.  
  1157. docsIfSigQUncorrectables OBJECT-TYPE
  1158.         SYNTAX      Counter32
  1159.         MAX-ACCESS  read-only
  1160.         STATUS      current
  1161.         DESCRIPTION
  1162.             "Number of codewords received on this channel with uncorrectable
  1163.              errors. This includes all codewords, whether or not they were
  1164.              part of frames destined for this device."
  1165.         ::= { docsIfSignalQualityEntry 4 }
  1166.  
  1167. docsIfSigQSignalNoise OBJECT-TYPE
  1168.         SYNTAX      TenthdBmV
  1169.         MAX-ACCESS  read-only
  1170.         STATUS      current
  1171.         DESCRIPTION
  1172.             "Signal/Noise ratio as perceived for this channel.
  1173.  
  1174.  
  1175. Expires January 1998                                           [Page 20]
  1176.  
  1177. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1178.  
  1179.  
  1180.              Only meaningful in Cable Modems."
  1181.         ::= { docsIfSignalQualityEntry 5 }
  1182.  
  1183. docsIfSigQInChannelResponse OBJECT-TYPE
  1184.         SYNTAX      INTEGER {
  1185.             other(1),
  1186.             excellent(2),
  1187.             good(3),
  1188.             ok(4),
  1189.             fair(5),
  1190.             poor(6),
  1191.             unknown(7)
  1192.         }
  1193.         MAX-ACCESS  read-only
  1194.         STATUS      current
  1195.         DESCRIPTION
  1196.             "Provides a rough indication of the received in-channel
  1197.              response."
  1198.         ::= { docsIfSignalQualityEntry 6 }
  1199.  
  1200. docsIfSigQMicroreflections OBJECT-TYPE
  1201.         SYNTAX      INTEGER {
  1202.             other(1),
  1203.             excellent(2),
  1204.             good(3),
  1205.             ok(4),
  1206.             fair(5),
  1207.             poor(6),
  1208.             unknown(7)
  1209.         }
  1210.         MAX-ACCESS  read-only
  1211.         STATUS      current
  1212.         DESCRIPTION
  1213.             "Provides a rough indication of the (lack of) micro-
  1214.              reflections."
  1215.         ::= { docsIfSignalQualityEntry 7 }
  1216.  
  1217. --
  1218. -- CABLE MODEM GROUP
  1219. --
  1220.  
  1221. -- #######
  1222.  
  1223. --
  1224. -- The CM MAC Table
  1225. --
  1226.  
  1227. docsIfCmMacTable OBJECT-TYPE
  1228.         SYNTAX      SEQUENCE OF DocsIfCmMacEntry
  1229.         MAX-ACCESS  not-accessible
  1230.         STATUS      current
  1231.         DESCRIPTION
  1232.  
  1233.  
  1234. Expires January 1998                                           [Page 21]
  1235.  
  1236. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1237.  
  1238.  
  1239.             "Describes the attributes of each CM MAC interface, extending
  1240.              the information available from ifEntry. Mandatory for all Cable
  1241.              Modems."
  1242.         ::= { docsIfCmObjects 1 }
  1243.  
  1244. docsIfCmMacEntry OBJECT-TYPE
  1245.         SYNTAX      DocsIfCmMacEntry
  1246.         MAX-ACCESS  not-accessible
  1247.         STATUS      current
  1248.         DESCRIPTION
  1249.             "An entry containing objects describing attributes of each MAC
  1250.              entry, extending the information in ifEntry.
  1251.              An entry in this table exists for each ifEntry with an
  1252.              ifType of docsCableMaclayer(xx)."
  1253.         INDEX { ifIndex }
  1254.         ::= { docsIfCmMacTable 1 }
  1255.  
  1256. DocsIfCmMacEntry ::= SEQUENCE {
  1257.         docsIfCmCmtsAddress           MacAddress,
  1258.         docsIfCmCapabilities          BITS,
  1259.         docsIfCmRangingRespTimeout    TimeTicks
  1260.         }
  1261.  
  1262. docsIfCmCmtsAddress OBJECT-TYPE
  1263.         SYNTAX      MacAddress
  1264.         MAX-ACCESS  read-only
  1265.         STATUS      current
  1266.         DESCRIPTION
  1267.             "Identifies the CMTS that is believed to control this MAC
  1268.              domain. At the CM, this will be the source address from SYNC,
  1269.              MAP, and other MAC-layer messages. If the CMTS is unknown,
  1270.              returns 00-00-00-00-00-00."
  1271.         ::= { docsIfCmMacEntry 1 }
  1272.  
  1273. docsIfCmCapabilities OBJECT-TYPE
  1274.         SYNTAX      BITS {
  1275.             atmCells(0),
  1276.             concatenation(1)
  1277.         }
  1278.         MAX-ACCESS  read-only
  1279.         STATUS      current
  1280.         DESCRIPTION
  1281.             "Identifies the capabilities of the MAC implementation
  1282.              at this interface. Note that packet transmission is
  1283.              always supported. Therefore, there is no specific bit
  1284.              required to explicitely indicate this capability."
  1285.         ::= { docsIfCmMacEntry 2 }
  1286.  
  1287. docsIfCmRangingRespTimeout OBJECT-TYPE
  1288.         SYNTAX      TimeTicks
  1289.         MAX-ACCESS  read-write
  1290.         STATUS      current
  1291.  
  1292.  
  1293. Expires January 1998                                           [Page 22]
  1294.  
  1295. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1296.  
  1297.  
  1298.         DESCRIPTION
  1299.             "Waiting time for a Ranging Response packet."
  1300.         REFERENCE
  1301.             "Data over Cable Radio Frequency Interface specification,
  1302.              Section 7, timer T3"
  1303.         DEFVAL { 20 }
  1304.         ::= { docsIfCmMacEntry 3 }
  1305.  
  1306. --
  1307. -- CM status table.
  1308. -- This table is implemented only at the CM.
  1309. --
  1310.  
  1311. docsIfCmStatusTable OBJECT-TYPE
  1312.         SYNTAX      SEQUENCE OF DocsIfCmStatusEntry
  1313.         MAX-ACCESS  not-accessible
  1314.         STATUS      current
  1315.         DESCRIPTION
  1316.             "This table maintains a number of status objects
  1317.              and counters for Cable Modems."
  1318.         ::= { docsIfCmObjects 2 }
  1319.  
  1320. docsIfCmStatusEntry OBJECT-TYPE
  1321.         SYNTAX      DocsIfCmStatusEntry
  1322.         MAX-ACCESS  not-accessible
  1323.         STATUS      current
  1324.         DESCRIPTION
  1325.             "A set of status objects and counters for a single MAC
  1326.              layer instance in a Cable Modem.
  1327.              An entry in this table exists for each ifEntry with an
  1328.              ifType of docsCableMaclayer(xx)."
  1329.         INDEX { ifIndex }
  1330.         ::= { docsIfCmStatusTable 1 }
  1331.  
  1332. DocsIfCmStatusEntry ::= SEQUENCE {
  1333.         docsIfCmStatusValue             INTEGER,
  1334.         docsIfCmStatusCode              OCTET STRING,
  1335.         docsIfCmStatusTxPower           TenthdBmV,
  1336.         docsIfCmStatusResets            Counter32,
  1337.         docsIfCmStatusLostSyncs         Counter32,
  1338.         docsIfCmStatusInvalidMaps       Counter32,
  1339.         docsIfCmStatusInvalidUcds       Counter32,
  1340.         docsIfCmStatusT2Timeouts        Counter32,
  1341.         docsIfCmStatusT3Timeouts        Counter32,
  1342.         docsIfCmStatusT4Timeouts        Counter32,
  1343.         docsIfCmStatusRangingAborteds   Counter32
  1344.         }
  1345.  
  1346. docsIfCmStatusValue OBJECT-TYPE
  1347.         SYNTAX      INTEGER {
  1348.             other(1),
  1349.             notReady(2),
  1350.  
  1351.  
  1352. Expires January 1998                                           [Page 23]
  1353.  
  1354. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1355.  
  1356.  
  1357.             notSynchronized(3),
  1358.             phySynchronized(4),
  1359.             usParametersAcquired(5),
  1360.             rangingComplete(6),
  1361.             ipComplete(7),
  1362.             todEstablished(8),
  1363.             securityEstablished(9),
  1364.             paramTransferComplete(10),
  1365.             registrationComplete(11),
  1366.             operational(12),
  1367.             accessDenied(13)
  1368.         }
  1369.         MAX-ACCESS  read-only
  1370.         STATUS      current
  1371.         DESCRIPTION
  1372.             "Current Cable Modem connectivity state, as specified
  1373.              in the RF Interface Specification."
  1374.         REFERENCE
  1375.             "RF Interface Specification, Chapter 7.2"
  1376.         ::= { docsIfCmStatusEntry 1 }
  1377.  
  1378. docsIfCmStatusCode OBJECT-TYPE
  1379.         SYNTAX      OCTET STRING
  1380.         MAX-ACCESS  read-only
  1381.         STATUS      current
  1382.         DESCRIPTION
  1383.             "Status code for this Cable Modem as defined
  1384.              in Appendix A. The status code consists of a single
  1385.              character indicating error groups, followed by a two-
  1386.              or three-digit number indicating the status condition."
  1387.         ::= { docsIfCmStatusEntry 2 }
  1388.  
  1389. docsIfCmStatusTxPower OBJECT-TYPE
  1390.         SYNTAX      TenthdBmV
  1391.         MAX-ACCESS  read-only
  1392.         STATUS      current
  1393.         DESCRIPTION
  1394.             "The operational transmit power for the attached upstream
  1395.              channel."
  1396.         ::= { docsIfCmStatusEntry 3 }
  1397.  
  1398. docsIfCmStatusResets OBJECT-TYPE
  1399.         SYNTAX      Counter32
  1400.         MAX-ACCESS  read-only
  1401.         STATUS      current
  1402.         DESCRIPTION
  1403.             "Number of times the CM reset or initialized
  1404.              this interface."
  1405.         ::= { docsIfCmStatusEntry 4 }
  1406.  
  1407. docsIfCmStatusLostSyncs OBJECT-TYPE
  1408.         SYNTAX      Counter32
  1409.  
  1410.  
  1411. Expires January 1998                                           [Page 24]
  1412.  
  1413. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1414.  
  1415.  
  1416.         MAX-ACCESS  read-only
  1417.         STATUS      current
  1418.         DESCRIPTION
  1419.             "Number of times the CM lost synchronization with
  1420.              the downstream channel."
  1421.         ::= { docsIfCmStatusEntry 5 }
  1422.  
  1423. docsIfCmStatusInvalidMaps OBJECT-TYPE
  1424.         SYNTAX      Counter32
  1425.         MAX-ACCESS  read-only
  1426.         STATUS      current
  1427.         DESCRIPTION
  1428.             "Number of times the CM received invalid MAP messages."
  1429.         ::= { docsIfCmStatusEntry 6 }
  1430.  
  1431. docsIfCmStatusInvalidUcds OBJECT-TYPE
  1432.         SYNTAX      Counter32
  1433.         MAX-ACCESS  read-only
  1434.         STATUS      current
  1435.         DESCRIPTION
  1436.             "Number of times the CM received invalid UCD messages."
  1437.         ::= { docsIfCmStatusEntry 7 }
  1438.  
  1439. docsIfCmStatusT2Timeouts OBJECT-TYPE
  1440.         SYNTAX      Counter32
  1441.         MAX-ACCESS  read-only
  1442.         STATUS      current
  1443.         DESCRIPTION
  1444.             "Number of times counter T2 expired in the CM."
  1445.         ::= { docsIfCmStatusEntry 8 }
  1446.  
  1447. docsIfCmStatusT3Timeouts OBJECT-TYPE
  1448.         SYNTAX      Counter32
  1449.         MAX-ACCESS  read-only
  1450.         STATUS      current
  1451.         DESCRIPTION
  1452.             "Number of times counter T3 expired in the CM."
  1453.         ::= { docsIfCmStatusEntry 9 }
  1454.  
  1455. docsIfCmStatusT4Timeouts OBJECT-TYPE
  1456.         SYNTAX      Counter32
  1457.         MAX-ACCESS  read-only
  1458.         STATUS      current
  1459.         DESCRIPTION
  1460.             "Number of times counter T4 expired in the CM."
  1461.         ::= { docsIfCmStatusEntry 10 }
  1462.  
  1463. docsIfCmStatusRangingAborteds OBJECT-TYPE
  1464.         SYNTAX      Counter32
  1465.         MAX-ACCESS  read-only
  1466.         STATUS      current
  1467.         DESCRIPTION
  1468.  
  1469.  
  1470. Expires January 1998                                           [Page 25]
  1471.  
  1472. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1473.  
  1474.  
  1475.             "Number of times the ranging process was aborted
  1476.              by the CMTS."
  1477.         ::= { docsIfCmStatusEntry 11 }
  1478.  
  1479. --
  1480. -- The Cable Modem Service Table
  1481. --
  1482.  
  1483. docsIfCmServiceTable  OBJECT-TYPE
  1484.         SYNTAX      SEQUENCE OF DocsIfCmServiceEntry
  1485.         MAX-ACCESS  not-accessible
  1486.         STATUS      current
  1487.         DESCRIPTION
  1488.             "Describes the attributes of each upstream service queue
  1489.              on a CM."
  1490.         ::= { docsIfCmObjects 3 }
  1491.  
  1492. docsIfCmServiceEntry OBJECT-TYPE
  1493.         SYNTAX      DocsIfCmServiceEntry
  1494.         MAX-ACCESS  not-accessible
  1495.         STATUS      current
  1496.         DESCRIPTION
  1497.             "Describes the attributes of an upstream bandwidth service
  1498.              queue.
  1499.              An entry in this table exists for each Service ID.
  1500.              The primary index is an ifIndex with an ifType of
  1501.              docsCableMaclayer(xx)."
  1502.         INDEX { ifIndex, docsIfCmServiceId }
  1503.         ::= { docsIfCmServiceTable 1 }
  1504.  
  1505. DocsIfCmServiceEntry ::= SEQUENCE {
  1506.         docsIfCmServiceId               INTEGER,
  1507.         docsIfCmServiceQosProfile       INTEGER,
  1508.         docsIfCmServiceTxSlotsImmed     Counter32,
  1509.         docsIfCmServiceTxSlotsDed       Counter32,
  1510.         docsIfCmServiceTxRetries        Counter32,
  1511.         docsIfCmServiceTxExceeded       Counter32,
  1512.         docsIfCmServiceRqRetries        Counter32,
  1513.         docsIfCmServiceRqExceeded       Counter32
  1514. }
  1515.  
  1516. docsIfCmServiceId OBJECT-TYPE
  1517.         SYNTAX      INTEGER (1..16383)
  1518.         MAX-ACCESS  not-accessible
  1519.         STATUS      current
  1520.         DESCRIPTION
  1521.             "Identifies a service queue for upstream bandwidth. The
  1522.              attributes of this service queue are shared between the CM and
  1523.              the CMTS. The CMTS allocates upstream bandwidth to this service
  1524.              queue based on requests from the CM and on the class of service
  1525.              associated with this queue."
  1526.         ::= { docsIfCmServiceEntry 1 }
  1527.  
  1528.  
  1529. Expires January 1998                                           [Page 26]
  1530.  
  1531. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1532.  
  1533.  
  1534. docsIfCmServiceQosProfile OBJECT-TYPE
  1535.         SYNTAX      INTEGER (1..2147483647)
  1536.         MAX-ACCESS  read-only
  1537.         STATUS      current
  1538.         DESCRIPTION
  1539.             "The index in docsIfQosProfileTable describing the quality of
  1540.              service attributes associated with this particular service."
  1541.         ::= { docsIfCmServiceEntry 2 }
  1542.  
  1543. docsIfCmServiceTxSlotsImmed OBJECT-TYPE
  1544.         SYNTAX      Counter32
  1545.         MAX-ACCESS  read-only
  1546.         STATUS      current
  1547.         DESCRIPTION
  1548.             "The number of upstream mini-slots which have been used to
  1549.              transmit data PDUs in immediate (contention) mode. This includes
  1550.              only those PDUs which are presumed to have arrived at the head-
  1551.              end (i.e., those which were explicitly acknowledged.) It does
  1552.              not include  retransmission attempts or mini-slots used by
  1553.              Requests."
  1554.         ::= { docsIfCmServiceEntry 3 }
  1555.  
  1556. docsIfCmServiceTxSlotsDed OBJECT-TYPE
  1557.         SYNTAX      Counter32
  1558.         MAX-ACCESS  read-only
  1559.         STATUS      current
  1560.         DESCRIPTION
  1561.             "The number of upstream mini-slots which have been used to
  1562.              transmit data PDUs in dedicated mode (i.e., as a result of a
  1563.              unicast Data Grant)."
  1564.         ::= { docsIfCmServiceEntry 4 }
  1565.  
  1566. docsIfCmServiceTxRetries OBJECT-TYPE
  1567.         SYNTAX      Counter32
  1568.         MAX-ACCESS  read-only
  1569.         STATUS      current
  1570.         DESCRIPTION
  1571.             "The number of attempts to transmit data PDUs containing
  1572.              requests for acknowledgment which did not result in
  1573.              acknowledgment."
  1574.         ::= { docsIfCmServiceEntry 5 }
  1575.  
  1576. docsIfCmServiceTxExceeded OBJECT-TYPE
  1577.         SYNTAX      Counter32
  1578.         MAX-ACCESS  read-only
  1579.         STATUS      current
  1580.         DESCRIPTION
  1581.             "The number of data PDUs transmission failures due to excessive
  1582.              retries without acknowledgment."
  1583.         ::= { docsIfCmServiceEntry 6 }
  1584.  
  1585. docsIfCmServiceRqRetries OBJECT-TYPE
  1586.  
  1587.  
  1588. Expires January 1998                                           [Page 27]
  1589.  
  1590. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1591.  
  1592.  
  1593.         SYNTAX      Counter32
  1594.         MAX-ACCESS  read-only
  1595.         STATUS      current
  1596.         DESCRIPTION
  1597.             "The number of attempts to transmit bandwidth requests which did
  1598.              not result in acknowledgment."
  1599.         ::= { docsIfCmServiceEntry 7 }
  1600.  
  1601. docsIfCmServiceRqExceeded OBJECT-TYPE
  1602.         SYNTAX      Counter32
  1603.         MAX-ACCESS  read-only
  1604.         STATUS      current
  1605.         DESCRIPTION
  1606.             "The number of requests for bandwidth which failed due to
  1607.              excessive retries without acknowledgment."
  1608.         ::= { docsIfCmServiceEntry 8 }
  1609.  
  1610. --
  1611. -- CMTS GROUP
  1612. --
  1613.  
  1614. --
  1615. -- The CMTS MAC Table
  1616. --
  1617.  
  1618. docsIfCmtsMacTable OBJECT-TYPE
  1619.         SYNTAX      SEQUENCE OF DocsIfCmtsMacEntry
  1620.         MAX-ACCESS  not-accessible
  1621.         STATUS      current
  1622.         DESCRIPTION
  1623.             "Describes the attributes of each CMTS MAC interface, extending
  1624.              the information available from ifEntry. Mandatory for all CMTS
  1625.              devices."
  1626.         ::= { docsIfCmtsObjects 1 }
  1627.  
  1628. docsIfCmtsMacEntry OBJECT-TYPE
  1629.         SYNTAX      DocsIfCmtsMacEntry
  1630.         MAX-ACCESS  not-accessible
  1631.         STATUS      current
  1632.         DESCRIPTION
  1633.             "An entry containing objects describing attributes of each MAC
  1634.              entry, extending the information in ifEntry.
  1635.              An entry in this table exists for each ifEntry with an
  1636.              ifType of docsCableMaclayer(xx)."
  1637.         INDEX { ifIndex }
  1638.         ::= { docsIfCmtsMacTable 1 }
  1639.  
  1640. DocsIfCmtsMacEntry ::= SEQUENCE {
  1641.         docsIfCmtsCapabilities            BITS,
  1642.         docsIfCmtsSyncInterval            INTEGER,
  1643.         docsIfCmtsUcdInterval             INTEGER,
  1644.         docsIfCmtsMaxServiceIds           INTEGER,
  1645.  
  1646.  
  1647. Expires January 1998                                           [Page 28]
  1648.  
  1649. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1650.  
  1651.  
  1652.         docsIfCmtsInsertionInterval       INTEGER,
  1653.         docsIfCmtsInvitedRangingAttempts  INTEGER
  1654.         }
  1655.  
  1656. docsIfCmtsCapabilities OBJECT-TYPE
  1657.         SYNTAX      BITS {
  1658.             atmCells(0),
  1659.             concatenation(1)
  1660.         }
  1661.         MAX-ACCESS  read-only
  1662.         STATUS      current
  1663.         DESCRIPTION
  1664.             "Identifies the capabilities of the CMTS MAC
  1665.              implementation at this interface. Note that packet
  1666.              transmission is always supported. Therefore, there
  1667.              is no specific bit required to explicitely indicate
  1668.              this capability."
  1669.         ::= { docsIfCmtsMacEntry 1 }
  1670.  
  1671. docsIfCmtsSyncInterval OBJECT-TYPE
  1672.         SYNTAX      INTEGER (1..200)
  1673.         UNITS       "Milliseconds"
  1674.         MAX-ACCESS  read-write
  1675.         STATUS      current
  1676.         DESCRIPTION
  1677.             "The interval between CMTS transmission of successive SYNC
  1678.              messages at this interface."
  1679.         REFERENCE
  1680.             "Data Over Cable Radio Frequency Interface Specification,
  1681.              [6], Sync Interval."
  1682.         ::= { docsIfCmtsMacEntry 2 }
  1683.  
  1684. docsIfCmtsUcdInterval OBJECT-TYPE
  1685.         SYNTAX      INTEGER (1..2000)
  1686.         UNITS       "Milliseconds"
  1687.         MAX-ACCESS  read-write
  1688.         STATUS      current
  1689.         DESCRIPTION
  1690.             "The interval between CMTS transmission of successive
  1691.              Upstream Channel Descriptor messages for each upstream
  1692.              channel at this interface."
  1693.         REFERENCE
  1694.             "Data Over Cable Radio Frequency Interface Specification,
  1695.              [6], UCD Interval."
  1696.         ::= { docsIfCmtsMacEntry 3 }
  1697.  
  1698. docsIfCmtsMaxServiceIds OBJECT-TYPE
  1699.         SYNTAX     INTEGER (1..16383)
  1700.         MAX-ACCESS read-only
  1701.         STATUS     current
  1702.         DESCRIPTION
  1703.             "The maximum number of service IDs that may be
  1704.  
  1705.  
  1706. Expires January 1998                                           [Page 29]
  1707.  
  1708. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1709.  
  1710.  
  1711.              simultaneously active."
  1712.         ::= { docsIfCmtsMacEntry 4 }
  1713.  
  1714. docsIfCmtsInsertionInterval OBJECT-TYPE
  1715.         SYNTAX      INTEGER(0..160000)
  1716.         MAX-ACCESS  read-write
  1717.         STATUS      current
  1718.         DESCRIPTION
  1719.             "The number of mini-slots to elapse between each broadcast
  1720.              station maintenance grant. Broadcast station maintenance
  1721.              grants are used to allow new cable modems to join the
  1722.              network. Zero indicates that a vendor-specific algorithm
  1723.              is used instead of a fixed number. Maximum amount of time
  1724.              permitted by the specification is 2 seconds, or 160,000
  1725.              mini-slots at a symbol rate of 2.56 Msym/s."
  1726.         REFERENCE
  1727.             "Data Over Cable Radio Frequency Interface Specification,
  1728.              [6], Ranging Interval."
  1729.         ::= { docsIfCmtsMacEntry 5 }
  1730.  
  1731. docsIfCmtsInvitedRangingAttempts OBJECT-TYPE
  1732.         SYNTAX      INTEGER (0..1024)
  1733.         MAX-ACCESS  read-write
  1734.         STATUS      current
  1735.         DESCRIPTION
  1736.             "The maximum number of attempts to make on invitations
  1737.              for ranging requests. A value of zero means the syatem
  1738.              should attempt to range forever."
  1739.         ::= { docsIfCmtsMacEntry 6 }
  1740.  
  1741. --
  1742. -- CMTS status table.
  1743. --
  1744.  
  1745. docsIfCmtsStatusTable OBJECT-TYPE
  1746.         SYNTAX      SEQUENCE OF DocsIfCmtsStatusEntry
  1747.         MAX-ACCESS  not-accessible
  1748.         STATUS      current
  1749.         DESCRIPTION
  1750.             "For the MAC layer, this group maintains a number of
  1751.              status objects and counters."
  1752.         ::= { docsIfCmtsObjects 2 }
  1753.  
  1754. docsIfCmtsStatusEntry OBJECT-TYPE
  1755.         SYNTAX      DocsIfCmtsStatusEntry
  1756.         MAX-ACCESS  not-accessible
  1757.         STATUS      current
  1758.         DESCRIPTION
  1759.             "Status entry for a single MAC layer.
  1760.              An entry in this table exists for each ifEntry with an
  1761.              ifType of docsCableMaclayer(xx)."
  1762.         INDEX { ifIndex }
  1763.  
  1764.  
  1765. Expires January 1998                                           [Page 30]
  1766.  
  1767. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1768.  
  1769.  
  1770.         ::= { docsIfCmtsStatusTable 1 }
  1771.  
  1772. DocsIfCmtsStatusEntry ::= SEQUENCE {
  1773.         docsIfCmtsStatusInvalidRangeReqs        Counter32,
  1774.         docsIfCmtsStatusRangingAborteds         Counter32,
  1775.         docsIfCmtsStatusInvalidRegReqs          Counter32,
  1776.         docsIfCmtsStatusFailedRegReqs           Counter32,
  1777.         docsIfCmtsStatusInvalidDataReqs         Counter32
  1778. }
  1779.  
  1780. docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE
  1781.         SYNTAX      Counter32
  1782.         MAX-ACCESS  read-only
  1783.         STATUS      current
  1784.         DESCRIPTION
  1785.             "This object counts invalid RNG-REQ messages received on
  1786.              this interface."
  1787.         ::= { docsIfCmtsStatusEntry 1 }
  1788.  
  1789. docsIfCmtsStatusRangingAborteds OBJECT-TYPE
  1790.         SYNTAX      Counter32
  1791.         MAX-ACCESS  read-only
  1792.         STATUS      current
  1793.         DESCRIPTION
  1794.             "This object counts ranging attempts that were explicitely
  1795.              aborted by the CMTS."
  1796.         ::= { docsIfCmtsStatusEntry 2 }
  1797.  
  1798. docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE
  1799.         SYNTAX      Counter32
  1800.         MAX-ACCESS  read-only
  1801.         STATUS      current
  1802.         DESCRIPTION
  1803.             "This object counts invalid REG-REQ messages received on
  1804.              this interface."
  1805.         ::= { docsIfCmtsStatusEntry 3 }
  1806.  
  1807. docsIfCmtsStatusFailedRegReqs OBJECT-TYPE
  1808.         SYNTAX      Counter32
  1809.         MAX-ACCESS  read-only
  1810.         STATUS      current
  1811.         DESCRIPTION
  1812.             "This object counts failed registration attempts, i.e.,
  1813.              authentication failures and class of service failures,
  1814.              on this interface."
  1815.         ::= { docsIfCmtsStatusEntry 4 }
  1816.  
  1817. docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE
  1818.         SYNTAX      Counter32
  1819.         MAX-ACCESS  read-only
  1820.         STATUS      current
  1821.         DESCRIPTION
  1822.  
  1823.  
  1824. Expires January 1998                                           [Page 31]
  1825.  
  1826. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1827.  
  1828.  
  1829.             "This object counts invalid data request messages
  1830.              received on this interface."
  1831.         ::= { docsIfCmtsStatusEntry 5 }
  1832.  
  1833. --
  1834. -- CM status table (within CMTS).
  1835. -- This table is implemented only at the CMTS.
  1836. -- It contains per CM status information available in the CMTS.
  1837. --
  1838.  
  1839. docsIfCmtsCmStatusTable OBJECT-TYPE
  1840.         SYNTAX      SEQUENCE OF DocsIfCmtsCmStatusEntry
  1841.         MAX-ACCESS  not-accessible
  1842.         STATUS      current
  1843.         DESCRIPTION
  1844.             "A set of objects in the CMTS, maintained for each
  1845.              Cable Modem connected to this CMTS."
  1846.         ::= { docsIfCmtsObjects 3 }
  1847.  
  1848. docsIfCmtsCmStatusEntry OBJECT-TYPE
  1849.         SYNTAX      DocsIfCmtsCmStatusEntry
  1850.         MAX-ACCESS  not-accessible
  1851.         STATUS      current
  1852.         DESCRIPTION
  1853.             "Status information for a single Cable Modem.
  1854.              An entry in this table exists for each Cable Modem
  1855.              that is connected to the CMTS implementing this table."
  1856.         INDEX { docsIfCmtsCmStatusIndex }
  1857.         ::= { docsIfCmtsCmStatusTable 1 }
  1858.  
  1859. DocsIfCmtsCmStatusEntry ::= SEQUENCE {
  1860.         docsIfCmtsCmStatusIndex                 INTEGER,
  1861.         docsIfCmtsCmStatusMacAddress            MacAddress,
  1862.         docsIfCmtsCmStatusIpAddress             IpAddress,
  1863.         docsIfCmtsCmStatusDownChannelIfIndex    InterfaceIndexOrZero,
  1864.         docsIfCmtsCmStatusUpChannelIfIndex      InterfaceIndexOrZero,
  1865.         docsIfCmtsCmStatusRxPower               TenthdBmV,
  1866.         docsIfCmtsCmStatusTimingOffset          Unsigned32,
  1867.         docsIfCmtsCmStatusEqualizationData      OCTET STRING
  1868. }
  1869.  
  1870. docsIfCmtsCmStatusIndex OBJECT-TYPE
  1871.         SYNTAX      INTEGER (1..2147483647)
  1872.         MAX-ACCESS  not-accessible
  1873.         STATUS      current
  1874.         DESCRIPTION
  1875.             "Index value to uniquely identify an entry in this table.
  1876.              For an individual Cable Modem, this index value should
  1877.              not change during CMTS uptime."
  1878.         ::= { docsIfCmtsCmStatusEntry 1 }
  1879.  
  1880. docsIfCmtsCmStatusMacAddress OBJECT-TYPE
  1881.  
  1882.  
  1883. Expires January 1998                                           [Page 32]
  1884.  
  1885. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1886.  
  1887.  
  1888.         SYNTAX      MacAddress
  1889.         MAX-ACCESS  read-only
  1890.         STATUS      current
  1891.         DESCRIPTION
  1892.             "MAC address of this Cable Modem. If the Cable Modem has
  1893.              multiple MAC addresses, this is the MAC address associated
  1894.              with the Cable interface."
  1895.         ::= { docsIfCmtsCmStatusEntry 2 }
  1896.  
  1897. docsIfCmtsCmStatusIpAddress OBJECT-TYPE
  1898.         SYNTAX      IpAddress
  1899.         MAX-ACCESS  read-only
  1900.         STATUS      current
  1901.         DESCRIPTION
  1902.             "IP address of this Cable Modem. If the Cable Modem has no
  1903.              IP address assigned, or the IP address is unknown, this
  1904.              object returns a value of 0.0.0.0. If the Cable Modem has
  1905.              multiple IP addresses, this object returns the IP address
  1906.              associated with the Cable interface."
  1907.         ::= { docsIfCmtsCmStatusEntry 3 }
  1908.  
  1909. docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE
  1910.         SYNTAX      InterfaceIndexOrZero
  1911.         MAX-ACCESS  read-only
  1912.         STATUS      current
  1913.         DESCRIPTION
  1914.             "IfIndex of the downstream channel this CM is connected
  1915.              to. If the downstream channel is unknown, this object
  1916.              returns a value of zero."
  1917.         ::= { docsIfCmtsCmStatusEntry 4 }
  1918.  
  1919. docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE
  1920.         SYNTAX      InterfaceIndexOrZero
  1921.         MAX-ACCESS  read-only
  1922.         STATUS      current
  1923.         DESCRIPTION
  1924.             "IfIndex of the upstream channel this CM is connected
  1925.              to. If the upstream channel is unknown, this object
  1926.              returns a value of zero."
  1927.         ::= { docsIfCmtsCmStatusEntry 5 }
  1928.  
  1929. docsIfCmtsCmStatusRxPower OBJECT-TYPE
  1930.         SYNTAX      TenthdBmV
  1931.         MAX-ACCESS  read-only
  1932.         STATUS      current
  1933.         DESCRIPTION
  1934.             "The receive power as percieved for upstream data from
  1935.              this Cable Modem.
  1936.              If the receive power is unknown, this object returns
  1937.              a value of zero."
  1938.         ::= { docsIfCmtsCmStatusEntry 6 }
  1939.  
  1940.  
  1941.  
  1942. Expires January 1998                                           [Page 33]
  1943.  
  1944. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  1945.  
  1946.  
  1947. docsIfCmtsCmStatusTimingOffset OBJECT-TYPE
  1948.         SYNTAX      Unsigned32
  1949.         MAX-ACCESS  read-only
  1950.         STATUS      current
  1951.         DESCRIPTION
  1952.             "A measure of the current round trip time for this CM.
  1953.              Used for timing of CM upstream transmissions to ensure
  1954.              synchronized arrivals at the CMTS. Units are in terms
  1955.              of (6.25 microseconds/64). Returns zero if the value
  1956.              is unknown."
  1957.         ::= { docsIfCmtsCmStatusEntry 7 }
  1958.  
  1959. docsIfCmtsCmStatusEqualizationData OBJECT-TYPE
  1960.         SYNTAX      OCTET STRING
  1961.         MAX-ACCESS  read-only
  1962.         STATUS      current
  1963.         DESCRIPTION
  1964.             "Equalization data for this CM. Returns an empty string
  1965.              if the value is unknown or if there is no equalization
  1966.              data available or defined."
  1967.         ::= { docsIfCmtsCmStatusEntry 8 }
  1968.  
  1969. --
  1970. -- The CMTS Service Table.
  1971. --
  1972.  
  1973. docsIfCmtsServiceTable OBJECT-TYPE
  1974.         SYNTAX      SEQUENCE OF DocsIfCmtsServiceEntry
  1975.         MAX-ACCESS  not-accessible
  1976.         STATUS      current
  1977.         DESCRIPTION
  1978.             "Describes the attributes of upstream service queues
  1979.              in a Cable Modem Termination System."
  1980.         ::= { docsIfCmtsObjects 4 }
  1981.  
  1982. docsIfCmtsServiceEntry OBJECT-TYPE
  1983.         SYNTAX      DocsIfCmtsServiceEntry
  1984.         MAX-ACCESS  not-accessible
  1985.         STATUS      current
  1986.         DESCRIPTION
  1987.             "Describes the attributes of a single upstream bandwidth
  1988.              service queue.
  1989.              Entries in this table exist for each ifEntry with an
  1990.              ifType of docsCableMaclayer(xx), and for each service
  1991.              queue (Service ID) within this MAC layer.
  1992.              Entries in this table are created with the creation of
  1993.              individual Service IDs by the MAC layer and removed
  1994.              when a Service ID is removed."
  1995.         INDEX { ifIndex, docsIfCmtsServiceId }
  1996.         ::= { docsIfCmtsServiceTable 1 }
  1997.  
  1998. DocsIfCmtsServiceEntry ::= SEQUENCE {
  1999.  
  2000.  
  2001. Expires January 1998                                           [Page 34]
  2002.  
  2003. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2004.  
  2005.  
  2006.         docsIfCmtsServiceId               INTEGER,
  2007.         docsIfCmtsServiceCmStatusIndex    INTEGER,
  2008.         docsIfCmtsServiceAdminStatus      INTEGER,
  2009.         docsIfCmtsServiceQosProfile       Integer32,
  2010.         docsIfCmtsServiceCreateTime       TimeTicks,
  2011.         docsIfCmtsServiceInOctets         Counter32,
  2012.         docsIfCmtsServiceInPackets        Counter32
  2013.         }
  2014.  
  2015. docsIfCmtsServiceId OBJECT-TYPE
  2016.         SYNTAX      INTEGER (1..16383)
  2017.         MAX-ACCESS  not-accessible
  2018.         STATUS      current
  2019.         DESCRIPTION
  2020.             "Identifies a service queue for upstream bandwidth. The
  2021.              attributes of this service queue are shared between the
  2022.              Cable Modem and the Cable Modem Termination System.
  2023.              The CMTS allocates upstream bandwidth to this service
  2024.              queue based on requests from the CM and on the class of
  2025.              service associated with this queue."
  2026.         ::= { docsIfCmtsServiceEntry 1 }
  2027.  
  2028. docsIfCmtsServiceCmStatusIndex OBJECT-TYPE
  2029.         SYNTAX      INTEGER (0..2147483647)
  2030.         MAX-ACCESS  read-only
  2031.         STATUS      current
  2032.         DESCRIPTION
  2033.             "Pointer to an entry in docsIfCmtsCmStatusTable identifying
  2034.              the Cable Modem using this Service Queue. If multiple
  2035.              Cable Modems are using this Service queue, the value of
  2036.              this object is zero."
  2037.         ::= { docsIfCmtsServiceEntry 2 }
  2038.  
  2039. docsIfCmtsServiceAdminStatus OBJECT-TYPE
  2040.         SYNTAX      INTEGER {
  2041.             enabled(1),
  2042.             disabled(2),
  2043.             destroyed(3) }
  2044.         MAX-ACCESS  read-write
  2045.         STATUS      current
  2046.         DESCRIPTION
  2047.             "Allows a service class for a particular modem to be
  2048.              suppressed, (re-)enabled, or deleted altogether."
  2049.         ::= { docsIfCmtsServiceEntry 3 }
  2050.  
  2051. docsIfCmtsServiceQosProfile OBJECT-TYPE
  2052.         SYNTAX      Integer32
  2053.         MAX-ACCESS  read-only
  2054.         STATUS      current
  2055.         DESCRIPTION
  2056.             "The index in docsIfQosProfileTable describing the quality of
  2057.              service attributes associated with this particular service."
  2058.  
  2059.  
  2060. Expires January 1998                                           [Page 35]
  2061.  
  2062. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2063.  
  2064.  
  2065.         ::= { docsIfCmtsServiceEntry 4 }
  2066.  
  2067. docsIfCmtsServiceCreateTime OBJECT-TYPE
  2068.         SYNTAX      TimeTicks
  2069.         MAX-ACCESS  read-only
  2070.         STATUS      current
  2071.         DESCRIPTION
  2072.             "The value of sysUpTime when this entry was created."
  2073.         ::= { docsIfCmtsServiceEntry 5 }
  2074.  
  2075. docsIfCmtsServiceInOctets OBJECT-TYPE
  2076.         SYNTAX      Counter32
  2077.         MAX-ACCESS  read-only
  2078.         STATUS      current
  2079.         DESCRIPTION
  2080.             "The cumulative number of data octets received on this
  2081.              Service ID."
  2082.         ::= { docsIfCmtsServiceEntry 6 }
  2083.  
  2084. docsIfCmtsServiceInPackets OBJECT-TYPE
  2085.         SYNTAX      Counter32
  2086.         MAX-ACCESS  read-only
  2087.         STATUS      current
  2088.         DESCRIPTION
  2089.             "The cumulative number of data packets received on this
  2090.              Service ID."
  2091.         ::= { docsIfCmtsServiceEntry 7 }
  2092.  
  2093. --
  2094. -- The following table provides upstream channel modulation profiles.
  2095. -- Entries in this table can be
  2096. -- re-used by one or more upstream channels. An upstream channel will
  2097. -- have a modulation profile
  2098. -- for each value of docsIfModIntervalUsageCode.
  2099. --
  2100.  
  2101. docsIfCmtsModulationTable OBJECT-TYPE
  2102.         SYNTAX      SEQUENCE OF DocsIfCmtsModulationEntry
  2103.         MAX-ACCESS  not-accessible
  2104.         STATUS      current
  2105.         DESCRIPTION
  2106.             "Describes a modulation profile associated with one or more
  2107.              upstream channels."
  2108.         ::= { docsIfCmtsObjects 5 }
  2109.  
  2110. docsIfCmtsModulationEntry OBJECT-TYPE
  2111.         SYNTAX      DocsIfCmtsModulationEntry
  2112.         MAX-ACCESS  not-accessible
  2113.         STATUS      current
  2114.         DESCRIPTION
  2115.             "Describes a modulation profile for an Interval Usage Code
  2116.              for one or more upstream channels.
  2117.  
  2118.  
  2119. Expires January 1998                                           [Page 36]
  2120.  
  2121. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2122.  
  2123.  
  2124.              Entries in this table are created by the operator. Initial
  2125.              default entries may be created at system initialization
  2126.              time. No individual objects have to be specified in order
  2127.              to create an entry in this table."
  2128.         INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode }
  2129.         ::= { docsIfCmtsModulationTable 1 }
  2130.  
  2131. DocsIfCmtsModulationEntry ::= SEQUENCE {
  2132.         docsIfCmtsModIndex                    INTEGER,
  2133.         docsIfCmtsModIntervalUsageCode        INTEGER,
  2134.         docsIfCmtsModControl                  RowStatus,
  2135.         docsIfCmtsModType                     INTEGER,
  2136. --        docsIfCmtsModPreambleStart            INTEGER,
  2137.         docsIfCmtsModPreambleLen              INTEGER,
  2138.         docsIfCmtsModDifferentialEncoding     TruthValue,
  2139.         docsIfCmtsModFECErrorCorrection       INTEGER,
  2140.         docsIfCmtsModFECCodewordLength        INTEGER,
  2141.         docsIfCmtsModScramblerSeed            INTEGER,
  2142.         docsIfCmtsModMaxBurstSize             INTEGER,
  2143.         docsIfCmtsModGuardTimeSize            Unsigned32,
  2144.         docsIfCmtsModLastCodewordShortened    TruthValue,
  2145.         docsIfCmtsModScrambler                TruthValue
  2146.         }
  2147.  
  2148. docsIfCmtsModIndex OBJECT-TYPE
  2149.         SYNTAX       INTEGER (1..2147483647)
  2150.         MAX-ACCESS   not-accessible
  2151.         STATUS      current
  2152.         DESCRIPTION
  2153.              "An index into the Channel Modulation table representing a group
  2154.               of Interval Usage Codes, all associated with the same channel."
  2155.         ::= { docsIfCmtsModulationEntry 1 }
  2156.  
  2157. docsIfCmtsModIntervalUsageCode OBJECT-TYPE
  2158.         SYNTAX       INTEGER {
  2159.             request(1),
  2160.             requestData(2),
  2161.             initialRanging(3),
  2162.             periodicRanging(4),
  2163.             shortData(5),
  2164.             longData(6)
  2165.         }
  2166.         MAX-ACCESS  not-accessible
  2167.         STATUS      current
  2168.         DESCRIPTION
  2169.             "An index into the Channel Modulation table which, when grouped
  2170.              with other Interval Usage Codes, fully instantiate all
  2171.              modulation sets for a given upstream channel."
  2172.         ::= { docsIfCmtsModulationEntry 2 }
  2173.  
  2174. docsIfCmtsModControl OBJECT-TYPE
  2175.         SYNTAX      RowStatus
  2176.  
  2177.  
  2178. Expires January 1998                                           [Page 37]
  2179.  
  2180. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2181.  
  2182.  
  2183.         MAX-ACCESS  read-create
  2184.         STATUS      current
  2185.         DESCRIPTION
  2186.             "Controls and reflects the status of rows in this table."
  2187.         ::= { docsIfCmtsModulationEntry 3 }
  2188.  
  2189. docsIfCmtsModType OBJECT-TYPE
  2190.         SYNTAX      INTEGER {
  2191.             other(1),
  2192.             qpsk(2),
  2193.             qam16(3)
  2194.         }
  2195.         MAX-ACCESS  read-create
  2196.         STATUS      current
  2197.         DESCRIPTION
  2198.             "The modulation type used on this channel."
  2199.         DEFVAL { qpsk }
  2200.         ::= { docsIfCmtsModulationEntry 4 }
  2201.  
  2202. -- Editor's note:
  2203. -- after thinking about this further, only the preamble length
  2204. -- should be specified. It should be up to the implementation
  2205. -- to select a sufficient start offset for any given length.
  2206. --
  2207. -- docsIfCmtsModPreambleStart OBJECT-TYPE
  2208. --         SYNTAX      INTEGER (0..1023)
  2209. --         MAX-ACCESS  read-create
  2210. --         STATUS      current
  2211. --         DESCRIPTION
  2212. --             "The starting bit offset into the preamble string
  2213. --              to be used for the preamble for this modulation profile."
  2214. --         DEFVAL { 0 }
  2215. --         ::= { docsIfCmtsModulationEntry 5 }
  2216.  
  2217. docsIfCmtsModPreambleLen OBJECT-TYPE
  2218.         SYNTAX      INTEGER (0..1024)
  2219.         MAX-ACCESS  read-create
  2220.         STATUS      current
  2221.         DESCRIPTION
  2222.             "The preamble length for this modulation profile in bits.
  2223.              Default value is the minimum needed by the implementation
  2224.              at the CMTS for the given modulation profile."
  2225.         ::= { docsIfCmtsModulationEntry 6 }
  2226.  
  2227. docsIfCmtsModDifferentialEncoding OBJECT-TYPE
  2228.         SYNTAX      TruthValue
  2229.         MAX-ACCESS  read-create
  2230.         STATUS      current
  2231.         DESCRIPTION
  2232.             "Whether or not differential encoding is used on this channel."
  2233.         DEFVAL { false }
  2234.         ::= { docsIfCmtsModulationEntry 7 }
  2235.  
  2236.  
  2237. Expires January 1998                                           [Page 38]
  2238.  
  2239. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2240.  
  2241.  
  2242. docsIfCmtsModFECErrorCorrection OBJECT-TYPE
  2243.         SYNTAX      INTEGER (0..10)
  2244.         MAX-ACCESS  read-create
  2245.         STATUS      current
  2246.         DESCRIPTION
  2247.             "The number of correctable errored bytes (t) used in forward
  2248.              error correction code. The value of 0 indicates no correction
  2249.              is employed. The number of check bytes appended will be twice
  2250.              this value."
  2251.         DEFVAL { 0 }
  2252.         ::= { docsIfCmtsModulationEntry 8 }
  2253.  
  2254. docsIfCmtsModFECCodewordLength OBJECT-TYPE
  2255.         SYNTAX      INTEGER (1..255)
  2256.         MAX-ACCESS  read-create
  2257.         STATUS      current
  2258.         DESCRIPTION
  2259.             "The number of data bytes (k) in the forward error correction
  2260.              codeword.
  2261.              This object is not used if docsIfCmtsModFECErrorCorrection
  2262.              is zero."
  2263.         DEFVAL { 32 }
  2264.         ::= { docsIfCmtsModulationEntry 9 }
  2265.  
  2266. docsIfCmtsModScramblerSeed OBJECT-TYPE
  2267.         SYNTAX      INTEGER (0..32767)
  2268.         MAX-ACCESS  read-create
  2269.         STATUS      current
  2270.         DESCRIPTION
  2271.             "The 15 bit seed value for the scrambler polynomial."
  2272.         DEFVAL { 0 }
  2273.         ::= { docsIfCmtsModulationEntry 10 }
  2274.  
  2275. docsIfCmtsModMaxBurstSize OBJECT-TYPE
  2276.         SYNTAX      INTEGER (0..255)
  2277.         MAX-ACCESS  read-create
  2278.         STATUS      current
  2279.         DESCRIPTION
  2280.             "The maximum number of mini-slots that can be transmitted during
  2281.              this channel's burst time. Returns zero if the burst length is
  2282.              bounded by the allocation MAP rather than this profile.
  2283.              Default value is 0 except for shortData, where it is 8."
  2284.         ::= { docsIfCmtsModulationEntry 11 }
  2285.  
  2286. docsIfCmtsModGuardTimeSize OBJECT-TYPE
  2287.         SYNTAX      Unsigned32
  2288.         MAX-ACCESS  read-only
  2289.         STATUS      current
  2290.         DESCRIPTION
  2291.             "The number of symbol-times which must follow the end of
  2292.              this channel's burst. Default value is the minimum time
  2293.              needed by the implementation for this modulation profile."
  2294.  
  2295.  
  2296. Expires January 1998                                           [Page 39]
  2297.  
  2298. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2299.  
  2300.  
  2301.         ::= { docsIfCmtsModulationEntry 12 }
  2302.  
  2303. docsIfCmtsModLastCodewordShortened OBJECT-TYPE
  2304.         SYNTAX      TruthValue
  2305.         MAX-ACCESS  read-create
  2306.         STATUS      current
  2307.         DESCRIPTION
  2308.             "Indicates if the last FEC codeword is truncated."
  2309.         DEFVAL { true }
  2310.         ::= { docsIfCmtsModulationEntry 13 }
  2311.  
  2312. docsIfCmtsModScrambler OBJECT-TYPE
  2313.         SYNTAX      TruthValue
  2314.         MAX-ACCESS  read-create
  2315.         STATUS      current
  2316.         DESCRIPTION
  2317.             "Indicates if the scrambler is employed."
  2318.         DEFVAL { false }
  2319.         ::= { docsIfCmtsModulationEntry 14 }
  2320.  
  2321. --
  2322. -- notification group is for future extension.
  2323. --
  2324. docsIfNotification OBJECT IDENTIFIER         ::= { docsIfMib 2 }
  2325.  
  2326. docsIfConformance  OBJECT IDENTIFIER         ::= { docsIfMib 3 }
  2327. docsIfCompliances  OBJECT IDENTIFIER         ::= { docsIfConformance 1 }
  2328. docsIfGroups       OBJECT IDENTIFIER         ::= { docsIfConformance 2 }
  2329.  
  2330. -- compliance statements
  2331.  
  2332. docsIfBasicCompliance MODULE-COMPLIANCE
  2333.         STATUS      current
  2334.         DESCRIPTION
  2335.             "The compliance statement for devices that implement MCNS
  2336.              compliant Radio Frequency Interfaces."
  2337.  
  2338. MODULE  -- docsIfMib
  2339.  
  2340. -- unconditionally mandatory groups
  2341. MANDATORY-GROUPS {
  2342.         docsIfBasicGroup
  2343.         }
  2344.  
  2345. -- conditionally mandatory group
  2346. GROUP docsIfCmGroup
  2347.         DESCRIPTION
  2348.             "This group is implemented only in Cable Modems, not in
  2349.              Cable Modem Termination Systems."
  2350.  
  2351. -- conditionally mandatory group
  2352. GROUP docsIfCmtsGroup
  2353.  
  2354.  
  2355. Expires January 1998                                           [Page 40]
  2356.  
  2357. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2358.  
  2359.  
  2360.         DESCRIPTION
  2361.             "This group is implemented only in Cable Modem Termination
  2362.              Systems, not in Cable Modems."
  2363.  
  2364. OBJECT  docsIfDownChannelFrequency
  2365.         MIN-ACCESS  read-only
  2366.         DESCRIPTION
  2367.             "Read-write in Cable Modem Termination Systems;
  2368.              read-only in Cable Modems."
  2369.  
  2370. OBJECT  docsIfDownChannelWidth
  2371.         MIN-ACCESS  read-only
  2372.         DESCRIPTION
  2373.             "It is conformant to implement this object as read-only.
  2374.              In Cable Modems, this object is always implemented as
  2375.              read-only."
  2376.  
  2377. OBJECT  docsIfDownChannelModulation
  2378.         MIN-ACCESS  read-only
  2379.         DESCRIPTION
  2380.             "Read-write in Cable Modem Termination Systems;
  2381.              read-only in Cable Modems."
  2382.  
  2383. OBJECT  docsIfDownChannelInterleave
  2384.         MIN-ACCESS  read-only
  2385.         DESCRIPTION
  2386.             "Read-write in Cable Modem Termination Systems;
  2387.              read-only in Cable Modems."
  2388.  
  2389. OBJECT  docsIfUpChannelFrequency
  2390.         MIN-ACCESS  read-only
  2391.         DESCRIPTION
  2392.             "Read-write in Cable Modem Termination Systems;
  2393.              read-only in Cable Modems."
  2394.  
  2395. OBJECT  docsIfUpChannelWidth
  2396.         MIN-ACCESS  read-only
  2397.         DESCRIPTION
  2398.             "Read-write in Cable Modem Termination Systems;
  2399.              read-only in Cable Modems."
  2400.  
  2401. OBJECT  docsIfUpChannelModulationProfile
  2402.         MIN-ACCESS  read-only
  2403.         DESCRIPTION
  2404.             "Read-write in Cable Modem Termination Systems;
  2405.              read-only in Cable Modems."
  2406.  
  2407. OBJECT  docsIfUpChannelSlotSize
  2408.         MIN-ACCESS  read-only
  2409.         DESCRIPTION
  2410.             "Read-write in Cable Modem Termination Systems;
  2411.              read-only in Cable Modems."
  2412.  
  2413.  
  2414. Expires January 1998                                           [Page 41]
  2415.  
  2416. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2417.  
  2418.  
  2419. OBJECT  docsIfUpChannelRangingBackoffStart
  2420.         MIN-ACCESS  read-only
  2421.         DESCRIPTION
  2422.             "Read-write in Cable Modem Termination Systems;
  2423.              read-only in Cable Modems."
  2424.  
  2425. OBJECT  docsIfUpChannelRangingBackoffEnd
  2426.         MIN-ACCESS  read-only
  2427.         DESCRIPTION
  2428.             "Read-write in Cable Modem Termination Systems;
  2429.              read-only in Cable Modems."
  2430.  
  2431. OBJECT  docsIfUpChannelTxBackoffStart
  2432.         MIN-ACCESS  read-only
  2433.         DESCRIPTION
  2434.             "Read-write in Cable Modem Termination Systems;
  2435.              read-only in Cable Modems."
  2436.  
  2437. OBJECT  docsIfUpChannelTxBackoffEnd
  2438.         MIN-ACCESS  read-only
  2439.         DESCRIPTION
  2440.             "Read-write in Cable Modem Termination Systems;
  2441.              read-only in Cable Modems."
  2442.  
  2443. OBJECT  docsIfCmtsServiceAdminStatus
  2444.         MIN-ACCESS  read-only
  2445.         DESCRIPTION
  2446.             "It is compliant to implement this object as read-only."
  2447.  
  2448. OBJECT  docsIfCmtsSyncInterval
  2449.         MIN-ACCESS  read-only
  2450.         DESCRIPTION
  2451.             "It is compliant to implement this object as read-only."
  2452.  
  2453. OBJECT  docsIfCmtsUcdInterval
  2454.         MIN-ACCESS  read-only
  2455.         DESCRIPTION
  2456.             "It is compliant to implement this object as read-only."
  2457.  
  2458. OBJECT  docsIfCmtsInsertionInterval
  2459.         MIN-ACCESS  read-only
  2460.         DESCRIPTION
  2461.             "It is compliant to implement this object as read-only."
  2462.  
  2463. OBJECT  docsIfCmtsInvitedRangingAttempts
  2464.         MIN-ACCESS  read-only
  2465.         DESCRIPTION
  2466.             "It is compliant to implement this object as read-only."
  2467.  
  2468.         ::= { docsIfCompliances 1 }
  2469.  
  2470. docsIfBasicGroup OBJECT-GROUP
  2471.  
  2472.  
  2473. Expires January 1998                                           [Page 42]
  2474.  
  2475. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2476.  
  2477.  
  2478.         OBJECTS {
  2479.             docsIfDownChannelId,
  2480.             docsIfDownChannelFrequency,
  2481.             docsIfDownChannelWidth,
  2482.             docsIfDownChannelModulation,
  2483.             docsIfDownChannelInterleave,
  2484.             docsIfDownChannelPower,
  2485.             docsIfUpChannelId,
  2486.             docsIfUpChannelFrequency,
  2487.             docsIfUpChannelWidth,
  2488.             docsIfUpChannelModulationProfile,
  2489.             docsIfUpChannelSlotSize,
  2490.             docsIfUpChannelTxTimingOffset,
  2491.             docsIfUpChannelRangingBackoffStart,
  2492.             docsIfUpChannelRangingBackoffEnd,
  2493.             docsIfUpChannelTxBackoffStart,
  2494.             docsIfUpChannelTxBackoffEnd,
  2495.             docsIfQosProfPriority,
  2496.             docsIfQosProfMaxUpBandwidth,
  2497.             docsIfQosProfGuarUpBandwidth,
  2498.             docsIfQosProfMaxDownBandwidth,
  2499.             docsIfQosProfMaxTxBurst,
  2500.             docsIfSigQIncludesContention,
  2501.             docsIfSigQUnerroreds,
  2502.             docsIfSigQCorrecteds,
  2503.             docsIfSigQUncorrectables,
  2504.             docsIfSigQSignalNoise,
  2505.             docsIfSigQInChannelResponse,
  2506.             docsIfSigQMicroreflections
  2507.         }
  2508.         STATUS      current
  2509.         DESCRIPTION
  2510.             "Group of objects implemented in both Cable Modems and
  2511.              Cable Modem Termination Systems."
  2512.         ::= { docsIfGroups 1 }
  2513.  
  2514. docsIfCmGroup OBJECT-GROUP
  2515.         OBJECTS {
  2516.             docsIfCmCmtsAddress,
  2517.             docsIfCmCapabilities,
  2518.             docsIfCmRangingRespTimeout,
  2519.             docsIfCmStatusValue,
  2520.             docsIfCmStatusCode,
  2521.             docsIfCmStatusTxPower,
  2522.             docsIfCmStatusResets,
  2523.             docsIfCmStatusLostSyncs,
  2524.             docsIfCmStatusInvalidMaps,
  2525.             docsIfCmStatusInvalidUcds,
  2526.             docsIfCmStatusT2Timeouts,
  2527.             docsIfCmStatusT3Timeouts,
  2528.             docsIfCmStatusT4Timeouts,
  2529.             docsIfCmStatusRangingAborteds,
  2530.  
  2531.  
  2532. Expires January 1998                                           [Page 43]
  2533.  
  2534. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2535.  
  2536.  
  2537.             docsIfCmServiceQosProfile,
  2538.             docsIfCmServiceTxSlotsImmed,
  2539.             docsIfCmServiceTxSlotsDed,
  2540.             docsIfCmServiceTxRetries,
  2541.             docsIfCmServiceTxExceeded,
  2542.             docsIfCmServiceRqRetries,
  2543.             docsIfCmServiceRqExceeded
  2544.         }
  2545.         STATUS      current
  2546.         DESCRIPTION
  2547.             "Group of objects implemented in both Cable Modems and
  2548.              Cable Modem Termination Systems."
  2549.         ::= { docsIfGroups 2 }
  2550.  
  2551. docsIfCmtsGroup OBJECT-GROUP
  2552.         OBJECTS {
  2553.             docsIfCmtsCapabilities,
  2554.             docsIfCmtsSyncInterval,
  2555.             docsIfCmtsUcdInterval,
  2556.             docsIfCmtsMaxServiceIds,
  2557.             docsIfCmtsInsertionInterval,
  2558.             docsIfCmtsInvitedRangingAttempts,
  2559.             docsIfCmtsStatusInvalidRangeReqs,
  2560.             docsIfCmtsStatusRangingAborteds,
  2561.             docsIfCmtsStatusInvalidRegReqs,
  2562.             docsIfCmtsStatusFailedRegReqs,
  2563.             docsIfCmtsStatusInvalidDataReqs,
  2564.             docsIfCmtsCmStatusMacAddress,
  2565.             docsIfCmtsCmStatusIpAddress,
  2566.             docsIfCmtsCmStatusDownChannelIfIndex,
  2567.             docsIfCmtsCmStatusUpChannelIfIndex,
  2568.             docsIfCmtsCmStatusRxPower,
  2569.             docsIfCmtsCmStatusTimingOffset,
  2570.             docsIfCmtsCmStatusEqualizationData,
  2571.             docsIfCmtsServiceCmStatusIndex,
  2572.             docsIfCmtsServiceAdminStatus,
  2573.             docsIfCmtsServiceQosProfile,
  2574.             docsIfCmtsServiceCreateTime,
  2575.             docsIfCmtsServiceInOctets,
  2576.             docsIfCmtsServiceInPackets,
  2577.             docsIfCmtsModType,
  2578.             docsIfCmtsModControl,
  2579. --            docsIfCmtsModPreambleStart,
  2580.             docsIfCmtsModPreambleLen,
  2581.             docsIfCmtsModDifferentialEncoding,
  2582.             docsIfCmtsModFECErrorCorrection,
  2583.             docsIfCmtsModFECCodewordLength,
  2584.             docsIfCmtsModScramblerSeed,
  2585.             docsIfCmtsModMaxBurstSize,
  2586.             docsIfCmtsModGuardTimeSize,
  2587.             docsIfCmtsModLastCodewordShortened,
  2588.             docsIfCmtsModScrambler
  2589.  
  2590.  
  2591. Expires January 1998                                           [Page 44]
  2592.  
  2593. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2594.  
  2595.  
  2596.         }
  2597.         STATUS      current
  2598.         DESCRIPTION
  2599.             "Group of objects implemented in Cable Modem Termination
  2600.              Systems."
  2601.         ::= { docsIfGroups 3 }
  2602.  
  2603. END
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649. Expires January 1998                                           [Page 45]
  2650.  
  2651. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2652.  
  2653.  
  2654. 5.  Acknowledgments
  2655.  
  2656. This document was produced by the IPCDN Working Group.  It is based on a
  2657. document written by Pam Anderson from CableLabs, Wilson Sawyer from
  2658. BayNetworks, and Rich Woundy from Continental Cablevision.
  2659.  
  2660. Special thanks is also due to
  2661.  
  2662.         Azlina Palmer
  2663.  
  2664.  
  2665. 6.  References
  2666.  
  2667. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  2668.      S. Waldbusser, "Structure of Management Information for Version 2
  2669.      of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  2670.      January 1996.
  2671.  
  2672. [2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  2673.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  2674.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  2675.      March 1991.
  2676.  
  2677. [3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "A Simple
  2678.      Network Management Protocol (SNMP)", STD 15, RFC 1157, SNMP
  2679.      Research, Performance Systems International, MIT Lab for Computer
  2680.      Science, May 1990.
  2681.  
  2682. [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and
  2683.      S. Waldbusser, "Protocol Operations for Version 2 of the Simple
  2684.      Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  2685.  
  2686. [5]  McCloghrie, K. and F. Kastenholz, "Evolution of the Interfaces
  2687.      Group of MIB-II", RFC 1573, Hughes LAN Systems, FTP Software,
  2688.      January 1994.
  2689.  
  2690. [6]  "MCNS Data Over Cable Services Cable Modem Radio Frequency
  2691.      Interface Specification SP-RFID01-970326", MCNS, March 1997.
  2692.  
  2693.  
  2694. 7.  Security Considerations
  2695.  
  2696. Security issues are not discussed in this memo.
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707. Expires January 1998                                           [Page 46]
  2708.  
  2709. INTERNET-DRAFT           MCNS RF Interface MIB                 July 1997
  2710.  
  2711.  
  2712. 8.  Author's Address
  2713.  
  2714.      Guenter Roeck
  2715.      cisco Systems
  2716.      170 West Tasman Drive
  2717.      San Jose, CA 95134
  2718.      U.S.A.
  2719.  
  2720.      Phone: +1 408 527 3143
  2721.      Email: groeck@cisco.com
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765. Expires January 1998                                           [Page 47]
  2766.