Copyright: 1992-1997


WBEM SDK ActiveX Applications

[This is preliminary documentation and subject to change.]

The Web-Based Enterprise Management (WBEM) SDK ActiveX™ applications include:

•	WBEM Object Browser

The Object Browser is primarily used to view objects in a WBEM CIM Object Manager (CIMOM) database.

•	WBEM Developer Studio

The Developer Studio is used to view classes in a CIMOM database.


System Requirements for the ActiveX Applications

[This is preliminary documentation and subject to change.]

The system requirements for running the ActiveX™ applications are as follows:

•	Microsoft® Windows NT® version 4.0 or higher or Windows® 95. ActiveX components are not supported on Windows NT 3.51.

•	Internet Explorer version 3.01 or higher. Note that the original version of Windows 95 includes a version of Internet Explorer that is labeled 4.0 but is actually an older version. You must update Internet Explorer if you are still using this version. You can download the latest version of Internet Explorer from http://www.microsoft.com.

•	Screen resolution no less than 800x600.

•	VBScript version 2.0 must be installed on your machine. You can download VBScript from http://www.microsoft.com/vbscript.


Opening the ActiveX Applications

[This is preliminary documentation and subject to change.]

To open the ActiveX applications

1.	Click Start.

2.	Point to Programs, then click WBEM SDK.

3.	Click the application you want to open (WBEM Developer Studio or WBEM Object Browser). The WBEM Login dialog box appears:

See Logging into WBEM for instructions on entering login information.


Logging into WBEM

[This is preliminary documentation and subject to change.]

To log into WBEM

1.	Select the authentication method you want to use:

Current User

This method validates against the credentials of the currently logged-in user and does not require you to enter a user name or password. If no account has been defined in the WBEM Security database for the currently logged-in user, you will be logged on to the WBEM GUEST account.

WBEM

If you select WBEM, enter your WBEM User Name and Password. If no account has been defined for this user name and password in the WBEM Security database, you will be logged on to the WBEM GUEST account.

NTLM Domain

If you select NTLM Domain, enter the Windows® NT® domain name as well as your User Name and Password for that domain.

2.	Click OK.


WBEM Object Browser

[This is preliminary documentation and subject to change.]

The WBEM Object Browser is designed for use by system managers. The Object Browser displays the object tree in a CIMOM database, showing the relationships (associations) between the objects. You can browse the objects in the database by traversing these relationships in either tree or graphical formats. You can also use the Object Browser to edit property values, edit object and property qualifiers, and run operations on objects.


Object Browser User Interface

[This is preliminary documentation and subject to change.]

The WBEM Object Browser contains an Object Explorer  and an Object Viewer. In general, you select objects in the Object Explorer and their details appear in the Object Viewer.

The following screen shows the WBEM Object Browser.. Click the screen components to display information on the Object Browser user interface.


Object Browser Functions

[This is preliminary documentation and subject to change.]

Using the Object Browser, you can do the following:

•	Display the object tree contained in a specified CIMOM database

•	Reroot the object tree

•	Display properties, methods (operations), and associations for a selected object

•	Display custom views of object data

•	Display instances of grouped objects

•	Display property and object qualifiers

•	Run operations on a selected object  [not implemented in this release]

•	Edit property values and object and property qualifiers

Note  If an error occurs while you are editing object properties or qualifiers (for example, if you enter a property type and value that are incompatible), a message box appears with a brief description of the problem. Click the Advanced button to display the error object's properties which contain more details on the problem that occurred.


Displaying an Object Tree

[This is preliminary documentation and subject to change.]

By default, the Object Browser sets the namespace to root\DEFAULT, which is the default namespace on the local machine. You can view the object tree for any namespace in your system or on a network by specifying the namespace path in one of the following ways:

Specifying a Namespace in the Objects in Box

Selecting a Namespace From the History List

Browsing for a Namespace

Using the Go to Namespace Function

Note  While the Object Browser runs with any database, a database that has no associations shows only a single object, the root selected by the user. This type of database can be viewed more effectively in the WBEM Developer Studio.


Specifying a Namespace in the Objects in Box

[This is preliminary documentation and subject to change.]

The format for specifying a namespace in the Objects in box is as follows:

\\<machine>\root\<namespace>

For example, specifying \\EDKDOCS1\root\DEFAULT displays the object tree for the default namespace on the machine EDKDOCS1. If no machine is specified, the default is the local machine. You can also specify a chain of namespaces, separating each with a backslash:

\\<machine>\root\<namespace>\<namespace>\<namespace>


Selecting a Namespace From the History List

[This is preliminary documentation and subject to change.]

The Objects in box keeps a list of previously-selected namespaces. Click the down arrow to select a namespace from this history list.


Browsing for a Namespace

[This is preliminary documentation and subject to change.]

To browse for a namespace

1.	Click the Browse for Namespace button. The Browse for Namespace dialog box appears.

2.	By default, the Machine Name box shows the local machine. To select a namespace on another machine, type that machine name in the Machine Name box and press Enter.

—or—

Click Network Neighborhood, select the remote machine from the list that appears, then click OK.

The WBEM Login dialog box appears.

3.	Enter the appropriate login information (see Logging into WBEM for instructions) and click OK. This returns you to the Browse for Namespace dialog box.

4.	In the Browse for Namespace dialog box, click the plus sign next to the root folder to display the namespaces on the selected machine.

5.	Click the namespace you want to use, then click OK. This returns you to the Object Browser where the object tree for the selected namespace appears.


Using the Go to Namespace Function

[This is preliminary documentation and subject to change.]

The object tree can contain objects from other namespaces. If an object is from another namespace, the object's full path appears in the tree (including the machine name if it resides on a different machine). You can display the tree for that object's namespace using the Go to Namespace function.

To use the Go to Namespace function

1.	Right-click the object whose namespace you want to display.

2.	Select the Go to Namespace option. The object tree for the namespace appears rooted at the selected object.


Rerooting the Object Tree

[This is preliminary documentation and subject to change.]

When the Object Browser opens, it searches for an instance of the System class or any class derived from System. If found, this class becomes the root of the initial object tree. If no such class is found, the Object Browser displays a dialog box asking for a class name. Type a class name in the dialog box and click OK. The specified class becomes the root of the initial object tree.

Any regular object can be made the root of the object tree using one of the following methods:

Using Make Root to Reroot the Object Tree

Using Browse for Instance to Reroot the Object Tree


Using Make Root to Reroot the Object Tree

[This is preliminary documentation and subject to change.]

To change the object tree's root, right-click the object you want to be the new root, then select Make Root from the menu that appears. Note that because only regular objects can be the root, the Make Root option is not available if grouping nodes are selected.


Using Browse for Instance to Reroot the Object Tree

[This is preliminary documentation and subject to change.]

You can reroot the object tree from a specific instance using the Browse for Instance function. The Browse for Instance function allows you to display all objects in selected classes. You can then select the object you want to be the new root of the object tree.

To browse for an instance

1.	In the Object Explorer, click the Browse for Instance button. The Browse for Instance dialog box appears.

The Browse for Instance dialog box shows a list of classes in the current namespace. By default, all classes in the namespace are shown. You can display only those classes that can have instances by clicking this option below the list of classes.

2.	Select the classes whose objects you want to display. Click the class name in the Available Classes box, then click the Add button. Each class selected appears in the Browse for objects in box.

You can remove selected classes from the search by clicking the class name in the Browse for objects box, then clicking the Remove button.

3.	Click OK. The Browse for Objects Results dialog box appears which shows all objects in the selected classes.

4.	Click the object you want to be the root of the object tree, then click OK. This returns you to the Object Browser. The object tree appears with the selected object as the new root.


Displaying Properties of Regular Objects

[This is preliminary documentation and subject to change.]

To display properties of a regular object

1.	Select the object in the Object Explorer.

2.	Click the Properties tab in the Object Viewer.

The Properties page displays the properties for a selected regular object. Properties attached to an object by the system are preceded by a double underscore (for example, __SERVER). Nonsystem properties are either defined by the user or inherited from parent classes.

See Also

Displaying Properties of Association Objects


Displaying Custom Views of Object Data

[This is preliminary documentation and subject to change.]

Developers can create custom views of data and associate those views with specific objects. If a custom view is available for an object, the Views button becomes active when the object is selected.

To display a custom view

1.	Click Views. The Views window appears with a list of available views.

2.	Select the view you want from the list, then click OK.

To return to the Generic view, click Views and select Generic view from the list. Then click OK.

Sample custom view


Sample Custom View

[This is preliminary documentation and subject to change.]

The following sample custom view shows the amount of free space available on a system's disk drives. The WBEM SDK samples directory <drive>:\<Wbem-directory>\sdk\com\CustomViews contains files and instructions for creating this sample view.


Editing Object Properties

[This is preliminary documentation and subject to change.]

You can edit the Value field for most properties.

To edit a property value

1.	Display the Properties page for the object you want to change. For instructions, see Displaying Properties of Regular Objects or Displaying Properties of Association Objects.

2.	Click the property value you want to change.

3.	If a down arrow appears when you select the value, click the arrow and choose a value from the list that appears.

If no down arrow appears, type the new value in the field.

If the property type is an array, clicking the Array button in the Value field displays a dialog box in which you can enter each value in the array. When you have finished entering values, click OK to return to the Properties page.

If the property type is an object, the Value field contains either <empty> or an Object button. To change this field do one of the following:

•	Click the Object button to display the Embedded Object dialog box. You can edit properties and qualifiers from this box in the same way as in the Object Viewer Properties page. Click OK to return to the Object Viewer.

•	Right-click the Object button and select Set to <empty>.

•	Right-click the <empty> value and select Create object. This displays the Embedded Object dialog box. Enter the name of the class to which the object belongs. The Properties page for that class appears. You can edit properties and qualifiers in the same way as in the Object Viewer Properties page. Click OK to return to the Object Viewer.

4.	When you have finished editing, click Save. A confirmation message appears. Click Yes to save the changes.

Note  Some property values are read-only and cannot be edited.


Displaying Instances in the Object Browser

[This is preliminary documentation and subject to change.]

When you select a grouping node in the Object Explorer, the Object Viewer displays an instance table showing all objects in the namespace that belong to the selected group, as well as the common properties of those objects.


Displaying and Executing Object Methods

[This is preliminary documentation and subject to change.]

To display object methods

1.	Select the object in the Object Explorer.

2.	Click the Methods tab.

Execution of methods is not implemented in this release.


Displaying Object Associations

[This is preliminary documentation and subject to change.]

To display object associations

1.	Select the object in the Object Explorer.

2.	Click the Associations tab in the Object Viewer.

The Associations page graphically displays the objects associated with the current object. Right-clicking object icons in this page displays a menu with the following options:

Properties

Jumps to the Properties page for the selected object.

Make Root

Invokes the Make Root function.

Go to Namespace

Invokes the Go to Namespace function.

The following screen shows all objects associated with the computer system EDKDOCS1. Click the screen components to display additional information.


Displaying Properties of Association Objects

[This is preliminary documentation and subject to change.]

To display the properties of an association object

1.	In the Associations page, double-click the icon for the association object you want to display.

2.	Click the Properties tab. The property details for the selected association object appear.

You can also right-click an object in the Object Explorer, then select Association from the menu that appears. The Object Viewer displays the details of the association object that links the selected object to the object above it.

See Also

Displaying Properties of Regular Objects


Editing Properties of Association Objects

[This is preliminary documentation and subject to change.]

You can edit the property values of association objects in the same way as regular objects. For instructions, see Editing Object Properties.


Displaying Object Qualifiers

[This is preliminary documentation and subject to change.]

To display object qualifiers

1.	Select the object in the Object Explorer and click the Properties tab in the Object Viewer.

2.	Right-click in the Properties page of the Object Viewer.

3.	Select Object qualifiers from the menu that appears. The Qualifiers window appears.


Displaying Property Qualifiers

[This is preliminary documentation and subject to change.]

Property qualifiers can only be displayed for non-system properties.

To display property qualifiers

1.	Select the object in the Object Explorer and click the Properties tab in the Object Viewer.

2.	Double-click the property whose qualifiers you want to display.

—or—

Right-click the property whose qualifiers you want to display and select Property qualifiers from the menu that appears.

In both cases, the Qualifiers window appears. If the object has no property qualifiers, the window is blank.

Click OK or Cancel to close the Qualifiers window.


Editing Object and Property Qualifiers

[This is preliminary documentation and subject to change.]

To edit object and property qualifiers

1.	Select the object in the Object Explorer.

2.	Display the Qualifiers (object or property) window you want to edit.

3.	Click the field you want to change.

4.	If a down arrow appears when you select the field, click the arrow and choose a value from the list that appears.

If no down arrow appears, type the new value in the field.

Click the I, C, and O fields to select or cancel these settings.

The Origin field is read-only and indicates where the qualifier originated: local (for qualifiers defined in the current object) or propagated (for qualifiers propagated from another object).

5.	When you have finished editing, click OK. This closes the Qualifiers window.

6.	In the Object Viewer, click Save. A confirmation message appears. Click Yes to save the changes.


WBEM Developer Studio

[This is preliminary documentation and subject to change.]

The WBEM Developer Studio is designed primarily for use by developers, particularly those writing providers, and for advanced system managers. You can use Developer Studio to:

•	View classes in a CIMOM database.

•	Edit classes, properties, qualifiers, and instances.

•	Run operations on classes.

•	Generate and compile Managed Object Format (MOF) files.

•	Generate framework provider code in the Developer Studio.


Developer Studio User Interface

[This is preliminary documentation and subject to change.]

The Developer Studio contains a Class Explorer  and a Class Viewer. In general, you select classes in the Class Explorer and their details appear in the Class Viewer. The Developer Studio also provides wizards that generate and compile MOF files and generate framework provider C++ code.

The following sample shows a WBEM Developer Studio screen.. Click the screen components to display information about the Developer Studio user interface.


Developer Studio Functions

[This is preliminary documentation and subject to change.]

Using the Developer Studio, you can do the following:

•	Display the class inheritance tree (schema) in a specified CIMOM database

•	Search for a specific class

•	Display the definition of an existing class (properties, qualifiers, and methods )

•	Display instances of an existing class (standard or custom views)

•	Extend and modify the existing schema by adding or deleting class definitions

•	Modify a class by adding, editing, or deleting properties, qualifiers, and methods in a class definition

•	Add or delete instances of a class

•	Run the C++ code generator, MOF file generator, and MOF file compiler on selected classes and/or instances

Note  If an error occurs while you are editing class properties or qualifiers (for example, if you enter a property type and value that are incompatible), a message box appears with a brief description of the problem. Click the Advanced button to display the error object's properties which contain more details on the problem that occurred.


Displaying a Class Inheritance Tree

[This is preliminary documentation and subject to change.]

By default, the Developer Studio sets the namespace to root\DEFAULT, which is the default namespace on the local machine. You can view the class inheritance tree for any namespace in your system or on a network by specifying the namespace path in one of the following ways:

Specifying a Namespace in the Classes in Box

Selecting a Namespace from the History List

Browsing for a Namespace


Specifying a Namespace in the Classes in Box

[This is preliminary documentation and subject to change.]

The format for specifying a namespace in the Classes in box is as follows:

\\<machine>\root\<namespace>

For example, specifying \\EDKDOCS1\root\DEFAULT displays the class inheritance tree for the default namespace on the machine EDKDOCS1. If no machine is specified, the default is the local machine. You can also specify a chain of namespaces, separating each with a backslash:

\\<machine>\root\<namespace>\<namespace>\<namespace>


Selecting a Namespace from the History List

[This is preliminary documentation and subject to change.]

The Classes in box keeps a list of previously-selected namespaces. Click the down arrow to select a namespace from this history list.


Browsing for a Namespace

[This is preliminary documentation and subject to change.]

You can also browse for a namespace.

To browse for a namespace

1.	Click the Browse for Namespace button. The Browse for Namespace dialog box appears.

2.	By default, the Machine Name box shows the local machine. To select a namespace on another machine, type that machine name in the Machine Name box and press Enter.

—or—

Click Network Neighborhood, select the remote machine from the list that appears, then click OK.

The WBEM Login dialog box appears.

3.	Enter the appropriate login information (see Logging into WBEM for instructions) and click OK. This returns you to the Browse for Namespace dialog box.

4.	In the Browse for Namespace dialog box, click the plus sign next to the root folder to display the namespaces on the selected machine.

5.	Click the namespace you want to use, then click OK. This returns you to the Developer Studio where the class inheritance tree for the selected namespace appears.


Searching for a Class

[This is preliminary documentation and subject to change.]

To search for a specific class in the namespace

1.	In the Class Explorer, click the Search for Class button. The Search for Class dialog box appears.

2.	Enter the name of the class you want to find and click OK. If found, the class is selected in the Class Explorer and its details appear in the Class Viewer.


Displaying the Definition of an Existing Class

[This is preliminary documentation and subject to change.]

Within Developer Studio, you can display the properties, qualifiers, and methods of an existing class.

Displaying Class Properties

Displaying Class Qualifiers

Displaying Property Qualifiers

Displaying Class Methods


Displaying Class Properties

[This is preliminary documentation and subject to change.]

To display properties of a class

1.	Select the class in the Class Explorer.

2.	Click the Properties tab in the Class Viewer.

Properties attached to a class by the system are preceded by a double underscore (for example, __SERVER). Note that you cannot change or delete system properties; it is also recommended that you not create properties that begin with a double underscore. Nonsystem properties are either defined by the user or inherited from parent classes.


Displaying Class Qualifiers

[This is preliminary documentation and subject to change.]

To display class qualifiers

1.	Select the class in the Class Explorer and click the Properties tab in the Class Viewer.

2.	Right-click in the Properties page of the Class Viewer.

3.	Select Object qualifiers from the menu that appears. The Qualifiers window appears.


Displaying Property Qualifiers

[This is preliminary documentation and subject to change.]

Property qualifiers can only be displayed for non-system properties.

To display property qualifiers

1.	Select the class in the Class Explorer and click the Properties tab in the Class Viewer.

2.	Double-click the property whose qualifiers you want to display.

—or—

Right-click the property whose qualifiers you want to display and select Property qualifiers from the menu that appears.

In both cases, the Qualifiers window appears. If the class has no property qualifiers, the window is blank.

Click OK or Cancel to close the Qualifiers window.


Displaying Class Methods

[This is preliminary documentation and subject to change.]

To display class methods

1.	Select the object in the Class Explorer.

2.	Click the Methods tab.

Execution of methods is not implemented in this release.


Displaying Instances of an Existing Class

[This is preliminary documentation and subject to change.]

Within Developer Studio, you can display a table of all instances of a class. You can also define and display custom views of instances.

Displaying an Instance Table

Creating and Using Custom Views of Instances


Displaying an Instance Table

[This is preliminary documentation and subject to change.]

You can display an instance table for any class in the namespace. An instance table shows all instances of the selected class in the namespace, as well as their common properties.

To display the instance table

1.	Select a class in the Class Explorer.

2.	Click the Instances button in the Class Viewer. The instance table for the selected class appears. If there are no instances of a selected class, the table displays the message "No Instances Available".

To return to the class definition display, click the Instances button again.


Creating and Using Custom Views of Instances

[This is preliminary documentation and subject to change.]

To create a custom view of class instance data

1.	Write an ActiveX™ control that defines the format for the data display.

2.	Associate that view with the class definition using a new custom view instance.

After you create a custom view and associat it with a class instance, selecting that instance in the Class Viewer activates the Views button. Click Views and choose the view you want from the list that appears. Then click OK.

Sample custom view


Adding Class Definitions

[This is preliminary documentation and subject to change.]

To add a class

1.	In the Class Explorer, select the class that to be the parent of the new class.

2.	Click Add Class. The Add Class dialog box appears.

3.	Type the name of the new class in the New Class box, then click OK.

The Class Viewer displays the new class in the Properties page, showing all the parent class's properties that are inherited by the new class.

To add a class at the top level

1.	In the Class Explorer, click Add Class. The Add Class dialog box appears.

2.	Erase the parent class name in the Add Class dialog box, which must be blank..

3.	Type the name of the new class in the New Class box and click OK.

For information on adding properties to a new class, see Adding Class Properties.


Deleting Class Definitions

[This is preliminary documentation and subject to change.]

To delete a class

1.	In the Class Explorer, select the class you want to delete.

2.	Click Delete Class. The Delete Class Query box appears.

3.	Click Yes to delete the class.

When you delete a class, all of its child classes are also deleted.


Modifying Class Definitions

[This is preliminary documentation and subject to change.]

You can modify a class by adding, editing, or deleting properties, qualifiers, and methods in a class definition.

Adding Class Properties

Deleting Class Properties

Editing Class Properties

Adding Class or Property Qualifiers

Deleting Class or Property Qualifiers

Editing Class or Property Qualifiers

Modifying Class Methods


Adding Class Properties

[This is preliminary documentation and subject to change.]

To add a class property

1.	Select the class you want to change in the Class Explorer and click the Properties tab in the Class Viewer. The class's properties appear in the Properties page.

2.	Click the blank Name field at the bottom of the properties table. Type the new property name.

3.	Click the Type field, then click the down arrow and choose a property type from the list that appears. When you select the type, a default value may appear in the Value field.

4.	If you want a value other than the default in the Value field, click the field and enter the desired value. When you select this field and begin typing, a list box may appear from which you can choose the appropriate value.

If the property type is an array, clicking the Array button in the Value field displays a dialog box in which you can enter each value in the array. When you are done entering values, click OK to return to the Properties page.

To create an embedded object, do the following:

Select object as the property type. The Object Type dialog box appears.

a.	Optionally, enter the name of the class to which the embedded object belongs and click OK.

b.	By default, the Value field is set to <empty>. To change this value, right-click the field and select Create Object from the menu. The Embedded Object dialog box appears. If you selected a class in step b, this dialog box displays the Properties page for that class.

Otherwise, the display is blank. Enter the name of the class to which the embedded object belongs in the Class field to display that class' Properties page.

c.	Edit the properties and/or qualifiers for the embedded object if necessary, then click OK to return to the Class Viewer.

5.	Click Save. A confirmation message appears. Click Yes to save the new data.


Deleting Class Properties

[This is preliminary documentation and subject to change.]

To delete a class property

1.	Select the class in the Class Explorer and click the Properties tab in the Class Viewer.

2.	Click the blank box to the left of the property you want to delete. This selects the entire property entry.

3.	Press the Delete key. A confirmation message appears. Click OK to delete the property.

4.	Click Save. A confirmation message appears. Click Yes to confirm the deletion.


Editing Class Properties

[This is preliminary documentation and subject to change.]

To edit a property field

1.	Select the class in the Class Explorer and click the Properties tab in the Class Viewer.

2.	Click the field you want to change.

3.	If a down arrow appears when you select the field, click the arrow and choose a value from the list that appears.

If no down arrow appears, type the new value in the field.

If you edit a Value field that contains an array, a dialog box appears that shows each value in the array. Edit the values you want to change, then click OK to return to the Properties page.

If the property type is an object, the Value field contains either <empty> or an Object button. To change this field do one of the following:

•	Click the Object button to display the Embedded Object dialog box. You can edit properties and qualifiers from this box in the same way as in the Class Viewer Properties page. Click OK to return to the Class Viewer.

•	Right-click the Object button and select Set to <empty>.

•	Right-click the <empty> value and select Create object. This displays the Embedded Object dialog box. Enter the name of the class to which the object belongs. The Properties page for that class appears. You can edit properties and qualifiers in the same way as in the Class Viewer Properties page. Click OK to return to the Class Viewer.

4.	When you have finished editing, click Save. A confirmation message appears. Click Yes to save the changes.


Adding Class or Property Qualifiers

[This is preliminary documentation and subject to change.]

To add qualifiers to a class or property

1.	Display the Qualifiers window for the desired class or property. For instructions, see Displaying Class Qualifiers or Displaying Property Qualifiers.

2.	Click the blank Name field and enter the new qualifier name.

3.	Click the Type field, then click the down arrow and choose a type from the list that appears. When you select the type, a default value may appear in the Value field.

4.	Click the I, C, and O fields to select or cancel these settings.

The Origin field is read-only and indicates where the qualifier originated: local (for qualifiers defined in the current object) or propagated (for qualifiers propagated from another object).

5.	If you want a value other than the default in the Value field, click the field and enter the desired value. When you select this field and begin typing, a list box may appear from which you can choose the appropriate value.

6.	When you have finished editing, click OK to close the Qualifiers window.

7.	In the Class Viewer, click Save. A confirmation message appears. Click Yes to save the changes.


Deleting Class or Property Qualifiers

[This is preliminary documentation and subject to change.]

To delete qualifiers

1.	Display the Qualifiers window for the desired class or property. For instructions, see Displaying Class Qualifiers or Displaying Property Qualifiers.

2.	Click the blank box to the left of the qualifier you want to delete. This selects the entire qualifier entry.

3.	Press the Delete key. A confirmation message appears. Click OK to delete the qualifier.

4.	Click OK to close the Qualifiers window.

5.	In the Class Viewer, click Save. A confirmation message appears. Click Yes to confirm the deletion.


Editing Class or Property Qualifiers

[This is preliminary documentation and subject to change.]

To edit class or property qualifiers

1.	Display the Qualifiers (class or property) window you want to edit. For instructions, see Displaying Class Qualifiers or Displaying Property Qualifiers.

2.	Click the field you want to change.

3.	If a down arrow appears when you select the field, click the arrow and choose a value from the list that appears.

If no down arrow appears, type the new value in the field.

Click the I, C, and O fields to select or cancel these settings.

The Origin field is read-only and indicates where the qualifier originated: local (for qualifiers defined in the current object) or propagated (for qualifiers propagated from another object).

4.	When you have finished editing, click OK to close the Qualifiers window.

5.	In the Class Viewer, click Save. A confirmation message appears. Click Yes to save your changes.


Modifying Class Methods

[This is preliminary documentation and subject to change.]

[Not implemented in this release.]


Adding Instances of a Class

[This is preliminary documentation and subject to change.]

To add an instance of a class

1.	In the Class Explorer, select the class for which you want to create an instance.

2.	Click Create instance in the Class Viewer. The viewer displays data for the new instance and the Save button becomes active.

3.	Enter values for the key property fields. For information on editing properties, see Editing Class Properties.

4.	When you have finished editing the key fields, click Save.

Note  You cannot add instances of the following classes:

•	Classes that do not have key fields (abstract classes)

•	Classes that have dynamic instance providers


Deleting Instances of a Class

[This is preliminary documentation and subject to change.]

To delete an instance of a class

1.	Display the instance table for the desired class. For instructions, see Displaying an Instance Table.

2.	Click the blank box to the left of the instance you want to delete. This selects the entire instance entry.

3.	Click Delete instance in the Class Viewer. A confirmation message appears. Click OK to delete the instance.


MOF Generator Wizard

[This is preliminary documentation and subject to change.]

The MOF Generator Wizard generates a MOF file for class definitions and/or instances from an existing database. Typically, you run this wizard when you have created a new class or when you want to port existing database information to another machine.

To run the MOF Generator Wizard

1.	In the Class Explorer, click the check boxes to select the any class you want to insert in the MOF file.

2.	Double-click the MOF Generator Wizard icon. A welcome screen appears.

3.	Click Next. The next screen shows each class you selected in step 1. For each class, do the following:

a.	Select the class name from the list under Classes to generate code for. The instances of that class, if any, appear in the right pane.

b.	Select whether you want the class definition in the MOF file by clicking the check box next to Include class definition.

c.	Click the check boxes to select the instances to be included in the MOF file.

4.	Click Next. In the next screen, enter the MOF File Name and the directory where it is to reside, or use the Browse button to select a directory.

5.	Click Finish. A message box appears notifying you that the MOF file has been generated. Click OK to dismiss the message and close the wizard.


MOF Compiler Wizard

[This is preliminary documentation and subject to change.]

The MOF Compiler Wizard compiles a MOF file into a database, importing any class definitions or instances from the MOF file into the current database You can also use this wizard to check the syntax of a MOF file.

Compiling a MOF File

Checking the Syntax of a MOF File


Compiling a MOF File

[This is preliminary documentation and subject to change.]

To compile a MOF file

1.	Double-click the MOF Compiler Wizard icon. A welcome screen appears. Select Compile a .MOF file.

2.	Click Next. In the next screen, type the path and file name for the MOF file you want to compile (or use the Browse button to select the file) and the namespace where you want the MOF file to be loaded.

3.	Click Next. In the next screen, select or cancel the selection of the appropriate compiler options. You can choose to modify classes and instances that are already in the namespace or to add new classes and instances to the namespace.

4.	Click Finish to compile the file. The WBEM Login dialog box appears.

Enter the appropriate login information (see Logging into WBEM for instructions) and click OK. A message box appears notifying you of successful compilation. Click OK to dismiss the message. The resulting database file is created in the same directory as the MOF file.


Checking the Syntax of a MOF File

[This is preliminary documentation and subject to change.]

To check the syntax of a MOF file

1.	Double-click the MOF Compiler Wizard icon. A welcome screen appears. Select Check the syntax of a .MOF file.

2.	Click Next. In the next screen, type the path and file name for the MOF file you want to check, or use the Browse button to select the file.

3.	Click Finish. The wizard checks the file's syntax and reports the results in a message box. Click OK to dismiss the message.


C++ Code Generator Wizard

[This is preliminary documentation and subject to change.]

The C++ Code Generator Wizard generates framework provider code for classes defined in the database. This is an initial step in the process of writing a provider that provides dynamic instances for a particular class of objects.

To run the C++ Code Generator Wizard

1.	In the Class Explorer, click the check boxes to select any classes for which you want to generate code.

2.	Double-click the Provider C++ Wizard icon. A welcome screen appears.

3.	Click Next. The next screen shows each class you selected in step 1. For each class, do the following:

a.	Select the class name from the list under Classes to generate code for.

b.	Enter a Base File Name, C++ Class Name, and Description for the class.

c.	Select whether you want to override any inherited properties for the class. If you select Override Inherited Properties, a list of properties appears. Click the check boxes to select the properties to override.

If you are writing a provider for a class that is derived from an abstract class or if the parent class does not have a provider, you typically need to provide all the class properties. In this case, select Override Inherited Properties, then select all the properties that appear.

If your class is derived from a class that already has a provider, you only need to provide the properties the derived class defines. You do not need to override inherited properties in this case.

4.	Click Next. In the next screen, enter the Provider Name, Provider Description, and the directory where you want the generated files to reside. You can use the Browse button to select the directory.

5.	Click Finish. A message box appears notifying you that the files have been generated. Click OK to dismiss the message box and close the wizard.

The wizard generates the following files: .CPP and .H files for each class created, .DEF and .ODL files for the provider, and Olesrvr.cpp. For instructions on turning these files into a functioning provider, see "Creating a Provider" in the WBEM SDK help file.


Objects in box

[This is preliminary documentation and subject to change.]

Displays the current namespace. Click the Down Arrow button to select a namespace from the history list. See Displaying an Object Tree.


Browse for Namespace button

[This is preliminary documentation and subject to change.]

 Click this button to browse and select namespaces on the local machine or a remote machine. See Browsing for a Namespace.


Browse for Instance button

[This is preliminary documentation and subject to change.]

 Click this button to browse classes for a specific instance and reroot the Object Explorer tree from that instance. See Using Browse for Instance to Reroot the Object Tree.


Object Explorer frame

[This is preliminary documentation and subject to change.]

The left frame in the WBEM Object Browser is the Object Explorer, which shows the object tree contained in the current namespace.

Clicking the plus and minus boxes expands and contracts the tree display. The tree shows regular objects and grouping nodes. Grouping nodes are not objects themselves but are a way to organize objects. The icons next to the names indicate the type of object or node:

	Regular object
	Node that groups objects by type.
	Node that groups objects by association type and role. All objects beneath such a node are associated to the parent object through the same association type and role.
Some of these icons are also used in the Object Viewer frame.

Hovering over an object in the tree displays the object's path, which identifies the object in the namespace. You can also change the root of the object tree. For instructions, see Rerooting the Object Tree.


Selected object

[This is preliminary documentation and subject to change.]

This area displays the name of the selected object.


Forward and Back buttons

[This is preliminary documentation and subject to change.]

 Click these buttons to display previously-viewed pages.


Save button

[This is preliminary documentation and subject to change.]

 Commits changed information to CIMOM.


Views button

[This is preliminary documentation and subject to change.]

 Switches to custom views of object data. For more information, see Displaying Custom Views of Object Data.


Object Viewer frame

[This is preliminary documentation and subject to change.]

The right frame in the WBEM Object Browser is the Object Viewer, which displays details on a selected object. Using the tabs, you can display the properties, methods, and associations for an object. For additional information on each of these views, see Object Browser Functions. Selecting a regular object in the Object Explorer automatically updates the Object Viewer to show details on that object. Selecting a grouping node updates the Object Viewer to show an instance table for that node.

The Object Viewer uses an additional icon to identify association objects ( [image] ) on the Associations page.


Properties tab

[This is preliminary documentation and subject to change.]

Displays properties of the current object.


Methods tab

[This is preliminary documentation and subject to change.]

Displays methods of the current object.


Associations tab

[This is preliminary documentation and subject to change.]

Displays associations of the current object.


Help button

[This is preliminary documentation and subject to change.]

 Double-click this button to display online Help for the WBEM ActiveX applications.


Current object

[This is preliminary documentation and subject to change.]

The left-most icon represents the current object.


Branches

[This is preliminary documentation and subject to change.]

Each branch from the current object represents an association of that object to another object.


Association object

[This is preliminary documentation and subject to change.]

 This icon represents the association object. Hovering over the association object icon displays the association type. Hovering over the connecting lines on each side of the association object icon displays the roles of the related objects.

You can jump to an association object by double-clicking its icon. This also updates the Properties and Methods pages to show information for the newly-selected association object.


Objects associated to the current object

[This is preliminary documentation and subject to change.]

The right-most icons represent the objects associated with the current object. You can jump to another regular object by double-clicking its icon. This also updates the Properties and Methods pages to show information for the newly-selected object.


Classes in box

[This is preliminary documentation and subject to change.]

Displays the current namespace. Click the Down Arrow button to select a namespace from the history list. See Displaying a Class Inheritance Tree.


Class Explorer frame

[This is preliminary documentation and subject to change.]

The left frame in the WBEM Developer Studio is the Class Explorer, which shows the selected namespace and the schema defined for that namespace as a class inheritance tree. Clicking the plus and minus boxes expands and contracts the tree display. The shaded icons next to the class names indicate the type of objects defined by the class:

	Class that defines regular objects
	Class that defines association objects
The check boxes are used to select and cancel the selection of classes for the wizard operations performed in the Developer Studio. You can also select or clear all check boxes by right-clicking anywhere in the Class Explorer and choosing Select all or Unselect all from the menu that appears.

For non-wizard operations, select classes by clicking the class name in the Class Explorer.


Browse for Namespace button

[This is preliminary documentation and subject to change.]

 Click this button to browse and select namespaces on the local machine or a remote machine. See Browsing for a Namespace.


Search for Class button

[This is preliminary documentation and subject to change.]

 Click this button to search for a specific class in the namespace. See Searching for a Class.


Add Class button

[This is preliminary documentation and subject to change.]

 Adds a new class to the current database. See Adding Class Definitions.


Delete Class button

[This is preliminary documentation and subject to change.]

 Deletes a selected class from the current database. See Deleting Class Definitions.


Class Viewer frame

[This is preliminary documentation and subject to change.]

The right frame in the WBEM Developer Studio is the Class Viewer, which displays details on a selected class. Using the tabs, you can display the properties and methods defined for a class. For additional information on these views, see Displaying the Definition of an Existing Class. Selecting a class in the Class Explorer automatically updates the Class Viewer display.


Instances button

[This is preliminary documentation and subject to change.]

 Displays a table of all instances of a selected class. See Displaying an Instance Table.


Create Instance button

[This is preliminary documentation and subject to change.]

 Creates a new instance of a selected class. See Adding Instances of a Class.


Delete Instance button

[This is preliminary documentation and subject to change.]

 Deletes the selected instance. See Deleting Instances of a Class.


MOF Generator Wizard

[This is preliminary documentation and subject to change.]

 Inserts selected class definitions and/or instances from the database into a text file in the MOF syntax. See MOF Generator Wizard.


MOF Compiler Wizard

[This is preliminary documentation and subject to change.]

 Imports class definitions and/or instances described in a MOF file into the current database. See MOF Compiler Wizard.


C++ Code Generator Wizard

[This is preliminary documentation and subject to change.]

 Generates framework provider C++ code for a selected class. See C++ Code Generator Wizard.