Reference: CIM WorkShop Window and Dialogs

The following section provides descriptions of the frames, toolbar icons, and fields that comprise the CIM WorkShop window. It also describes CIM WorkShop dialogs.

The CIM WorkShop Window

The CIM WorkShop window is divided into two main frames. In the left frame, you can view the class inheritance tree of the current host. In the right frame, you can view the properties and methods of a selected class.

Figure 4-2 The CIM WorkShop Window

Table 4-1 Frames of the CIM WorkShop Window

Frame	Description
Left frame	Displays classes and instances contained in the namespace of the current host. The left frame in the CIM WorkShop shows the contents of the selected namespace. The classes that belong to the namespace are displayed hierarchically. This organization of classes is known as a class inheritance tree. Classes that contain subclasses are represented as a key icon and a folder. Clicking the key or double-clicking the folder causes the list of subclasses to display. Classes that do not contain subclasses are represented by page icons.
Right frame	Provides a Properties tab and a Methods tab from which you can view the values of properties and methods of a class. You can view attributes and values of qualifiers and flavors by right-clicking on a property or method.
Toolbar	Provides icons that enable you to change hosts, change location to a namespace within the default namespace /root/cimv2, find a class in the class inheritance tree, create a subclass, and show instances and qualifiers of a selected class.
Title bar	Posts the title of the CIM WorkShop window

CIM WorkShop Toolbar Icons

The icons provided in the CIM WorkShop toolbar enable you to display and change namespaces and search for classes and instances.

Figure 4-3 The CIM WorkShop Toolbar

Table 4-2 Icons of the CIM WorkShop Toolbar

Icon	Description
Change Hosts	Enables you to connect to a different host or name space and to log in with a different user name and password.
Change Namespace	Causes the Change Name Space dialog box to display in which you can select another name space to view.
Find Class	Enables you to search for a specific class in the name space.
New Class	Causes the New Class dialog box to display in which you can create a new subclass of a selected class.
Show Instances	Causes the Show Instances dialog box to display in which you can view instances of a selected class.
Show Qualifiers	Causes the Qualifiers dialog box to display in which you can view the qualifiers of a selected class.
Refresh Selected Class	Resets the display of the class hierarchy tree. Open class folders are closed and the tree is returned to the state it was in when it was first displayed.

The Properties Tab

The Properties tab shows information about a selected property. An icon resembling a folder with an arrow indicates that the property is inherited from a superclass. An icon resembling a gold key indicates that the property is a Key. Key properties provide unique identifiers for an instance of the domain class. The unique instance is indicated by a key qualifier.

In the Properties tab, the Name and Type of the property are displayed. You can change the value of a property when you create a new class of the domain class.

The Methods Tab

By selecting the Methods tab, you can view all methods of the class. Methods are listed consecutively. Reading horizontally from left to right, the following attributes are displayed for each method:

Table 4-3 Method Tab Attributes

Method Attribute	Description	Example
Name	Name specified for the method	GetDateTime
Value	Value specified for the method, for example,	null
Type	Type of method	string
Qualifier flavor	Flavor of qualifier assigned to the method	TRANSLATABLE
Description	String that returns the current system date and time in CIM date-time format	19990519142015.0000000-300

CIM WorkShop Menus

The following table describes the CIM WorkShop menus and menu items.

Table 4-4 CIM WorkShop Menus and Menu Items

Menu	Menu Item	Description
Workshop	Change Host	Causes the Show Instances dialog box to display, in which you can view all instances of a selected class.
	Change Namespace	Causes the Change Namespace dialog box to display, in which you can change location to a namespace in the default /root/cimv2 namespace.
	Exit	Enables you to exit CIM Workshop.
Action	Add Class	Causes the New Class dialog box to display in which you can create a subclass for a selected class.
	Delete Class	Deletes a selected class.
	Find Class	Enables you to specify a class to find in the class inheritance tree.
	Instances	Causes the Instances dialog box to display for the selected class. In this dialog box, you can view all instances of the class, add new instances, and delete instances.
	Qualifiers	Causes the Qualifiers dialog box to display. In this dialog box, you can view qualifier values, scope, and flavor of a selected class.
	Refresh	Causes the latest changes to be retrieved from the CIM Object Manager and displayed in CIM WorkShop for a selected class or namespace.

Login Dialog Box

The login dialog box is displayed when you first encounter CIM WorkShop. In the login dialog box, you specify the following:

• Host on which the CIM Object Manager is running and which contains the namespace you want to use

• Namespace in which you want to work

• Your user name

• Your password

If you do not specify a user name and password, you log in to CIM WorkShop as a guest. Guest privileges are read-only.

New Class Dialog Box

In the New Class dialog box, you can create a new class.

Figure 4-4 The New Class Dialog Box

Add Properties Dialog Box

In the Add Properties dialog box, you can add new properties to a class as you create it. In the Name field, you specify the name of the property. In the type field, select a type and click OK.

Qualifiers Dialog Box

In the Qualifiers dialog box, you can view qualifiers for a selected class, property, or method. When you create a new class, you can add qualifiers to the class or modify qualifiers of the class, its properties, or its methods in the Qualifiers dialog box. The title bar of the Qualifiers dialog box indicates the name of the class for which you view qualifiers or the class for which you add or modify qualifiers.

The following table describes the fields of the Qualifiers dialog box.

Table 4-5 Qualifiers Dialog Box Fields

Name of Field	Description	Example
Name	Shows the name of the qualifier	Provider
Type	Shows the type of value that the qualifier provides	STRING
Value	Shows the value of the qualifier	Solaris

The following table describes the buttons of the Qualifiers dialog box.

Table 4-6 Qualifiers Dialog Box Buttons

Name of Button	Description
Scope	Causes the Scope dialog box to display, in which you can view the scope of a selected qualifier
Flavors	Causes the Flavors dialog box to display, in which you can view the flavor of a selected qualifier
Add Qualifier	Causes the Add Qualifier dialog box to display, in which you can select a qualifier to add for a new subclass, property, or method
Delete Qualifier	Causes a selected qualifier to be deleted from the Qualifiers dialog box

Scope Dialog Box

In the Scope dialog box, you can view the scope of a qualifier that modifies an existing class, property, or method. You can also change the scope of a qualifier that you create for a new class or for a property or method added to a new class. The Scope field lists all possible scopes you can select.

Flavors Dialog Box

In the Flavors dialog box, you can view the flavor of a qualifier. You can also change the flavor of a qualifier that you create for a new class or for a property or method added to a new class. The Flavors field lists all possible flavors you can select.

Value Type Dialog Boxes

When you create new properties for a class, you can use any of the dialog boxes that CIM WorkShop provides for specifying properties of a particular type. These dialog boxes are configured to accept only a value of the appropriate type. The dialog boxes include the following:

• Real Integer dialog box

• Signed Integer dialog box

• Unsigned Integer dialog box

• String dialog box

• Array dialog box

• Boolean dialog box

Real Integer Dialog Box

The Values field of this dialog box accepts only a real integer. A real integer can be a negative or positive number including a decimal point. When you create a property that is of the type Real Integer, type a real integer in the Values field of this dialog box.

Signed Integer Dialog Box

The Values field of this dialog box accepts only a signed integer of a specified size. A signed integer can be a negative or positive whole number. CIM properties that have values which are signed integers can be 8 bits, 16 bits, 32 bits, or 64 bits in size. Depending on the size of the signed integer that makes up the value of the property, type the following in the Values field of this dialog box:

• For a property that is an 8-bit signed integer, type a positive or negative numeric value equivalent to 8 bits.

• For a property that is a 16-bit signed integer, type a positive or negative numeric value equivalent to 16 bits.

• For a property that is a 32-bit signed integer, type a positive or negative numeric value equivalent to 32 bits.

• For a property that is a 64-bit signed integer, type a positive or negative numeric value equivalent to 64 bits.

Unsigned Integer Dialog Box

The Values field of this dialog box accepts only an unsigned integer of a specified size. An unsigned integer can be only a positive whole number. CIM properties that have values which are unsigned integers can be 8 bits, 16 bits, 32 bits, or 64 bits in size. Depending on the size of the unsigned integer that makes up the value of the property, type the following in the Values field of this dialog box:

• For a property that is an 8-bit unsigned integer, type a positive numeric value equivalent to 8 bits.

• For a property that is a 16-bit unsigned integer, type a positive numeric value equivalent to 16 bits.

• For a property that is a 32-bit unsigned integer, type a positive numeric value equivalent to 32 bits.

• For a property that is a 64-bit unsigned integer, type a positive numeric value equivalent to 64 bits.

String Dialog Box

The Values field of this dialog box accepts only alphabetic and numeric characters. When you specify the value of a property that is a character string, you must enter a character string, such as Processor_Type, in the Values field of this dialog box. Character strings may not contain integers.

Array Dialog Boxes

In the Array dialog boxes, you can specify an array as a value for a property. The following array dialog boxes are available to return arrays:

• 8-Bit Unsigned Integer Array Dialog Box - returns a collection of positive integers equivalent to 8 bits in size

• 16-Bit Unsigned Integer Array Dialog Box - returns a collection of positive integers equivalent to 16 bits in size

• 32-Bit Unsigned Integer Array Dialog Box - returns a collection of positive integers equivalent to 32 bits in size

• 64-Bit Unisgned Integer Array Dialog Box - returns a collection of positive integers equivalent to 64 bits in size

• 8-Bit Signed Integer Array Dialog Box - returns a collection of positive or negative integers equivalent to 8 bits in size

• 16-Bit Signed Integer Array Dialog Box - returns a collection of positive or negative integers equivalent to 16 bits in size

• 32-Bit Signed Integer Array Dialog Box - returns a collection of positive or negative integers equivalent to 32 bits in size

• 64-Bit Signed Integer Array Dialog Box - returns a collection of positive or negative integers equivalent to 64 bits in size

• String Array Dialog Box - returns a collection of alphabetic and numeric character strings

• Boolean Array Dialog Box - returns a collection of Boolean expressions, True or False

• 32-Bit Real Array Dialog Box - returns a collection of positive or negative real numbers, with or without a decimal point, equivalent to 32 bits in size

• 64-Bit Real Array Dialog Box - returns a collection of positive or negative real numbers, with or without a decimal point, equivalent to 64 bits in size

• 16-Bit Character Array Dialog Box - returns a collection of alphabetic and numeric character strings equivalent to 16 bits in size

• Date/Time Array Dialog Box - returns a collection of dates in the format mm-dd-yy and times in the format hh:mm:ss

Boolean Dialog Box

In the Boolean dialog box, you can specify True or False as the value of a selected property.

Instance Window

The Instance window lists all instances for a selected class. You can also view the properties, methods, and qualifiers associated with each instance.

You display the Instance window by:

• Selecting a class in the CIM WorkShop window and clicking Action->Instances

• Right-clicking a class in the CIM WorkShop window and clicking Instances in the pop-up menu

Frames of the Instances Window

If the selected class has instances, the instances are listed in the left frame of the Instances window. Each instance is displayed with its Name, CreationClassName, and TargetOperatingSystem. If the selected class does not have instances, the left frame is empty.

Like the CIM WorkShop window, the right frame of the Instances window contains two tabs: Properties tab and Methods tab. All properties of the selected instance are displayed in the table of the Properties tab. The Inherited Properties icon--which appears in the left column of the Properties table as a purple rectangle with an arrow pointing to a white rectangle--indicates that the property is inherited from the class used to create the instance. The Key Qualifiers icon--which appears as a gold key--indicates that a property has an inherited Key qualifier.

Instances Window Toolbar Icons

The Instances window contains the following icons in the toolbar:

Table 4-7 Instance Window Toolbar Icons

Icon Name	Description
Add New Instance	Causes the Add Instance dialog box to display in which you can create a new instance to add to the class inheritance tree
Delete Selected Instance	Enables you to delete a selected instance
Refresh Instance List	Updates the list of instances in the left side of the Instances window with the newest instances and the latest changes to instances

Menus of the Instances Window

The instances window contains the following menus and menu items:

Table 4-8 Menus of the Instances Window

Menu Name	Menu Item	Description
Instance Editor	Exit	Causes the Instances window to close
Action	Add Instance	Causes the Add Instances dialog box to display, in which you can create new instances to add to the class inheritance tree
	Delete Instance	Enables you to delete a selected instance
	Refresh	Updates the list of instances in the left side of the Instances window with the newest instances and the latest changes to instances

Add Instances Dialog Box

In the Add Instances dialog box, you can right-click a property to change its value for a new instance. You cannot change the values of inherited properties.