Class CIM_TokenBucketMeterService
extends CIM_MeterService

This class represents a logical entity that resides in the data forwarding path of a network device. It describes the metering of network traffic using a token bucket meter. Two types of token bucket meters are defined using this class - a simple, 2 parameter bucket meter, and a multi-stage meter. A simple token bucket usually has two parameters, an average token rate and a burst size. Quoting from the IETF Draft, 'A Conceptual Model for DiffServ Routers', "TB meters compare the arrival rate of packets to the average rate specified by the TB profile. Logically, tokens accumulate in a bucket at the average rate, up to a maximum credit which is the burst size. Packets of length L bytes are considered conforming if any tokens are available in the bucket at the time of packet arrival: up to L bytes may then be borrowed from future token allocations. Packets are allowed to exceed the average rate in bursts up to the burst size. Packets which arrive to find a bucket with no tokens in it are deemed non-conforming." This type of meter has only two conformance levels - conforming and non-conforming. This class also defines an excess burst size, which enables the meter to have three conformance levels (basically, 'conforming', 'partially conforming', and 'non-conforming'). The difference is that packets that exceed the excess burst size are deemed non-conforming, while packets that exceed the smaller BurstSize but are less than the ExcessBurstSize are deemed partially conforming. This is modeled as a subclass of ConditioningService and has the ability to invoke different ConditioningServices for conforming, partially conforming and non-conforming traffic.

Class Hierarchy

CIM_ManagedElement
   |
   +--CIM_ManagedSystemElement
   |
   +--CIM_LogicalElement
   |
   +--CIM_Service
   |
   +--CIM_NetworkService
   |
   +--CIM_ForwardingService
   |
   +--CIM_ConditioningService
   |
   +--CIM_MeterService
   |
   +--CIM_TokenBucketMeterService

Direct Known Subclasses

None.

Class Qualifiers

NameData TypeValueScopeFlavors
DescriptionstringThis class represents a logical entity that resides in the data forwarding path of a network device. It describes the metering of network traffic using a token bucket meter. Two types of token bucket meters are defined using this class - a simple, 2 parameter bucket meter, and a multi-stage meter. A simple token bucket usually has two parameters, an average token rate and a burst size. Quoting from the IETF Draft, 'A Conceptual Model for DiffServ Routers', "TB meters compare the arrival rate of packets to the average rate specified by the TB profile. Logically, tokens accumulate in a bucket at the average rate, up to a maximum credit which is the burst size. Packets of length L bytes are considered conforming if any tokens are available in the bucket at the time of packet arrival: up to L bytes may then be borrowed from future token allocations. Packets are allowed to exceed the average rate in bursts up to the burst size. Packets which arrive to find a bucket with no tokens in it are deemed non-conforming." This type of meter has only two conformance levels - conforming and non-conforming. This class also defines an excess burst size, which enables the meter to have three conformance levels (basically, 'conforming', 'partially conforming', and 'non-conforming'). The difference is that packets that exceed the excess burst size are deemed non-conforming, while packets that exceed the smaller BurstSize but are less than the ExcessBurstSize are deemed partially conforming. This is modeled as a subclass of ConditioningService and has the ability to invoke different ConditioningServices for conforming, partially conforming and non-conforming traffic.None TRANSLATABLE= true

Local Class Properties

NameData TypeQualifiers
NameData TypeValueScopeFlavors
AverageRatereal32
DescriptionstringThis property is a 32-bit real number that is used to define the committed rate of the meter.None TRANSLATABLE= true
UnitsstringKiloBits per SecondNone TRANSLATABLE= true
BurstSizereal32
DescriptionstringThis property is a 32-bit real number that is used to define the maximum number of tokens available for the committed rate (specified by the AverageRate property).None TRANSLATABLE= true
UnitsstringKiloBytesNone TRANSLATABLE= true
ExcessBurstSizereal32
DescriptionstringThis property is a 32-bit real number that is used to define the maximum number of tokens available for the peak rate (specified by the PeakRate property).None TRANSLATABLE= true
UnitsstringKiloBytesNone TRANSLATABLE= true
PeakRatereal32
DescriptionstringThis attribute is a 32-bit real number that is used to define the peak rate of the meter.None TRANSLATABLE= true
UnitsstringKiloBits per SecondNone TRANSLATABLE= true

Inherited Properties

NameData TypeClass Origin
CaptionstringCIM_ManagedElement
ConformanceLevelsuint16CIM_MeterService
CreationClassNamestringCIM_Service
DescriptionstringCIM_ManagedElement
EnabledbooleanCIM_ConditioningService
InstallDatedatetimeCIM_ManagedSystemElement
MeterTypeuint16CIM_MeterService
NamestringCIM_Service
OtherMeterTypestringCIM_MeterService
OtherProtocolTypestringCIM_ForwardingService
ProtocolTypeuint16CIM_ForwardingService
ServiceURLstringCIM_NetworkService
StartedbooleanCIM_Service
StartModestringCIM_Service
StatusstringCIM_ManagedSystemElement
SystemCreationClassNamestringCIM_Service
SystemNamestringCIM_Service