IBM Tivoli Software IBM Tivoli Software

[ Bottom of Page | Previous Page | Next Page | Contents | Index ]


Editing CIM classes

Objective

To edit or add the resources you want to monitor and collect the data.

Background information

The class list shows the available classes. When you select a class, all properties corresponding to the selected class are listed in the Class Properties table.

The CIM repository of WMI stores the available CIM classes. WMI providers provide class instances. If the resource you want to monitor is not described by any class in the CIM repository, you can add a new class.

For example, if you are creating a resource model to use on a UNIX-based operating system, you need to add this CIM class to the CIM repository of WMI. You do not need a WMI data provider for this class. It exists in the CIM repository to be available only when you work with the IBM Tivoli Monitoring Resource Model Builder.

To add a new class to the CIM repository, you must write a Managed Object Format (MOF) text file that defines the class and the provider. For Windows systems, you can use either a native WMI provider or a Java provider. For non-Windows systems, you must use a Java provider.

To run the resource model on an endpoint, you must transfer the MOF file and the provider (DLL file for a WMI provider, or a Jar for a Java provider) to the endpoint. Do this by adding a dependency to the resource model.

If you run a collection test at this point, the resource model collects data about all the properties of the selected class. However, if you are using a CIM class that does not have either a WMI provider or Java provider for Windows available through WMI, you cannot perform a collection test.

Before you begin

None

When you finish

Check the Tasks view to verify that you do not have any errors in your resource model. If the Tasks view displays errors, correct the errors before running the resource model. The Tasks view displays in the bottom pane of the IBM Tivoli Monitoring Resource Model Builder.

Procedure

  1. Open the resource model.
  2. Click the CIM Classes page.
  3. Work with an existing class, add a new class, or launch the WMI MOF Compiler Wizard.

    Additional Information: The following editing options are available:

    Add CIM data source
    Opens the Add new CIM data source window, in which you can do the following:
    • Search for specific classes from the class list by doing the following:
      1. Click the binocular icon to open the WMI Class Search window.
      2. Enter a search phrase and search options.
      3. Click Search to display the search results on the bottom of the window.
      4. Select a class and click OK.
    • Add a class by doing the following:
      1. Click the plus-sign icon to open the Add Class window.
      2. Enter a name for the Superclass and the New class name.
      3. Click OK to add the new class to the class list.
    • Delete a class by doing the following:
      1. Select a class to delete to highlight the class.
      2. Click the minus-sign icon to delete the class.
      3. Click OK to confirm the deletion.
    • Perform a collection test by doing the following:

      For Windows resource models only: Click Collection Test to see an example of the collected instances of the class defined. If you are performing an asynchronous collection, data collection starts when you click Collection Test. A pop-up window opens enabling you to click OK to stop the data collection. In this way, you are simulating a cycle time interval. The Collected Instances window opens and shows the results of data collection.

    • Click Show Description to display information about the properties of the selected class included with the CIM class provider.
    • Click MOF Compiler to launch the WMI MOF Compiler Wizard and import MOF files into the WMI repository.
    MOF Wizard
    Launches the WMI MOF Compiler Wizard so you can import MOF files into the WMI repository. After compiling a MOF file from this page, you must reconnect to your CIM repository for it to open in the CIM/WMI navigator.
    Selected
    The class name and full path.
    Use Alias
    The name used in the decision tree script. If you do not assign an alias, the decision tree calls the class name and path displayed in the Selected field. Use a simple, but meaningful alias.
    Class properties
    The properties for the class. Select the properties you want to list from the Available table and move them to the Selected table by clicking the right-arrow icon. Move properties from the Selected table to the Available table by clicking the right-arrow icon. You cannot remove key properties from the Selected table.
    Collection Information
    The sort option for the collected data. The sort options are:
    • No Sort

      Implies no sequence order. Type the number of cycles you want to elapse between two successive data collections in the Every text box.

      • Every = 0, runs the collection one time
      • Every = 1, runs the collection at every cycle
      • Every = n, runs the collection at every "n" cycles
      • Every = -1, runs the collection based on the monitoring algorithm of the Visit Tree section of the Decision Tree Script. This value is set automatically when you select the Collect on demand check box.
    • Sort Ascending

      Sorts from the lowest value to the highest. Type the key element for the sort in the Sorting Field text box. For Windows resource models, type the number of instances in your data collection in the Number of Instances text box. Type the number of cycles you want to elapse between two successive data collections In the Every text box.

      • Every = 0, runs the collection one time
      • Every = 1, runs the collection at every cycle
      • Every = n, runs the collection at every "n" cycles
      • Every = -1, runs the collection based on the monitoring algorithm of the Visit Tree section of the Decision Tree Script. This value is set automatically when you select the Collect on demand check box.
    • Sort Descending

      Sorts from the highest value to the lowest on the basis of the sorting key element you choose. Type the key element for the sort in the Sorting Field text box.

      For Windows resource models only, type the number of instances that you want in your data collection in the Number of Instances text box. Type the number of cycles you want to elapse between two successive data collections in the Every text box.

      • Every = 0, runs the collection one time
      • Every = 1, runs the collection at every cycle
      • Every = n, runs the collection at every "n" cycles
      • Every = -1, runs the collection based on the monitoring algorithm of the Visit Tree section of the Decision Tree Script. This value is set automatically when you select the Collect on demand check box.
    • Asynchronous
      Note:
      Asynchronous collection can be selected only for those classes whose providers support __InstanceOperationEvent. For more information, see the WMI Web site.

      For Windows resource models only: Starts data collection at a cycle and carries it until the following cycle, when the collection is made available. Specify the following information that you want to obtain:

      • Instance creation
      • Instance modification
      • Instance deletion
    WHERE Clause
    For Windows resource models only: A WQL where statement (query) to define filtering criteria for data collection, if required.
    Note:
    When entering a clause manually, the clause must begin with "where."
  4. Save the changes and close the resource model or go to another editing page.

[ Top of Page | Previous Page | Next Page | Contents | Index ]