Device\CIM_QueryStatisticsCollection.mof.mof (HTML version)

Return to index
CIM_QueryStatisticsCollection Superclass: CIM_StatisticsCollection
A subclass of SystemSpecificCollection which collects together statistics and gathers them into an efficient representation. This enables very large numbers of statistics to be efficiently gathered via CIM Indications or Operations.
Qualifiers:Experimental Version ( "2.10.0" )
Parameters (local in grey)
Required
ModelCorrespondence { "CIM_QueryStatisticsCollection.Query" , "CIM_QueryStatisticsCollection.SelectedEncoding" }
string SelectedValues ;
A string containing a table of Values with the columns corresponding to the select list entries defined in Query. The encoding is defined by SelectedEncoding.
Values { "CSV" , "DMTF Reserved" , "Vendor Reserved" }
Required
ValueMap { "2" , ".." , "0x8000.." }
uint16 SelectedEncoding = 2 ;
The encoding of the SelectedNames, SelectedTypes, and SelectedValues strings.
- CSV = Comma Separated Values.
Required
ModelCorrespondence { "CIM_QueryStatisticsCollection.Query" , "CIM_QueryStatisticsCollection.SelectedEncoding" }
string SelectedNames ;
A string containing the Names of the select list entries defined in Query. The encoding is defined by SelectedEncoding.
Required
ModelCorrespondence { "CIM_QueryStatisticsCollection.QueryLanguage" }
string Query ;
A query expression that defines information to be placed into the SelectedNames, SelectedTypes, and SelectedValues properties.

The FROM clause MAY reference any class.

An Example:
SELECT Stats.*
FROM CIM_BlockStatisticalData Stats,
CIM_QueryStatisticsCollection QSC,
CIM_MemberOfCollection MoC
Where ObjectPath(QSC) = ObjectPath(SELF)
AND ObjectPath(QSC) = MoC.Collection
AND ObjectPath(Stats) = MoC.Member
AND CurrentDateTime() >=
Stats.StatisticTime + Stats.SampleInterval
Required
ModelCorrespondence { "CIM_QueryStatisticsCollection.Query" , "CIM_QueryStatisticsCollection.SelectedEncoding" }
string SelectedTypes ;
A string containing the Types of the select list entries defined in Query. The encoding is defined by SelectedEncoding.
Values { "CQL" , "DMTF Reserved" , "Vendor Reserved" }
Required
ValueMap { "2" , ".." , "0x8000.." }
uint16 QueryLanguage = 2 ;
The language in which the query is expressed.
datetime SampleInterval = "00000000000000.000000:000" ;
This property provides the minimum sampling interval for the associated statistics so that client applications can determine the minimum interval that the StatisticsCollection should be sampled. If the statistics are sampled at different cycles, this property MUST be set to a zero time interval.
dateTime TimeLastSampled ;
The time that the statistics collection was last sampled. Note that this property MAY be used to trigger an indication for 'push' delivery of statistics samples.
Key
string InstanceID ;
Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class. To ensure uniqueness within the NameSpace, the value of InstanceID should be constructed using the following 'preferred' algorithm:
<OrgID>:<LocalID>
Where <OrgID> and <LocalID> are separated by a colon ':', and where <OrgID> must include a unique name. It can be a copyrighted, trademarked, or otherwise unique name that is owned by the business entity that is creating or defining the InstanceID. Or, it could be a registered ID that is assigned to the business entity by a recognized global authority. (This requirement is similar to the <Schema Name>_<Class Name> structure of Schema class names.) In addition, to ensure uniqueness <OrgID> must not contain a colon (':'). When using this algorithm, the first colon to appear in InstanceID must appear between <OrgID> and <LocalID>.
<LocalID> is chosen by the business entity and should not be re-used to identify different underlying (real-world) elements. If the above 'preferred' algorithm is not used, the defining entity must ensure that the resulting InstanceID is not re-used as any of InstanceIDs produced by this or other providers for the NameSpace of this instance.
For DMTF-defined instances, the 'preferred' algorithm must be used with the <OrgID> set to 'CIM'.
MaxLen ( 64 )
string Caption ;
The Caption property is a short textual description (one- line string) of the object.
string Description ;
The Description property provides a textual description of the object.
string ElementName ;
A user-friendly name for the object. This property allows each instance to define a user-friendly name in addition to its key properties, identity data, and description information.
Note that the Name property of ManagedSystemElement is also defined as a user-friendly name. But, it is often subclassed to be a Key. It is not reasonable that the same property can convey both identity and a user-friendly name, without inconsistencies. Where Name exists and is not a Key (such as for instances of LogicalDevice), the same information can be present in both the Name and ElementName properties.