Node::wbemRetrieveData Method

Product Information > JADE Object Manager Guide > Chapter 4 - JADE System Instrumentation and Diagnosis > NodewbemRetrieveData Method

Node::wbemRetrieveData Method

wbemRetrieveData(className:     String;
                 instNameArray: HugeStringArray;
                 jdoArray:      JadeDynamicObjectArray input);

The Node class wbemRetrieveData method retrieves Web-Based Enterprise Management (WBEM) instances and property values for a specified WBEM class. The values are retrieved from the machine on which the node specified by the receiver object is running.

JADE allows only a subset of classes to be used. The allowed classes are those relating to cache, memory, system, processor, server, disk, and network interface information.

A JadeDynamicObject instance is created for each WBEM instance that is retrieved and added to the instance of the JadeDynamicObjectArray specified by the jdoArray input parameter. If the array is transient, the JadeDynamicObject instances are transient (not shared). If the array is persistent, the instances are persistent.

The caller is responsible for creating and deleting the JadeDynamicObjectArray instance, and for deleting any JadeDynamicObject instances that are added to it.

The instNameArray parameter is used to select the set of WBEM instances that are retrieved. If used, the array should contain a set of strings representing the names of the WBEM instances to be retrieved. Only WBEM instances that have names that match entries in the array are returned. If the value of the instNameArray parameter is null, all instances for the class specified by the className parameter are returned.

This method does not clear or purge the JadeDynamicObjectArray before inserting the JadeDynamicObject instances. Therefore, if called multiple times without first calling the purge or clear methods, previously added entries will remain in the array.

Each JadeDynamicObject that is created contains properties representing each property of the corresponding WBEM instance. The name of each property matches the WBEM class property name.

The property value is one of the following types, depending on the corresponding WBEM property type:

JADE converts WBEM properties that are arrays into individual properties with the array index inserted at the end of each property name.

For an example of the use of and output from this method, see the Node class wbemRetrieveData method in Volume 2 of the JADE Encyclopaedia of Classes.

Some properties are not returned by JADE. These are mainly properties that pertain to WBEM class and superclass names.

There is a limit of approximately 48K bytes to the size of the WBEM data that can be retrieved from remote computers. If this limit is exceeded, an 1141 exception (WBEM data exceeded maximum allowable size) is raised. If this exception occurs, the instNameArray parameter should be used to restrict the number of WBEM class instances that are retrieved.

If a name that is not allowed or recognized is used, an 1136 exception (Attempt to use a prohibited WBEM interface class name) or an 1133 exception (WBEM interface error when querying data) is raised.