javax.wbem.client
Interface BatchHandle

All Known Implementing Classes:

BatchCIMClient

public interface BatchHandle

Interface for any CIMOM Handle. The implementation must take care of communicating with the CIMOM.

Since:

WBEM 1.0

Method Summary

int	associatorNames(CIMObjectPath objectName, java.lang.String assocClass, java.lang.String resultClass, java.lang.String role, java.lang.String resultRole) This operation is used to enumerate the names of CIM Objects (Classes or Instances) that are associated to a particular source CIM Object.
int	associators(CIMObjectPath objectName, java.lang.String assocClass, java.lang.String resultClass, java.lang.String role, java.lang.String resultRole, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) This operation is used to enumerate CIM Objects (Classes or Instances) that are associated to a particular source CIM Object.
int	createClass(CIMObjectPath name, CIMClass cc) Adds the CIM class to the specified namespace.
int	createInstance(CIMObjectPath name, CIMInstance ci) Invokes the object manager on this client to add the specified CIM instance to the specified namespace.
int	createNameSpace(CIMNameSpace ns) Creates a CIM namespace, a directory containing CIM classes and CIM instances.
int	createQualifierType(CIMObjectPath name, CIMQualifierType qt) Adds the specified CIM qualifier type to the specified namespace.
int	deleteClass(CIMObjectPath path) Deletes the CIM class for the object specified by the CIM object path, a name that uniquely identifies a CIM object.
int	deleteInstance(CIMObjectPath path) Deletes the CIM instance specified by the CIM object path, a name that uniquely identifies a CIM object.
int	deleteNameSpace(CIMNameSpace ns) Deletes the specified namespace on the current host.
int	deleteQualifierType(CIMObjectPath path) Deletes the CIM qualfier for the object specified by the CIM object path, a name that uniquely identifies a CIM object.
int	enumerateClasses(CIMObjectPath path, boolean deep, boolean localOnly, boolean includeQualifiers, boolean includeClassOrigin) Enumerates the class specified in the path.
int	enumerateClassNames(CIMObjectPath path, boolean deep) Enumerates the class specified in the path.
int	enumerateInstanceNames(CIMObjectPath path) Returns all instance NAMES belonging to the class specified in the path.
int	enumerateInstances(CIMObjectPath path, boolean deep, boolean localOnly, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) Returns all instances (the whole instance and not just the names) belonging to the class specified in the path.
int	enumNameSpace(CIMObjectPath path, boolean deep) Gets a list of the namespaces within the namespace specified by the CIM object path.
int	enumQualifierTypes(CIMObjectPath path) Enumerates the qualifiers defined in a namespace.
int	execQuery(CIMObjectPath name, java.lang.String query, java.lang.String ql) Executes a query to retrieve objects.
int	getClass(CIMObjectPath name, boolean localOnly, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) Gets the CIM class for the specified CIM object path.
int	getInstance(CIMObjectPath name, boolean localOnly, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) Gets the CIM instance for the specified CIM object path.
int	getProperty(CIMObjectPath name, java.lang.String propertyName) Invokes the object manager on this client to get the specified CIM instance property.
int	getQualifierType(CIMObjectPath name) Gets the CIM qualifier type specified in the CIM object path.
int	invokeMethod(CIMObjectPath name, java.lang.String methodName, java.util.Vector inParams, java.util.Vector outParams) Executes the specified method on the specified object.
int	referenceNames(CIMObjectPath objectName, java.lang.String resultClass, java.lang.String role) This operation is used to enumerate the association objects that refer to a particular target CIM Object (Class or Instance).
int	references(CIMObjectPath objectName, java.lang.String resultClass, java.lang.String role, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) This operation is used to enumerate the association objects that refer to a particular target CIM Object (Class or Instance).
int	setClass(CIMObjectPath name, CIMClass cc) Modifies the CIM class in the specified namespace.
int	setInstance(CIMObjectPath name, CIMInstance ci) Invokes the object manager on this client to modify the specified CIM instance in the specified namespace.
int	setProperty(CIMObjectPath name, java.lang.String propertyName, CIMValue newValue) Invokes the object manager on this client to set the specified CIM instance property value.
int	setQualifierType(CIMObjectPath name, CIMQualifierType qt) Adds the specified CIM qualifier type to the specified namespace.

Method Detail

createNameSpace

public int createNameSpace(CIMNameSpace ns)
                    throws CIMException

Creates a CIM namespace, a directory containing CIM classes and CIM instances. When a client application connects to the CIM Object Manager, it specifies a namespace. All subsequent operations occur within that namespace on the CIM Object Manager host.

Parameters:

ns - The CIMNameSpace object that specifies a string for the host and a string for the namespace

Returns:

int - Operation ID.

deleteNameSpace

public int deleteNameSpace(CIMNameSpace ns)
                    throws CIMException

Deletes the specified namespace on the current host.

Parameters:

ns - The CIMNameSpace object that identifies the namespace to be deleted

Returns:

int - Operation ID.

deleteClass

public int deleteClass(CIMObjectPath path)
                throws CIMException

Deletes the CIM class for the object specified by the CIM object path, a name that uniquely identifies a CIM object. The CIM object path consists of two parts: namespace + model path. The namespace portion of the CIM object path identifies the host running the CIM Object Manager and the namespace. A namespace is a directory-like structure that contains CIM classes, instances, and qualifier types.

The model path portion of the CIM object path uniquely identifies a CIM object within the namespace on the host. The model path for a class is the class name.

Parameters:

path - The CIMObjectPath identifying the class to delete

Returns:

int - Operation ID.

deleteInstance

public int deleteInstance(CIMObjectPath path)
                   throws CIMException

Deletes the CIM instance specified by the CIM object path, a name that uniquely identifies a CIM object. A CIM object path consists of two parts: namespace + model path. The model path is created by concatenating the properties of a class that are qualified with the KEY qualifier.

Parameters:

path - The CIMObjectPath identifying the CIM instance to delete

Returns:

int - Operation ID.

deleteQualifierType

public int deleteQualifierType(CIMObjectPath path)
                        throws CIMException

Deletes the CIM qualfier for the object specified by the CIM object path, a name that uniquely identifies a CIM object.

Parameters:

path - the CIMObjectPath identifying the CIM qualifier to delete

Returns:

int - Operation ID.

enumNameSpace

public int enumNameSpace(CIMObjectPath path,
                         boolean deep)
                  throws CIMException

Gets a list of the namespaces within the namespace specified by the CIM object path.

Parameters:

path - The CIMObjectPath identifying the namespace to be enumerated.

deep - If set to true, the enumeration returned will contain the entire hierarchy of namespaces present under the enumerated namespace. If set to false the enumeration will return only the first level children of the enumerated namespace.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

enumerateClasses

public int enumerateClasses(CIMObjectPath path,
                            boolean deep,
                            boolean localOnly,
                            boolean includeQualifiers,
                            boolean includeClassOrigin)
                     throws CIMException

Enumerates the class specified in the path. The entire class contents (and not just the class names) are returned.

Parameters:

path - The CIMObjectPath identifying the class to be enumerated.

deep - If set to true, the enumeration returned will contain the names of all classes derived from the enumerated class. If set to false the enumeration will return only the names of the first level children of the enumerated class.

localOnly - if true, only the non-inherited properties and methods are returned, otherwise all properties and methods are returned.

includeQualifiers - If the IncludeQualifiers input parameter is true this specifies that all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included. If false no Qualifiers are present in the returned Object.

includeClassOrigin - If the IncludeClassOrigin input parameter is true, this specifies that the CLASSORIGIN attribute MUST be present on all appropriate elements in each returned Object. If false, no CLASSORIGIN attributes are present in each returned Object.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

See Also:

CIMClient.enumerateClassNames(javax.wbem.cim.CIMObjectPath), CIMClient.enumerateClasses(javax.wbem.cim.CIMObjectPath)

enumerateClassNames

public int enumerateClassNames(CIMObjectPath path,
                               boolean deep)
                        throws CIMException

Enumerates the class specified in the path. The class NAMES are returned as a vector of CIMObjectPaths.

Parameters:

path - The CIMObjectPath identifying the class to be enumerated.

deep - If set to true, the enumeration returned will contain the names of all classes derived from the enumerated class. If set to false the enumeration will return only the names of the first level children of the enumerated class.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

enumerateInstanceNames

public int enumerateInstanceNames(CIMObjectPath path)
                           throws CIMException

Returns all instance NAMES belonging to the class specified in the path. This could include instances names of all the classes in the specified class' hierarchy.

Parameters:

path - The CIMObjectPath identifying the class whose instances are to be enumerated.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

enumerateInstances

public int enumerateInstances(CIMObjectPath path,
                              boolean deep,
                              boolean localOnly,
                              boolean includeQualifiers,
                              boolean includeClassOrigin,
                              java.lang.String[] propertyList)
                       throws CIMException

Returns all instances (the whole instance and not just the names) belonging to the class specified in the path. This could include instances of all the classes in the specified class' hierarchy.

Parameters:

path - The CIMObjectPath identifying the class whose instances are to be enumerated.

deep - If set to false, the enumeration returned will contain only the properties defined for the class specified in the path parameter. If set to true all properties are returned.

localOnly - if true, only the non-inherited properties are returned, otherwise all properties are returned.

includeQualifiers - If the IncludeQualifiers input parameter is true this specifies that all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included. If false no Qualifiers are present in the returned Object.

includeClassOrigin - If the IncludeClassOrigin input parameter is true, this specifies that the CLASSORIGIN attribute MUST be present on all appropriate elements in each returned Object. If false, no CLASSORIGIN attributes are present in each returned Object.

propertyList - If the PropertyList input parameter is not NULL, the members of the array define one or more Property names. Each returned Object MUST NOT include elements for any Properties missing from this list. Note that if LocalOnly is specified as true (or DeepInheritance is specified as false) this acts as an additional filter on the set of Properties returned (for example, if Property A is included in the PropertyList but LocalOnly is set to true and A is not local to a returned Instance, then it will not be included in that Instance). If the PropertyList input parameter is an empty array this signifies that no Properties are included in each returned Object. If the PropertyList input parameter is NULL this specifies that all Properties (subject to the conditions expressed by the other parameters) are included in each returned Object. If the PropertyList contains duplicate elements, the Server ignores the duplicates but otherwise process the request normally. If the PropertyList contains elements which are invalid Property names for any target Object, the Server ignores such entries but otherwise process the request normally.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

enumQualifierTypes

public int enumQualifierTypes(CIMObjectPath path)
                       throws CIMException

Enumerates the qualifiers defined in a namespace.

Parameters:

path - The CIMObjectPath identifying the namespace whose qualifier definitions are to be enumerated.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

getClass

public int getClass(CIMObjectPath name,
                    boolean localOnly,
                    boolean includeQualifiers,
                    boolean includeClassOrigin,
                    java.lang.String[] propertyList)
             throws CIMException

Gets the CIM class for the specified CIM object path.

Parameters:

name - the CIMObjectPath that identifies the CIM class

localOnly - if true, only the non-inherited properties and methods are returned, otherwise all properties and methods are returned.

includeQualifiers - If the IncludeQualifiers input parameter is true this specifies that all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included. If false no Qualifiers are present in the returned Object.

includeClassOrigin - If the IncludeClassOrigin input parameter is true, this specifies that the CLASSORIGIN attribute MUST be present on all appropriate elements in each returned Object. If false, no CLASSORIGIN attributes are present in each returned Object.

propertyList - If the PropertyList input parameter is not NULL, the members of the array define one or more Property names. Each returned Object MUST NOT include elements for any Properties missing from this list. Note that if LocalOnly is specified as true (or DeepInheritance is specified as false) this acts as an additional filter on the set of Properties returned (for example, if Property A is included in the PropertyList but LocalOnly is set to true and A is not local to a returned Instance, then it will not be included in that Instance). If the PropertyList input parameter is an empty array this signifies that no Properties are included in each returned Object. If the PropertyList input parameter is NULL this specifies that all Properties (subject to the conditions expressed by the other parameters) are included in each returned Object. If the PropertyList contains duplicate elements, the Server ignores the duplicates but otherwise process the request normally. If the PropertyList contains elements which are invalid Property names for any target Object, the Server ignores such entries but otherwise process the request normally.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

See Also:

CIMClient.enumerateClasses(javax.wbem.cim.CIMObjectPath), CIMClient.enumerateClassNames(javax.wbem.cim.CIMObjectPath)

getInstance

public int getInstance(CIMObjectPath name,
                       boolean localOnly,
                       boolean includeQualifiers,
                       boolean includeClassOrigin,
                       java.lang.String[] propertyList)
                throws CIMException

Gets the CIM instance for the specified CIM object path.

Parameters:

name - CIM Object Path that identifies this CIM instance

localOnly - if true, only the non-inherited properties are returned, otherwise all properties are returned.

includeQualifiers - If the IncludeQualifiers input parameter is true this specifies that all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included. If false no Qualifiers are present in the returned Object.

includeClassOrigin - If the IncludeClassOrigin input parameter is true, this specifies that the CLASSORIGIN attribute MUST be present on all appropriate elements in each returned Object. If false, no CLASSORIGIN attributes are present in each returned Object.

propertyList - If the PropertyList input parameter is not NULL, the members of the array define one or more Property names. Each returned Object MUST NOT include elements for any Properties missing from this list. Note that if LocalOnly is specified as true (or DeepInheritance is specified as false) this acts as an additional filter on the set of Properties returned (for example, if Property A is included in the PropertyList but LocalOnly is set to true and A is not local to a returned Instance, then it will not be included in that Instance). If the PropertyList input parameter is an empty array this signifies that no Properties are included in each returned Object. If the PropertyList input parameter is NULL this specifies that all Properties (subject to the conditions expressed by the other parameters) are included in each returned Object. If the PropertyList contains duplicate elements, the Server ignores the duplicates but otherwise process the request normally. If the PropertyList contains elements which are invalid Property names for any target Object, the Server ignores such entries but otherwise process the request normally.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

See Also:

CIMClient.enumerateInstances(javax.wbem.cim.CIMObjectPath), CIMClient.enumerateInstanceNames(javax.wbem.cim.CIMObjectPath)

invokeMethod

public int invokeMethod(CIMObjectPath name,
                        java.lang.String methodName,
                        java.util.Vector inParams,
                        java.util.Vector outParams)
                 throws CIMException

Executes the specified method on the specified object. A method is a declaration containing the method name, return type, and parameters in the method.

Parameters:

name - CIM object path that identifies the method

methodName - the string name of the method to be invoked

inParams - the input parameters specified as a vector of CIMValue.

outParams - The output parameters, the CIMValue of these parameters will be appended to the outParams vector. The outParams vector is populated when the performBatchOperations call is completed.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

getQualifierType

public int getQualifierType(CIMObjectPath name)
                     throws CIMException

Gets the CIM qualifier type specified in the CIM object path.

Parameters:

name - CIM object path that identifies the CIM qualifier type

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

createQualifierType

public int createQualifierType(CIMObjectPath name,
                               CIMQualifierType qt)
                        throws CIMException

Adds the specified CIM qualifier type to the specified namespace.

Parameters:

name - CIM object path that identifies the CIM qualifier type

qt - the CIM qualifier type to be added

Returns:

int - Operation ID.

setQualifierType

public int setQualifierType(CIMObjectPath name,
                            CIMQualifierType qt)
                     throws CIMException

Adds the specified CIM qualifier type to the specified namespace.

Parameters:

name - CIM object path that identifies the CIM qualifier type

qt - the CIM qualifier type to be added

Returns:

int - Operation ID.

createClass

public int createClass(CIMObjectPath name,
                       CIMClass cc)
                throws CIMException

Adds the CIM class to the specified namespace.

Parameters:

name - CIM object path that identifies the CIM class to be added

cc - CIMClass to be added

Returns:

int - Operation ID.

setClass

public int setClass(CIMObjectPath name,
                    CIMClass cc)
             throws CIMException

Modifies the CIM class in the specified namespace.

Parameters:

name - CIM object path that identifies the CIM class to be modified

cc - CIMClass to be modified

Returns:

int - Operation ID.

createInstance

public int createInstance(CIMObjectPath name,
                          CIMInstance ci)
                   throws CIMException

Invokes the object manager on this client to add the specified CIM instance to the specified namespace.

Parameters:

name - CIM object path that identifies the CIM instance to be added

ci - CIM instance to be added

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

setInstance

public int setInstance(CIMObjectPath name,
                       CIMInstance ci)
                throws CIMException

Invokes the object manager on this client to modify the specified CIM instance in the specified namespace.

Parameters:

name - CIM object path that identifies the CIM instance to be modified

ci - CIM instance to be modified

Returns:

int - Operation ID.

getProperty

public int getProperty(CIMObjectPath name,
                       java.lang.String propertyName)
                throws CIMException

Invokes the object manager on this client to get the specified CIM instance property.

Parameters:

name - CIM object path that identifies the CIM instance to be accessed

propertyName - Property whose value is required.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

setProperty

public int setProperty(CIMObjectPath name,
                       java.lang.String propertyName,
                       CIMValue newValue)
                throws CIMException

Invokes the object manager on this client to set the specified CIM instance property value.

Parameters:

name - CIM object path that identifies the CIM instance to be accessed

propertyName - Property whose value is to be set.

newValue - The value for property propertyName.

Returns:

int - Operation ID.

execQuery

public int execQuery(CIMObjectPath name,
                     java.lang.String query,
                     java.lang.String ql)
              throws CIMException

Executes a query to retrieve objects. The WBEM Query Language is a subset of standard American National Standards Institute Structured Query Language (ANSI SQL) with semantic changes to support WBEM. Unlike SQL, in this release, it is a retrieval-only language. You cannot use the WBEM Query Language to modify, insert, or delete information.

Only queries on class instances are supported.

Parameters:

name - CIMObjectPath that identifies the class in which to query.

query - A string containing the text of the query. This parameter cannot be null.

ql - String that identifies the query language to use for parsing the query string. WQL level 1 is the only currently supported query language.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

The user does not have permission to view the result.

The requested query language is not supported.

The query specifies a class that does not exist.

Example:

The following API call returns an enumeration of all instances of the device_class.

cc.execQuery(new CIMObjectPath(), SELECT * FROM device_class, cc.WQL)

associators

public int associators(CIMObjectPath objectName,
                       java.lang.String assocClass,
                       java.lang.String resultClass,
                       java.lang.String role,
                       java.lang.String resultRole,
                       boolean includeQualifiers,
                       boolean includeClassOrigin,
                       java.lang.String[] propertyList)
                throws CIMException

This operation is used to enumerate CIM Objects (Classes or Instances) that are associated to a particular source CIM Object.

Parameters:

objectName - - Defines the source CIM Object whose associated Objects are to be returned. This may be either a Class name or Instance name (modelpath).

assocClass - The AssocClass input parameter, if not NULL, MUST be a valid CIM Association Class name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Instance of this Class or one of its subclasses.

resultClass - The ResultClass input parameter, if not NULL, MUST be a valid CIM Class name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be either an Instance of this Class (or one of its subclasses) or be this Class (or one of its subclasses).

role - The Role input parameter, if not NULL, MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Association in which the source Object plays the specified role (i.e. the name of the Property in the Association Class that refers to the source Object MUST match the value of this parameter).

resultRole - The ResultRole input parameter, if not NULL, MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Association in which the returned Object plays the specified role (i.e. the name of the Property in the Association Class that refers to the returned Object MUST match the value of this parameter).

includeQualifiers - If the IncludeQualifiers input parameter is true this specifies that all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included as elements in the response. If false no elements are present in each returned Object.

includeClassOrigin - If the IncludeClassOrigin input parameter is true, this specifies that the CLASSORIGIN attribute MUST be present on all appropriate elements in each returned Object. If false, no CLASSORIGIN attributes are present in each returned Object.

propertyList - If the PropertyList input parameter is not NULL, the members of the array define one or more Property names. Each returned Object MUST NOT include elements for any Properties missing from this list. Note that if LocalOnly is specified as true (or DeepInheritance is specified as false) this acts as an additional filter on the set of Properties returned (for example, if Property A is included in the PropertyList but LocalOnly is set to true and A is not local to a returned Instance, then it will not be included in that Instance). If the PropertyList input parameter is an empty array this signifies that no Properties are included in each returned Object. If the PropertyList input parameter is NULL this specifies that all Properties (subject to the conditions expressed by the other parameters) are included in each returned Object. If the PropertyList contains duplicate elements, the Server ignores the duplicates but otherwise process the request normally. If the PropertyList contains elements which are invalid Property names for any target Object, the Server ignores such entries but otherwise process the request normally. Clients SHOULD NOT explicitly specify properties in the PropertyList parameter unless they have specified a non-NULL value for the ResultClass parameter.

Returns:

int - Operation ID. Result array from the performBatch method contains the actual return value.

associatorNames

public int associatorNames(CIMObjectPath objectName,
                           java.lang.String assocClass,
                           java.lang.String resultClass,
                           java.lang.String role,
                           java.lang.String resultRole)
                    throws CIMException

This operation is used to enumerate the names of CIM Objects (Classes or Instances) that are associated to a particular source CIM Object.

Parameters:

objectName - - Defines the source CIM Object whose associated Objects are to be returned. This may be either a Class name or Instance name (modelpath).

assocClass - The AssocClass input parameter, if not NULL, MUST be a valid CIM Association Class name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Instance of this Class or one of its subclasses.

resultClass - The ResultClass input parameter, if not NULL, MUST be a valid CIM Class name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be either an Instance of this Class (or one of its subclasses) or be this Class (or one of its subclasses).

role - The Role input parameter, if not NULL, MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Association in which the source Object plays the specified role (i.e. the name of the Property in the Association Class that refers to the source Object MUST match the value of this parameter).

resultRole - The ResultRole input parameter, if not NULL, MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be associated to the source Object via an Association in which the returned Object plays the specified role (i.e. the name of the Property in the Association Class that refers to the returned Object MUST match the value of this parameter).

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

references

public int references(CIMObjectPath objectName,
                      java.lang.String resultClass,
                      java.lang.String role,
                      boolean includeQualifiers,
                      boolean includeClassOrigin,
                      java.lang.String[] propertyList)
               throws CIMException

This operation is used to enumerate the association objects that refer to a particular target CIM Object (Class or Instance).

Parameters:

objectName - The ObjectName input parameter defines the target CIM Object whose referring Objects are to be returned. This is either a Class name or Instance name (model path).

ResultClass - The ResultClass input parameter, if not NULL, MUST be a valid CIM Class name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be an Instance of this Class (or one of its subclasses), or this Class (or one of its subclasses).

role - The Role input parameter, if not NULL, MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Objects MUST refer to the target Object via a Property whose name matches the value of this parameter.

includeQualifiers - If the IncludeQualifiers input parameter is true this specifies that all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included as elements in the response. If false no elements are present in each returned Object.

includeClassOrigin - If the IncludeClassOrigin input parameter is true, this specifies that the CLASSORIGIN attribute MUST be present on all appropriate elements in each returned Object. If false, no CLASSORIGIN attributes are present in each returned Object.

propertyList - If the PropertyList input parameter is not NULL, the members of the array define one or more Property names. Each returned Object MUST NOT include elements for any Properties missing from this list. Note that if LocalOnly is specified as true (or DeepInheritance is specified as false) this acts as an additional filter on the set of Properties returned (for example, if Property A is included in the PropertyList but LocalOnly is set to true and A is not local to a returned Instance, then it will not be included in that Instance). If the PropertyList input parameter is an empty array this signifies that no Properties are included in each returned Object. If the PropertyList input parameter is NULL this specifies that all Properties (subject to the conditions expressed by the other parameters) are included in each returned Object. If the PropertyList contains duplicate elements, the Server ignores the duplicates but otherwise process the request normally. If the PropertyList contains elements which are invalid Property names for any target Object, the Server ignores such entries but otherwise process the request normally. Clients SHOULD NOT explicitly specify properties in the PropertyList parameter unless they have specified a non-NULL value for the ResultClass parameter. Instances meeting the requested criteria.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.

referenceNames

public int referenceNames(CIMObjectPath objectName,
                          java.lang.String resultClass,
                          java.lang.String role)
                   throws CIMException

This operation is used to enumerate the association objects that refer to a particular target CIM Object (Class or Instance).

Parameters:

objectName - The ObjectName input parameter defines the target CIM Object whose referring Objects are to be returned. This is either a Class name or Instance name (model path).

ResultClass - The ResultClass input parameter, if not NULL, MUST be a valid CIM Class name. It acts as a filter on the returned set of Objects by mandating that each returned Object MUST be an Instance of this Class (or one of its subclasses), or this Class (or one of its subclasses).

role - The Role input parameter, if not NULL, MUST be a valid Property name. It acts as a filter on the returned set of Objects by mandating that each returned Objects MUST refer to the target Object via a Property whose name matches the value of this parameter.

Returns:

int - Operation ID. Result list from the performBatch method contains the actual return value.