Class CIM_DiscreteMetricDefinition
extends CIM_BaseMetricDefinition

Specialization of BaseMetricDefinition that represents a discrete metric type. This class is does not have instances. Instead, it is used to define derived classes that override the Values and ValueMap qualifiers of the DiscreteValues array property, in order to define the predefined set of discrete values to be used. The remainder of this description defines the discrete metric concept: Discrete metrics are metrics (as defined in BaseMetricDefinition), that have an additional discrete value, which is from a set of predefined values. In order to contrast this to the general metrics that have a continuous value range, we call those 'analog metrics' in this description. The transformation of analog values into discrete values is defined by analog thresholds that represent the transition boundary from one discrete value to the next. There are independent thresholds for each direction, so that a hysteresis can be defined. There is a mandatory set of instances for each discrete value: Using the concepts of the dynamic metrics model, there is a DiscreteMetricValue instance representing the discrete metric value and a DiscreteMetricDefinition instance representing its according definition (associated through MetricInstance). In addition, there is a similar couple for the analog metric the discrete metric is derived from, consisting of a BaseMetricValue instance and according BaseMetricDefinition instance (again associated via MetricInstance). These two pairs of instances are connected through the DiscreteMetricDefinitionDependency association between the two metric definition classes, defining that the discrete metric definition and all its values are derived from this analog metric definition and all its values. The existence of the DiscreteMetricDefinitionDependency association mandates that there shall be one DiscreteMetricValue instance for each analog BaseMetricValue instance in the mandatory set of instances described above. Furthermore, it mandates that there are DiscreteMetricValueDependency association instances between the discrete and analog value instances. A recipe for creating a discrete metric type on existing analog metric type is to create a DiscreteMetricDefinition instance, and then to connect that to the analog BaseMetricDefinition by means of creating an instance of DiscreteMetricDefinitionDependency. This results in the DiscreteMetricValue and DiscreteMetricValueDependency instances coming into existence. Please note that hysteresis is implicitly defined as the difference between the trigger value and the reset value.

Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods


Class Hierarchy

CIM_ManagedElement
   |
   +--CIM_BaseMetricDefinition
   |
   +--CIM_DiscreteMetricDefinition

Direct Known Subclasses

Class Qualifiers

NameData TypeValue
DescriptionstringSpecialization of BaseMetricDefinition that represents a discrete metric type. This class is does not have instances. Instead, it is used to define derived classes that override the Values and ValueMap qualifiers of the DiscreteValues array property, in order to define the predefined set of discrete values to be used. The remainder of this description defines the discrete metric concept: Discrete metrics are metrics (as defined in BaseMetricDefinition), that have an additional discrete value, which is from a set of predefined values. In order to contrast this to the general metrics that have a continuous value range, we call those 'analog metrics' in this description. The transformation of analog values into discrete values is defined by analog thresholds that represent the transition boundary from one discrete value to the next. There are independent thresholds for each direction, so that a hysteresis can be defined. There is a mandatory set of instances for each discrete value: Using the concepts of the dynamic metrics model, there is a DiscreteMetricValue instance representing the discrete metric value and a DiscreteMetricDefinition instance representing its according definition (associated through MetricInstance). In addition, there is a similar couple for the analog metric the discrete metric is derived from, consisting of a BaseMetricValue instance and according BaseMetricDefinition instance (again associated via MetricInstance). These two pairs of instances are connected through the DiscreteMetricDefinitionDependency association between the two metric definition classes, defining that the discrete metric definition and all its values are derived from this analog metric definition and all its values. The existence of the DiscreteMetricDefinitionDependency association mandates that there shall be one DiscreteMetricValue instance for each analog BaseMetricValue instance in the mandatory set of instances described above. Furthermore, it mandates that there are DiscreteMetricValueDependency association instances between the discrete and analog value instances. A recipe for creating a discrete metric type on existing analog metric type is to create a DiscreteMetricDefinition instance, and then to connect that to the analog BaseMetricDefinition by means of creating an instance of DiscreteMetricDefinitionDependency. This results in the DiscreteMetricValue and DiscreteMetricValueDependency instances coming into existence. Please note that hysteresis is implicitly defined as the difference between the trigger value and the reset value.
Experimentalbooleantrue
UMLPackagePathstringCIM::Metrics::BaseMetric
Versionstring2.13.0

Class Properties

Local Class Properties

NameData TypeDefault ValueQualifiers
NameData TypeValue
BaseIndexuint16
DescriptionstringThis property is an index into the DiscreteValues array, and is called the 'base index'. The value of the corresponding array entry is called the 'base value'. The base value is the reference point for the AnalogTriggerValues and AnalogResetValues arrays. Moving away from the base value is controlled by the AnalogTriggerValues array, and moving back towards the base value is controlled by the AnalogResetValues array.
AnalogResetValuesstring[]
DescriptionstringArray defining the analog values used as thresholds when the discrete value moves towards the base value. These thresholds are called 'reset values'. The array entries are string representations of the analog values and are interpreted as a datatype and unit defined in the Datatype and Unit properties of the associated analog BaseMetricDefinition instance. If this property is not NULL, the number of array entries shall be one less than the entries in the DiscreteValues array. Array entries in this array at indexes abover or equal to the base index control the transition to lower indexes in the DiscreteValues array. Array entries in this array at indexes below the base index control the transition to higher indexes in the DiscreteValues array. If this property is NULL, reset values may still be in effect but are not externalized at the CIM level.
AnalogTriggerValuesstring[]
DescriptionstringArray defining the analog values used as thresholds when the discrete value moves away from the base value. These thresholds are called 'trigger values'. The array entries are string representations of the analog values and are interpreted as a datatype and unit defined in the Datatype and Unit properties of the associated analog BaseMetricDefinition instance. If this property is not NULL, the number of array entries shall be one less than the entries in the DiscreteValues array. Array entries in this array at indexes above or equal to the base index control the transition to higher indexes in the DiscreteValues array. Array entries in this array at indexes below the base index control the transition to lower indexes in the DiscreteValues array. If this property is NULL, trigger values may still be in effect but are not externalized at the CIM level.
DiscreteValuesuint16[]
DescriptionstringArray defining the mapping between analog and discrete values. Each array entry is the discrete value assigned to a range on the analog scale. Adjacent array entries represent adjacent ranges on the analog scale. The boundaries of the analog ranges are defined in the AnalogTriggerValues and AnalogResetValues array properties. The possible discrete values are defined using the Values and ValueMap qualifiers. Any derived class of this class shall define the set of possible discrete values in overridden Values and ValueMap qualifiers. The Values qualifiers are string representations of the discrete values and are interpreted as a datatype and unit defined in the Datatype and Unit properties of this instance. An according derived class of DiscreteMetricValue shall define the same set of possible discrete values in overridden qualifiers of its DiscreteValue property.
ModelCorrespondencestringCIM_DiscreteMetricValue.DiscreteValue
Requiredbooleantrue
ValueMapstring.., 0x8000..0xFFFF
ValuesstringDMTF Reserved, Vendor Reserved

Inherited Properties

NameData TypeClass Origin
Accuracyuint32CIM_BaseMetricDefinition
AccuracyUnitsstringCIM_BaseMetricDefinition
Calculableuint16CIM_BaseMetricDefinition
CaptionstringCIM_ManagedElement
ChangeTypeuint16CIM_BaseMetricDefinition
DataTypeuint16CIM_BaseMetricDefinition
DescriptionstringCIM_ManagedElement
ElementNamestringCIM_ManagedElement
GatheringTypeuint16CIM_BaseMetricDefinition
Generationuint64CIM_ManagedElement
IdstringCIM_BaseMetricDefinition
InstanceIDstringCIM_ManagedElement
IsContinuousbooleanCIM_BaseMetricDefinition
MetricIDstringCIM_BaseMetricDefinition
NamestringCIM_BaseMetricDefinition
ProgrammaticUnitsstringCIM_BaseMetricDefinition
SampleIntervaldatetimeCIM_BaseMetricDefinition
TimeScopeuint16CIM_BaseMetricDefinition
UnitsstringCIM_BaseMetricDefinition
BreakdownDimensionsstring[]CIM_BaseMetricDefinition

Class Methods