Chapter 2 CIM WorkShop

This chapter explains how to use CIM WorkShop to add new properties, methods, and qualifiers to the classes and instances that you create, and to set the scope and flavor of new qualifiers for new classes and instances. The following topics are covered:

• About CIM WorkShop

• Starting CIM WorkShop

• Navigating in CIM WorkShop

• Viewing Class Characteristics

• Working in Namespaces

• Working with Classes

• Adding a Class

• Deleting Classes and Their Attributes

• Working with Instances

• Invoking Methods

• Reference: CIM WorkShop Windows and Dialog Boxes

About CIM WorkShop

CIM WorkShop provides a graphical user interface in which you can view and create classes and instances. In CIM WorkShop, you can complete any of the following tasks:

• View and select namespaces

• Add namespaces

• View and create classes

• Add properties, qualifiers, and methods to new classes

• View and create instances

• View and modify instance values

CIM guidelines prevent you from modifying or editing the properties, methods, or qualifiers of CIM Schema or Solaris Schema classes. However, you can create new classes and instances of classes. When you create a new class or instance, you can add or delete properties, methods, and qualifiers. You can also change the values, including the scope and flavor, of new qualifiers that you create for a new class, instance, property, or method. You cannot change the values of inherited properties, methods, or qualifiers.

Starting CIM WorkShop

CIM WorkShop is available as part of the Sun WBEM SDK.

The CIM Object Manager must be installed to run CIM WorkShop. During an installation of Solaris WBEM Services in the Solaris operating environment, the CIM Object Manager runs on the local host. If you install only the Sun WBEM SDK, you must point to a host on which the CIM Object Manager already has started. You can enter this information in the Host field of the Login dialog box that is displayed when you start CIM WorkShop. For information about the CIM WorkShop dialog boxes and fields, see Reference: CIM WorkShop Window and Dialogs.

How to Start CIM WorkShop

1. Start the CIM WorkShop:

   • Type the following command at the system prompt:

     % /usr/sadm/bin/cimworkshop

   The CIM WorkShop window is displayed, followed by the Login dialog box. The Login dialog box shows the name of the host computer on which CIM Workshop is installed and the path of the default namespace, root\cimv2. Context Help, information about how to complete the dialog box, is displayed on the left side of the Login dialog box. When you click a field, the help content changes to reflect how to enter information into the field and the meaning of the field.

2. In the CIM WorkShop login dialog box, do the following:

   • In the Host Name field, type the name of a host running the CIM Object Manager.

     ---

     Note –

     By default, CIM WorkShop connects to the CIM Object Manager on the local host, in the default namespace, root\cimv2. If you start CIM WorkShop as part of the WBEM SDK in the Solaris operating environment or in the Microsoft Windows environment, you need to provide the name of a host that is already running a CIM Object Manager.

     ---

   • In the Namespace field, click in the field and type the name of the namespace that you want to use, or retain the name of the default namespace.

   • In the User Name field, type the user name you generally use for system and networking privileges.

   • In the Password field, type the password you generally use for system and networking privileges.

     ---

     Note –

     If you do not specify a user name and password, you can log in using the default user account, guest. Guest privileges are read-only. Your CIM Object Manager administrator can set up write privileges associated with your user name and password.

     ---

   • By default, CIM WorkShop uses the RMI protocol to connect to the CIM Object Manager on the local host, in the default namespace, root\cimv2. You can select HTTP if you want to communicate to a CIM Object Manager using the standard XML/HTTP protocol from the Desktop Management Task Force.

3. Click OK.

   A message is displayed to show that the classes in the class inheritance tree are being enumerated. In the left side of the CIM WorkShop window, CIM classes are displayed.

Navigating in CIM WorkShop

When you first start CIM WorkShop, the classes of the CIM Schema display hierarchically in the left side of the CIM WorkShop window. This arrangement of classes is referred to as the class inheritance tree. When you select a class, its associated properties are listed in the right side of the window. In the following illustration, the properties of the class Solaris_ComputerSystem are listed in the right side of the CIM WorkShop window.

Figure 2–1 Class Inheritance Tree in CIM WorkShop Window

For information about the toolbar, menus, and layout of the CIM WorkShop window, see Reference: CIM WorkShop Window and Dialogs.

Browsing the Class Inheritance Tree

Each class that has classes is denoted by two icons: a folder icon and an enabler icon. The enabler icon looks like a small key to the left of the folder icon.

The folder icon indicates that the class serves as a container for the classes it contains. The enabler icon serves as a navigation aid.

When an enabler icon is displayed horizontally, the class folder is closed and classes are contained. When you click the enabler icon, the class folder opens and classes are revealed. When the enabler icon is displayed vertically, it indicates that the class folder is open.

How To Display the Contents of a Class

Click the enabler icon of the desired class to view its contents.

How to Display the Properties and Methods of a Class

Click the class folder icon of the class.

The properties and methods of the class are displayed in the right frame of the CIM WorkShop window.

Finding a Class

CIM WorkShop enables you to quickly find a specific class.

How to Find a Class

1. In the toolbar, click the Find Class icon.

2. In the Find Class dialog box, type the name of the class you want to find and click OK.

   When the specified class is found, its details are displayed in the right frame of the CIM WorkShop window.

Viewing Class Characteristics

When you select a class from the class inheritance tree—by clicking its folder icon—two tabs, indicating the properties and methods of the class, are displayed in the right side of the CIM WorkShop window.

Selecting a Class

In the class inheritance tree, classes that contain classes are indicated by folder icons. Classes that do not contain classes are indicated by purple rectangles. Select a class by clicking the folder or page icon of the class in the class inheritance tree.

Viewing Class Properties

By default, when the CIM WorkShop window is displayed, the Properties tab appears in the right side of the CIM WorkShop window. In the left side of the CIM WorkShop window, you can select a class from the class inheritance tree; you can view all properties of the class in the Properties tab. Inherited properties are indicated by an icon that consists of a purple rectangle with a black arrow pointing to a white rectangle. Properties that have an assigned key qualifier are indicated by a gold key icon. For information about the presentation of properties in the Properties tab, see The Properties Tab.

Viewing Class Methods

After you select a class in the class inheritance tree, you can click the Methods tab to display the methods associated with the class. For information about how the methods are displayed in the methods tab, see The Methods Tab.

Viewing Qualifiers

In CIM, qualifiers are attributes of classes, instances, properties, and methods. In CIM Workshop, you can view the qualifiers by right-clicking a class, property, or method and clicking Qualifiers in the pop-up menu. Clicking Qualifiers causes the Qualifiers dialog box to be displayed. For information about the presentation of qualifier information in the Qualifiers dialog box, see Qualifiers Dialog Box.

Viewing the Scope of a Qualifier

When you click the Scope button in the Qualifiers dialog box, the Scope dialog box is displayed. In the Scope dialog box, you can view the scope of a qualifier. For information about the Scope dialog box, see Scope Dialog Box.

Viewing the Flavor of a Qualifier

When you click the Flavor button in the Qualifiers dialog box, the Flavors dialog box is displayed. In the Flavors dialog box, you can view the flavor of a qualifier. For information about the Flavors dialog box, see Flavors Dialog Box.

Working in Namespaces

A namespace is a logical entity, an abstraction of a managed object into which classes and instances can be stored. A namespace can be implemented in various forms including a directory structure, a database, or a folder. By default, CIM WorkShop connects to the CIM Object Manager on the local host, in the default namespace root\cimv2. All classes contained in the default namespace are displayed in the left side of the CIM WorkShop window. The name of the current namespace is listed in the toolbar of the CIM WorkShop window. In CIM WorkShop, you can browse the classes of namespaces on different hosts and you can change location to new namespaces.

When you want to set user privileges for a particular namespace, use the Sun WBEM User Manager. For information about the Sun WBEM User Manager tool, see “Administering Security” in Solaris WBEM Services Administrator's Guide.

This section describes how to:

• Create a namespace

• Change to a namespace

• Change to a host

• Refresh the class inheritance tree of the namespace

Creating a Namespace

You can create one or more namespaces within an existing namespace.

How to Create a Namespace

1. Select Change Namepace from the Workshop menu in the main CIM WorkShop window.

2. Right click on the namespace in which you want to create the new namespace, and then select Add Namespace.

3. In the Input dialog box, type the name of the new namespace and click OK.

Changing Namespaces

In the Sun WBEM SDK, the default namespace is root\cimv2. You can change to any other namespace.

How to Change Namespaces

1. In the CIM WorkShop window, click Workshop->Change Namespace.

2. In the Change Namespace dialog box, click the icon of the namespace you want to use. Click OK.

   The namespace you have selected becomes the current namespace.

Changing Hosts

You can change to another host to view namespaces or processes.

How to Change Hosts

1. Click Workshop->Change Host or click the Change Hosts icon in the CIM WorkShop toolbar.

2. In the Host Name field, type the name of the host on which the namespace you want to view is located.

3. Type your user name and password in the User Name and Password fields, respectively.

4. Click OK.

Refreshing Classes and Namespaces

You can refresh the display of the class inheritance tree in the namespace to reflect current changes made by other users who work in the namespace.

How to Refresh a Class Inheritance Tree

1. In the class inheritance tree, click the folder of the class you want to refresh.

2. Click Action->Refresh or click the Refresh Selected Class icon in the CIM WorkShop toolbar.

Working with Classes

Classes are the building blocks of applications. When you start CIM WorkShop, it becomes populated with the classes that make up the CIM and Solaris Schemas. These classes adhere to the Distributed Management Task Force standards. Their unique properties, methods, and qualifier values cannot be changed.

To set new values for an existing class, you can create a new instance or class. The CIM and Solaris Schema classes serve as templates. When you create a new instance or class, you produce a copy of the selected class in which you can add new properties, methods, and qualifier values. In this way, you build your own extensions into the CIM or Solaris Schemas.

You cannot modify the values of inherited properties, methods, or qualifiers.

For information about how to create an instance, see Working with Instances. For information about how to create a class, see the following section.

Adding a Class

Adding a class to an existing class involves the following tasks:

• Selecting the class

• Creating a new class

• Adding new qualifiers to the class

• Adding new properties to the class

• Adding new qualifiers to the properties

• Setting qualifier values: scope and flavor

Creating a Class

The first step in creating a class is to specify a name for the class. In CIM WorkShop, class names are displayed using standard CIM syntax: SchemaIndicator_ClassName. If you create a class of a CIM Schema class, the acronym CIM is used before the class name. If you create a class of a Solaris Schema class, the name Solaris is used before the class name. The underscore character (_) is required in the name of all classes that inherit a Key qualifier.

How to Add a class

1. In the class inheritance tree of the CIM WorkShop window, select the class from which to create a class.

2. Choose one of the following procedures for creating a class:

   • Click Action->Add Class.

     or

   • Click the Add New Class icon in the toolbar of the CIM WorkShop window.

     or

   • Right-click the selected class and click Add Class.

     The New Class dialog box is displayed.

3. In the Class Name field, type the name of the new class.

   For example, you can create a class from the class Solaris_ComputerSystem titled Ultra1_ComputerSystem.

4. To retain inherited properties and methods of the class, click OK. To add new properties, click Add Property.

   If you click OK, a class is created that uses inherited properties, methods, qualifiers, and their values. If you click Add Property, the Add Property dialog box is displayed, in which you can specify properties to add to the class. For information about how to add properties to a class, see Adding New Properties to a Class.

Adding Qualifiers

You can add qualifiers to a new class. You cannot change or reset the values of inherited qualifiers that modify the class. Also, you cannot delete inherited qualifiers.

How to Add Qualifiers

1. In the New Class dialog box, after you provide a name for the new class, click Class Qualifiers.

2. In the Qualifiers dialog box, right-click the Qualifier for which you want to set new values and click Add Qualifier.

3. In the Add Qualifier dialog box, select the name of a qualifier in the list and click OK.

4. To set the scope of the qualifier:

   1. Click Scope.

   2. In the Scope dialog box, select the scope of the qualifier and click OK.

5. To set the flavor of the qualifier:

   1. Click Flavors.

   2. In the Flavors dialog box, select the flavor of the qualifier and click OK.

6. Click OK in the Qualifiers dialog box to close it.

Adding New Properties to a Class

You can add new properties to a class and modify their values. You cannot change the values of inherited properties, and you cannot delete inherited properties.

How to Add a New Property to a Class

1. After specifying a name for the new class, click Add Property in the New Class dialog box.

   The Add Property dialog box is displayed.

2. In the Name field, type the name of the new property.

3. Select a property type from the Type field and click OK.

   The new property is displayed in the Properties tab of the New Class dialog box. If the list of properties is long, click the scroll bar to view the newly added property.

4. Click OK in the New Class dialog box.

   For information about how to add new qualifiers or set qualifier values for a new property or class, see the following sections.

Adding Qualifiers to a New Property

You can set the values of qualifiers for new properties of the class. You cannot change or reset the values of qualifiers that modify inherited properties or methods. You cannot delete inherited qualifiers.

How to Add Qualifiers to a New Property

1. In the New Class dialog box, click the new property you created and click Property Qualifiers.

   The Qualifiers dialog box is displayed for the property that you created.

2. Click Add Qualifier.

3. In the Name field of the Add Qualifier dialog box, select a qualifier and click OK.

4. Click OK in the Qualifiers dialog box and in the New Class dialog box.

   The qualifier and qualifier type are set for the selected property.

Deleting Classes and Their Attributes

CIM WorkShop provides a way to delete classes, properties, methods, and qualifiers that you no longer need or use.

When you delete a class, you delete all subclasses it contains. You also delete all associated properties, methods, and qualifiers of the class and its subclasses.

Deleting a Class

Use the following procedure to delete a class from the class inheritance tree.

How to Delete a Class

1. Select the class that you want to delete.

2. Click Action->Delete Class and click OK in the dialog box that asks you to confirm your decision to delete a class.

   The class is deleted.

Deleting a Property of a Class

You can delete only a property that you created in a new class. Otherwise, you can view but not modify or delete properties of classes. You cannot delete an inherited property in a subclass. However, when you create a new class, you can delete any new properties added to the class. For information about how to create a class, see Adding a Class.

How to Delete a Property of a Class

1. In the Properties tab of the New Class dialog box, select the property name or type and click Delete Property.

Deleting Qualifiers

When you create a new class, you can delete qualifiers of properties or methods inherited from the parent class. For information about how to create a class, see Adding a Class.

How to Delete a Qualifier of a Property

1. In the Properties tab of the New Class dialog box, select the property that you want to delete.

2. Click Property Qualfiers.

3. In the Qualifiers dialog box, select the qualifier to delete, Sclick Delete Qualifier, then click OK.

   The selected qualifier is deleted. The New Class dialog box is displayed.

How to Delete a Qualifier of a Method

1. In the Methods tab of the New Class dialog box, right-click the method with the qualifier you want to delete.

2. Click Qualifiers in the pop-up menu.

3. Select the qualifier you want to delete.

4. Right click the qualifier and select Delete Qualifier or select the qualifier to delete and click the Delete Qualifier button.

5. Select Qualifier to list the qualifiers for this method.

How to Add a Qualifier to a Method

1. In the Methods tab of the New Class dialog box, right-click the method to add a qualifier to and then select Qualifiers.

2. Click the Add Qualifier button in the Qualifiers dialog box.

3. Select the name of the qualifier type to add and then click OK. Click OK to close the Qualifiers dialog box.

Working with Instances

In CIM WorkShop, you can create instances of classes. Instances inherit the characteristics of the class. You can then change the attributes of a new instance to create a unique instance of a class.

Displaying Instances

Before you create a new instance of a class, it is useful to view the instances of the class to see what properties and methods they contain.

How to Display Instances of an Existing Class

1. In the class inheritance tree of the CIM WorkShop window, select the class for which you want to view instances.

2. To display the Instances window:

   • Click Action->Instances->Deep Enumeration or Shallow Enumeration.

     or

   • Click the Show Instances icon on the CIM WorkShop toolbar.

     or

   • Right click a class and select either Deep Enumeration or Shallow Enumeration from the pop-up dialog box.

The Instances window is displayed. If the selected class has instances, the instances are displayed in the left frame of the Instances window. If the selected class does not have instances, the left frame of the Instances window is empty.

Adding Instances

Add instances to a class when you want to modify the inherited qualities of objects.

How to Add an Instance to a Class

1. In the CIM WorkShop window:

   • Click Action->Instances->Deep Enumeration to list the instances of the current class and all its descendant classes.

     or

   • Click Action->Instances->Shallow Enumeration to list the instances of the current class.

     The Instances window is displayed. All instances of the class are displayed in the left side of the window.

2. Right-click an instance listed in the Instances window.

   The Add Instances dialog box is displayed with options to Refresh, Add Instance, or Delete Instance.

3. Click Add Instance.

4. To modify the inherited properties of an instance:

   1. Click in the value field to be changed.

      A dialog box is displayed in which you can provide a value for the property. The dialog box displayed varies depending on the type of the selected property. For example, if you select a property that has a type string, the String dialog box will display. The Value field of this dialog box accepts only character strings.

   2. In the Value field of the dialog box, type the required value.

5. Click OK to close the Add Instances window.

Deleting Instances

You can delete an instance that you no longer use.

How to Delete an Instance

1. In the left frame of the CIM WorkShop window, right-click the class from which you want to delete an instance.

2. In the pop-up menu, click Instances->Deep Enumeration to list instances of the selected class and its subclasses. Click Instances->Shallow Enumeration ot list instances of the selected class.

3. In the Instance window, right-click the instance you want to delete and click Delete Instance in the pop-up menu.

   The instance is deleted.

Invoking Methods

In CIM WorkShop, you can set input values for a parameter of a method and invoke the method. Input parameters feed set values, such as a character string, Boolean expression, or integer to a function of the method to enable the function to complete its operations. Invoking the method returns additional data in the form of output parameters.

For information about the dialog boxes you use to set parameter values and invoke methods, see Value Type Dialog Boxes and Invoke Methods Dialog Box.

How to Invoke a Method

1. In the CIM WorkShop window.

2. Select Action->Instances->Deep Enumeration to list the instances of the selected class and is subclasses. Select Action->Instances->Shallow Enumeration to list the instances of the selected class.

3. Click the Methods Tab.

4. Right-click the method to invoke and select Invoke Method.

5. In the Input Value column of the Invoke Method dialog box, click the cell of the value you want to add.

   A Cell Value dialog box opens.

6. Type an input value in the cell for the parameter and click OK.

7. Click Invoke Method.

   All output values and the return value are filled in automatically.

8. To add another input value, click and type a value in the corresponding cell of the Input Value column.

9. When you have finished adding new input values and invoking the method, click Close.

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 2–2 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 2–3 The CIM WorkShop Toolbar

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, Type, and Value 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

A method is a function that describes the behavior of a class. Examples of methods are behaviors such as start service, stop service, format disk, and so on. By selecting the Methods tab, you can view all methods of the class. Methods are listed consecutively.

Methods have two parts, a signature and a body. The signature consists of the method name, the parameters names, types, and their order, and the method return type. The method body consists of a sequence of instructions.

Reading from left to right horizontally, the method contains three parts:

• Return data type — The data type of the return value for this method.

• Name of the method

• Parameters — A comma-separated list of parameters enclosed within parentheses. Each parameter has a name and data type. Parameters that are input to the method are preceded with [IN]; parameters that are output from the method are preceded with [OUT]. A parameter can have one or more qualifiers.

In the following example, the method SetDateTime takes the input parameter Time, which is of type datetime and returns a boolean.

boolean SetDateTime([IN(true)] datetime Time);

CIM WorkShop Menus

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

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

• Transfer protocol

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

By default, CIM WorkShop uses the RMI protocol to connect to the CIM Object Manager on the local host, in the default namespace, root\cimv2. You can select HTTP if you want to communicate to a CIM Object Manager using the standard XML/HTTP protocol from the Desktop Management Task Force. When a connection is established, all classes contained in the default namespace are displayed in the left side of the CIM WorkShop window.

New Class Dialog Box

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

Figure 2–4 The New Class Dialog Box

Add Property Dialog Box

In the Add Property 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.

The following table describes the buttons of 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.

Flavors Dialog Box

In the Flavors dialog box, you can view the flavor of a qualifier.

Value Type Dialog Boxes

When you create new properties for a class or set input parameters for a method, you can use any of the dialog boxes that CIM WorkShop provides for specifying values 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

• Date/Time 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 alphanumeric 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 Unsigned 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 alphanumeric 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.

Date/Time Dialog Box

The DateTime dialog box enables you to set the date and time value as specified in the CIM Specification for a new property or method. The DateTime dialog box is displayed from:

• New Class dialog box when you select the value of a new property that uses the DateTime value

• Invoke Methods dialog box when you select the Input Value of a method's parameter

A Set Value dialog box is displayed. Click Add in the Set Value dialog box to display the Date/Time dialog box.

In the fields of the DateTime dialog box, type the date and time value in the following manner:

• Year yyyy is a 4-digit year

• Month mm is the month

• Day dd is the day

• Hour hh is the hour, on a 24-hour clock

• Minutes mm is the minute

• Seconds ss is the second

• Microsecondsmmmmmm is the number of microseconds

• Universal Coordinate Time s is a positive (+) or negative (-) sign that indicates the Universal Coordinated Time, or a (:)

  ---

  Note –

  If a (:) is provided, the value is interpreted as a time interval, and yyyymm are interpreted as days.

  ---

• utc is the offset from UTC in minutes

For example, Monday June 7, 1999 at 1:30:15 PM EST would be represented as: 19990607133015.000000-300

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:

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

• Click Action->Instances->Deep Enumeration or Shallow Enumeration.

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, a message is displayed.

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:

Menus of the Instances Window

The instances window contains the following menus and menu items:

Add Instance Dialog Box

In the Add Instance dialog box, if a property can be changed, you can click in the value field to open a Reference Edit dialog box. In the Reference Edit dialog box, click the value field to open a value dialog box. You cannot change the values of inherited properties.

Invoke Methods Dialog Box

The Invoke Methods dialog box is displayed from the Methods tab of an instance of a class that contains methods. Right-click the method and select Invoke Method from the menu. In the Invoke Methods dialog box, you can set the input values for the variables, or parameters, of a method and invoke the method. An example of a parameter value is a signed integer or a Date/Time value.

The Invoke Methods dialog box supports three types of parameters:

• Input parameters specify data values that are passed to a function and executed

• Output parameters specify data values that are returned by a function to the screen of an application or a printer

• Input/Output parameters take data to complete functions and return values

For information about how to invoke a method, see Invoking Methods.