INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


       Radio Frequency (RF) Interface Management Information Base
                    for MCNS compliant RF interfaces
                draft-ietf-ipcdn-rf-interface-mib-01.txt

                      Tue Sep  2 16:46:42 PDT 1997


                         Guenter Roeck (editor)
                             cisco Systems
                            groeck@cisco.com





Status of this Memo

This document is an Internet-Draft.  Internet-Drafts are working
documents of the Internet Engineering Task Force (IETF), its Areas, and
its Working Groups.  Note that other groups may also distribute working
documents as Internet-Drafts.

Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time.  It is inappropriate to use Internet-Drafts as reference material
or to cite them other than as a "work in progress".

To view the entire list of current Internet-Drafts, please check the
"1id-abstracts.txt" listing contained in the Internet-Drafts Shadow
Directories on ftp.is.co.za (Africa), ftp.nordu.net (Europe),
munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
ftp.isi.edu (US West Coast).

Abstract

This memo defines an experimental portion of the Management Information
Base (MIB) for use with network management protocols in the Internet
community.  In particular, it defines a basic set of managed objects for
SNMP-based management of MCNS compliant Radio Frequency (RF) interfaces.

This memo specifies a MIB module in a manner that is compliant to the
SNMPv2 SMI.  The set of objects is consistent with the SNMP framework
and existing SNMP standards.

This memo does not specify a standard for the Internet community.

This memo is a product of the IPCDN working group within the Internet
Engineering Task Force.  Comments are solicited and should be addressed
to the working group's mailing list at ipcdn@terayon.com and/or the
author.



Expires March 1998                                              [Page 1]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


Table of Contents


1 The SNMPv2 Network Management Framework .........................    3
2 Object Definitions ..............................................    3
3 Overview ........................................................    4
3.1 Structure of the MIB ..........................................    4
3.1.1 General Description .........................................    4
3.2 Relationship to the Interfaces MIB ............................    4
3.2.1 Layering Model ..............................................    4
3.2.2 ifTestTable .................................................    5
3.2.3 ifRcvAddressTable ...........................................    5
3.2.4 ifEntry .....................................................    5
3.2.4.1 ifEntry for Downstream interfaces .........................    5
3.2.4.1.1 ifEntry  for  Downstream  interfaces  in  Cable  Modem
     Termination Systems ..........................................    5
3.2.4.1.2 ifEntry for Downstream interfaces in Cable Modems .......    7
3.2.4.2 ifEntry for Upstream interfaces ...........................    9
3.2.4.2.1  ifEntry  for  Upstream  interfaces  in  Cable   Modem
     Termination Systems ..........................................    9
3.2.4.2.2 ifEntry for Upstream interfaces in Cable Modems .........   11
3.2.4.3 ifEntry for the MAC Layer .................................   13
4 Definitions .....................................................   15
5 Acknowledgments .................................................   50
6 References ......................................................   50
7 Security Considerations .........................................   50
8 Author's Address ................................................   51


























Expires March 1998                                              [Page 2]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


1.  The SNMPv2 Network Management Framework

The SNMPv2 Network Management Framework presently consists of three
major components.  They are:

o    the SMI, described in RFC 1902 [1] - the mechanisms used for
     describing and naming objects for the purpose of management.

o    the MIB-II, STD 17, RFC 1213 [2] - the core set of managed objects
     for the Internet suite of protocols.

o    the protocol, RFC 1157 [3] and/or RFC 1905 [4], - the protocol for
     accessing managed objects.

The Framework permits new objects to be defined for the purpose of
experimentation and evaluation.


2.  Object Definitions

Managed objects are accessed via a virtual information store, termed the
Management Information Base or MIB.  Objects in the MIB are defined
using the subset of Abstract Syntax Notation One (ASN.1) defined in the
SMI.  In particular, each object type is named by an OBJECT IDENTIFIER,
an administratively assigned name.  The object type together with an
object instance serves to uniquely identify a specific instantiation of
the object.  For human convenience, we often use a textual string,
termed the descriptor, to refer to the object type.

























Expires March 1998                                              [Page 3]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


3.  Overview

This MIB provides a set of objects required for the management of MCNS
compliant Cable Modem (CM) and Cable Modem Termination System (CMTS) RF
interfaces.  The specification is derived from the MCNS Radio Frequency
Interface specification [6].


3.1.  Structure of the MIB

This MIB is structured in three groups:

o    Information required both in Cable Modems and Cable Modem
     Termination systems.

o    Information required in Cable Modems only.

o    Information required in Cable Modem Termination Systems only.


3.1.1.  General Description

3.2.  Relationship to the Interfaces MIB

This section clarifies the relationship of this MIB to the Interfaces
MIB [5].  Several areas of correlation are addressed in the following
subsections.  The implementor is referred to the Interfaces MIB document
in order to understand the general intent of these areas.


3.2.1.  Layering Model

An instance of ifEntry exists for each RF Downstream interface, for each
RF Upstream interface, and for each RF MAC layer.  The ifStackTable [5]
must be implemented to identify relationships among sub-interfaces.

The following example illustrates a MAC interface with one downstream
and two upstream channels.

                                   | <== to network layer
                     +-------------+--------------+
                     |           RF MAC           |
                     +----+---------+-----------+-+
                          |         |           |
                +---------+---+ +---+-------+ +-+---------+
                | Downstream1 | | Upstream1 | | Upstream2 |
                +-------------+ +-----------+ +-----------+

As can be seen from this example, the RF MAC interface is layered on top
of the downstream and upstream interfaces.



Expires March 1998                                              [Page 4]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


In this example, the assignment of index values could be as follows:

ifIndex ifType                  Description

   1    docsCableMaclayer(xx)   CATV MAC Layer
   2    docsCableDownstream(xx) CATV Downstream interface
   3    docsCableUpstream(xx)   CATV Upstream interface
   4    docsCableUpstream(xx)   CATV Upstream interface

The corresponding ifStack entries would then be:

        | IfStackHigherLayer | ifStackLowerLayer |
        |         0          |         1         |
        |         1          |         2         |
        |         1          |         3         |
        |         1          |         4         |
        |         2          |         0         |
        |         3          |         0         |
        |         4          |         0         |

The same interface model can also be used in Telco Return systems.  A
pure Telco Return system (Cable Modem as well as Cable Modem Termination
System) would not have upstream, but only downstream cable channels.
Systems supporting both Telco Return and cable upstream channels can use
the above model without modification.

Telco Return Upstream channel(s) are handled by the appropriate MIBs,
such as PPP or Modem MIBs.

3.2.2.  ifTestTable

The ifTestTable is not supported by this MIB.


3.2.3.  ifRcvAddressTable

The ifRcvAddressTable is not supported by this MIB.


3.2.4.  ifEntry

3.2.4.1.  ifEntry for Downstream interfaces

The ifEntry for Downstream interfaces supports the ifGeneralGroup and
the ifPacketGroup of the Interfaces MIB.

3.2.4.1.1.  ifEntry for Downstream interfaces in Cable Modem Termination
Systems

ifTable           Comments
==============    ===========================================
ifIndex           Each RF Cable Downstream interface is represented


Expires March 1998                                              [Page 5]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


                  by an ifEntry.

ifDescr           Textual port description.

ifType            The IANA value of docsCableDownstream(xx).

ifSpeed           Return the speed of this downstream channel.
                  The returned value the raw bandwidth in bits/s
                  of this interface.

ifPhysAddress     Return an empty string.

ifAdminStatus     The administrative status of this interface.

ifOperStatus      The current operational status of this interface.

ifLastChange      Refer to the Interfaces MIB.

ifLinkUpDownTrapEnable
                  Refer to the Interfaces MIB.

ifConnectorPresent
                  Refer to the Interfaces MIB.

ifHighSpeed       Refer to the Interfaces MIB.

ifName            Refer to the Interfaces MIB.

ifMtu             The size of the largest frame which can be
                  sent on this interface, specified in octets.
                  The value includes the length of the MAC header.

ifInOctets        Return zero.

ifInUcastPkts     Return zero.

ifInNUcastPkts    Deprecated. Return zero.

ifInMulticastPkts Return zero.

ifInBroadcastPkts Return zero.

ifInDiscards      Return zero.

ifInErrors        Return zero.

ifInUnknownProtos Return zero.

ifOutOctets       The total number of octets transmitted on this
                  interface. This includes MAC packets as well as
                  data packets, and includes the length of the MAC
                  header.


Expires March 1998                                              [Page 6]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


ifOutUcastPkts    The number of Unicast packets transmitted on this
                  interface. This includes MAC packets as well as
                  data packets.

ifOutNUcastPkts   Deprecated. Return the number of Broadcast and
                  Multicast packets transmitted on this interface.
                  This includes MAC packets as well as data packets.

ifOutMulticastPkts
                  Return the number of Multicast packets transmitted
                  on this interface.
                  This includes MAC packets as well as data packets.

ifOutBroadcastPkts
                  Return the number of broadcast packets transmitted
                  on this interface.
                  This includes MAC packets as well as data packets.

ifOutDiscards     The total number of outbound packets which
                  were discarded. Possible reasons are:
                  buffer shortage.

ifOutErrors       The number of packets which could not be
                  transmitted due to errors.

ifOutQlen         Deprecated. Return zero.

ifSpecific        Deprecated. Return {0 0}.


3.2.4.1.2.  ifEntry for Downstream interfaces in Cable Modems
ifTable           Comments
==============    ===========================================
ifIndex           Each RF Cable Downstream interface is represented
                  by an ifEntry.

ifDescr           Textual port description.

ifType            The IANA value of docsCableDownstream(xx).

ifSpeed           Return the speed of this downstream channel.
                  The returned value the raw bandwidth in bits/s
                  of this interface.

ifPhysAddress     Return an empty string.

ifAdminStatus     The administrative status of this interface.

ifOperStatus      The current operational status of this interface.

ifLastChange      Refer to the Interfaces MIB.


Expires March 1998                                              [Page 7]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


ifLinkUpDownTrapEnable
                  Refer to the Interfaces MIB.

ifConnectorPresent
                  Refer to the Interfaces MIB.

ifHighSpeed       Refer to the Interfaces MIB.

ifName            Refer to the Interfaces MIB.

ifMtu             The size of the largest frame which can be
                  received from this interface, specified in octets.
                  The value includes the length of the MAC header.

ifInOctets        The total number of octets received on this
                  interface. This includes data packets as well as
                  MAC layer packets, and includes the length of the
                  MAC header.

ifInUcastPkts     The number of Unicast packets received on this
                  interface. This includes data packets as well as
                  MAC layer packets.

ifInNUcastPkts    Deprecated. Return the number of Broadcast and
                  Multicast packets received on this interface.
                  This includes data packets as well as MAC layer
                  packets.

ifInMulticastPkts Return the number of Multicast packets received
                  on this interface. This includes data packets as
                  well as MAC layer packets.

ifInBroadcastPkts Return the number of Broadcast packets received
                  on this interface. This includes data packets
                  as well as MAC layer packets.

ifInDiscards      The total number of received packets which have been
                  discarded.
                  The possible reasons are: buffer shortage.

ifInErrors        The number of inbound packets that contained
                  errors preventing them from being deliverable
                  to higher layers.
                  Possible reasons are: MAC FCS error.

ifInUnknownProtos The number of frames with an unknown packet type.
                  This are MAC frames with an unknown packet type.

ifOutOctets       Return zero.

ifOutUcastPkts    Return zero.


Expires March 1998                                              [Page 8]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


ifOutNUcastPkts   Deprecated. Return zero.

ifOutMulticastPkts
                  Return zero.

ifOutBroadcastPkts
                  Return zero.

ifOutDiscards     Return zero.

ifOutErrors       Return zero.

ifOutQlen         Deprecated. Return zero.

ifSpecific        Deprecated. Return {0 0}.


3.2.4.2.  ifEntry for Upstream interfaces

The ifEntry for Upstream interfaces supports the ifGeneralGroup and the
ifPacketGroup of the Interfaces MIB.

3.2.4.2.1.  ifEntry for Upstream interfaces in Cable Modem Termination
Systems

ifTable           Comments
==============    ===========================================
ifIndex           Each RF Cable Upstream interface is represented
                  by an ifEntry.

ifDescr           Textual port description.

ifType            The IANA value of docsCableUpstream(xx).

ifSpeed           Return the speed of this upstream channel.
                  The returned value is the raw bandwidth
                  in bits/s of this interface, regarding the
                  highest speed modulation profile that is
                  defined.

ifPhysAddress     Return an empty string.

ifAdminStatus     The administrative status of this interface.

ifOperStatus      The current operational status of this interface.

ifLastChange      Refer to the Interfaces MIB.

ifLinkUpDownTrapEnable
                  Refer to the Interfaces MIB.

ifConnectorPresent


Expires March 1998                                              [Page 9]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


                  Refer to the Interfaces MIB.

ifHighSpeed       Refer to the Interfaces MIB.

ifName            Refer to the Interfaces MIB.

ifMtu             The size of the largest frame which can be
                  received on this interface, specified in octets.
                  The value includes the length of the MAC header.

ifInOctets        The total number of octets received on this
                  interface. This includes data packets as well as
                  MAC layer packets, and includes the length of the
                  MAC header.

ifInUcastPkts     The number of Unicast packets received on this
                  interface. This includes data packets as well as
                  MAC layer packets.

ifInNUcastPkts    Deprecated. Return the number of Broadcast and
                  Multicast packets received on this interface.
                  This includes data packets as well as MAC layer
                  packets.

ifInMulticastPkts Return the number of Multicast packets received
                  on this interface. This includes data packets as
                  well as MAC layer packets.

ifInBroadcastPkts Return the number of Broadcast packets received
                  on this interface. This includes data packets
                  as well as MAC layer packets.

ifInDiscards      The total number of received packets which have been
                  discarded.
                  The possible reasons are: buffer shortage.

ifInErrors        The number of inbound packets that contained
                  errors preventing them from being deliverable
                  to higher layers.
                  Possible reasons are: MAC FCS error.

ifInUnknownProtos The number of frames with an unknown packet type.
                  This are MAC frames with an unknown packet type.

ifOutOctets       Return zero.

ifOutUcastPkts    Return zero.

ifOutNUcastPkts   Deprecated. Return zero.

ifOutMulticastPkts
                  Return zero.


Expires March 1998                                             [Page 10]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


ifOutBroadcastPkts
                  Return zero.

ifOutDiscards     Return zero.

ifOutErrors       Return zero.

ifOutQlen         Deprecated. Return zero.

ifSpecific        Deprecated. Return {0 0}.


3.2.4.2.2.  ifEntry for Upstream interfaces in Cable Modems

ifTable           Comments
==============    ===========================================
ifIndex           Each RF Cable Upstream interface is represented
                  by an ifEntry.

ifDescr           Textual port description.

ifType            The IANA value of docsCableUpstream(xx).

ifSpeed           Return the speed of this upstream channel.
                  The returned value is the raw bandwidth
                  in bits/s of this interface, regarding the
                  highest speed modulation profile that is
                  defined.

ifPhysAddress     Return an empty string.

ifAdminStatus     The administrative status of this interface.

ifOperStatus      The current operational status of this interface.

ifLastChange      Refer to the Interfaces MIB.

ifLinkUpDownTrapEnable
                  Refer to the Interfaces MIB.

ifConnectorPresent
                  Refer to the Interfaces MIB.

ifHighSpeed       Refer to the Interfaces MIB.

ifName            Refer to the Interfaces MIB.

ifMtu             The size of the largest frame which can be
                  transmitted on this interface, specified in octets.
                  The value includes the length of the MAC header.

ifInOctets        Return zero.


Expires March 1998                                             [Page 11]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


ifInUcastPkts     Return zero.

ifInNUcastPkts    Deprecated. Return zero.

ifInMulticastPkts Return zero.

ifInBroadcastPkts Return zero.

ifInDiscards      Return zero.

ifInErrors        Return zero.

ifInUnknownProtos Return zero.

ifOutOctets       The total number of octets transmitted on this
                  interface. This includes MAC packets as well as
                  data packets, and includes the length of the MAC
                  header.

ifOutUcastPkts    The number of Unicast packets transmitted on this
                  interface. This includes MAC packets as well as
                  data packets.

ifOutNUcastPkts   Deprecated. Return the number of Broadcast and
                  Multicast packets transmitted on this interface.
                  This includes MAC packets as well as data packets.

ifOutMulticastPkts
                  Return the number of Multicast packets transmitted
                  on this interface.
                  This includes MAC packets as well as data packets.

ifOutBroadcastPkts
                  Return the number of broadcast packets transmitted
                  on this interface.
                  This includes MAC packets as well as data packets.

ifOutDiscards     The total number of outbound packets which
                  were discarded. Possible reasons are:
                  buffer shortage.

ifOutErrors       The number of packets which could not be
                  transmitted due to errors.

ifOutQlen         Deprecated. Return zero.

ifSpecific        Deprecated. Return {0 0}.






Expires March 1998                                             [Page 12]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


3.2.4.3.  ifEntry for the MAC Layer

The ifEntry for the MAC Layer supports the ifGeneralGroup and the
ifPacketGroup of the Interfaces MIB.

ifTable           Comments
==============    ===========================================
ifIndex           Each RF Cable MAC layer entity is represented
                  by an ifEntry.

ifDescr           Textual port description.

ifType            The IANA value of docsCableMaclayer(xx).

ifSpeed           Return zero.

ifPhysAddress     Return the physical address of this interface.

ifAdminStatus     The administrative status of this interface.

ifOperStatus      The current operational status of the MAC
                  layer interface.

ifLastChange      Refer to the Interfaces MIB.

ifLinkUpDownTrapEnable
                  Refer to the Interfaces MIB.

ifConnectorPresent
                  Refer to the Interfaces MIB.

ifHighSpeed       Return zero.

ifName            Refer to the Interfaces MIB.

ifMtu             Return 1500.

ifInOctets        The total number of data octets received on this
                  interface, targeted for upper protocol layers.

ifInUcastPkts     The number of Unicast packets received on this
                  interface, targeted for upper protocol layers.

ifInNUcastPkts    Deprecated. Return the number of Broadcast and
                  Multicast packets received on this interface,
                  targeted for upper protocol layers.

ifInMulticastPkts Return the number of Multicast packets received
                  on this interface, targeted for upper protocol
                  layers.

ifInBroadcastPkts Return the number of Broadcast packets received


Expires March 1998                                             [Page 13]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


                  on this interface, targeted for upper protocol
                  layers.

ifInDiscards      The total number of received packets which have been
                  discarded.
                  The possible reasons are: buffer shortage.

ifInErrors        The number of inbound packets that contained
                  errors preventing them from being deliverable
                  to higher layers.
                  Possible reasons are: data packet FCS error,
                  invalid MAC header.

ifInUnknownProtos The number of frames with an unknown packet type.
                  This is the number of data packets targeted for upper
                  protocol layers with an unknown packet type.

ifOutOctets       The total number of octets, received from upper
                  protocol layers and transmitted on this interface.

ifOutUcastPkts    The number of Unicast packets, received from upper
                  protocol layers and transmitted on this interface.

ifOutNUcastPkts   Deprecated. Return the number of Broadcast and
                  Multicast packets received from upper protocol
                  layers and transmitted on this interface.

ifOutMulticastPkts
                  Return the number of Multicast packets received
                  from upper protocol layers and transmitted on this
                  interface.

ifOutBroadcastPkts
                  Return the number of broadcast packets received
                  from upper protocol layers and transmitted on this
                  interface.

ifOutDiscards     The total number of outbound packets which
                  were discarded. Possible reasons are:
                  buffer shortage.

ifOutErrors       The number of packets which could not be
                  transmitted due to errors.

ifOutQlen         Deprecated. Return zero.

ifSpecific        Deprecated. Return {0 0}.






Expires March 1998                                             [Page 14]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


4.  Definitions


DOCS-IF-MIB DEFINITIONS ::= BEGIN

IMPORTS
        MODULE-IDENTITY, OBJECT-TYPE, BITS,
        Unsigned32, Integer32, Counter32, TimeTicks, IpAddress
                    FROM SNMPv2-SMI
        TEXTUAL-CONVENTION,
        MacAddress,
        RowStatus,
        TruthValue
                    FROM SNMPv2-TC
        OBJECT-GROUP, MODULE-COMPLIANCE
                    FROM SNMPv2-CONF
        ifIndex, InterfaceIndexOrZero
                    FROM IF-MIB
        transmission
                    FROM RFC1213-MIB;

docsIfMib MODULE-IDENTITY
        LAST-UPDATED    "9709021644Z" -- Sep 02, 1997
        ORGANIZATION    "IETF IPCDN Working Group"
        CONTACT-INFO
            "        Guenter Roeck
             Postal: cisco Systems
                     170 West Tasman Drive
                     San Jose, CA 95134
                     U.S.A.
             Phone:  +1 408 527 3143
             E-mail: groeck@cisco.com"
        DESCRIPTION
            "This is the MIB Module for MCNS compliant Radio Frequency
             (RF) interfaces in Cable Modems (CM) and Cable Modem
             Termination Systems (CMTS)."
        ::= { transmission 999 }
-- Editor's note: This is not a valid assignment. Final value
-- will be the value of docsCableMaclayer(xx) once assigned.

-- Textual Conventions

TenthdBmV ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "d-1"
        STATUS       current
        DESCRIPTION
            "This data type represents power levels that are normally
             expressed in dBmV. Units are in tenths of a dBmV;
             for example, 5.1 dBmV will be represented as 51."
        SYNTAX       Integer32

docsIfMibObjects  OBJECT IDENTIFIER ::= { docsIfMib 1 }


Expires March 1998                                             [Page 15]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 }
docsIfCmObjects   OBJECT IDENTIFIER ::= { docsIfMibObjects 2 }
docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 }

--
-- BASE GROUP
--

--
-- The following table is implemented on both the Cable Modem (CM)
-- and the Cable Modem Termination System (CMTS).
--

docsIfDownstreamChannelTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfDownstreamChannelEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "This table describes the attributes of downstream
             channels (frequency bands)."
        ::= { docsIfBaseObjects 1 }

docsIfDownstreamChannelEntry OBJECT-TYPE
        SYNTAX      DocsIfDownstreamChannelEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "List of attributes for a single Downstream channel.
             An entry in this table exists for each ifEntry with an
             ifType of docsCableDownstream(xx)."
        INDEX { ifIndex }
        ::= { docsIfDownstreamChannelTable 1 }

DocsIfDownstreamChannelEntry ::= SEQUENCE {
            docsIfDownChannelId               INTEGER,
            docsIfDownChannelFrequency        INTEGER,
            docsIfDownChannelWidth            INTEGER,
            docsIfDownChannelModulation       INTEGER,
            docsIfDownChannelInterleave       INTEGER,
            docsIfDownChannelPower            TenthdBmV
        }

docsIfDownChannelId OBJECT-TYPE
        SYNTAX      INTEGER (0..255)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The CMTS identification of the downstream channel within
             this particular MAC interface. If the interface is down,
             the object returns the most current value. If the
             downstream channel ID is unknown, this object returns
             a value of 0."


Expires March 1998                                             [Page 16]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        ::= { docsIfDownstreamChannelEntry 1 }

docsIfDownChannelFrequency  OBJECT-TYPE
        SYNTAX      INTEGER (36000000..1000000000)
        UNITS       "hertz"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The center of the downstream frequency associated with
             this channel. This object will return the current tuner
             frequency. If a CMTS provides IF output, this object
             may return the IF frequency, unless this CMTS is in
             control of the final downstream RF frequency."
        ::= { docsIfDownstreamChannelEntry 2 }

docsIfDownChannelWidth  OBJECT-TYPE
        SYNTAX      INTEGER (0..16000000)
        UNITS       "hertz"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The bandwidth of this downstream channel. Most
             implementations are expected to support a channel width
             of 6 MHz (North America) and/or 8 MHz (Europe)."
        ::= { docsIfDownstreamChannelEntry 3 }

docsIfDownChannelModulation OBJECT-TYPE
        SYNTAX      INTEGER {
            unknown(1),
            other(2),
            qam64(3),
            qam256(4)
        }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The modulation type associated with this downstream
             channel. If the interface is down, this object either
             returns the configured value (CMTS), the most current
             value (CM), or the value of unknown(1)."
        ::= { docsIfDownstreamChannelEntry 4 }

docsIfDownChannelInterleave OBJECT-TYPE
        SYNTAX      INTEGER {
            unknown(1),
            other(2),
            taps8Increment16(3),
            taps16Increment8(4),
            taps32Increment4(5),
            taps64Increment2(6),
            taps128Increment1(7)
        }


Expires March 1998                                             [Page 17]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The Forward Error Correction (FEC) interleaving used
             for this downstream channel.
             Values are defined as follows:
             taps8Increment16(3):   protection 5.9/4.1 usec,
                                    latency .22/.15 mse
             taps16Increment8(4):   protection 12/8.2 usec,
                                    latency .48/.33 msec
             taps32Increment4(5):   protection 24/16 usec,
                                    latency .98/.68 msec
             taps64Increment2(6):   protection 47/33 usec,
                                    latency 2/1.4 msec
             taps128Increment1(7):  protection 95/66 usec,
                                    latency 4/2.8 msec
             If the interface is down, this object either returns
             the configured value (CMTS), the most current value (CM),
             or the value of unknown(1).
             The value of other(2) is returned if the interleave
             is known but not defined in the above list."
        ::= { docsIfDownstreamChannelEntry 5 }

docsIfDownChannelPower OBJECT-TYPE
        SYNTAX      TenthdBmV
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "At the CMTS, the operational transmit power. At the CM,
             the received power level. May be set to zero at the CM
             if power level measurement is not supported.
             If the interface is down, this object either returns
             the configured value (CMTS), the most current value (CM)
             or the value of 0."
        ::= { docsIfDownstreamChannelEntry 6 }

--
-- The following table is implemented on both the CM and the CMTS.
-- For the CM, only attached channels appear in the table.
--

docsIfUpstreamChannelTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfUpstreamChannelEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes the attributes of attached upstream channels
             (frequency bands)."
        ::= { docsIfBaseObjects 2 }

docsIfUpstreamChannelEntry OBJECT-TYPE
        SYNTAX      DocsIfUpstreamChannelEntry


Expires March 1998                                             [Page 18]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "List of attributes for a single upstream channel.
             An entry in this table exists for each ifEntry with an
             ifType of docsCableUpstream(xx)."
        INDEX { ifIndex }
        ::= { docsIfUpstreamChannelTable 1 }

DocsIfUpstreamChannelEntry ::= SEQUENCE {
            docsIfUpChannelId                     INTEGER,
            docsIfUpChannelFrequency              INTEGER,
            docsIfUpChannelWidth                  INTEGER,
            docsIfUpChannelModulationProfile      Unsigned32,
            docsIfUpChannelSlotSize               Unsigned32,
            docsIfUpChannelTxTimingOffset         Unsigned32,
            docsIfUpChannelRangingBackoffStart    INTEGER,
            docsIfUpChannelRangingBackoffEnd      INTEGER,
            docsIfUpChannelTxBackoffStart         INTEGER,
            docsIfUpChannelTxBackoffEnd           INTEGER
        }

docsIfUpChannelId OBJECT-TYPE
        SYNTAX      INTEGER (0..255)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The CMTS identification of the upstream channel."
        ::= { docsIfUpstreamChannelEntry 1 }

docsIfUpChannelFrequency OBJECT-TYPE
        SYNTAX      INTEGER (5000000..1000000000)
        UNITS       "hertz"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The center of the frequency band associated with this
             upstream channel."
        ::= { docsIfUpstreamChannelEntry 2 }

docsIfUpChannelWidth OBJECT-TYPE
        SYNTAX      INTEGER (1..16000000)
        UNITS       "hertz"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The bandwidth of this upstream channel."
        ::= { docsIfUpstreamChannelEntry 3 }

docsIfUpChannelModulationProfile OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-write


Expires March 1998                                             [Page 19]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        STATUS      current
        DESCRIPTION
            "An entry identical to the docsIfModIndex in the
             docsIfCmtsModulationTable that describes this channel.
             This channel is further instantiated there by a grouping
             of interval usage codes which together fully describe the
             channel modulation. This object returns 0 if the
             docsIfCmtsModulationTable does not exist or is empty."
        ::= { docsIfUpstreamChannelEntry 4 }

docsIfUpChannelSlotSize OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The number of 6.25 microsecond ticks in each upstream mini-
             slot."
        ::= { docsIfUpstreamChannelEntry 5 }

docsIfUpChannelTxTimingOffset OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "A measure of the current round trip time at the CM, or the
             maximum round trip time seen by the CMTS.  Used for timing
             of CM upstream transmissions to ensure synchronized
             arrivals at the CMTS. Units are in terms of
             (6.25 microseconds/64)."
        ::= { docsIfUpstreamChannelEntry 6 }

docsIfUpChannelRangingBackoffStart OBJECT-TYPE
        SYNTAX      INTEGER (0..16)
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The initial random backoff window to use when retrying
             Ranging Requests. Expressed as a power of 2. A value of 16
             at the CMTS indicates that a proprietary adaptive retry
             mechanism is to be used."
        ::= { docsIfUpstreamChannelEntry 7 }

docsIfUpChannelRangingBackoffEnd OBJECT-TYPE
        SYNTAX      INTEGER (0..16)
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The final random backoff window to use when retrying
             Ranging Requests. Expressed as a power of 2. A value of 16
             at the CMTS indicates that a proprietary adaptive retry
             mechanism is to be used."
        ::= { docsIfUpstreamChannelEntry 8 }


Expires March 1998                                             [Page 20]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


docsIfUpChannelTxBackoffStart OBJECT-TYPE
        SYNTAX      INTEGER (0..16)
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The initial random backoff window to use when retrying
             transmissions. Expressed as a power of 2. A value of 16
             at the CMTS indicates that a proprietary adaptive retry
             mechanism is to be used."
        ::= { docsIfUpstreamChannelEntry 9 }

docsIfUpChannelTxBackoffEnd OBJECT-TYPE
        SYNTAX      INTEGER (0..16)
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The final random backoff window to use when retrying
             transmissions. Expressed as a power of 2. A value of 16
             at the CMTS indicates that a proprietary adaptive retry
             mechanism is to be used."
        ::= { docsIfUpstreamChannelEntry 10 }

-- The following table describes the attributes of each class of
-- service.
-- The entries in this table are referenced from the
-- docsIfServiceEntries.
-- They exist as a separate table in order to reduce redundant
-- information in docsIfServiceTable.
--
-- This table is implemented at both the CM and the CMTS.
-- The CM need only maintain entries for the classes of service
-- referenced by its docsIfServiceTable.
--

docsIfQosProfileTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfQosProfileEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes the attributes for each class of service."
        ::= { docsIfBaseObjects 3 }

docsIfQosProfileEntry OBJECT-TYPE
        SYNTAX      DocsIfQosProfileEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes the attributes for a single class of service.
             Entries in this table are created at CM registration time
             as required."
        INDEX { docsIfQosProfIndex }
        ::= { docsIfQosProfileTable 1 }


Expires March 1998                                             [Page 21]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


DocsIfQosProfileEntry ::= SEQUENCE {
            docsIfQosProfIndex                INTEGER,
            docsIfQosProfPriority             INTEGER,
            docsIfQosProfMaxUpBandwidth       INTEGER,
            docsIfQosProfGuarUpBandwidth      INTEGER,
            docsIfQosProfMaxDownBandwidth     INTEGER,
            docsIfQosProfMaxTxBurst           INTEGER
        }

docsIfQosProfIndex OBJECT-TYPE
        SYNTAX      INTEGER (1..2147483647)
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "The index value which uniquely identifies an entry
             in the docsIfQosProfileTable."
        ::= { docsIfQosProfileEntry 1 }

docsIfQosProfPriority  OBJECT-TYPE
        SYNTAX      INTEGER (0..7)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "A relative priority assigned to this service when
             allocating bandwidth. Zero indicates lowest priority;
             seven highest.
             Interpretation of priority is device-specific."
        ::= { docsIfQosProfileEntry 2 }

docsIfQosProfMaxUpBandwidth OBJECT-TYPE
        SYNTAX      INTEGER (0..100000000)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The maximum upstream bandwidth, in bits per second,
             allowed for a service with this service class.
             Zero if there is no restriction of upstream bandwidth."
        ::= { docsIfQosProfileEntry 3 }

docsIfQosProfGuarUpBandwidth OBJECT-TYPE
        SYNTAX      INTEGER (0..100000000)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Minimum guaranteed upstream bandwidth, in bits per second,
             allowed for a service with this service class."
        ::= { docsIfQosProfileEntry 4 }

docsIfQosProfMaxDownBandwidth OBJECT-TYPE
        SYNTAX      INTEGER (0..100000000)
        MAX-ACCESS  read-only
        STATUS      current


Expires March 1998                                             [Page 22]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        DESCRIPTION
            "The maximum downstream bandwidth, in bits per second,
             allowed for a service with this service class.
             Zero if there is no restriction of downstream bandwidth."
        ::= { docsIfQosProfileEntry 5 }

docsIfQosProfMaxTxBurst OBJECT-TYPE
        SYNTAX      INTEGER (0..255)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The maximum number of mini-slots that may be requested
             for a single upstream transmission.
             A value of zero means there is no limit."
        ::= { docsIfQosProfileEntry 6 }


docsIfSignalQualityTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfSignalQualityEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "At the CM, describes the PHY signal quality of downstream
             channels. At the CMTS, describes the PHY signal quality of
             upstream channels. At the CMTS, this table may exclude
             contention intervals."
        ::= { docsIfBaseObjects 4 }

docsIfSignalQualityEntry OBJECT-TYPE
        SYNTAX      DocsIfSignalQualityEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "At the CM, describes the PHY characteristics of a
             downstream channel. At the CMTS, describes the PHY signal
             quality of an upstream channel.
             An entry in this table exists for each ifEntry with an
             ifType of docsCableUpstream(xx) for Cable Modem Termination
             Systems and docsCableDownstream(xx) for Cable Modems."
        INDEX { ifIndex }
        ::= { docsIfSignalQualityTable 1 }

DocsIfSignalQualityEntry ::= SEQUENCE {
            docsIfSigQIncludesContention  TruthValue,
            docsIfSigQUnerroreds          Counter32,
            docsIfSigQCorrecteds          Counter32,
            docsIfSigQUncorrectables      Counter32,
            docsIfSigQSignalNoise         TenthdBmV,
            docsIfSigQMicroreflections    INTEGER
        }

docsIfSigQIncludesContention OBJECT-TYPE


Expires March 1998                                             [Page 23]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        SYNTAX      TruthValue
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "true(1) if this CMTS includes contention intervals in
             the counters in this table. Always false(2) for CMs."
        ::= { docsIfSignalQualityEntry 1 }

docsIfSigQUnerroreds OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Codewords received on this channel without error.
             This includes all codewords, whether or not they
             were part of frames destined for this device."
        ::= { docsIfSignalQualityEntry 2 }

docsIfSigQCorrecteds OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Codewords received on this channel with correctable
             errors. This includes all codewords, whether or not
             they were part of frames destined for this device."
        ::= { docsIfSignalQualityEntry 3 }

docsIfSigQUncorrectables OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Codewords received on this channel with uncorrectable
             errors. This includes all codewords, whether or not
             they were part of frames destined for this device."
        ::= { docsIfSignalQualityEntry 4 }

docsIfSigQSignalNoise OBJECT-TYPE
        SYNTAX      TenthdBmV
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Signal/Noise ratio as perceived for this channel.
             Only meaningful in Cable Modems. Returns zero for
             Cable Modem Termination Systems."
        ::= { docsIfSignalQualityEntry 5 }

docsIfSigQMicroreflections OBJECT-TYPE
        SYNTAX      INTEGER (0..255)
        UNITS       "dBc"
        MAX-ACCESS  read-only


Expires March 1998                                             [Page 24]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        STATUS      current
        DESCRIPTION
            "Total microreflections including in-channel response
             as perceived on this interface, measured in dBc below
             the signal level.
             This object is not assumed to return an absolutely
             accurate value, but should give a rough indication
             of microreflections received on this interface.
             It is up to the implementor to provide information
             as accurate as possible."
        ::= { docsIfSignalQualityEntry 6 }

--
-- CABLE MODEM GROUP
--

-- #######

--
-- The CM MAC Table
--

docsIfCmMacTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfCmMacEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes the attributes of each CM MAC interface,
             extending the information available from ifEntry."
        ::= { docsIfCmObjects 1 }

docsIfCmMacEntry OBJECT-TYPE
        SYNTAX      DocsIfCmMacEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "An entry containing objects describing attributes of
             each MAC entry, extending the information in ifEntry.
             An entry in this table exists for each ifEntry with an
             ifType of docsCableMaclayer(xx)."
        INDEX { ifIndex }
        ::= { docsIfCmMacTable 1 }

DocsIfCmMacEntry ::= SEQUENCE {
            docsIfCmCmtsAddress           MacAddress,
            docsIfCmCapabilities          BITS,
            docsIfCmRangingRespTimeout    TimeTicks
        }

docsIfCmCmtsAddress OBJECT-TYPE
        SYNTAX      MacAddress
        MAX-ACCESS  read-only


Expires March 1998                                             [Page 25]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        STATUS      current
        DESCRIPTION
            "Identifies the CMTS that is believed to control this MAC
             domain. At the CM, this will be the source address from
             SYNC, MAP, and other MAC-layer messages. If the CMTS is
             unknown, returns 00-00-00-00-00-00."
        ::= { docsIfCmMacEntry 1 }

docsIfCmCapabilities OBJECT-TYPE
        SYNTAX      BITS {
            atmCells(0),
            concatenation(1)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Identifies the capabilities of the MAC implementation
             at this interface. Note that packet transmission is
             always supported. Therefore, there is no specific bit
             required to explicitely indicate this capability."
        ::= { docsIfCmMacEntry 2 }

docsIfCmRangingRespTimeout OBJECT-TYPE
        SYNTAX      TimeTicks
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Waiting time for a Ranging Response packet."
        REFERENCE
            "Data over Cable Radio Frequency Interface specification,
             Section 7, timer T3"
        DEFVAL { 20 }
        ::= { docsIfCmMacEntry 3 }

--
-- CM status table.
-- This table is implemented only at the CM.
--

docsIfCmStatusTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfCmStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "This table maintains a number of status objects
             and counters for Cable Modems."
        ::= { docsIfCmObjects 2 }

docsIfCmStatusEntry OBJECT-TYPE
        SYNTAX      DocsIfCmStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current


Expires March 1998                                             [Page 26]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        DESCRIPTION
            "A set of status objects and counters for a single MAC
             layer instance in a Cable Modem.
             An entry in this table exists for each ifEntry with an
             ifType of docsCableMaclayer(xx)."
        INDEX { ifIndex }
        ::= { docsIfCmStatusTable 1 }

DocsIfCmStatusEntry ::= SEQUENCE {
            docsIfCmStatusValue                     INTEGER,
            docsIfCmStatusCode                      OCTET STRING,
            docsIfCmStatusTxPower                   TenthdBmV,
            docsIfCmStatusResets                    Counter32,
            docsIfCmStatusLostSyncs                 Counter32,
            docsIfCmStatusInvalidMaps               Counter32,
            docsIfCmStatusInvalidUcds               Counter32,
            docsIfCmStatusInvalidRangingResp        Counter32,
            docsIfCmStatusInvalidRegistrationResp   Counter32,
            docsIfCmStatusT1Timeouts                Counter32,
            docsIfCmStatusT2Timeouts                Counter32,
            docsIfCmStatusT3Timeouts                Counter32,
            docsIfCmStatusT4Timeouts                Counter32,
            docsIfCmStatusRangingAborteds           Counter32
        }

docsIfCmStatusValue OBJECT-TYPE
        SYNTAX      INTEGER {
            other(1),
            notReady(2),
            notSynchronized(3),
            phySynchronized(4),
            usParametersAcquired(5),
            rangingComplete(6),
            ipComplete(7),
            todEstablished(8),
            securityEstablished(9),
            paramTransferComplete(10),
            registrationComplete(11),
            operational(12),
            accessDenied(13)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Current Cable Modem connectivity state, as specified
             in the RF Interface Specification."
        REFERENCE
            "Data over Cable Radio Frequency Interface Specification,
             Chapter 7.2."
        ::= { docsIfCmStatusEntry 1 }

docsIfCmStatusCode OBJECT-TYPE


Expires March 1998                                             [Page 27]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        SYNTAX      OCTET STRING
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Status code for this Cable Modem as defined in the
             RF Interface Specification. The status code consists
             of a single character indicating error groups, followed
             by a two- or three-digit number indicating the status
             condition."
        REFERENCE
            "Data over Cable Radio Frequency Interface Specification,
             Cable Modem status codes."

        ::= { docsIfCmStatusEntry 2 }

docsIfCmStatusTxPower OBJECT-TYPE
        SYNTAX      TenthdBmV
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The operational transmit power for the attached upstream
             channel."
        ::= { docsIfCmStatusEntry 3 }

docsIfCmStatusResets OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times the CM reset or initialized
             this interface."
        ::= { docsIfCmStatusEntry 4 }

docsIfCmStatusLostSyncs OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times the CM lost synchronization with
             the downstream channel."
        ::= { docsIfCmStatusEntry 5 }

docsIfCmStatusInvalidMaps OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times the CM received invalid MAP messages."
        ::= { docsIfCmStatusEntry 6 }

docsIfCmStatusInvalidUcds OBJECT-TYPE
        SYNTAX      Counter32


Expires March 1998                                             [Page 28]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times the CM received invalid UCD messages."
        ::= { docsIfCmStatusEntry 7 }

docsIfCmStatusInvalidRangingResp OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times the CM received invalid ranging response
             messages."
        ::= { docsIfCmStatusEntry 8 }

docsIfCmStatusInvalidRegistrationResp OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times the CM received invalid registration
             response messages."
        ::= { docsIfCmStatusEntry 9 }

docsIfCmStatusT1Timeouts OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times counter T1 expired in the CM."
        ::= { docsIfCmStatusEntry 10 }

docsIfCmStatusT2Timeouts OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times counter T2 expired in the CM."
        ::= { docsIfCmStatusEntry 11 }

docsIfCmStatusT3Timeouts OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times counter T3 expired in the CM."
        ::= { docsIfCmStatusEntry 12 }

docsIfCmStatusT4Timeouts OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current


Expires March 1998                                             [Page 29]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        DESCRIPTION
            "Number of times counter T4 expired in the CM."
        ::= { docsIfCmStatusEntry 13 }

docsIfCmStatusRangingAborteds OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Number of times the ranging process was aborted
             by the CMTS."
        ::= { docsIfCmStatusEntry 14 }

--
-- The Cable Modem Service Table
--

docsIfCmServiceTable  OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfCmServiceEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes the attributes of each upstream service queue
             on a CM."
        ::= { docsIfCmObjects 3 }

docsIfCmServiceEntry OBJECT-TYPE
        SYNTAX      DocsIfCmServiceEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes the attributes of an upstream bandwidth service
             queue.
             An entry in this table exists for each Service ID.
             The primary index is an ifIndex with an ifType of
             docsCableMaclayer(xx)."
        INDEX { ifIndex, docsIfCmServiceId }
        ::= { docsIfCmServiceTable 1 }

DocsIfCmServiceEntry ::= SEQUENCE {
            docsIfCmServiceId               INTEGER,
            docsIfCmServiceQosProfile       INTEGER,
            docsIfCmServiceTxSlotsImmed     Counter32,
            docsIfCmServiceTxSlotsDed       Counter32,
            docsIfCmServiceTxRetries        Counter32,
            docsIfCmServiceTxExceeded       Counter32,
            docsIfCmServiceRqRetries        Counter32,
            docsIfCmServiceRqExceeded       Counter32
        }

docsIfCmServiceId OBJECT-TYPE
        SYNTAX      INTEGER (1..16383)


Expires March 1998                                             [Page 30]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Identifies a service queue for upstream bandwidth. The
             attributes of this service queue are shared between the
             CM and the CMTS. The CMTS allocates upstream bandwidth
             to this service queue based on requests from the CM and
             on the class of service associated with this queue."
        ::= { docsIfCmServiceEntry 1 }

docsIfCmServiceQosProfile OBJECT-TYPE
        SYNTAX      INTEGER (1..2147483647)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The index in docsIfQosProfileTable describing the quality
             of service attributes associated with this particular
             service."
        ::= { docsIfCmServiceEntry 2 }

docsIfCmServiceTxSlotsImmed OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The number of upstream mini-slots which have been used to
             transmit data PDUs in immediate (contention) mode. This
             includes only those PDUs which are presumed to have
             arrived at the headend (i.e., those which were explicitly
             acknowledged.) It does not include retransmission attempts
             or mini-slots used by Requests."
        ::= { docsIfCmServiceEntry 3 }

docsIfCmServiceTxSlotsDed OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The number of upstream mini-slots which have been used to
             transmit data PDUs in dedicated mode (i.e., as a result
             of a unicast Data Grant)."
        ::= { docsIfCmServiceEntry 4 }

docsIfCmServiceTxRetries OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The number of attempts to transmit data PDUs containing
             requests for acknowledgment which did not result in
             acknowledgment."
        ::= { docsIfCmServiceEntry 5 }


Expires March 1998                                             [Page 31]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


docsIfCmServiceTxExceeded OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The number of data PDUs transmission failures due to
             excessive retries without acknowledgment."
        ::= { docsIfCmServiceEntry 6 }

docsIfCmServiceRqRetries OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The number of attempts to transmit bandwidth requests
             which did not result in acknowledgment."
        ::= { docsIfCmServiceEntry 7 }

docsIfCmServiceRqExceeded OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The number of requests for bandwidth which failed due to
             excessive retries without acknowledgment."
        ::= { docsIfCmServiceEntry 8 }

--
-- CMTS GROUP
--

--
-- The CMTS MAC Table
--

docsIfCmtsMacTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfCmtsMacEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes the attributes of each CMTS MAC interface,
             extending the information available from ifEntry.
             Mandatory for all CMTS devices."
        ::= { docsIfCmtsObjects 1 }

docsIfCmtsMacEntry OBJECT-TYPE
        SYNTAX      DocsIfCmtsMacEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "An entry containing objects describing attributes of each
             MAC entry, extending the information in ifEntry.


Expires March 1998                                             [Page 32]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


             An entry in this table exists for each ifEntry with an
             ifType of docsCableMaclayer(xx)."
        INDEX { ifIndex }
        ::= { docsIfCmtsMacTable 1 }

DocsIfCmtsMacEntry ::= SEQUENCE {
            docsIfCmtsCapabilities            BITS,
            docsIfCmtsSyncInterval            INTEGER,
            docsIfCmtsUcdInterval             INTEGER,
            docsIfCmtsMaxServiceIds           INTEGER,
            docsIfCmtsInsertionInterval       TimeTicks,
            docsIfCmtsInvitedRangingAttempts  INTEGER
        }

docsIfCmtsCapabilities OBJECT-TYPE
        SYNTAX      BITS {
            atmCells(0),
            concatenation(1)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Identifies the capabilities of the CMTS MAC
             implementation at this interface. Note that packet
             transmission is always supported. Therefore, there
             is no specific bit required to explicitely indicate
             this capability."
        ::= { docsIfCmtsMacEntry 1 }

docsIfCmtsSyncInterval OBJECT-TYPE
        SYNTAX      INTEGER (1..200)
        UNITS       "Milliseconds"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The interval between CMTS transmission of successive SYNC
             messages at this interface."
        REFERENCE
            "Data Over Cable Radio Frequency Interface Specification,
             Sync Interval."
        ::= { docsIfCmtsMacEntry 2 }

docsIfCmtsUcdInterval OBJECT-TYPE
        SYNTAX      INTEGER (1..2000)
        UNITS       "Milliseconds"
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The interval between CMTS transmission of successive
             Upstream Channel Descriptor messages for each upstream
             channel at this interface."
        REFERENCE


Expires March 1998                                             [Page 33]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


            "Data Over Cable Radio Frequency Interface Specification,
             UCD Interval."
        ::= { docsIfCmtsMacEntry 3 }

docsIfCmtsMaxServiceIds OBJECT-TYPE
        SYNTAX     INTEGER (1..16383)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The maximum number of service IDs that may be
             simultaneously active."
        ::= { docsIfCmtsMacEntry 4 }

docsIfCmtsInsertionInterval OBJECT-TYPE
        SYNTAX      TimeTicks
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The amount of time to elapse between each broadcast
             station maintenance grant. Broadcast station maintenance
             grants are used to allow new cable modems to join the
             network. Zero indicates that a vendor-specific algorithm
             is used instead of a fixed time. Maximum amount of time
             permitted by the specification is 2 seconds."
        REFERENCE
            "Data Over Cable Radio Frequency Interface Specification,
             Ranging Interval."
        ::= { docsIfCmtsMacEntry 5 }

docsIfCmtsInvitedRangingAttempts OBJECT-TYPE
        SYNTAX      INTEGER (0..1024)
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The maximum number of attempts to make on invitations
             for ranging requests. A value of zero means the syatem
             should attempt to range forever."
        ::= { docsIfCmtsMacEntry 6 }

--
-- CMTS status table.
--

docsIfCmtsStatusTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfCmtsStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "For the MAC layer, this group maintains a number of
             status objects and counters."
        ::= { docsIfCmtsObjects 2 }


Expires March 1998                                             [Page 34]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


docsIfCmtsStatusEntry OBJECT-TYPE
        SYNTAX      DocsIfCmtsStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Status entry for a single MAC layer.
             An entry in this table exists for each ifEntry with an
             ifType of docsCableMaclayer(xx)."
        INDEX { ifIndex }
        ::= { docsIfCmtsStatusTable 1 }

DocsIfCmtsStatusEntry ::= SEQUENCE {
            docsIfCmtsStatusInvalidRangeReqs        Counter32,
            docsIfCmtsStatusRangingAborteds         Counter32,
            docsIfCmtsStatusInvalidRegReqs          Counter32,
            docsIfCmtsStatusFailedRegReqs           Counter32,
            docsIfCmtsStatusInvalidDataReqs         Counter32,
            docsIfCmtsStatusT5Timeouts              Counter32
        }

docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This object counts invalid RNG-REQ messages received on
             this interface."
        ::= { docsIfCmtsStatusEntry 1 }

docsIfCmtsStatusRangingAborteds OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This object counts ranging attempts that were explicitely
             aborted by the CMTS."
        ::= { docsIfCmtsStatusEntry 2 }

docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This object counts invalid REG-REQ messages received on
             this interface."
        ::= { docsIfCmtsStatusEntry 3 }

docsIfCmtsStatusFailedRegReqs OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION


Expires March 1998                                             [Page 35]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


            "This object counts failed registration attempts, i.e.,
             authentication failures and class of service failures,
             on this interface."
        ::= { docsIfCmtsStatusEntry 4 }

docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This object counts invalid data request messages
             received on this interface."
        ::= { docsIfCmtsStatusEntry 5 }

docsIfCmtsStatusT5Timeouts OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This object counts the number of times counter T5
             expired on this interface."
        ::= { docsIfCmtsStatusEntry 6 }

--
-- CM status table (within CMTS).
-- This table is implemented only at the CMTS.
-- It contains per CM status information available in the CMTS.
--

docsIfCmtsCmStatusTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfCmtsCmStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "A set of objects in the CMTS, maintained for each
             Cable Modem connected to this CMTS."
        ::= { docsIfCmtsObjects 3 }

docsIfCmtsCmStatusEntry OBJECT-TYPE
        SYNTAX      DocsIfCmtsCmStatusEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Status information for a single Cable Modem.
             An entry in this table exists for each Cable Modem
             that is connected to the CMTS implementing this table."
        INDEX { docsIfCmtsCmStatusIndex }
        ::= { docsIfCmtsCmStatusTable 1 }

DocsIfCmtsCmStatusEntry ::= SEQUENCE {
            docsIfCmtsCmStatusIndex               INTEGER,
            docsIfCmtsCmStatusMacAddress          MacAddress,


Expires March 1998                                             [Page 36]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


            docsIfCmtsCmStatusIpAddress           IpAddress,
            docsIfCmtsCmStatusDownChannelIfIndex  InterfaceIndexOrZero,
            docsIfCmtsCmStatusUpChannelIfIndex    InterfaceIndexOrZero,
            docsIfCmtsCmStatusRxPower             TenthdBmV,
            docsIfCmtsCmStatusTimingOffset        Unsigned32,
            docsIfCmtsCmStatusEqualizationData    OCTET STRING
        }

docsIfCmtsCmStatusIndex OBJECT-TYPE
        SYNTAX      INTEGER (1..2147483647)
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Index value to uniquely identify an entry in this table.
             For an individual Cable Modem, this index value should
             not change during CMTS uptime."
        ::= { docsIfCmtsCmStatusEntry 1 }

docsIfCmtsCmStatusMacAddress OBJECT-TYPE
        SYNTAX      MacAddress
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "MAC address of this Cable Modem. If the Cable Modem has
             multiple MAC addresses, this is the MAC address associated
             with the Cable interface."
        ::= { docsIfCmtsCmStatusEntry 2 }

docsIfCmtsCmStatusIpAddress OBJECT-TYPE
        SYNTAX      IpAddress
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "IP address of this Cable Modem. If the Cable Modem has no
             IP address assigned, or the IP address is unknown, this
             object returns a value of 0.0.0.0. If the Cable Modem has
             multiple IP addresses, this object returns the IP address
             associated with the Cable interface."
        ::= { docsIfCmtsCmStatusEntry 3 }

docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE
        SYNTAX      InterfaceIndexOrZero
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "IfIndex of the downstream channel this CM is connected
             to. If the downstream channel is unknown, this object
             returns a value of zero."
        ::= { docsIfCmtsCmStatusEntry 4 }

docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE
        SYNTAX      InterfaceIndexOrZero


Expires March 1998                                             [Page 37]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "IfIndex of the upstream channel this CM is connected
             to. If the upstream channel is unknown, this object
             returns a value of zero."
        ::= { docsIfCmtsCmStatusEntry 5 }

docsIfCmtsCmStatusRxPower OBJECT-TYPE
        SYNTAX      TenthdBmV
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The receive power as percieved for upstream data from
             this Cable Modem.
             If the receive power is unknown, this object returns
             a value of zero."
        ::= { docsIfCmtsCmStatusEntry 6 }

docsIfCmtsCmStatusTimingOffset OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "A measure of the current round trip time for this CM.
             Used for timing of CM upstream transmissions to ensure
             synchronized arrivals at the CMTS. Units are in terms
             of (6.25 microseconds/64). Returns zero if the value
             is unknown."
        ::= { docsIfCmtsCmStatusEntry 7 }

docsIfCmtsCmStatusEqualizationData OBJECT-TYPE
        SYNTAX      OCTET STRING
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Equalization data for this CM. Returns an empty string
             if the value is unknown or if there is no equalization
             data available or defined."
        REFERENCE
            "Data over Cable Radio Frequency Interface Specification,
             Figure 6-22."
        ::= { docsIfCmtsCmStatusEntry 8 }

--
-- The CMTS Service Table.
--

docsIfCmtsServiceTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfCmtsServiceEntry
        MAX-ACCESS  not-accessible
        STATUS      current


Expires March 1998                                             [Page 38]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        DESCRIPTION
            "Describes the attributes of upstream service queues
             in a Cable Modem Termination System."
        ::= { docsIfCmtsObjects 4 }

docsIfCmtsServiceEntry OBJECT-TYPE
        SYNTAX      DocsIfCmtsServiceEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes the attributes of a single upstream bandwidth
             service queue.
             Entries in this table exist for each ifEntry with an
             ifType of docsCableMaclayer(xx), and for each service
             queue (Service ID) within this MAC layer.
             Entries in this table are created with the creation of
             individual Service IDs by the MAC layer and removed
             when a Service ID is removed."
        INDEX { ifIndex, docsIfCmtsServiceId }
        ::= { docsIfCmtsServiceTable 1 }

DocsIfCmtsServiceEntry ::= SEQUENCE {
            docsIfCmtsServiceId               INTEGER,
            docsIfCmtsServiceCmStatusIndex    INTEGER,
            docsIfCmtsServiceAdminStatus      INTEGER,
            docsIfCmtsServiceQosProfile       Integer32,
            docsIfCmtsServiceCreateTime       TimeTicks,
            docsIfCmtsServiceInOctets         Counter32,
            docsIfCmtsServiceInPackets        Counter32
        }

docsIfCmtsServiceId OBJECT-TYPE
        SYNTAX      INTEGER (1..16383)
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Identifies a service queue for upstream bandwidth. The
             attributes of this service queue are shared between the
             Cable Modem and the Cable Modem Termination System.
             The CMTS allocates upstream bandwidth to this service
             queue based on requests from the CM and on the class of
             service associated with this queue."
        ::= { docsIfCmtsServiceEntry 1 }

docsIfCmtsServiceCmStatusIndex OBJECT-TYPE
        SYNTAX      INTEGER (0..2147483647)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "Pointer to an entry in docsIfCmtsCmStatusTable identifying
             the Cable Modem using this Service Queue. If multiple
             Cable Modems are using this Service Queue, the value of


Expires March 1998                                             [Page 39]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


             this object is zero."
        ::= { docsIfCmtsServiceEntry 2 }

docsIfCmtsServiceAdminStatus OBJECT-TYPE
        SYNTAX      INTEGER {
            enabled(1),
            disabled(2),
            destroyed(3) }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "Allows a service class for a particular modem to be
             suppressed, (re-)enabled, or deleted altogether."
        ::= { docsIfCmtsServiceEntry 3 }

docsIfCmtsServiceQosProfile OBJECT-TYPE
        SYNTAX      Integer32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The index in docsIfQosProfileTable describing the quality
             of service attributes associated with this particular
             service."
        ::= { docsIfCmtsServiceEntry 4 }

docsIfCmtsServiceCreateTime OBJECT-TYPE
        SYNTAX      TimeTicks
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The value of sysUpTime when this entry was created."
        ::= { docsIfCmtsServiceEntry 5 }

docsIfCmtsServiceInOctets OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The cumulative number of Packet Data octets received
             on this Service ID. The count does not include the
             size of the Cable MAC header"
        ::= { docsIfCmtsServiceEntry 6 }

docsIfCmtsServiceInPackets OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The cumulative number of Packet Data packets received
             on this Service ID."
        ::= { docsIfCmtsServiceEntry 7 }


Expires March 1998                                             [Page 40]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


--
-- The following table provides upstream channel modulation profiles.
-- Entries in this table can be
-- re-used by one or more upstream channels. An upstream channel will
-- have a modulation profile
-- for each value of docsIfModIntervalUsageCode.
--

docsIfCmtsModulationTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF DocsIfCmtsModulationEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes a modulation profile associated with one or more
             upstream channels."
        ::= { docsIfCmtsObjects 5 }

docsIfCmtsModulationEntry OBJECT-TYPE
        SYNTAX      DocsIfCmtsModulationEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Describes a modulation profile for an Interval Usage Code
             for one or more upstream channels.
             Entries in this table are created by the operator. Initial
             default entries may be created at system initialization
             time. No individual objects have to be specified in order
             to create an entry in this table."
        INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode }
        ::= { docsIfCmtsModulationTable 1 }

DocsIfCmtsModulationEntry ::= SEQUENCE {
            docsIfCmtsModIndex                    INTEGER,
            docsIfCmtsModIntervalUsageCode        INTEGER,
            docsIfCmtsModControl                  RowStatus,
            docsIfCmtsModType                     INTEGER,
            docsIfCmtsModPreambleLen              INTEGER,
            docsIfCmtsModDifferentialEncoding     TruthValue,
            docsIfCmtsModFECErrorCorrection       INTEGER,
            docsIfCmtsModFECCodewordLength        INTEGER,
            docsIfCmtsModScramblerSeed            INTEGER,
            docsIfCmtsModMaxBurstSize             INTEGER,
            docsIfCmtsModGuardTimeSize            Unsigned32,
            docsIfCmtsModLastCodewordShortened    TruthValue,
            docsIfCmtsModScrambler                TruthValue
        }

docsIfCmtsModIndex OBJECT-TYPE
        SYNTAX       INTEGER (1..2147483647)
        MAX-ACCESS   not-accessible
        STATUS      current
        DESCRIPTION


Expires March 1998                                             [Page 41]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


             "An index into the Channel Modulation table representing
              a group of Interval Usage Codes, all associated with the
              same channel."
        ::= { docsIfCmtsModulationEntry 1 }

docsIfCmtsModIntervalUsageCode OBJECT-TYPE
        SYNTAX       INTEGER {
            request(1),
            requestData(2),
            initialRanging(3),
            periodicRanging(4),
            shortData(5),
            longData(6)
        }
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "An index into the Channel Modulation table which, when
             grouped with other Interval Usage Codes, fully
             instantiate all modulation sets for a given upstream
             channel."
        ::= { docsIfCmtsModulationEntry 2 }

docsIfCmtsModControl OBJECT-TYPE
        SYNTAX      RowStatus
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "Controls and reflects the status of rows in this table."
        ::= { docsIfCmtsModulationEntry 3 }

docsIfCmtsModType OBJECT-TYPE
        SYNTAX      INTEGER {
            other(1),
            qpsk(2),
            qam16(3)
        }
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "The modulation type used on this channel."
        DEFVAL { qpsk }
        ::= { docsIfCmtsModulationEntry 4 }

docsIfCmtsModPreambleLen OBJECT-TYPE
        SYNTAX      INTEGER (0..1024)
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "The preamble length for this modulation profile in bits.
             Default value is the minimum needed by the implementation
             at the CMTS for the given modulation profile."


Expires March 1998                                             [Page 42]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


        ::= { docsIfCmtsModulationEntry 5 }

docsIfCmtsModDifferentialEncoding OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "Specifies whether or not differential encoding is used
             on this channel."
        DEFVAL { false }
        ::= { docsIfCmtsModulationEntry 6 }

docsIfCmtsModFECErrorCorrection OBJECT-TYPE
        SYNTAX      INTEGER (0..10)
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "The number of correctable errored bytes (t) used in
             forward error correction code. The value of 0 indicates
             no correction is employed. The number of check bytes
             appended will be twice this value."
        DEFVAL { 0 }
        ::= { docsIfCmtsModulationEntry 7 }

docsIfCmtsModFECCodewordLength OBJECT-TYPE
        SYNTAX      INTEGER (1..255)
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "The number of data bytes (k) in the forward error
             correction codeword.
             This object is not used if docsIfCmtsModFECErrorCorrection
             is zero."
        DEFVAL { 32 }
        ::= { docsIfCmtsModulationEntry 8 }

docsIfCmtsModScramblerSeed OBJECT-TYPE
        SYNTAX      INTEGER (0..32767)
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "The 15 bit seed value for the scrambler polynomial."
        DEFVAL { 0 }
        ::= { docsIfCmtsModulationEntry 9 }

docsIfCmtsModMaxBurstSize OBJECT-TYPE
        SYNTAX      INTEGER (0..255)
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "The maximum number of mini-slots that can be transmitted
             during this channel's burst time. Returns zero if the


Expires March 1998                                             [Page 43]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


             burst length is bounded by the allocation MAP rather than
             this profile.
             Default value is 0 except for shortData, where it is 8."
        ::= { docsIfCmtsModulationEntry 10 }

docsIfCmtsModGuardTimeSize OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The number of symbol-times which must follow the end of
             this channel's burst. Default value is the minimum time
             needed by the implementation for this modulation profile."
        ::= { docsIfCmtsModulationEntry 11 }

docsIfCmtsModLastCodewordShortened OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "Indicates if the last FEC codeword is truncated."
        DEFVAL { true }
        ::= { docsIfCmtsModulationEntry 12 }

docsIfCmtsModScrambler OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "Indicates if the scrambler is employed."
        DEFVAL { false }
        ::= { docsIfCmtsModulationEntry 13 }

--
-- notification group is for future extension.
--
docsIfNotification OBJECT IDENTIFIER     ::= { docsIfMib 2 }

docsIfConformance  OBJECT IDENTIFIER     ::= { docsIfMib 3 }
docsIfCompliances  OBJECT IDENTIFIER     ::= { docsIfConformance 1 }
docsIfGroups       OBJECT IDENTIFIER     ::= { docsIfConformance 2 }

-- compliance statements

docsIfBasicCompliance MODULE-COMPLIANCE
        STATUS      current
        DESCRIPTION
            "The compliance statement for devices that implement MCNS
             compliant Radio Frequency Interfaces."

MODULE  -- docsIfMib


Expires March 1998                                             [Page 44]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


-- unconditionally mandatory groups
MANDATORY-GROUPS {
        docsIfBasicGroup
        }

-- conditionally mandatory group
GROUP docsIfCmGroup
        DESCRIPTION
            "This group is implemented only in Cable Modems, not in
             Cable Modem Termination Systems."

-- conditionally mandatory group
GROUP docsIfCmtsGroup
        DESCRIPTION
            "This group is implemented only in Cable Modem Termination
             Systems, not in Cable Modems."

OBJECT  docsIfDownChannelFrequency
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfDownChannelWidth
        MIN-ACCESS  read-only
        DESCRIPTION
            "It is conformant to implement this object as read-only.
             In Cable Modems, this object is always implemented as
             read-only."

OBJECT  docsIfDownChannelModulation
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfDownChannelInterleave
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfUpChannelFrequency
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfUpChannelWidth
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;


Expires March 1998                                             [Page 45]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


             read-only in Cable Modems."

OBJECT  docsIfUpChannelModulationProfile
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfUpChannelSlotSize
        MIN-ACCESS  read-only
        DESCRIPTION
            "This object is always read-only in Cable Modems.
             It is compliant to implement this object as read-only
             in Cable Modem Termination Systems."

OBJECT  docsIfUpChannelRangingBackoffStart
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfUpChannelRangingBackoffEnd
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfUpChannelTxBackoffStart
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfUpChannelTxBackoffEnd
        MIN-ACCESS  read-only
        DESCRIPTION
            "Read-write in Cable Modem Termination Systems;
             read-only in Cable Modems."

OBJECT  docsIfCmtsServiceAdminStatus
        MIN-ACCESS  read-only
        DESCRIPTION
            "It is compliant to implement this object as read-only."

OBJECT  docsIfCmtsSyncInterval
        MIN-ACCESS  read-only
        DESCRIPTION
            "It is compliant to implement this object as read-only."

OBJECT  docsIfCmtsUcdInterval
        MIN-ACCESS  read-only
        DESCRIPTION


Expires March 1998                                             [Page 46]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


            "It is compliant to implement this object as read-only."

OBJECT  docsIfCmtsInsertionInterval
        MIN-ACCESS  read-only
        DESCRIPTION
            "It is compliant to implement this object as read-only."

OBJECT  docsIfCmtsInvitedRangingAttempts
        MIN-ACCESS  read-only
        DESCRIPTION
            "It is compliant to implement this object as read-only."

        ::= { docsIfCompliances 1 }

docsIfBasicGroup OBJECT-GROUP
        OBJECTS {
            docsIfDownChannelId,
            docsIfDownChannelFrequency,
            docsIfDownChannelWidth,
            docsIfDownChannelModulation,
            docsIfDownChannelInterleave,
            docsIfDownChannelPower,
            docsIfUpChannelId,
            docsIfUpChannelFrequency,
            docsIfUpChannelWidth,
            docsIfUpChannelModulationProfile,
            docsIfUpChannelSlotSize,
            docsIfUpChannelTxTimingOffset,
            docsIfUpChannelRangingBackoffStart,
            docsIfUpChannelRangingBackoffEnd,
            docsIfUpChannelTxBackoffStart,
            docsIfUpChannelTxBackoffEnd,
            docsIfQosProfPriority,
            docsIfQosProfMaxUpBandwidth,
            docsIfQosProfGuarUpBandwidth,
            docsIfQosProfMaxDownBandwidth,
            docsIfQosProfMaxTxBurst,
            docsIfSigQIncludesContention,
            docsIfSigQUnerroreds,
            docsIfSigQCorrecteds,
            docsIfSigQUncorrectables,
            docsIfSigQSignalNoise,
            docsIfSigQMicroreflections
        }
        STATUS      current
        DESCRIPTION
            "Group of objects implemented in both Cable Modems and
             Cable Modem Termination Systems."
        ::= { docsIfGroups 1 }

docsIfCmGroup OBJECT-GROUP
        OBJECTS {


Expires March 1998                                             [Page 47]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


            docsIfCmCmtsAddress,
            docsIfCmCapabilities,
            docsIfCmRangingRespTimeout,
            docsIfCmStatusValue,
            docsIfCmStatusCode,
            docsIfCmStatusTxPower,
            docsIfCmStatusResets,
            docsIfCmStatusLostSyncs,
            docsIfCmStatusInvalidMaps,
            docsIfCmStatusInvalidUcds,
            docsIfCmStatusInvalidRangingResp,
            docsIfCmStatusInvalidRegistrationResp,
            docsIfCmStatusT1Timeouts,
            docsIfCmStatusT2Timeouts,
            docsIfCmStatusT3Timeouts,
            docsIfCmStatusT4Timeouts,
            docsIfCmStatusRangingAborteds,
            docsIfCmServiceQosProfile,
            docsIfCmServiceTxSlotsImmed,
            docsIfCmServiceTxSlotsDed,
            docsIfCmServiceTxRetries,
            docsIfCmServiceTxExceeded,
            docsIfCmServiceRqRetries,
            docsIfCmServiceRqExceeded
        }
        STATUS      current
        DESCRIPTION
            "Group of objects implemented in both Cable Modems and
             Cable Modem Termination Systems."
        ::= { docsIfGroups 2 }

docsIfCmtsGroup OBJECT-GROUP
        OBJECTS {
            docsIfCmtsCapabilities,
            docsIfCmtsSyncInterval,
            docsIfCmtsUcdInterval,
            docsIfCmtsMaxServiceIds,
            docsIfCmtsInsertionInterval,
            docsIfCmtsInvitedRangingAttempts,
            docsIfCmtsStatusInvalidRangeReqs,
            docsIfCmtsStatusRangingAborteds,
            docsIfCmtsStatusInvalidRegReqs,
            docsIfCmtsStatusFailedRegReqs,
            docsIfCmtsStatusInvalidDataReqs,
            docsIfCmtsStatusT5Timeouts,
            docsIfCmtsCmStatusMacAddress,
            docsIfCmtsCmStatusIpAddress,
            docsIfCmtsCmStatusDownChannelIfIndex,
            docsIfCmtsCmStatusUpChannelIfIndex,
            docsIfCmtsCmStatusRxPower,
            docsIfCmtsCmStatusTimingOffset,
            docsIfCmtsCmStatusEqualizationData,


Expires March 1998                                             [Page 48]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


            docsIfCmtsServiceCmStatusIndex,
            docsIfCmtsServiceAdminStatus,
            docsIfCmtsServiceQosProfile,
            docsIfCmtsServiceCreateTime,
            docsIfCmtsServiceInOctets,
            docsIfCmtsServiceInPackets,
            docsIfCmtsModType,
            docsIfCmtsModControl,
            docsIfCmtsModPreambleLen,
            docsIfCmtsModDifferentialEncoding,
            docsIfCmtsModFECErrorCorrection,
            docsIfCmtsModFECCodewordLength,
            docsIfCmtsModScramblerSeed,
            docsIfCmtsModMaxBurstSize,
            docsIfCmtsModGuardTimeSize,
            docsIfCmtsModLastCodewordShortened,
            docsIfCmtsModScrambler
        }
        STATUS      current
        DESCRIPTION
            "Group of objects implemented in Cable Modem Termination
             Systems."
        ::= { docsIfGroups 3 }

END




























Expires March 1998                                             [Page 49]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


5.  Acknowledgments

This document was produced by the IPCDN Working Group.  It is based on a
document written by Pam Anderson from CableLabs, Wilson Sawyer from
BayNetworks, and Rich Woundy from Continental Cablevision.

Special thanks is also due to Azlina Palmer, who helped a lot reviewing
the document.


6.  References

[1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
     S. Waldbusser, "Structure of Management Information for Version 2
     of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
     January 1996.

[2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
     for Network Management of TCP/IP-based internets: MIB-II", STD 17,
     RFC 1213, Hughes LAN Systems, Performance Systems International,
     March 1991.

[3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "A Simple
     Network Management Protocol (SNMP)", STD 15, RFC 1157, SNMP
     Research, Performance Systems International, MIT Lab for Computer
     Science, May 1990.

[4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and
     S. Waldbusser, "Protocol Operations for Version 2 of the Simple
     Network Management Protocol (SNMPv2)", RFC 1905, January 1996.

[5]  McCloghrie, K. and F. Kastenholz, "Evolution of the Interfaces
     Group of MIB-II", RFC 1573, Hughes LAN Systems, FTP Software,
     January 1994.

[6]  "MCNS Data Over Cable Services Cable Modem Radio Frequency
     Interface Specification SP-RFID01-970326", MCNS, March 1997.


7.  Security Considerations

Security issues are not discussed in this memo.











Expires March 1998                                             [Page 50]


INTERNET-DRAFT           MCNS RF Interface MIB            September 1997


8.  Author's Address

     Guenter Roeck
     cisco Systems
     170 West Tasman Drive
     San Jose, CA 95134
     U.S.A.

     Phone: +1 408 527 3143
     Email: groeck@cisco.com











































Expires March 1998                                             [Page 51]