This documentation supports the 19.08 version of BMC CMDB.

To view an earlier version, select the version from the Product version menu.

Qualification conventions for reconciliation activities

The easiest way to build a qualification is to select the fields, keywords, and values from the Qualification Builder. 

Note

The qualification sets always apply to source datasets only and never to a destination or master dataset. For example, it is not possible to limit the number of CIs for a match from the master dataset in an identification activity.

You can also create the qualification manually. If you select the manual option, observe the following conventions.

  • The dollar sign ($) indicates the value of the attribute of a CI.
  • The single quotation mark (') indicates the column or the actual attribute name.
  • Enclose nonnumeric values (including time, selection, and currency values) in double quotation marks. 
    Example: 'VirtualSystemType' = "VMWare"
    In the current (source) dataset, this qualification finds all instances of BMC_ComputerSystem where the VirtualSystemType attribute has a value of VMWare.
  • For currency fields, enclose one of the following items in single quotation marks:
    • The name or ID of the currency field. 
      Example: 'Currency Field' = $NULL$
    • The name of the currency field, followed by a period, followed by a specific portion of the currency field's value. 
      Example: 'Currency Field.VALUE' < 5000
  • Use keywords anywhere that you can enter character values. The most commonly used keywords are $DATE$$NULL$$TIME$$TIMESTAMP$$USER$, and $WEEKDAY$.

    Note

    Keywords are case sensitive. Use only UPPERCASE characters.

  • Use $attribute_name$ when the Verify in Target Dataset option is not used. It is an in-memory operation and provides quicker response.

  • The ‘attribute_name’ is used in a purge activity when the Verify in Target Dataset option is used because the query needs to explicitly check the “values” in the database. Using $attribute_name$ here is a time consuming operation and is not recommended.

  • To restrict a reconciliation activity to a particular CI class, you must include the following qualification rules:

    NamespaceClassQualification
    If the class is a CI
    BMC.COREBMC_BaseElement
    $ClassId$ = "<CLASSNAME>"
    If the class is a relationship
    BMC.COREBMC_BaseRelationship
    $ClassId$   = "<CLASSNAME>"

    <CLASSNAME> is the class to which you want to restrict the reconciliation activity.

  • After creating a qualification for a field in a given class, the CIs are restricted within that class and all other classes are merged indiscriminately. For example, the following qualification restricts only CIs with the BMC_ComputerSystems class. All other classes are processed as a normal reconciliation job.

    NamespaceClassQualification
    BMC.COREBMC_ComputerSystems$EnvironmentSpecification$ = "ASTAttribute"
Was this page helpful? Yes No Submitting... Thank you

Comments