CimIQL operation tokens

The CimIQL probe requires operation tokens.

Each of the following core operations has a counterpart in the CIM Operations over HTTP standard.

Table 1. CimIQL Operation Token Summary
Return Value Details Equivalent CIM Operation over HTTP
class object
Get Object
  • Retrieves a single object of a specific class by specifying all of its unique keys (as key tokens) and any optional parameter tokens, separated by commas.
GetInstance
class object
Enumerate Objects
EnumerateInstances
class object
Enumerate Associated Objects
  • Retrieves objects associated with each result from the preceding query.
Associators
statement results
Substitution
  • A no-op token that feeds the results of a previous named statement as input into the next query of its own statement.
Reference the results of a named statement

Get Object Token

<classname>{<key token>,<parameter token>,...}
  • Retrieves a single object of a specific class by specifying all of its unique keys (as key tokenskey tokens) and any optional parameter tokens, separated by commas. This token is also known as the .
  • The <classname> is the case-sensitive CIM class name of the desired object. By default, objects of the specified class and of any extended classes are retrieved.
  • The key and parameter tokens are enclosed by a single pair of curly brackets { ... }.
  • This token must only be used as the first query in a statement.
  • Returns: class object
  • Example:
    CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.*

Enumerate Objects Token

<classname>{{<condition token>,<parameter token>,...}}<array index token> OR <classname><array index token>
  • Retrieves objects that match a set of condition tokens and parameter tokens. This token is also known as the .
  • The condition tokens and parameter tokens are enclosed by two pairs of curly brackets {{ ... }}. The curly brackets are optional if there are no conditions or parameters necessary.
  • The <classname> is the case-sensitive CIM class name of the desired objects. By default, objects of the specified class and of any extended classes are retrieved.
  • The index token is optional.
  • This token must only be used as the first query in a statement.
  • Returns: class object
  • Example:
    CIM_ComputerSystem{{Name!='runtime'}}.*

Enumerate Associated Objects Token

<association classname>{{<property filter token>,<parameter token>,...}}<array index token> OR <association classname><array index token>
  • Retrieves objects associated with each result from the preceding query.
  • The condition tokens and parameter tokens are enclosed by two pairs of curly brackets {{ ... }}. The curly brackets are optional if there are no properties filters or parameters necessary.
  • The <association classname> is the name of the many-to-many or one-to-many class that associates two objects together. By default, objects of the specified class and of any extended classes are retrieved.
  • The <parameter token>, ResultClass, may be specified to filter results based on the resulting object's classname.
  • The index token is optional.
  • This token must not be used as the first query in a statement.
  • Returns: class object
  • Example:
    CIM_ComputerSystem{{Name='runtime'}}[2].*

Substitution Token

${<statement name>}
  • A no-op token that feeds the results of a previous named statement as input into the next query of its own statement.
  • Returns: void
  • Example:
    $(lastComputer).ElementName