Policy\CIM_QueryCondition.mof.mof (HTML version)

Return to index
CIM_QueryCondition Superclass: CIM_PolicyCondition
QueryCondition defines the criteria for generating a set of query results that are accessible to other QueryConditions or MethodActions of the same PolicyRule. If there are no results returned from the query, then the Condition evaluates to false; otherwise, true.

QueryConditions are assumed to be constantly evaluated whenever precursor PolicyConditions are met. Actual implementations may evaluate conditions dynamically, via polling, or via other means.

QueryCondition instances are viewed as clients of query. The QueryCondition implementation takes the query results and makes them available by the name specified in QueryResultName to the FROM clause in the Query property of other QueryConditions or MethodActions. (The details of how this is accomplished are implementation dependent.) These results are not available via CIM Operations, do not create lifecycle indications, and do not persist beyond a single evaluation of the associated PolicyRule.
Qualifiers:Version ( "2.12.0" ) Experimental UMLPackagePath ( "CIM::Policy" )
Parameters (local in grey)
Required
ModelCorrespondence { "CIM_QueryCondition.QueryLanguage" , "CIM_QueryCondition.QueryResultName" }
string Query ;
A query expression that MAY be evaluated and that defines the query results that MAY be generated. Note that the query's FROM clause MAY reference any class, including those named by the QueryResultName of other QueryCondition instances associated to the same PolicyRule.
Required
boolean Trigger = false ;
If Trigger = true, and with the exception of any PolicyTimePeriodConditions, PolicyConditions of this Policy are not evaluated until this 'triggering' condition query is true. There MUST be no more than one QueryCondition with Trigger = true associated with a particular Policy.
Required
ModelCorrespondence { "CIM_QueryCondition.Query" , "CIM_MethodAction.Query" }
string QueryResultName ;
In the context of the associated PolicyRule, QueryResultName defines a unique alias for the query results that MAY be used in subsequent QueryConditions or MethodActions of the same PolicyRule. This string is treated as a class name, in a query statement.
ValueMap { "2" , "3" , ".." , "0x8000.." }
Values { "CQL" , "CQLT" , "DMTF Reserved" , "Vendor Reserved" }
Required
ModelCorrespondence { "CIM_QueryCondition.Query" }
uint16 QueryLanguage = 2 ;
The language in which the Query string is expressed./n CQL - refers to the 'DMTF:CQL' language defined by DSP0200.
CQL: indicates a CIM Query Language string.
CQLT: indicates a CIM Query Language Template string. When used, the identifiers recognized in the $identifier$ tokens are 'SELF' and the property names of this class, or one of its subclasses. When used in the Query string, $SELF$ will be replaced by a string corresponding to a WBEM URI referencing the instance of this class that contains the Query template string. Tokens of the form $<propertyname>$ will be replaced by a string representing the corresponding property value of the instance of this class that contains the Query string.
MaxLen ( 256 )
Key
string PolicyConditionName ;
A user-friendly name of this PolicyCondition.
MaxLen ( 256 )
Key
string SystemCreationClassName ;
The name of the class or the subclass used in the creation of the System object in whose scope this PolicyCondition is defined.

This property helps to identify the System object in whose scope this instance of PolicyCondition exists. For a rule-specific PolicyCondition, this is the System in whose context the PolicyRule is defined. For a reusable PolicyCondition, this is the instance of PolicyRepository (which is a subclass of System) that holds the Condition.

Note that this property, and the analogous property SystemName, do not represent propagated keys from an instance of the class System. Instead, they are properties defined in the context of this class, which repeat the values from the instance of System to which this PolicyCondition is related, either directly via the PolicyConditionInPolicyRepository association or indirectly via the PolicyConditionInPolicyRule aggregation.
MaxLen ( 256 )
Key
string PolicyRuleCreationClassName ;
For a rule-specific PolicyCondition, the CreationClassName of the PolicyRule object with which this Condition is associated. For a reusable Policy Condition, a special value, 'NO RULE', should be used to indicate that this Condition is reusable and not associated with a single PolicyRule.
MaxLen ( 256 )
Key
string SystemName ;
The name of the System object in whose scope this PolicyCondition is defined.

This property completes the identification of the System object in whose scope this instance of PolicyCondition exists. For a rule-specific PolicyCondition, this is the System in whose context the PolicyRule is defined. For a reusable PolicyCondition, this is the instance of PolicyRepository (which is a subclass of System) that holds the Condition.
MaxLen ( 256 )
Key
string CreationClassName ;
CreationClassName indicates the name of the class or the subclass used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.
MaxLen ( 256 )
Key
string PolicyRuleName ;
For a rule-specific PolicyCondition, the name of the PolicyRule object with which this Condition is associated. For a reusable PolicyCondition, a special value, 'NO RULE', should be used to indicate that this Condition is reusable and not associated with a single PolicyRule.
string PolicyKeywords [ ] ;
An array of keywords for characterizing / categorizing policy objects. Keywords are of one of two types:
- Keywords defined in this and other MOFs, or in DMTF white papers. These keywords provide a vendor- independent, installation-independent way of characterizing policy objects.
- Installation-dependent keywords for characterizing policy objects. Examples include 'Engineering', 'Billing', and 'Review in December 2000'.
This MOF defines the following keywords: 'UNKNOWN', 'CONFIGURATION', 'USAGE', 'SECURITY', 'SERVICE', 'MOTIVATIONAL', 'INSTALLATION', and 'EVENT'. These concepts are self-explanatory and are further discussed in the SLA/Policy White Paper. One additional keyword is defined: 'POLICY'. The role of this keyword is to identify policy-related instances that may not be otherwise identifiable, in some implementations. The keyword 'POLICY' is NOT mutually exclusive of the other keywords specified above.
string CommonName ;
A user-friendly name of this policy-related 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.
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.