IPCDN  Working Grop                                    John Harvey
<draft-ietf-ipcdn-qos-mib-02.txt>                      Mike Patrick
                                                       Motorola ING


               Data Over Cable System Quality of Service
              Management Information Base (DOCSIS-QOS MIB)

                            December 8, 1999







Status of this Memo

   This document is an Internet-Draft and is in full conformance with
   all the provisions of Section 10 of RFC2026.  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".

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html.


   Copyright (c) The Internet Society 1998.  All Rights Reserved.










Expires June 2000                                               [Page 1]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



Abstract

   This document defines a basic set of managed objects for SNMP-based
   management of extended QOS features of Cable Modems (CMs) and Cable
   Modem Termination Systems (CMTSs) conforming to the Data over Cable
   System (DOCSIS) standard version 1.1.


Table of Contents


       Status of this Memo...............................   1
       Abstract..........................................   2
       Revision History..................................   3

   1.  Introduction......................................   3
       1.1  Management Framework.........................   4
       1.2  Glossary.....................................   5

   2.  Overview..........................................   7
       2.1  Textual Conventions..........................   7
       2.2  MIB  Organization............................   7
            2.2.1   docsQosPktClassTable.................  11
            2.2.2   docsQosParamSetTable.................  11
            2.2.3   docsQosServiceFlowTable..............  13
            2.2.4   docsQosServiceFlowStatsTable.........  14
            2.2.5   docsQosUpstreamStatsTable............  14
            2.2.6   docsQosDynamicServiceStatsTable......  14
            2.2.7   docsQosServiceFlowLogTable...........  15
            2.2.8   docsQosServiceClassTable.............  16
            2.2.9   docsQosServiceClassPolicyTable.......  16
            2.2.10  docsQosPHSTable......................  16
            2.2.11  docsQosCmtsMacToSrvFlowTable.........  17

   3.  Externally Administered Classification............  17

   4.  Definitions.......................................  21

   5.  References........................................  66

   6.  Authors' Addresses................................  69







Expires June 2000                                               [Page 2]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



Revision History


   Rev  Date               Description
   ---  --------           -----------
   -02  12/08/99           Add docsQosServiceFlowStatsTable,
                           docsQosUpstreamStatsTable,
                           docsQosDynamicServiceStatsTable,
                           docsQosServiceFlowLogTable
   -01  06/25/99           Complete rewrite based on -I01 draft
   -00  08/07/98           Initial draft posted for discussion.





.  Introduction

   This memo specifies a MIB module in a manner that is compliant to the
   SNMP SMIv2[5][6][7].  The set of objects is consistent with the SNMP
   framework and existing SNMP standards.

   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.


1.1  Management Framework

   The SNMP Management Framework presently consists of five major
   components:
















Expires June 2000                                               [Page 3]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



   o   An overall architecture, described in RFC 2271 [1].

   o   Mechanisms for describing and naming objects and events for the
       purpose of management. The first version of this Structure of
       Management Information (SMI) is called SMIv1 and described in
       RFC 1155 [2], RFC 1212 [3] and RFC 1215 [4]. The second version,
       called SMIv2, is described in RFC 1902 [5], RFC 1903 [6] and RFC
       1904 [7].

   o   Message protocols for transferring management information. The
       first version of the SNMP message protocol is called SNMPv1 and
       described in RFC 1157 [8]. A second version of the SNMP message
       protocol, which is not an Internet standards track protocol, is
       called SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10].
       The third version of the message protocol is called SNMPv3 and
       described in RFC 1906 [10], RFC 2272 [11] and RFC 2274 [12].

   o   Protocol operations for accessing management information. The
       first set of protocol operations and associated PDU formats is
       described in RFC 1157 [8]. A second set of protocol operations
       and associated PDU formats is described in RFC 1905 [13].

   o   A set of fundamental applications described in RFC 2273 [14] and
       the view-based access control mechanism described in RFC 2275
       [15].


   Managed objects are accessed via a virtual information store, termed
   the Management Information Base or MIB.  Objects in the MIB are
   defined using the mechanisms defined in the SMI.

   This memo specifies a MIB module that is compliant to the SMIv2. A
   MIB conforming to the SMIv1 can be produced through the appropriate
   translations. The resulting translated MIB must be semantically
   equivalent, except where objects or events are omitted because no
   translation is possible (use of Counter64). Some machine readable
   information in SMIv2 will be converted into textual descriptions in
   SMIv1 during the translation process. However, this loss of machine
   readable information is not considered to change the semantics of the
   MIB.








Expires June 2000                                               [Page 4]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



1.2  Glossary



   Active QPS     Active Qos Parameter Set.  The set of QOS parameters
                  that describe the current level service provided to a
                  Service Flow.

   Active SF      Active Service Flow. An SF with a non-empty Active
                  QPS.

   Admitted QPS   Admitted Qos Parameter Set. The set of QOS parameters
                  that describe a level of service which the Service
                  Flow is not currently using, but which it is
                  guaranteed to receive upon the SF's request to make
                  the set Active.

   Admitted SF    A Service Flow with a non-empty Admitted QPS.

   CATV           Cable TV

   CM             Cable Modem, a modem connecting a subscriber's LAN the
                  CATF RF network. DOCSIS CMs operate as a MAC layer
                  bridge between the home LAN and the RF network.

   CMTS           Cable Modem Termination System, the "head-end" device
                  providing connectivity between the RF network and the
                  Internet.

   Downstream     The direction from the head end towards the
                  subscriber.

   DSA            Dynamic Service Addition, a DOCSIS MAC management
                  message requesting the dynamic creation of a new
                  Service Flow.  New SFs are created with a three-
                  message exchange of a DSA-REQ, DSA-RSP, and DSA-ACK.

   DSC            Dynamic Service Change, a DOCSIS MAC management
                  message requesting a change to the attributes of a
                  Service Flow.  SFs are changed with a three-message
                  exchange of a DSC-REQ, DSC-RSP, and DSC-ACK.

   DSD            Dynamic Service Delete, a DOCSIS MAC management
                  message requesting the deletion of a Service Flow. SFs
                  are deleted with a two-message exchange of a DSD-REQ



Expires June 2000                                               [Page 5]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                  and DSD-ACK.

   Head-end       The origination point in most cable systems of the
                  subsriber video signals. It is generally also the
                  location of the CMTS.

   PHS            Payload Header Suppression, a feature of DOCSIS 1.1 in
                  which header bytes that are common in a sequence of
                  packets of a Service Flow are replaced by a one-byte
                  PHSI Index (PHSI) when transmitting the packet on the
                  RF network.

   Provisioned QPS A QOS Parameter Set describing an envelope of service
                  within which a Service Flow is authorized to request
                  admission.  All existing service flows must have a
                  non-empty Provisioned QPS, hence all SFs are
                  considered to be "Provisioned".

   SCN            Service Class Name -- a named set of QOS parameters.
                  A Service Flow may or may not be associated with a
                  single named Service Class.  A Service Class has as an
                  attribute a Qos Parameter Set that is used as the
                  default set of values for all Service Flows belonging
                  to the Service Class.

   SID            Service ID. A 16-bit integer assigned by the CMTS for
                  an Upstream Service Flow with a non-empty Active QOS
                  Parameter Set.

   SF             Service Flow. A unidirectional stream of packets
                  between the CM and CMTS. SFs are characterized as
                  upstream or downstream.  The SF is the fundamental
                  unit of service provided on a DOCSIS CATV network.

   SFID           Service Flow ID.  A 32-bit unsigned integer assigned
                  by the CMTS to each Service Flows

   Upstream       The direction from a subscriber CM to the head-end
                  CMTS.









Expires June 2000                                               [Page 6]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



.  Overview

   This MIB provides a set of objects required for the management of
   DOCSIS 1.1 compliant Cable Modems (CM) and Cable Modem Termination
   Systems (CMTS).  The specification is derived from the DOCSIS 1.1
   Radio Frequency Interface specification [16].   Please note that the
   DOCSIS standard only requires Cable Modems to implement SNMPv1 and to
   process IPv4 customer traffic. Design choices in this MIB reflect
   those requirements.  Future versions of the DOCSIS standard are
   expected to require support for SNMPv3 and IPv6 as well.

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in [19].


2.1  Textual Conventions

   The textual convention "IfDirection" is defined to indicate the
   direction of a packet classifer relative to an interface. It takes
   the values of either inbound(1) or outbound(2).

   The textual convention "BitRate" corresponds to the bits per second
   as defined for QOS Parameter Sets in DOCSIS1.1. This definition
   includes all bits of the Ethernet MAC frame as transmitted on the RF
   network, starting with the Destination Address and ending with the
   Ethernet FCS. It does NOT includes bits in the DOCSIS MAC header.





2.2  MIB Organization


   The structure of the MIB is summarized below:












Expires June 2000                                               [Page 7]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



   docsQosMIB
     docsQosMIBObjects
       docsQosPktClassTable
         docsQosPktClassEntry
           docsQosPktClassId
           docsQosPktClassDirection
           docsQosPktClassPriority
           docsQosPktClassIpTosLow
           docsQosPktClassIpTosHigh
           docsQosPktClassIpTosMask
           docsQosPktClassIpProtocol
           docsQosPktClassIpSourceAddr
           docsQosPktClassIpSourceMask
           docsQosPktClassIpDestAddr
           docsQosPktClassIpDestMask
           docsQosPktClassSourcePortStart
           docsQosPktClassSourcePortEnd
           docsQosPktClassDestPortStart
           docsQosPktClassDestPortEnd
           docsQosPktClassDestMacAddr
           docsQosPktClassDestMacMask
           docsQosPktClassSourceMacAddr
           docsQosPktClassEnetProtocolType
           docsQosPktClassEnetProtocol
           docsQosPktClassUserPriApplies
           docsQosPktClassUserPriLow
           docsQosPktClassUserPriHigh
           docsQosPktClassVlanId
           docsQosPktClassState
           docsQosPktClassPkts
       docsQosParamSetTable
         docsQosParamSetEntry
           docsQosParamSetRowType
           docsQosParamSetIndex
           docsQosParamSetRowStatus
           docsQosParamSetServiceClassName
           docsQosParamSetPriority
           docsQosParamSetMaxTrafficRate
           docsQosParamSetMaxTrafficBurst
           docsQosParamSetMinReservedRate
           docsQosParamSetMinReservedPkt
           docsQosParamSetActiveTimeout
           docsQosParamSetAdmittedTimeout
           docsQosParamSetMaxConcatBurst
           docsQosParamSetSchedulingType



Expires June 2000                                               [Page 8]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



           docsQosParamSetRequestPolicy
           docsQosParamSetNomPollInterval
           docsQosParamSetTolPollJitter
           docsQosParamSetUnsolicitGrantSize
           docsQosParamSetNomGrantInterval
           docsQosParamSetTolGrantJitter
           docsQosParamSetGrantsPerInterval
           docsQosParamSetTosAndMask
           docsQosParamSetTosOrMask
           docsQosParamSetMaxLatency
       docsQosServiceFlowTable
         docsQosServiceFlowEntry
           docsQosServiceFlowId
           docsQosServiceFlowProvisionedParamSetIndex
           docsQosServiceFlowAdmittedParamSetIndex
           docsQosServiceFlowActiveParamSetIndex
           docsQosServiceFlowSID
           docsQosServiceFlowDirection
           docsQosServiceFlowPrimary
       docsQosServiceFlowStatsTable
         docsQosServiceFlowStatsEntry
           docsQosServiceFlowPkts
           docsQosServiceFlowOctets
           docsQosServiceFlowTimeCreated
           docsQosServiceFlowTimeActive
           docsQosServiceFlowPHSUnknowns
           docsQosServiceFlowPolicedDropPkts
           docsQosServiceFlowPolicedDelayPkts
       docsQosUpstreamStatsTable
         docsQosUpstreamStatsEntry
           docsQosSID
           docsQosUpstreamFragPkts
           docsQosUpstreamIncompletePkts
           docsQosUpstreamConcatBursts
       docsQosDynamicServiceStatsTable
         docsQosDynamicServiceStatsEntry
           docsQosIfDirection
           docsQosDSAReqs
           docsQosDSARsps
           docsQosDSAAcks
           docsQosDSCReqs
           docsQosDSCRsps
           docsQosDSCAcks
           docsQosDSDReqs
           docsQosDSDRsps



Expires June 2000                                               [Page 9]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



           docsQosDynamicAdds
           docsQosDynamicAddFails
           docsQosDynamicChanges
           docsQosDynamicChangeFails
           docsQosDynamicDeletes
           docsQosDynamicDeleteFails
       docsQosServiceFlowLogTable
         docsQosServiceFlowLogEntry
           docsQosServiceFlowLogIndex
           docsQosServiceFlowLogIfIndex
           docsQosServiceFlowLogSFID
           docsQosServiceFlowLogCmMac
           docsQosServiceFlowLogPkts
           docsQosServiceFlowLogOctets
           docsQosServiceFlowLogTimeDeleted
           docsQosServiceFlowLogTimeCreated
           docsQosServiceFlowLogTimeActive
           docsQosServiceFlowLogControl
       docsQosServiceClassTable
         docsQosServiceClassEntry
           docsQosServiceClassName
           docsQosServiceClassParamSetIndex
           docsQosServiceClassStatus
       docsQosServiceClassPolicyTable
         docsQosServiceClassPolicyEntry
           docsQosServiceClassPolicyIndex
           docsQosServiceClassPolicyName
           docsQosServiceClassPolicyRulePriority
           docsQosServiceClassPolicyStatus
       docsQosPHSTable
         docsQosPHSEntry
           docsQosPHSIndex
           docsQosPHSField
           docsQosPHSMask
           docsQosPHSSize
           docsQosPHSVerify
           docsQosPHSClassifierIndex
       docsQosCMtsMacToSrvFlowTable
         docsQosCmtsMacToSrvFlowEntry
           docsQosCmtsCmMac
           docsQosCmtsServiceFlowId
           docsQosCmtsIfIndex






Expires June 2000                                              [Page 10]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



   The MIB is organized as 11 tables. Most tables are implemented in
   both the CM and CMTS; the docsQosUpstreamStatsTable and
   docsQosServiceFlowLogTable are implemented on the CMTS only.


2.2.1  docsQosPktClassTable

   The docsQosPktClassTable reports the Service Flow Classifiers
   implemented by the managed device. The table is indexed by the tuple
   { ifIndex, docsQosServiceFlowId, docsQosPktClassId }.  The ifIndex
   corresponds to an CATV MAC interface.  Each CATV MAC interfaces has a
   set of Service Flows, identified with a docsQosServiceFlowId value
   that is unique for that interface. Each service flow may have a
   number of packet classifiers that map packets to the flow. The
   ClassiferId for the classifier is unique only within a particular
   service flow.

   The semantics of packet classification are provided in [16]. Briefly,
   the DOCSIS MAC interface calls for matching packets based on values
   within the 802.2 (LLC), 802.3, IP, and/or  UDP/TCP headers.  Packets
   which map more than one classifier are prioritized according to their
   docsQosPktClassPriority value. The docsQosServiceFlowId (an index
   object) indicates to which service flow the packet is classified.

   The docsQosPktClassTable is distinct from the docsDevIpFilterTable of
   [21] in that docsQosPktClassTable is intended only to reflect the
   state of the dynamically added Service Flow Classifiers. SF
   Classifiers may be created only via a CM configuration file or from
   the Dynamic Service Addition (DSA) messages.  For this reason,
   docsQosPktClassTable is read-only.

   The docsDevIpFilterTable is intended for external administration of
   packet classifiers.  See the section "Externally Administered
   Classification", below.



2.2.2  docsQosParamSetTable

   The docsQosParamSetTable reports the values of a Qos Parameter Set as
   defined in Section C.2.2 of [16]. In general, a Service Flow is
   associated with three different Qos Parameter Sets (QPSs): an
   "active" QPS, an "admitted" QPS, and a "provisioned" or "authorized"
   QPS.  The relationship of these three sets is represented below:




Expires June 2000                                              [Page 11]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999






                         +---------------------+
                         | Provisioned         |
                         |                     |
                         |  +---------------+  |
                         |  |  Admitted     |  |
                         |  |               |  |
                         |  |  +---------+  |  |
                         |  |  |  Active |  |  |
                         |  |  |         |  |  |
                         |  |  +---------+  |  |
                         |  |               |  |
                         |  +---------------+  |
                         |                     |
                         +---------------------+

                       Figure 1: Qos Parameter Sets



   The Provisioned QPS describes the maximum service envelope for which
   the SF is authorized. The Admitted QPS is the set of services for
   which a service flow has requested admission to the DOCSIS RF
   network, but which is not yet active. The Admitted QPS is used during
   the two-phase process of IP Telephony service flow admission to admit
   the bandwidth for a bidirectional voice call when the far end is
   ringing.  Since ringing may occur for up to four minutes, this
   permits the bandwidth to be reserved but not actually consumed during
   this interval.  The Active QPS is the set of services actually being
   used by the Service Flow. The DOCSIS v1.1 specification [16] defines
   what it means for a QPS envelope to be "within" another.  In general,
   an inner QPS is considered to be "within" an outer QPS when all QOS
   parameters represent demands of equal or fewer resources of the
   network.

   In addition to their use as attributes of a Service Flow, a QPS is
   also an attribute of a Service Class.  A DOCSIS CM configuration file
   or DSA message may request the creation of a new SF and give only the
   Service Class Name. The CMTS "expands the macro" of a Service Class
   Name creation by populating the Provisioned, Admitted, and/or Active
   QPSs of the Service Flow with the QPS of the Service Class Name. All
   of the QPSs of a Service Flow be expansions of the same Service
   Class, and in this case the SF is said to "belong" to the Service



Expires June 2000                                              [Page 12]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



   Class.  Changing the contents of a Service Class'es QPS does not
   affect the QPS of any Service Flow earlier expanded from that Service
   Class name. Only the CMTS implements docsQosServiceClassTable and
   docQosQosParamSetEntry's for Service Classes; the CM does not.

   See [16] section 8 for a full description and the theory of operation
   of Docsis 1.1 QOS operation.

   The docsQosParamSetTable of this MIB deprecates the
   docsIfQosProfileTable of [22].  A DOCSIS 1.1 compliant CMTS
   implements upstream and downstream Service Flows per DOCSIS 1.1 even
   for DOCSIS 1.0 modems.  The DOCSIS 1.1 QOS Parameter Set is a
   superset of the parameters provided in docsIfQosProfileTable.

   The docsQosParamSetTable sets are indexed by {docsQosParamSetRowType,
   docsQosParamSetIndex}.  The docsQosParamSetRowType value indicates
   whether the QPS belongs to a Service Flow or a Service Class.  The
   docsQosParamSetIndex is a device-local small integer that is unique
   within its docsQosParamSetRowType.

   Only Service Class QPS rows may be created externally; the Service
   Flow QPS rows are created internally via DOCSIS mechanisms and are
   read-only to external SNMP applications.

   Because each Service Flow is semantically considered to have separate
   QPSs, the managed device MUST NOT permit there to be more than one
   reference to a particular docsQosParamSetIndex. For example, even
   though the Provisioned, Admitted, and Active QPSs of a service flow
   may have exactly the same values, the must appear in the MIB to have
   separate QPS rows. Of course, implementations may only implement a
   single copy of the QPS values in this case.



2.2.3  docsQosServiceFlowTable

   The docsQosServiceFlowTable provides read-only information about all
   of the service flows known by the device. It is indexed by the
   combination of { ifIndex, dosQosServiceFlowId }, where ifIndex
   corresponds to a CATV MAC interface and docsQosServiceFlowId is the
   32- bit integer assigned by the CMTS controlling the MAC domain.  A
   CM typically has only a single CATV MAC interface, while a CMTS may
   have several. See  [22] for a description of the ifIndex numbering
   for DOCSIS devices.




Expires June 2000                                              [Page 13]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



   The docsQosServiceFlowTable provides the docsQosParamSetIndex for all
   three of the QPSs associated with the SF.  For an active upstream SF,
   it also provides the Service ID (SID) assigned by the CMTS for the
   SF. The table indicates whether a given SF is in the upstream or
   downstream direction, and whether it is the "primary" SF in that
   direction.  The primary SF carries traffic that is not otherwise
   classified to any other SF in that direction.


2.2.4  docsQosServiceFlowStatsTable

   The docsQosServiceFlowStatsTable provides statistics for all
   currently existing SFs known by the managed device.  It provides
   basic packet and octet counters, as well as certain other SF-specific
   stats such as the time at which the flow was created and how many
   seconds it has been active.

   The table also provides objects which can be used to fine-tune
   admission control decisions, namely the number of packets dropped or
   delayed due to QOS policing decisions enforced by the managed device.


2.2.5  docsQosUpstreamStatsTable

   This table provides statistics that are measured only at the CMTS in
   the upstream direction. These include a count of the number of
   packets that were fragmented, fragmentation errors (i.e. incomplete
   packets) and the number of concatenation bursts.


2.2.6  docsQosDynamicServiceStatsTable

   This table provides read-only stats on the operation of the Dynamic
   Service state machines as specified in section 9.4 of [16]. It
   provides a set of 14 counters *in each direction* for a Docsis MAC
   layer interface. That is, each Docsis MAC layer interface has one row
   for downstream stats, and a second row for upstream stats.

   Eight of the counters are DSx packet type counts, one counter for
   each of the eight DSx packet types. For example, the docsQosDSAReqs
   object in the upstream row at the CMTS counts the number of DSA-REQ
   messages received by the CMTS from that interface.  The
   docsQosDSAReqs object in the downstream row at the CMTS counts the
   number of DSA-REQ messages transmitted by the CMTS on that interface.




Expires June 2000                                              [Page 14]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



   The remaining six counters per (interface, direction) combination
   count the number of successful and unsuccessful *transactions* that
   were initiated on the interface and direction. For example, the
   upstream docsQosDynamicAdds on a CMTS is the number of successfully
   completed CM-initiated dynamic additions, because at the CMTS a CM-
   initiated DSA starts in the upstream direction.  The downstream
   docsQosDynamicAdds at a CMTS is the number of successful CMTS-
   initiated DSA transactions.

   Dynamic service transactions can fail for a number of reasons, as
   listed in the state machines of section 9.4. Rather than include
   still more counters for each different failure reason, they are
   grouped into a single count, e.g docsQosDynamicAddFails.  Again, this
   object exists in both directions, so that locally originated vs
   remotely originated transaction failures are counted separately.
   Further troubleshooting of transaction failures will require vendor-
   specific queries and operation.


2.2.7  docsQosServiceFlowLogTable

   This table contains a log of the Service Flows no longer existing in
   the docsQosServiceFlowTable. It is intended to be periodically polled
   by traffic monitoring and billing agents. It is implemented only at
   the CMTS.

   It contains a chronlogical log of SF session statistics, including a
   total count of packets and octets transferred on the SF.  It includes
   time stamps of the SF creation and deletion time, as well as its
   number of active seconds. The active second count is the count of
   seconds that the SF had a non-empty Active Qos Parameter Set, i.e. it
   was eligible to pass data.  For unicast SFs, it includes the CM MAC
   address associated with the flow for billing reference purposes.

   The maximum number of log records kept by a CMTS, and the duration
   that a log record is maintained in the table is vendor-specific.  An
   explicit control object is provided so that the monitoring
   application can explicitly delete records it has read.










Expires June 2000                                              [Page 15]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



2.2.8  docsQosServiceClassTable

   This table defines the Service Class Name and references a Qos
   Parameter Set for each Service Class defined in a CMTS.  It is
   indexed by the Service Class Name string itself.  The table is read-
   create on a CMTS, and is not implemented in a CM.



2.2.9  docsQosServiceClassPolicyTable


   The docsQosServiceClassPolicyTable can be referenced by the
   docsDevFilterPolicyTable of [21] in order to have a "policy" that
   classifies packets to a named Service Class. This is one mechanism by
   which "external" entities (like an SNMP manager) may control the
   classification of packet for QOS purposes. Entries are indexed by a
   small integer docsQosServiceClassPolicyIndex.  They provide a Service
   Class Name and a Rule Priority.  A policy referencing a row of this
   table intends the packet to be forwarded on a Service Flow
   "belonging" to the named Service Class. See the section "Externally
   Administered Classification", below.

   This table is implemented on both the CM and CMTS, and is read-create
   on both.


2.2.10  docsQosPHSTable

   The Payload Header Suppression (PHS) feature of DOCSIS 1.1 permits
   packets to replace the unchanging bytes of the Ethernet, IP, and UDP
   headers with a one-byte index when transmitting on the cable network.
   This is especially useful for IP Telephony packets, where such
   suppression can result in almost twice the number of calls supported
   within the same upstream channel.

   Each entry of the table corresponds to a PHS Rule as described in
   section 8.4 of [16].  The rules are identified by an 8-bit PHS Index,
   which is unique per Service Flow.  The table therefore indexed by the
   tuple {docsQosServiceFlowId, docsQosPHSIndex}.

   This table is read-only, and MUST be implemented on both the CM and
   CMTS when PHS is supported.





Expires June 2000                                              [Page 16]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



2.2.11  docsQosCmtsMacToSrvFlowTable

   The docsQosCmtsMacToSrvFlowTable provides describes the mapping of CM
   mac addresses to the  Service Flow Ids that are uniquely identified
   with that CM.  External applications may collect statistics on all
   packets flowing through a CM by determining the SFID of all of its
   flows, and then collecting the statistics of packets and bytes for
   each flow.

   Downstream multicast service flows are not indicated in the
   docsQosCmtsMacToSrvFlowTable because they are not associated with
   only one CM.




.  Externally Administered Classification

   Docsis 1.1 provides rich semantics for the classification of packets
   to service flows with it Service Flow Classifier table. Service Flow
   Classifiers may be created statically in the DOCSIS CM configuration
   file, or may be created dynamically with Dynamic Service Addition
   (DSA) and Dynamic Service Change (DSC) DOCSIS MAC messages.

   Several major issues arose with the concept of externally
   administered classification, i.e. should an external SNMP manager be
   permitted to create classification rows? One problem was the co-
   ordination of classifier IDs, since such an approach would require
   either separate classifier ID number spaces or objects to co-ordinate
   both internal and external classifier ID assignments.  A more serious
   problem, however, was the requirement that external creation of SF
   Classifiers would require "knowledge" of the individual Service Flow
   ID for service flows by external applications.  It was strongly felt
   by the committee that SFIDs should remain an internal Docsis object,
   and not be transmitted as part of protocol flows, e.g. for IP packet
   telephony signalling.  Docsis 1.1 introduced the concept of named
   Service Classes for ease of administration within a domain of CMs and
   CMTSs.  What was desired was to permit external classification of
   packets to a Service Class, not a particular Service Flow.

   The DOCSIS committee therefore decided to use the already-defined IP
   Packet Filter Table [21] for the external classification of packets
   for QOS purposes.  The docsDevIpPacketFilterTable defines similar
   packet matching criteria as docsQosPktClassTable, but it matches a
   packet to an arbitrary "policy set" instead of a particular Service



Expires June 2000                                              [Page 17]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



   Flow. One of the policies in the policy set then selects the Service
   Class of the SF on which to forward the packet.  The
   docsQosServiceClassPolicyTable of this MIB defines the Service Class
   Name to which a packet is classified.

   The interaction of external and internal packet classification is
   depicted below.









































Expires June 2000                                              [Page 18]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999





               |
               |  Outbound Pkt
               V
           docsDevIpFilterTable------> docsDevFilterPolicyTable
               |                                |
               |                                V
               |                      docsQosServiceClassPolicyTable
               |                                |
               | Pkt                            | ServiceClassName,
               |                                | ServiceClassPolicyRulePriority
               V                                V
      +--------------------------------------------------------+
      |        |   DOCSIS MAC LAYER ENTITY      |              |
      |        |                                | Select any   |
      |        V                                | SFID Y in SCN|
      |    docsQosPktClassTable <---------------|              |
      |        |                                |              |
      |        | docsQosPktClassPriority,       |              |
      |        | SFID X                         |              |
      |        V                                V              |
      |      ----------------------------------------+         |
      |      | Select the SFID associated with the   |         |
      |      | higher of docsQosPktClassPriority or  |         |
      |      | docsQosServiceClassPolicyRulePriority |         |
      |      +---------------------------------------+         |
      |                             |                          |
      |                             V                          |
      |           |    |          |    |                       |
      |           |    |    ...   |    |  Service Flows        |
      |           +----+          +----+                       |
      |           SFID X          SFID Y                       |
      +--------------------------------------------------------+

           Figure 2: Docsis Packet Classification


   The processing of an outgoing packet proceeds as follows:

          1.  The packet is first checked for matches with rows of the
              docsDevIpFilterTable. If it matches, the matching row
              provides a docsDevFilterPolicyId integer.





Expires June 2000                                              [Page 19]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



          2.  The docsDevFilterPolicyId indexes into one (or more) rows
              of docsDevFilterPolicyTable. Each row provides an
              arbitrary RowPointer (docsDevFilterPolicyPtr),
              corresponding to a policy to be applied to the packet.

          3.  This MIB defines a docsQosServiceClassPolicyTable whose
              entries may be pointed to by docsDevFilterPolicyPtr in
              order to administratively classify packets to a named
              DOCSIS Service Class.  The docsQosServiceClassPolicyEntry
              provides a Service Class Name (SCN) as
              docsQosServiceClassPolicyName and a classification rule
              priority as docsQosServiceClassPolicyRulePriority. These
              are submitted to the device's Docsis MAC Layer entity as a
              special form of the MAC_DATA.request primitive, as
              described in Section E.2.1 of [16].

          4.  The MAC Layer selects an SFID ("Y") of an active Service
              Flow belonging to the named class, choosing an SF
              arbitrarily if there is more than one.

          5.  The packet is then classified according to the
              docsQosPktClassTable, which may classify the packet to a
              different SFID "X".  Associated with the classifier is a
              docsQosPktClassPriority.

          6.  In the event of a conflict between the SCN-determined SFID
              and the classified SFID, the greater of
              docsQosPktClassPriority and
              docsQosServiceClassPolicyRulePriority determines which
              SFID is selected to forward the packet.

        A packet which does not match a docsQosServiceClassPolicyEntry
        is directly submitted to the Docsis MAC layer, where the
        docsQosPktClassTable selects the SID on which it is to be
        forwarded.

        By convention (in [16]), the "internal" docsQosPktClassPriority
        values should be in the range of 64-191, while the "external"
        priorities may be either in the range 192-255 to override the
        internal classification or the range 0-63 to be overriden by
        internal classification.

        This classification mechanism applies both upstream from the CM
        and downstream from the CMTS.




Expires June 2000                                              [Page 20]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



.  Definitions

--
-- Docsis QOS Extensions MIB
--

DOCS-QOS-MIB DEFINITIONS ::= BEGIN

IMPORTS
    MODULE-IDENTITY,
    OBJECT-TYPE,
    Integer32,
    Counter32,
    IpAddress,
    BITS,
    Unsigned32
      FROM SNMPv2-SMI

    TEXTUAL-CONVENTION,
    MacAddress,
    RowStatus,
    TruthValue,
    DisplayString,
    TimeStamp
      FROM SNMPv2-TC

    OBJECT-GROUP,
    MODULE-COMPLIANCE
      FROM SNMPv2-CONF

    ifIndex,
    InterfaceIndex
      FROM IF-MIB

    docsIfMib
      FROM DOCS-IF-MIB;

docsQosMIB   MODULE-IDENTITY
    LAST-UPDATED    "9912082046Z" -- Dec 8, 1999
    ORGANIZATION    "IETF IPCDN Working Group"
    CONTACT-INFO
        "
         Co-Author: Michael Patrick
         Postal:    Motorola ISG
                    20 Cabot Blvd, MS M4-30



Expires June 2000                                              [Page 21]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    Mansfield, MA 02048-1193
                    U.S.A.
         Phone:     +1 508 261 5707
         E-mail:    lzz007@email.mot.com

         Co-Author: John Harvey
         Postal:    Motorola ING
                    20 Cabot Blvd, MS M4-25
                    Mansfield, MA 02048-1193
                    U.S.A.
         Phone:     +1-508-261-4579
         E-mail:    ljh031@dma.isg.mot.com"
    DESCRIPTION
        "This is the management information for
         Quality Of Service (QOS) for DOCSIS 1.1."

    REVISION        "9909301705Z" -- Sep 30, 1999
    DESCRIPTION
        "Published as draft-ietf-ipcdn-qos-mib-02.txt.

         Updated to added docsQosCmtsMacToSrvFlowTable,
         docsQosServiceFlowStatsTable, docsQosUpstreamStatsTable,
         docsQosDynamicServiceStatsTable, docsQosServiceFlowLogTable,
         docsQosPktClassState, conformance statements and fixed
         syntax errors."
    ::= { docsIfMib 7 }                -- BPIPlus mib is docsIfMIb 6

docsQosMIBObjects  OBJECT IDENTIFIER ::= { docsQosMIB 1 }

-- Textual Conventions
IfDirection ::= TEXTUAL-CONVENTION
    STATUS          current
    DESCRIPTION     "Indicates a direction on an RF MAC interface.

                     The value downstream(1) is from Cable Modem
                     Termination System to Cable Modem.

                     The value upstream(2) is from Cable Modem to
                     Cable Modem Termination System."
    SYNTAX          INTEGER {
                       downstream(1),
                       upstream(2)
                    }

BitRate ::= TEXTUAL-CONVENTION



Expires June 2000                                              [Page 22]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    DISPLAY-HINT    "d"
    STATUS          current
    DESCRIPTION     "The rate of traffic in unit of bits per second.
                     Used to specify traffic rate for QOS."
    SYNTAX          Unsigned32


--
-- Packet Classifier Table
--
docsQosPktClassTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosPktClassEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "This table describes the packet classification
                    configured on the CM or CMTS.
                    The model is that a packet either received
                    as input from an interface or transmittted
                    for output on an interface may be compared
                    against an ordered list of rules pertaining to
                    the packet contents. Each rule is a row of this
                    table. A matching rule provides a service flow
                    id to to which the packet is classified.
                    All rules need to match for a packet to match
                    a classifier."
    ::= { docsQosMIBObjects 1 }


docsQosPktClassEntry OBJECT-TYPE
    SYNTAX          DocsQosPktClassEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "An entry in this table provides a single packet
                     classifier rule. The index ifIndex is an ifType
                     of docsCableMaclayer(127)."
    INDEX {
            ifIndex,
            docsQosServiceFlowId,
            docsQosPktClassId
          }
    ::= { docsQosPktClassTable 1 }


DocsQosPktClassEntry ::= SEQUENCE {
    docsQosPktClassId               Integer32,



Expires June 2000                                              [Page 23]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    docsQosPktClassDirection        IfDirection,
    docsQosPktClassPriority         Integer32,
    docsQosPktClassIpTosLow         OCTET STRING,
    docsQosPktClassIpTosHigh        OCTET STRING,
    docsQosPktClassIpTosMask        OCTET STRING,
    docsQosPktClassIpProtocol       Integer32,
    docsQosPktClassIpSourceAddr     IpAddress,
    docsQosPktClassIpSourceMask     IpAddress,
    docsQosPktClassIpDestAddr       IpAddress,
    docsQosPktClassIpDestMask       IpAddress,
    docsQosPktClassSourcePortStart  Integer32,
    docsQosPktClassSourcePortEnd    Integer32,
    docsQosPktClassDestPortStart    Integer32,
    docsQosPktClassDestPortEnd      Integer32,
    docsQosPktClassDestMacAddr      MacAddress,
    docsQosPktClassDestMacMask      MacAddress,
    docsQosPktClassSourceMacAddr    MacAddress,
    docsQosPktClassEnetProtocolType INTEGER,
    docsQosPktClassEnetProtocol     Integer32,
    docsQosPktClassUserPriApplies   TruthValue,
    docsQosPktClassUserPriLow       Integer32,
    docsQosPktClassUserPriHigh      Integer32,
    docsQosPktClassVlanId           Integer32,
    docsQosPktClassState            INTEGER,
    docsQosPktClassPkts             Counter32
  }

docsQosPktClassId       OBJECT-TYPE
    SYNTAX          Integer32 (1..65535)
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "Index assigned to packet classifier entry by
                     the CMTS which is unique per serivce flow."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.1.3.2"
    ::= { docsQosPktClassEntry 1 }

docsQosPktClassDirection OBJECT-TYPE
    SYNTAX          IfDirection
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "Indicates the direction to which the classifier
                     is applied."
    ::= { docsQosPktClassEntry 2 }

docsQosPktClassPriority OBJECT-TYPE



Expires June 2000                                              [Page 24]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    SYNTAX          Integer32 (0..255)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "The value specificies the order of evaluation
                     of the classifiers.
                     The higher the value the higher the priority.
                     The value of zero is used as default in
                     provisioned service flows classifiers.
                     The default value of 64 is used for dynamic
                     service flow classifiers."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.1.3.5"
    ::= { docsQosPktClassEntry 3 }

docsQosPktClassIpTosLow OBJECT-TYPE
    SYNTAX          OCTET STRING (SIZE(1))
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "The low value of a range of TOS byte values."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.1"
    ::= { docsQosPktClassEntry 4 }

docsQosPktClassIpTosHigh OBJECT-TYPE
    SYNTAX          OCTET STRING (SIZE(1))
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "The 8-bit high value of a range of TOS byte
                     values."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.1"
    ::= { docsQosPktClassEntry 5 }

docsQosPktClassIpTosMask OBJECT-TYPE
    SYNTAX          OCTET STRING (SIZE(1))
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "The mask value is bitwise ANDed with TOS byte
                     in an IP packet and this value is used check
                     range checking of TosLow and TosHigh.

                     A value of zero means that IP TOS byte
                     is not used for packet classification."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.1"
    ::= { docsQosPktClassEntry 6 }

docsQosPktClassIpProtocol OBJECT-TYPE
    SYNTAX          Integer32 (0..258)



Expires June 2000                                              [Page 25]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object indicates the value of the IP
                    Protocol field required for IP packets to match
                    this rule.

                    The value 256 matches traffic with any IP Protocol
                    value. The value 257 by convention matches both TCP
                    and UDP.

                    A value of 258 means that IP protocol is not used
                    for packet classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.2"
    ::= { docsQosPktClassEntry 7 }

docsQosPktClassIpSourceAddr OBJECT-TYPE
    SYNTAX          IpAddress
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "This object specifies the value of the IP
                     Source Address required for packets to match
                     this rule. An IP packet matches the rule when
                     the packet ip source address bitwise ANDed
                     with the docsQosPktClassIpSourceMask value
                     equals the docsQosPktClassIpSourceAddr value.

                     A value of 0.0.0.0 means that IP source address
                     is not used for packet classification."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.3"
    ::= { docsQosPktClassEntry 8 }

docsQosPktClassIpSourceMask OBJECT-TYPE
    SYNTAX          IpAddress
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object specifies which bits of a packet's
                    IP Source Address that are compared to match
                    this rule.
                    An IP packet matches the rule when the packet
                    source address bitwise ANDed with the
                    docsQosPktClassIpSourceMask value equals the
                    docsQosIpPktClassSourceAddr value.

                    A value of 0.0.0.0 means that IP source address
                    is not used for packet classification."



Expires June 2000                                              [Page 26]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.4"
    ::= { docsQosPktClassEntry 9 }


docsQosPktClassIpDestAddr OBJECT-TYPE
    SYNTAX          IpAddress
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "This object specifies the value of the IP
                     Destination Address required for packets to
                     match this rule. An IP packet matches the rule
                     when the packet IP destination address
                     bitwise ANDed with the
                     docsQosPktClassIpDestMask value equals the
                     docsQosPktClassIpDestAddr value.

                     A value of 0.0.0.0 means that IP destination
                     address is not used for packet classification."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.5"
    ::= { docsQosPktClassEntry 10 }

docsQosPktClassIpDestMask OBJECT-TYPE
    SYNTAX          IpAddress
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object specifies which bits of a packet's
                    IP Destination Address that are compared to
                    match this rule.
                    An IP packet matches the rule when the packet
                    destination address bitwise ANDed with the
                    docsQosPktClassIpDestMask value equals the
                    docsQosPktClassIpDestAddr value.

                    A value of 0.0.0.0 means that IP destination address
                    is not used for packet classification."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.6"
    ::= { docsQosPktClassEntry 11}

docsQosPktClassSourcePortStart OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "This object specifies the low end inclusive
                     range of TCP/UDP source port numbers to which
                     a packet is compared. This object is irrelevant



Expires June 2000                                              [Page 27]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                     for non-TCP/UDP IP packets.

                     A value of 65535 for docsQosPktClassSourcePortEnd
                     and a value of 0 for docsQosPktClassSourcePortStart
                     means that source port number is not used for
                     packet classification."
    REFERENCE        "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.7"
    ::= { docsQosPktClassEntry 12 }

docsQosPktClassSourcePortEnd OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "This object specifies the high end inclusive
                     range of TCP/UDP source port numbers to which
                     a packet is compared. This object is irrelevant
                     for non-TCP/UDP IP packets.

                     A value of 65535 for docsQosPktClassSourcePortEnd
                     and a value of 0 for docsQosPktClassSourcePortStart
                     means that source port number is not used for
                     packet classification."
    REFERENCE        "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.9"
    ::= { docsQosPktClassEntry 13 }

docsQosPktClassDestPortStart OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "This object specifies the low end inclusive
                     range of TCP/UDP destination port numbers to
                     which a packet is compared.

                     A value of 65535 for docsQosPktClassDestPortEnd
                     and a value of 0 for docsQosPktClassDestPortStart
                     means that destination port number is not used for
                     packet classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.9"
    ::= { docsQosPktClassEntry 14 }

docsQosPktClassDestPortEnd OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "This object specifies the high end inclusive



Expires June 2000                                              [Page 28]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                     range of TCP/UDP destination port numbers to which
                     a packet is compared.

                     A value of 65535 for docsQosPktClassDestPortEnd
                     and a value of 0 for docsQosPktClassDestPortStart
                     means that destination port number is not used for
                     packet classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.5.10"
    ::= { docsQosPktClassEntry 15 }

docsQosPktClassDestMacAddr OBJECT-TYPE
    SYNTAX          MacAddress
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "An Ethernet packet matches an entry when its
                    destination MAC address bitwise ANDed with
                    docsQosPktClassDestMacMask equals the value of
                    docsQosPktClassDestMacAddr.

                    A value of 0 means that destination mac address
                    is not used for packet classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.6.1"
    ::= { docsQosPktClassEntry 16 }

docsQosPktClassDestMacMask OBJECT-TYPE
    SYNTAX          MacAddress
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "An Ethernet packet matches an entry when its
                    destination MAC address bitwise ANDed with
                    docsQosPktClassDestMacMask equals the value of
                    docsQosPktClassDestMacAddr.

                    A value of 0 means that destination mac address
                    is not used for packet classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.6.1"
    ::= { docsQosPktClassEntry 17 }

docsQosPktClassSourceMacAddr OBJECT-TYPE
    SYNTAX          MacAddress
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "An Ethernet packet matches this entry when its
                    source MAC address equals the value of
                    this object.



Expires June 2000                                              [Page 29]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    A value of 0 means that source mac address
                    is not used for packet classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.6.2"
    ::= { docsQosPktClassEntry 18 }

docsQosPktClassEnetProtocolType OBJECT-TYPE
    SYNTAX          INTEGER {
                      none(0),
                      ethertype(1),
                      dsap(2)
                    }
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object indicates the format of the layer 3
                    protocol id in the Ethernet packet. A value of
                    none(0) means that the rule does not use the
                    layer 3 protocol type as a matching criteria.

                    A value of ethertype(1) means that the rule
                    applies only to frames which contains an
                    EtherType value. Ethertype values are contained
                    in packets using the Dec-Intel-Xerox (DIX)
                    encapsulation or the RFC1042 Sub-Network Access
                    Protocol (SNAP) encapsulation formats.

                    A value of dsap(2) means that the rule applies
                    only to frames using the IEEE802.3
                    encapsulation format with a Destination Service
                    Access Point (DSAP) other
                    than 0xAA (which is reserved for SNAP).

                    If the Ethernet frame contains an 802.1P/Q Tag
                    header (i.e. EtherType 0x8100), this object
                    applies to the embedded EtherType field within
                    the 802.1P/Q header."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.6.3"
    ::= { docsQosPktClassEntry 19 }


docsQosPktClassEnetProtocol OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "If docsQosEthPktClassProtocolType is none(0),
                    this object is ignored when considering whether



Expires June 2000                                              [Page 30]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    a packet matches the current rule.

                    If dosQosEthPktClassEncap is ethertype(1), this
                    object gives the 16-bit value of the EtherType
                    that the packet must match in order to match the rule.

                    If docsQosEthPktClassEncap is dsap(2), the lower 8
                    bits of this object's value must match the DSAP byte
                    of the packet in order to match the rule.

                    If the Ethernet frame contains an 802.1P/Q Tag header
                    (i.e. EtherType 0x8100), this object applies to the
                    embedded EtherType field within the 802.1P/Q header."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.6.3"
    ::= { docsQosPktClassEntry 20 }


docsQosPktClassUserPriApplies OBJECT-TYPE
    SYNTAX          TruthValue
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "If this object is true(1) then user priority field
                    in 802.1P is applied to ethernet frames. A value of
                    false(2) signifies that user priority field does
                    apply to this rule."
    ::= { docsQosPktClassEntry 21 }


docsQosPktClassUserPriLow OBJECT-TYPE
    SYNTAX          Integer32 (0..7)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object applies only to Ethernet frames
                    using the 802.1P/Q tag header (indicated with
                    EtherType 0x8100). Such frames include a 16-bit
                    Tag that contains a 3 bit Priority field and
                    a 12 bit VLAN number.

                    Tagged Ethernet packets must have a 3-bit
                    Priority field within the range of
                    docsQosPktClassPriLow and docsQosPktClassPriHigh in
                    order to match this rule.

                    A value of false(2) for docsQosPktClassUserPriApplies
                    means that priority field is not used for packet



Expires June 2000                                              [Page 31]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.7.1"
    ::= { docsQosPktClassEntry 22 }

docsQosPktClassUserPriHigh OBJECT-TYPE
    SYNTAX          Integer32 (0..7)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object applies only to Ethernet frames
                    using the 802.1P/Qtag header (indicated with
                    EtherType 0x8100). Such frames include a 16-bit
                    Tag that contains a 3 bit Priority field and
                    a 12 bit VLAN number.

                    Tagged Ethernet packets must have a 3-bit
                    Priority field within the range of
                    docsQosPktClassPriLow and
                    docsQosPktClassPriHigh in order to match this
                    rule.

                    A value of false(2) for docsQosPktClassUserPriApplies
                    means that priority field is not used for packet
                    classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.7.1"
    ::= { docsQosPktClassEntry 23 }

docsQosPktClassVlanId OBJECT-TYPE
    SYNTAX          Integer32 (0..4095)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object applies only to Ethernet frames
                    using the 802.1P/Q tag header.

                    If this object's value is nonzero, tagged
                    packets must have a VLAN Identifier that matches
                    the value in order to match the rule.

                    A value is zero for docsQosPktClassVlanId means that
                    VLAN Id is not used for packet classification."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.7.2"
    ::= { docsQosPktClassEntry 24 }

docsQosPktClassState OBJECT-TYPE
    SYNTAX          INTEGER {
                      active(1),



Expires June 2000                                              [Page 32]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                      inactive(2)
                    }
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object indicates whether or not the classifier
                    is currently classifing packets to a Service Flow."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.3.6"
    ::= { docsQosPktClassEntry 25 }

docsQosPktClassPkts OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "This object counts the number of packets that have
                    been classified using this entry."
    ::= { docsQosPktClassEntry 26 }


--
-- Qos Parameter Set Table
--
docsQosParamSetTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosParamSetEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "This table describes the set of DOCSIS QoS
                    parameters defined in a managed device.
                    Each entry in this table is used to define one
                    Qos Parameter Set.

                    Only rows with a value of serviceClass(2)
                    for docsQosParamSetRowType are read-create.
                    Rows with value of serviceFlow(1) are read-only."
    ::= { docsQosMIBObjects 2 }

docsQosParamSetEntry OBJECT-TYPE
    SYNTAX          DocsQosParamSetEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION
    "A unique set of Qos parameters."
    INDEX {
            docsQosParamSetRowType,
            docsQosParamSetIndex
          }



Expires June 2000                                              [Page 33]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    ::= { docsQosParamSetTable 1 }

DocsQosParamSetEntry ::= SEQUENCE {
    docsQosParamSetRowType               INTEGER,
    docsQosParamSetIndex              Unsigned32,
    docsQosParamSetRowStatus          RowStatus,
    docsQosParamSetServiceClassName   DisplayString,
    docsQosParamSetPriority           Integer32,
    docsQosParamSetMaxTrafficRate     BitRate,
    docsQosParamSetMaxTrafficBurst    Unsigned32,
    docsQosParamSetMinReservedRate    BitRate,
    docsQosParamSetMinReservedPkt     Integer32,
    docsQosParamSetActiveTimeout      Integer32,
    docsQosParamSetAdmittedTimeout    Integer32,
    docsQosParamSetMaxConcatBurst     Integer32,
    docsQosParamSetSchedulingType     INTEGER,
    docsQosParamSetRequestPolicy      BITS,
    docsQosParamSetNomPollInterval    Unsigned32,
    docsQosParamSetTolPollJitter      Unsigned32,
    docsQosParamSetUnsolicitGrantSize Integer32,
    docsQosParamSetNomGrantInterval   Unsigned32,
    docsQosParamSetTolGrantJitter     Unsigned32,
    docsQosParamSetGrantsPerInterval  Integer32,
    docsQosParamSetTosAndMask         OCTET STRING,
    docsQosParamSetTosOrMask          OCTET STRING,
    docsQosParamSetMaxLatency         Unsigned32
    }

docsQosParamSetRowType     OBJECT-TYPE
    SYNTAX          INTEGER {
                       serviceFlow (1),
                       serviceClass (2)
                    }
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "Defines the type of parameter set.

                     A serviceFlow(1) type is used to define a
                     parameter set associated with a service flow
                     and are read-only entries in this table. The
                     entries are added and deleted by the device.

                     A serviceClass(2) type is used to define a
                     parameter set associated with a service class
                     name and are read-create entries in this



Expires June 2000                                              [Page 34]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                     table."
    ::= { docsQosParamSetEntry 1 }

docsQosParamSetIndex    OBJECT-TYPE
    SYNTAX          Unsigned32 (1..4294967295)
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "Unique index for a QOS parameter set for each
                     docsQosParamSetRowType."
    ::= { docsQosParamSetEntry 2 }

docsQosParamSetRowStatus OBJECT-TYPE
    SYNTAX          RowStatus
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Used to control creation and deletion of
                    rows of with a value of serviceClass(2) for
                    docsQosParamSetRowType."
    ::= { docsQosParamSetEntry 3 }

docsQosParamSetServiceClassName OBJECT-TYPE
    SYNTAX          DisplayString
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Refers to the Service Class Name that the
                    parameter set values were derived.
                    If service class name was not used to specify
                    parameter set values then use zero length
                    DisplayString value."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.3.4"
    ::= { docsQosParamSetEntry 4 }

docsQosParamSetPriority OBJECT-TYPE
    SYNTAX          Integer32 (0..7)
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "The relative priority of a service flow.
                    Higher numbers indicate higher priority.
                    This priority should only be used to diffentiate
                    service flow with identical parameter sets."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.5.2"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 5 }

docsQosParamSetMaxTrafficRate OBJECT-TYPE



Expires June 2000                                              [Page 35]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    SYNTAX          BitRate
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Maximum sustained traffic rate allowed for this
                    service flow in bits/sec. Must count all MAC frame
                    data PDU from the bytes following the MAC header HCS to
                    the end of the CRC. The number of bytes
                    forwarded is limited during any time interval.
                    The value zero means no maximum traffic rate is
                    enforced. This object applies to both upstream and
                    downstream service flows."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.5.3"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 6 }

docsQosParamSetMaxTrafficBurst OBJECT-TYPE
    SYNTAX          Unsigned32
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the token bucket size in bytes
                    for this parameter set. The value is calculated
                    from the byte following the MAC header HCS to
                    the end of the CRC. This object is applied in
                    conjunction with docsQosParamSetMaxTrafficRate to
                    calculate maximum sustained traffic rate."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.5.4"
    DEFVAL          { 1522 }
    ::= { docsQosParamSetEntry 7 }

docsQosParamSetMinReservedRate OBJECT-TYPE
    SYNTAX          BitRate
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the guaranteed minimum rate in
                    bits/sec for this parameter set. The value is
                    calculated from the byte following the MAC
                    header HCS to the end of the CRC. The default
                    value of 0 has the meaning that no bandwidth
                    is reserved."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.5.5"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 8 }

docsQosParamSetMinReservedPkt OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)



Expires June 2000                                              [Page 36]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies an assumed minimum packet size in
                    bytes for which the docsQosParamSetMinReservedRate
                    will be provided. The value is calculated from
                    the byte following the MAC header HCS to the
                    end of the CRC. The default value is CMTS
                    implementation dependent."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.5.6"
    ::= { docsQosParamSetEntry 9 }

docsQosParamSetActiveTimeout OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    UNITS           "seconds"
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the maximum duration in seconds that
                    resources remain unused on an active service
                    flow before CMTS signals that both active and
                    admitted parameters set are null.
                    The default value of zero signifies an
                    infinite amount of time."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.5.7"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 10 }

docsQosParamSetAdmittedTimeout OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    UNITS           "seconds"
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the maximum duration in seconds that
                    resources remain in admitted state before
                    resources must be released.
                    The value of zero signifies an infinite amount
                    of time."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.5.9"
    DEFVAL          { 200 }
    ::= { docsQosParamSetEntry 11 }

docsQosParamSetMaxConcatBurst OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the maximum concatenated burst in



Expires June 2000                                              [Page 37]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    bytes which an upstream  service flow is allowed.
                    The value is calculated from the FC byte of the
                    Concatenation MAC Header to the last CRC in
                    concatenated MAC frame.
                    The value of zero specifies no maximum burst."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.1"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 12 }

docsQosParamSetSchedulingType OBJECT-TYPE
    SYNTAX          INTEGER {
                      undefined (1),
                      bestEffort (2),
                      nonRealTimePollingService(3),
                      realTimePollingService(4),
                      unsolictedGrantServiceWithAD(5),
                      unsolictedGrantService(6),
                      notApplicable(256)
                    }
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the upstream scheduling service used for
                    upstream service flow. The value notApplicable(256)
                    should be used for downstream service flows. "
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.2"
    DEFVAL          { bestEffort }
    ::= { docsQosParamSetEntry 13 }

docsQosParamSetRequestPolicy OBJECT-TYPE
    SYNTAX          BITS {
                      broadcastReqOpp (0),
                      priorityReqMulticastReq (1),
                      reqDataForReq (2),
                      reqDataForData (3),
                      piggybackReqWithData (4),
                      concatenateData (5),
                      fragmentData (6),
                      supressPayloadHeaders (7),
                      dropPktsExceedUGSize (8)
                    }
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies which IUC opportunities the CM uses
                    for upstream tranmission requests and packet
                    transmissions.



Expires June 2000                                              [Page 38]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    A bit value of 1 mean it must not use that
                    opportunity for upstream transmission.

                    broadcastReqOpp(0):
                         all CMs broadcast request opportunities

                    priorityReqMulticastReq(1):
                         priority request multicast request opportunities

                    reqDataForReq(3):
                         request/data opportunities for requests

                    reqDataForData(4):
                         request/data opportunities for data

                    concatenateData(5):
                         concatendate data

                    fragmentData(6):
                         fragment data

                    supressPayloadHeaders(7):
                         suppress payload headers

                    dropPktsExceedUGSize(8):
                         A value of 1 mean that service flow must drop
                         packet that do not fit in the Unsolicited
                         Grant size
                    "
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.3"
    DEFVAL          { { } } -- no enumerated values are set
    ::= { docsQosParamSetEntry 14 }

docsQosParamSetNomPollInterval OBJECT-TYPE
    SYNTAX          Unsigned32
    UNITS           "microseconds"
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the nominal interval in microseconds
                    between successive unicast request
                    opportunities on an upstream service flow.

                    This object only applies to upstream service flows
                    with schedulingType withg value of
                    nonRealTimePollingService(3) or



Expires June 2000                                              [Page 39]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    realTimePollingService(4)"
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.4"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 15 }

docsQosParamSetTolPollJitter OBJECT-TYPE
    SYNTAX          Unsigned32
    UNITS           "microseconds"
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the maximum amount of time in
                    microseconds that the unicast request interval
                    may be delayed from the nominal periodic
                    schedule on an upstream service flow."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.5"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 16 }

docsQosParamSetUnsolicitGrantSize OBJECT-TYPE
    SYNTAX          Integer32 (0..65535)
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the unsolicited grant size in bytes.
                    The grant size includes the entired MAC frame
                    data PDU from the Frame Control byte to end of
                    the MAC frame."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.6"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 17 }

docsQosParamSetNomGrantInterval OBJECT-TYPE
    SYNTAX          Unsigned32
    UNITS           "microseconds"
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the nominal interval in microseconds
                    between successive data grant opportunities
                    on an upstream service flow.

                    This object is required to be set to not default value
                    when docsQosParamSetScheduleType is set to either
                    unsolictedGrantServiceWithAD(5) or
                    unsolictedGrantService(6)."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.7"
    DEFVAL          { 0 }



Expires June 2000                                              [Page 40]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    ::= { docsQosParamSetEntry 18 }

docsQosParamSetTolGrantJitter OBJECT-TYPE
    SYNTAX          Unsigned32
    UNITS           "microseconds"
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the maximum amount of time in
                    microseconds that the transmission opportunities
                    may be delayed from the nominal periodic schedule.

                    This object is required to be set to non-default value
                    when docsQosParamSetSchedulingType is set to either
                    unsolictedGrantServiceWithAD(5) or
                    unsolictedGrantService(6)."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.8"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 19 }

docsQosParamSetGrantsPerInterval OBJECT-TYPE
    SYNTAX          Integer32 (0..127)
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the number of data grants per Nominal
                    Grant Interval
                    (docsQosParamSetNomGrantInterval).

                    This object is required to be set to non-default value
                    when docsQosParamSetSchedulingType is set to either
                    unsolictedGrantServiceWithAD(5) or
                    unsolictedGrantService(6)."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.9"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 20 }

docsQosParamSetTosAndMask OBJECT-TYPE
    SYNTAX          OCTET STRING (SIZE(1))
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the AND mask for IP TOS byte for overwriting
                    IP packets TOS value.  The IP packets TOS byte is
                    bitwise ANDed with docsQosParamSetTosAndMask and
                    result is bitwise ORed with docsQosParamSetTosORMask
                    and result is writen to IP packet TOS byte.
                    A value of 'FF'H for docsQosParamSetTosAndMask and



Expires June 2000                                              [Page 41]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    a value of '00'H for docsQosParamSetTosOrMask means
                    that IP Packet TOS byte is not overwritten."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.10"
    DEFVAL          { 'FF'H }
    ::= { docsQosParamSetEntry 21 }

docsQosParamSetTosOrMask OBJECT-TYPE
    SYNTAX          OCTET STRING (SIZE(1))
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the OR mask for IP TOS byte."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.10"
    DEFVAL          { '00'H }
    ::= { docsQosParamSetEntry 22 }

-- removed docsQosParamSetMinPhsSize OBJECT-TYPE
--        SYNTAX          Integer32 (0..255)
--        MAX-ACCESS      read-create
--        STATUS          current
--        DESCRIPTION    "Specifies the minimum payload header suppression
--                        size in bytes to be used by CM."
--        REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.6.11"
--        DEFVAL          { 0 }
--        ::= { docsQosParamSetEntry 23 }

docsQosParamSetMaxLatency OBJECT-TYPE
    SYNTAX          Unsigned32
    UNITS           "microseconds"
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Specifies the maximum latency between the
                    reception of a packet by the CMTS on its NSI
                    and the forwarding of the packet to the RF
                    interface. A value of zero signifies no maximum
                    latency enforced. This object only applies to
                    downstream service flows."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.7.1"
    DEFVAL          { 0 }
    ::= { docsQosParamSetEntry 23 }

--
--  Service Flow Table
--
docsQosServiceFlowTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosServiceFlowEntry



Expires June 2000                                              [Page 42]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "This table describes the set of Docsis-QOS
                     Service Flows in a managed device. "
    ::= { docsQosMIBObjects 3 }

docsQosServiceFlowEntry OBJECT-TYPE
    SYNTAX          DocsQosServiceFlowEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "Describes a service flow.
                     An entry in the table exists for each
                     Service Flow ID. The ifIndex is an
                     ifType of docsCableMaclayer(127)."
    INDEX {
            ifIndex,
            docsQosServiceFlowId
          }
    ::= { docsQosServiceFlowTable 1 }

DocsQosServiceFlowEntry ::= SEQUENCE {
    docsQosServiceFlowId                       Unsigned32,
    docsQosServiceFlowProvisionedParamSetIndex Unsigned32,
    docsQosServiceFlowAdmittedParamSetIndex    Unsigned32,
    docsQosServiceFlowActiveParamSetIndex      Unsigned32,
    docsQosServiceFlowSID                      Unsigned32,
    docsQosServiceFlowDirection                IfDirection,
    docsQosServiceFlowPrimary                  TruthValue
    }

docsQosServiceFlowId    OBJECT-TYPE
    SYNTAX          Unsigned32 (1..4294967295)
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "An index assigned to a service flow by CMTS."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.3.2"
    ::= { docsQosServiceFlowEntry 1 }

docsQosServiceFlowProvisionedParamSetIndex  OBJECT-TYPE
    SYNTAX          Unsigned32 (0..4294967295)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Refers to an entry in docsQosParamSetTable
                    with a docsQosParamSetRowType of serviceFlow(1)
                    that contains the provisioned parameter set



Expires June 2000                                              [Page 43]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    values for this service flow.
                    The value is docsQosParamSetIndex for the
                    provisioned parameters set associated with
                    this service flow entry.
                    This object return zero if the
                    docsQosParamSetEntry does not exist. Dynamically
                    created service flow would return a value of zero."
    ::= { docsQosServiceFlowEntry 3 }

docsQosServiceFlowAdmittedParamSetIndex  OBJECT-TYPE
    SYNTAX          Unsigned32 (0..4294967295)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Refers to an entry in docsQosParamSetTable
                    with a docsQosParamSetRowType of serviceFlow(1)
                    that contains the admitted parameter set
                    values for this service flow.
                    The value is docsQosParamSetIndex for the
                    admitted parameters set associated with
                    this service flow entry.
                    This object return zero if the
                    docsQosParamSetEntry does not exist."
    ::= { docsQosServiceFlowEntry 4 }

docsQosServiceFlowActiveParamSetIndex  OBJECT-TYPE
    SYNTAX          Unsigned32 (0..4294967295)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Refers to an entry in docsQosParamSetTable
                    with a docsQosParamSetRowType of serviceFlow(1)
                    that contains the active parameter set
                    values for this service flow.
                    The value is docsQosParamSetIndex for the
                    active parameters set associated with
                    this service flow entry.
                    This object return zero if the
                    docsQosParamSetEntry does not exist."
    ::= { docsQosServiceFlowEntry 5 }

docsQosServiceFlowSID  OBJECT-TYPE
    SYNTAX          Unsigned32 (0..16383)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Service Identifier (SID) assigned to an
                    addmitted or active service flow. This object



Expires June 2000                                              [Page 44]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    return a value of zero if a Service Id is not
                    associated with the service flow. Only active
                    or admitted upstream service flows will have a
                    Service Id (SID)."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.3.3"
    ::= { docsQosServiceFlowEntry 6 }

docsQosServiceFlowDirection OBJECT-TYPE
    SYNTAX          IfDirection
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The direction of the service flow."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.1/2"
    ::= { docsQosServiceFlowEntry 7 }

docsQosServiceFlowPrimary OBJECT-TYPE
    SYNTAX          TruthValue
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Object reflects whether service flow is the primary
                    or a secondary service flow.

                    A primary service flow is the default service flow
                    for otherwise unclassified traffic and all MAC
                    messages."
    REFERENCE      "SP-RFIv1.1-I01-990311, Section 8.1 "
    ::= { docsQosServiceFlowEntry 8 }


--
--  Service Flow Stats Table
--
docsQosServiceFlowStatsTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosServiceFlowStatsEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "This table describes statistics associated with the
                     Service Flows in a managed device. "
    ::= { docsQosMIBObjects 4 }

docsQosServiceFlowStatsEntry OBJECT-TYPE
    SYNTAX          DocsQosServiceFlowStatsEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "Describes a set of service flow statisics.



Expires June 2000                                              [Page 45]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                     An entry in the table exists for each
                     Service Flow ID. The ifIndex is an
                     ifType of docsCableMaclayer(127)."
    INDEX {
            ifIndex,
            docsQosServiceFlowId
          }
    ::= { docsQosServiceFlowStatsTable 1 }

DocsQosServiceFlowStatsEntry ::= SEQUENCE {
    docsQosServiceFlowPkts                     Counter32,
    docsQosServiceFlowOctets                   Counter32,
    docsQosServiceFlowTimeCreated              TimeStamp,
    docsQosServiceFlowTimeActive               Counter32,
    docsQosServiceFlowPHSUnknowns              Counter32,
    docsQosServiceFlowPolicedDropPkts          Counter32,
    docsQosServiceFlowPolicedDelayPkts         Counter32
    }

docsQosServiceFlowPkts OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of packet counted on this service flow."
    ::= { docsQosServiceFlowStatsEntry 1 }

docsQosServiceFlowOctets OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of octets counted on this service flow
                    after payload header suppression."
    ::= { docsQosServiceFlowStatsEntry 2 }

docsQosServiceFlowTimeCreated OBJECT-TYPE
    SYNTAX          TimeStamp
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The value of sysUpTime when the service flow
                    was created."
    ::= { docsQosServiceFlowStatsEntry 3 }

docsQosServiceFlowTimeActive OBJECT-TYPE
    SYNTAX          Counter32
    UNITS           "seconds"



Expires June 2000                                              [Page 46]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The total time that service flow has been active."
    ::= { docsQosServiceFlowStatsEntry 4 }

docsQosServiceFlowPHSUnknowns OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of packet with unknown payload header
                    suppresion index."
    ::= { docsQosServiceFlowStatsEntry 5 }

docsQosServiceFlowPolicedDropPkts OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of packet dropped due to policing of
                    that service flow."
    ::= { docsQosServiceFlowStatsEntry 6 }

docsQosServiceFlowPolicedDelayPkts OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of packet delayed due to policing of
                    that service flow."
    ::= { docsQosServiceFlowStatsEntry 7 }

--
--  Upstream Service Flow Stats Table (CMTS ONLY)
--
docsQosUpstreamStatsTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosUpstreamStatsEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "This table describes statistics associated with
                     upstream service flows."
    ::= { docsQosMIBObjects 5 }

docsQosUpstreamStatsEntry OBJECT-TYPE
    SYNTAX          DocsQosUpstreamStatsEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "Describes a set of upstream service flow statisics.



Expires June 2000                                              [Page 47]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                     An entry in the table exists for each
                     upstream Service Flow in a managed device.
                     The ifIndex is an ifType of docsCableMaclayer(127)."
    INDEX {
            ifIndex,
            docsQosSID
          }
    ::= { docsQosUpstreamStatsTable 1 }

DocsQosUpstreamStatsEntry ::= SEQUENCE {
    docsQosSID                            Integer32,
    docsQosUpstreamFragPkts               Counter32,
    docsQosUpstreamIncompletePkts         Counter32,
    docsQosUpstreamConcatBursts           Counter32
    }

docsQosSID OBJECT-TYPE
    SYNTAX          Integer32 (1..16383)
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "Identifies a service id for an admitted or active
                    upstream service flow."
    ::= { docsQosUpstreamStatsEntry 1 }


docsQosUpstreamFragPkts OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of fragmented packets counted on an
                    upstream  service flow."
    ::= { docsQosUpstreamStatsEntry 2 }

docsQosUpstreamIncompletePkts OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of incomplete fragmented packets counted
                    on an upstream service flow."
    ::= { docsQosUpstreamStatsEntry 3 }

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



Expires June 2000                                              [Page 48]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    DESCRIPTION    "The number of concatenated bursts counted on an
                    upstream service flow."
    ::= { docsQosUpstreamStatsEntry 4 }


--
--  Dynamic Service Stats Table
--
docsQosDynamicServiceStatsTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosDynamicServiceStatsEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "This table describes statistics associated with the
                     Dynamic Service Flows in a managed device. "
    ::= { docsQosMIBObjects 6 }

docsQosDynamicServiceStatsEntry OBJECT-TYPE
    SYNTAX          DocsQosDynamicServiceStatsEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "Describes a set of dynamic service flow statisics.
                     Two entries exist for each Docsis mac layer
                     interface for upstream and downstream direction.
                     The ifIndex is an ifType of docsCableMaclayer(127)."
    INDEX {
            ifIndex,
            docsQosIfDirection
          }
    ::= { docsQosDynamicServiceStatsTable 1 }

DocsQosDynamicServiceStatsEntry ::= SEQUENCE {
    docsQosIfDirection                         IfDirection,
    docsQosDSAReqs                             Counter32,
    docsQosDSARsps                             Counter32,
    docsQosDSAAcks                             Counter32,
    docsQosDSCReqs                             Counter32,
    docsQosDSCRsps                             Counter32,
    docsQosDSCAcks                             Counter32,
    docsQosDSDReqs                             Counter32,
    docsQosDSDRsps                             Counter32,
    docsQosDynamicAdds                         Counter32,
    docsQosDynamicAddFails                     Counter32,
    docsQosDynamicChanges                      Counter32,
    docsQosDynamicChangeFails                  Counter32,
    docsQosDynamicDeletes                      Counter32,



Expires June 2000                                              [Page 49]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    docsQosDynamicDeleteFails                  Counter32
   }

docsQosIfDirection OBJECT-TYPE
    SYNTAX          IfDirection
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "The direction of interface."
    ::= { docsQosDynamicServiceStatsEntry 1 }

docsQosDSAReqs OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Addition Requests"
    ::= { docsQosDynamicServiceStatsEntry 2 }

docsQosDSARsps OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Addition Responses"
    ::= { docsQosDynamicServiceStatsEntry 3 }

docsQosDSAAcks OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Addition Acknowlegements."
    ::= { docsQosDynamicServiceStatsEntry 4 }

docsQosDSCReqs OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Change Requests"
    ::= { docsQosDynamicServiceStatsEntry 5 }

docsQosDSCRsps OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Change Responses"
    ::= { docsQosDynamicServiceStatsEntry 6 }




Expires June 2000                                              [Page 50]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



docsQosDSCAcks OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Change Acknowlegements."
    ::= { docsQosDynamicServiceStatsEntry 7 }

docsQosDSDReqs OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Delete Requests"
    ::= { docsQosDynamicServiceStatsEntry 8 }

docsQosDSDRsps OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Delete Responses"
    ::= { docsQosDynamicServiceStatsEntry 9 }

docsQosDynamicAdds OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of sucessful Dynamic Service Additions."
    ::= { docsQosDynamicServiceStatsEntry 10 }

docsQosDynamicAddFails OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Addition failures."
    ::= { docsQosDynamicServiceStatsEntry 11 }

docsQosDynamicChanges OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of sucessful Dynamic Service Changes."
    ::= { docsQosDynamicServiceStatsEntry 12 }

docsQosDynamicChangeFails OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only



Expires June 2000                                              [Page 51]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Change failures."
    ::= { docsQosDynamicServiceStatsEntry 13 }

docsQosDynamicDeletes OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of sucessful Dynamic Service Deletes."
    ::= { docsQosDynamicServiceStatsEntry 14 }

docsQosDynamicDeleteFails OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of Dynamic Service Delete failures."
    ::= { docsQosDynamicServiceStatsEntry 15 }


--
--  Service Flow Log Table (CMTS ONLY)
--
docsQosServiceFlowLogTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosServiceFlowLogEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "This table contains a log of the disconnected
                     Service Flows in a managed device."
    ::= { docsQosMIBObjects 7 }

docsQosServiceFlowLogEntry OBJECT-TYPE
    SYNTAX          DocsQosServiceFlowLogEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "The information reguarding a single disconnected
                     service flow."
    INDEX {
            docsQosServiceFlowLogIndex
          }
    ::= { docsQosServiceFlowLogTable 1 }

DocsQosServiceFlowLogEntry ::= SEQUENCE {
    docsQosServiceFlowLogIndex                 Unsigned32,
    docsQosServiceFlowLogIfIndex               InterfaceIndex,
    docsQosServiceFlowLogSFID                  Unsigned32,



Expires June 2000                                              [Page 52]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    docsQosServiceFlowLogCmMac                 MacAddress,
    docsQosServiceFlowLogPkts                  Counter32,
    docsQosServiceFlowLogOctets                Counter32,
    docsQosServiceFlowLogTimeDeleted           TimeStamp,
    docsQosServiceFlowLogTimeCreated           TimeStamp,
    docsQosServiceFlowLogTimeActive            Counter32,
    docsQosServiceFlowLogControl               INTEGER
    }

docsQosServiceFlowLogIndex OBJECT-TYPE
    SYNTAX          Unsigned32
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "Unique index for a logged service flow."
    ::= { docsQosServiceFlowLogEntry 1 }

docsQosServiceFlowLogIfIndex OBJECT-TYPE
    SYNTAX          InterfaceIndex
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "The ifIndex of ifType docsCableMacLayter(127)
                     on the CMTS where the service flow was present."
    ::= {  docsQosServiceFlowLogEntry 2 }

docsQosServiceFlowLogSFID    OBJECT-TYPE
    SYNTAX          Unsigned32 (1..4294967295)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The index assigned to the service flow by the CMTS."
    ::= {  docsQosServiceFlowLogEntry 3 }

docsQosServiceFlowLogCmMac OBJECT-TYPE
    SYNTAX          MacAddress
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "The MAC address for the cable modem associated with
                     the service flow."
    ::= { docsQosServiceFlowLogEntry 4 }

docsQosServiceFlowLogPkts OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of packets counted on this service flow
                    after payload header suppression."



Expires June 2000                                              [Page 53]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    ::= { docsQosServiceFlowLogEntry 5 }

docsQosServiceFlowLogOctets OBJECT-TYPE
    SYNTAX          Counter32
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The number of octets counted on this service flow
                    after payload header suppression."
    ::= { docsQosServiceFlowLogEntry 6 }


docsQosServiceFlowLogTimeDeleted OBJECT-TYPE
    SYNTAX          TimeStamp
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The value of sysUpTime when the service flow
                    was deleted."
    ::= { docsQosServiceFlowLogEntry 7 }

docsQosServiceFlowLogTimeCreated OBJECT-TYPE
    SYNTAX          TimeStamp
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The value of sysUpTime when the service flow
                    was created."
    ::= { docsQosServiceFlowLogEntry 8 }


docsQosServiceFlowLogTimeActive OBJECT-TYPE
    SYNTAX          Counter32
    UNITS           "seconds"
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The total time that service flow was active."
    ::= { docsQosServiceFlowLogEntry 9 }

docsQosServiceFlowLogControl OBJECT-TYPE
    SYNTAX          INTEGER {
                     active(1),
                     destroy(6)
                    }

    MAX-ACCESS      read-write
    STATUS          current
    DESCRIPTION    "Setting this object to the value destroy(6) removes



Expires June 2000                                              [Page 54]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    this entry from the table.
                    Reading this object return the value active(1)."
    ::= { docsQosServiceFlowLogEntry 10 }


--
-- Service Class Table (CMTS ONLY)
--
docsQosServiceClassTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosServiceClassEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "This table describes the set of Docsis-QOS
                     Service Classes in a CMTS. "
    ::= { docsQosMIBObjects 8 }

docsQosServiceClassEntry OBJECT-TYPE
    SYNTAX          DocsQosServiceClassEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "A provisioned service class."
    INDEX {
             docsQosServiceClassName
          }
    ::= { docsQosServiceClassTable 1 }

DocsQosServiceClassEntry ::= SEQUENCE {
    docsQosServiceClassName          DisplayString,
    docsQosServiceClassParamSetIndex Unsigned32,
    docsQosServiceClassStatus        RowStatus
    }

docsQosServiceClassName OBJECT-TYPE
    SYNTAX          DisplayString
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "Service Class Name."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.2.3.4"
    ::= { docsQosServiceClassEntry 1 }

docsQosServiceClassParamSetIndex OBJECT-TYPE
    SYNTAX          Unsigned32 (1..4294967295)
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Refers  to an entry in docsQosParamSetTable



Expires June 2000                                              [Page 55]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    with a docsQosParamSetRowType of serviceClass(2).
                    The value is docsQosParamSetIndex for the
                    parameters set associated with this service
                    class entry."
    ::= { docsQosServiceClassEntry 2 }

docsQosServiceClassStatus OBJECT-TYPE
    SYNTAX          RowStatus
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Used to create or delete rows in this table.
                    This object should delete the entry in
                    docsQosParamSetTable referenced by
                    docsQosServiceClassParamSetIndex first
                    before deleting this entry."
    ::= { docsQosServiceClassEntry 3 }


--
-- Service Class PolicyTable
--
docsQosServiceClassPolicyTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosServiceClassPolicyEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "This table describes the set of Docsis-QOS
                    Service Class Policies.

                    This table is an adjunt to the
                    docsDevFilterPolicy table.  Entries in
                    docsDevFilterPolicy table can  point to
                    specific rows in this table.

                    This table permits mapping a packet to a service
                    class name of an active service flow so long as
                    a classifier does not exist at a higher
                    priority.
                   "
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix E.2.1"
    ::= { docsQosMIBObjects 9 }

docsQosServiceClassPolicyEntry OBJECT-TYPE
    SYNTAX          DocsQosServiceClassPolicyEntry
    MAX-ACCESS      not-accessible
    STATUS          current



Expires June 2000                                              [Page 56]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    DESCRIPTION     "A service class name policy entry."
    INDEX {
            docsQosServiceClassPolicyIndex
          }
    ::= { docsQosServiceClassPolicyTable 1 }

DocsQosServiceClassPolicyEntry ::= SEQUENCE {
    docsQosServiceClassPolicyIndex        Integer32,
    docsQosServiceClassPolicyName         DisplayString,
    docsQosServiceClassPolicyRulePriority Integer32,
    docsQosServiceClassPolicyStatus       RowStatus
    }

docsQosServiceClassPolicyIndex OBJECT-TYPE
    SYNTAX          Integer32 (1..2147483647)
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "Index value to uniquely identify an entry in
                    this table."
    ::= { docsQosServiceClassPolicyEntry 1 }

docsQosServiceClassPolicyName OBJECT-TYPE
    SYNTAX          DisplayString
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Service Class Name to identify the name of the
                    service class flow to which the packet should be
                    directed."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix E.2.1"
    ::= { docsQosServiceClassPolicyEntry 2 }

docsQosServiceClassPolicyRulePriority OBJECT-TYPE
    SYNTAX          Integer32 (0..255)
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Service Class Policy rule priority for the
                    entry."
    REFERENCE      "SP-RFIv1.1-I01-990311, Appendix C.2.1.3.5"
    ::= { docsQosServiceClassPolicyEntry 3 }

docsQosServiceClassPolicyStatus OBJECT-TYPE
    SYNTAX          RowStatus
    MAX-ACCESS      read-create
    STATUS          current
    DESCRIPTION    "Used to create or delete rows in this table.



Expires June 2000                                              [Page 57]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



                    This object should not be deleted if it is
                    reference by an entry in docsDevFilterPolicy.
                    The reference should be deleted first."
    ::= { docsQosServiceClassPolicyEntry 4 }

--
-- Payload Header Suppression(PHS) Table
--
docsQosPHSTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosPHSEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "This table describes set of payload header
                     suppression entries."
    ::= { docsQosMIBObjects 10 }

docsQosPHSEntry OBJECT-TYPE
    SYNTAX          DocsQosPHSEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "A payload header supression entry.
                     The ifIndex is an ifType of docsCableMaclayer(127)."
    INDEX {
            ifIndex,
            docsQosServiceFlowId,
            docsQosPHSIndex
          }
    ::= { docsQosPHSTable 1 }

DocsQosPHSEntry ::= SEQUENCE {
    docsQosPHSIndex            Integer32,
    docsQosPHSField            OCTET STRING,
    docsQosPHSMask             OCTET STRING,
    docsQosPHSSize             Integer32,
    docsQosPHSVerify           TruthValue,
    docsQosPHSClassifierIndex  Integer32
    }

docsQosPHSIndex         OBJECT-TYPE
    SYNTAX          Integer32 (1..255)
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "Payload header suppression index uniquely
                    references an entry on a per
                    docsQosServiceFlowId."



Expires June 2000                                              [Page 58]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.2.10.2"
    ::= { docsQosPHSEntry 1 }

docsQosPHSField         OBJECT-TYPE
    SYNTAX          OCTET STRING (SIZE(0..255))
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Payload header suppression field defines the
                    bytes of the header which must be
                    supressed/restored by the sending/receiving
                    device.

                    The number of octets in this object should be
                    the same as the value of docsQosPHSSize."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.2.10.1"
    ::= { docsQosPHSEntry 2 }

docsQosPHSMask          OBJECT-TYPE
    SYNTAX          OCTET STRING(SIZE(0..32))
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Payload header suppression mask defines the
                    bit mask which used in combination with the
                    docsQosPHSField defines which bytes in header
                    must be supressed/restored by the sending or
                    receiving device.

                    Each bit of this bit mask corresponds to a byte
                    in the docsQosPHSField, with the least
                    significant  bit corresponding to first byte of
                    the docsQosPHSField.

                    Each bit of the bit mask specifies whether of
                    not the corresponding byte should be supressed
                    in the packet. A bit value of '1' indicates that
                    the byte should be suppressed by the sending
                    device and restored by the receiving device.
                    A bit value of '0' indicates that
                    the byte should not be suppressed by the sending
                    device or restored by the receiving device.

                    If the bit mask does not contain a bit for each
                    byte in the docsQosPHSField then the bit mask is
                    extended with bit values of '1' to be the
                    neccessary length."



Expires June 2000                                              [Page 59]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.2.10.3"
    ::= { docsQosPHSEntry 3 }

docsQosPHSSize          OBJECT-TYPE
    SYNTAX          Integer32 (0..255)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Payload header suppression size specifies the
                    number of bytes in the header to be suppressed
                    and restored.

                    The value of this object must match the number
                    of bytes in the docsQosPHSField."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.2.10.4"
    ::= { docsQosPHSEntry 4 }

docsQosPHSVerify       OBJECT-TYPE
    SYNTAX          TruthValue
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "Payload header suppression verification value of
                    'true' the sender must verify docsQosPHSField
                    is the same as what is contained in the packet
                    to be suppressed."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.2.10.5"
    ::= { docsQosPHSEntry 5 }

docsQosPHSClassifierIndex OBJECT-TYPE
    SYNTAX          Integer32 (1..65535)
    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION    "The index of the packets classfier associated with
                    this payload header supression entry.

                    The value of this object is same as docsQosPktClassId
                    and refers to a particular entry in
                    docsQosPktClassTable using ifIndex and
                    docsQosServiceFlowId for this entry in addition to
                    docsQosPHSClassifierIndex."
    REFERENCE       "SP-RFIv1.1-I01-990311, Appendix C.2.2.8.2"
    ::= { docsQosPHSEntry 6 }


--
-- docsQosCmtsMacToSrvFlowTable (CMTS Only)



Expires June 2000                                              [Page 60]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



--
docsQosCmtsMacToSrvFlowTable OBJECT-TYPE
    SYNTAX          SEQUENCE OF DocsQosCmtsMacToSrvFlowEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "This table provide for referencing the service flows
                     associated with a particular cable modem. This allows
                     for indexing into other docsQos tables that are
                     indexed by docsQosServiceFlowId and ifIndex."
    ::= { docsQosMIBObjects 11 }

docsQosCmtsMacToSrvFlowEntry OBJECT-TYPE
    SYNTAX          DocsQosCmtsMacToSrvFlowEntry
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "An entry is created by CMTS for each service flow
                     connected to this CMTS."
    INDEX {
            docsQosCmtsCmMac,
            docsQosCmtsServiceFlowId
          }
    ::= { docsQosCmtsMacToSrvFlowTable 1 }

DocsQosCmtsMacToSrvFlowEntry ::= SEQUENCE {
    docsQosCmtsCmMac                MacAddress,
    docsQosCmtsServiceFlowId        Unsigned32,
    docsQosCmtsIfIndex              InterfaceIndex
    }

docsQosCmtsCmMac OBJECT-TYPE
    SYNTAX          MacAddress
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION     "The MAC address for the referenced CM."
    ::= { docsQosCmtsMacToSrvFlowEntry 1 }

docsQosCmtsServiceFlowId OBJECT-TYPE
    SYNTAX          Unsigned32 (1..4294967295)
    MAX-ACCESS      not-accessible
    STATUS          current
    DESCRIPTION    "An index assigned to a service flow by CMTS."
    ::= { docsQosCmtsMacToSrvFlowEntry 2 }

docsQosCmtsIfIndex OBJECT-TYPE
    SYNTAX          InterfaceIndex



Expires June 2000                                              [Page 61]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    MAX-ACCESS      read-only
    STATUS          current
    DESCRIPTION     "The ifIndex of ifType docsCableMacLayter(127)
                     on the CMTS that is connected to the Cable Modem."
    ::= { docsQosCmtsMacToSrvFlowEntry 3 }


--
-- Placeholder for notifications/traps.
--
docsQosNotification OBJECT IDENTIFIER   ::= { docsQosMIB 2 }


--
-- Conformance definitions
--
docsQosConformance  OBJECT IDENTIFIER   ::= { docsQosMIB 3 }
docsQosGroups       OBJECT IDENTIFIER   ::= { docsQosConformance 1 }
docsQosCompliances  OBJECT IDENTIFIER   ::= { docsQosConformance 2 }

docsQosCompliance MODULE-COMPLIANCE
    STATUS  current
    DESCRIPTION
        "The compliance statement for MCNS Cable Modems and
         Cable Modem Termination Systems that implement DOCSIS
         Service Flows."

    MODULE  -- docsQosMIB
        MANDATORY-GROUPS { docsQosBaseGroup }

        GROUP docsQosCmtsGroup
        DESCRIPTION
            "This group is mandatory for only Cable Modem Termination
             Systems (CMTS) and not implemented for Cable Modems."

        GROUP docsQosParamSetGroup
        DESCRIPTION
            "This group is mandatory for Cable Modem Termination
             Systems (CMTS) and Cable Modems. Cable modems only implement
             objects in this group as read-only."

        GROUP docsQosSrvClassPolicyGroup
        DESCRIPTION
            "This group is optional for Cable Modem Termination
             Systems (CMTS) and Cable Modems. This group only needs to



Expires June 2000                                              [Page 62]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



             be implement if policy based service flow classification
             is implemented. See docsDevPolicyTable in
             DOCS-CABLE-DEVICE-MIB for more details. "

        OBJECT  docsQosPktClassPkts
        DESCRIPTION
            "This object only needs to be implemented for in entries
             that are classifing packet and not policing pakets."

    ::= { docsQosCompliances 1 }

docsQosBaseGroup OBJECT-GROUP
    OBJECTS {
    docsQosPktClassDirection,
    docsQosPktClassPriority,
    docsQosPktClassIpTosLow,
    docsQosPktClassIpTosHigh,
    docsQosPktClassIpTosMask,
    docsQosPktClassIpProtocol,
    docsQosPktClassIpSourceAddr,
    docsQosPktClassIpSourceMask,
    docsQosPktClassIpDestAddr,
    docsQosPktClassIpDestMask,
    docsQosPktClassSourcePortStart,
    docsQosPktClassSourcePortEnd,
    docsQosPktClassDestPortStart,
    docsQosPktClassDestPortEnd,
    docsQosPktClassDestMacAddr,
    docsQosPktClassDestMacMask,
    docsQosPktClassSourceMacAddr,
    docsQosPktClassEnetProtocolType,
    docsQosPktClassEnetProtocol,
    docsQosPktClassUserPriApplies,
    docsQosPktClassUserPriLow,
    docsQosPktClassUserPriHigh,
    docsQosPktClassVlanId,
    docsQosPktClassState,
    docsQosPktClassPkts,

    docsQosServiceFlowProvisionedParamSetIndex,
    docsQosServiceFlowAdmittedParamSetIndex,
    docsQosServiceFlowActiveParamSetIndex,
    docsQosServiceFlowSID,
    docsQosServiceFlowDirection,
    docsQosServiceFlowPrimary,



Expires June 2000                                              [Page 63]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    docsQosServiceFlowPkts,   -- not sure if CM should implement
    docsQosServiceFlowOctets,
    docsQosServiceFlowTimeCreated,
    docsQosServiceFlowTimeActive,
    docsQosServiceFlowPHSUnknowns,
    docsQosServiceFlowPolicedDropPkts,
    docsQosServiceFlowPolicedDelayPkts,

    docsQosDSAReqs,
    docsQosDSARsps,
    docsQosDSAAcks,
    docsQosDSCReqs,
    docsQosDSCRsps,
    docsQosDSCAcks,
    docsQosDSDReqs,
    docsQosDSDRsps,
    docsQosDynamicAdds,
    docsQosDynamicAddFails,
    docsQosDynamicChanges,
    docsQosDynamicChangeFails,
    docsQosDynamicDeletes,
    docsQosDynamicDeleteFails,

    docsQosPHSField,
    docsQosPHSMask,
    docsQosPHSSize,
    docsQosPHSVerify,
    docsQosPHSClassifierIndex

    }
    STATUS  current
    DESCRIPTION
        "Group of objects implemenented in both Cable Modems and
         Cable Modem Termination Systems."
    ::= { docsQosGroups 1 }

docsQosParamSetGroup OBJECT-GROUP
    OBJECTS {
    docsQosParamSetRowStatus,
    docsQosParamSetServiceClassName,
    docsQosParamSetPriority,
    docsQosParamSetMaxTrafficRate,
    docsQosParamSetMaxTrafficBurst,
    docsQosParamSetMinReservedRate,
    docsQosParamSetMinReservedPkt,



Expires June 2000                                              [Page 64]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    docsQosParamSetActiveTimeout,
    docsQosParamSetAdmittedTimeout,
    docsQosParamSetMaxConcatBurst,
    docsQosParamSetSchedulingType,
    docsQosParamSetRequestPolicy,
    docsQosParamSetNomPollInterval,
    docsQosParamSetTolPollJitter,
    docsQosParamSetUnsolicitGrantSize,
    docsQosParamSetNomGrantInterval,
    docsQosParamSetTolGrantJitter,
    docsQosParamSetGrantsPerInterval,
    docsQosParamSetTosAndMask,
    docsQosParamSetTosOrMask,
    docsQosParamSetMaxLatency
    }
    STATUS  current
    DESCRIPTION
        "Group of objects implemenent in both Cable Modems and
         Cable Modem Termination Systems for QOS parameter sets."
    ::= { docsQosGroups 2 }


docsQosCmtsGroup OBJECT-GROUP
    OBJECTS {
    docsQosServiceClassParamSetIndex,
    docsQosServiceClassStatus,

    docsQosUpstreamFragPkts,
    docsQosUpstreamIncompletePkts,
    docsQosUpstreamConcatBursts,

    docsQosServiceFlowLogIfIndex,
    docsQosServiceFlowLogSFID,
    docsQosServiceFlowLogCmMac,
    docsQosServiceFlowLogPkts,
    docsQosServiceFlowLogOctets,
    docsQosServiceFlowLogTimeDeleted,
    docsQosServiceFlowLogTimeCreated,
    docsQosServiceFlowLogTimeActive,
    docsQosServiceFlowLogControl,

    docsQosCmtsIfIndex

    }
    STATUS  current



Expires June 2000                                              [Page 65]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



    DESCRIPTION
        "Group of objects implemenented only in
         Cable Modem Termination Systems."
    ::= { docsQosGroups 3 }

docsQosSrvClassPolicyGroup OBJECT-GROUP
    OBJECTS {
    docsQosServiceClassPolicyName,
    docsQosServiceClassPolicyRulePriority,
    docsQosServiceClassPolicyStatus
    }
    STATUS  current
    DESCRIPTION
        "Group of objects implemenented in both Cable Modems and
         Cable Modem Termination Systems when supporting policy based
         service flows."
    ::= { docsQosGroups 4 }


END







.  References




















Expires June 2000                                              [Page 66]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



   []  Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for
        Describing SNMP Management Frameworks", RFC 2271, Cabletron
        Systems, Inc., BMC Software, Inc., IBM T. J. Watson Research,
        January 1998

   []  Rose, M., and K. McCloghrie, "Structure and Identification of
        Management Information for TCP/IP-based Internets", RFC 1155,
        Performance Systems International, Hughes LAN Systems, May 1990

   []  Rose, M., and K. McCloghrie, "Concise MIB Definitions", RFC 1212,
        Performance Systems International, Hughes LAN Systems, March 1991

   []  M. Rose, "A Convention for Defining Traps for use with the SNMP",
        RFC 1215, Performance Systems International, March 1991

   []  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, SNMP Research,Inc., Cisco
        Systems, Inc., Dover Beach Consulting, Inc., International Network
        Services, January 1996.

   []  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual
        Conventions for Version 2 of the Simple Network Management Protocol
        (SNMPv2)", RFC 1903, SNMP Research, Inc., Cisco Systems, Inc.,
        Dover Beach Consulting, Inc., International Network Services,
        January 1996.

   []  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Conformance
        Statements for Version 2 of the Simple Network Management Protocol
        (SNMPv2)", RFC 1904, SNMP Research, Inc., Cisco Systems, Inc.,
        Dover Beach Consulting, Inc., International Network Services,
        January 1996.

   []  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
        Management Protocol", RFC 1157, SNMP Research, Performance Systems
        International, Performance Systems International, MIT Laboratory
        for Computer Science, May 1990.

   []  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
        "Introduction to Community-based SNMPv2", RFC 1901, SNMP Research,
        Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
        International Network Services, January 1996.

   [] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Transport
        Mappings for Version 2 of the Simple Network Management Protocol



Expires June 2000                                              [Page 67]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



        (SNMPv2)", RFC 1906, SNMP Research, Inc., Cisco Systems, Inc.,
        Dover Beach Consulting, Inc., International Network Services,
        January 1996.

   [] Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message
        Processing and Dispatching for the Simple Network Management
        Protocol (SNMP)", RFC 2272, SNMP Research, Inc., Cabletron Systems,
        Inc., BMC Software, Inc., IBM T. J. Watson Research, January 1998.

   [] Blumenthal, U., and B. Wijnen, "User-based Security Model (USM) for
        version 3 of the Simple Network Management Protocol (SNMPv3)", RFC
        2274, IBM T. J. Watson Research, January 1998.

   [] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
        Operations for Version 2 of the Simple Network Management Protocol
        (SNMPv2)", RFC 1905, SNMP Research, Inc., Cisco Systems, Inc.,
        Dover Beach Consulting, Inc., International Network Services,
        January 1996.

   [] Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC
        2273, SNMP Research, Inc., Secure Computing Corporation, Cisco
        Systems, January 1998

   [] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access
        Control Model (VACM) for the Simple Network Management Protocol
        (SNMP)", RFC 2275, IBM T. J. Watson Research, BMC Software, Inc.,
        Cisco Systems, Inc., January 1998

   [] " Data-Over-Cable Service Interface Specifications: Cable Modem
        Radio Frequency Interface Specification SP-RFIv1_1-I01-990311", DOCSIS,
        March 1999, http://www.cablemodem.com.

   [] L. Steinberg, "Techniques for Managing Asynchronously Generated
        Alerts", RFC 1224, May 1991.

   [] "Data-Over-Cable Service Interface Specifications: Operations
        Support System Interface Specification RF Interface SP-OSSI-RF-
        I02-980410", DOCSIS, April 1998,
        http://www.cablemodem.com/public/pubtechspec/ossi/sp-ossi.PDF.

   [] Bradner, S., "Key words for use in RFCs to Indicate Requirement
        Levels", RFC2119, Harvard University, March 1997

   [] "Data-Over-Cable Service Interface Specifications: Baseline Privacy
        Interface Specification SP-BPI-I01-970922", DOCSIS, September 1977,



Expires June 2000                                              [Page 68]

INTERNET-DRAFT     <draft-ietf-ipcdn-qos-mib-02.txt>       December 1999



        http://www.cablemodem.com/public/pubtechspec/ss/SP-BPI-I01-
        970922.pdf

   [] "Cable Device Management Information Base for DOCSIS compliant Cable
        Modems and Cable Modem Termination Systems", RFC2669

   [] "Radio Frequency (RF) Interface Management Information Base
        for MCNS/DOCSIS compliant RF interfaces", RFC 2670






.  Authors' Addresses

   John Harvey
   Motorola Information Networking Group
   20 Cabot Blvd., MS M4-25
   Mansfield, MA 02048
   Phone: (508) 261-4579
   Email: ljh031@email.mot.com

   Michael Patrick
   Motorola Information Networking Group
   20 Cabot Blvd., MS M4-30
   Mansfield, MA 02048
   Phone: (508) 261-5707
   Email: lzz007@email.mot.com



















Expires June 2000                                              [Page 69]