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