javax.wbem.client
Class BatchCIMClient

java.lang.Object
  javax.wbem.client.BatchCIMClient

All Implemented Interfaces:

BatchHandle

public class BatchCIMClient

extends java.lang.Object

implements BatchHandle

The BatchCIMClient allows a client application to batch multiple requests into one remote call. The methods in this class correspond to CIM operation. A method when invoked, gives rise to a CIMOperation object. As multiple methods are invoked, a list of such CIMOperation objects is built. The client application executes the batch of requests by invoking the performBatchOperations() method on the CIMClient object and passing a BatchCIMClient object as a parameter.

Since:

WBEM 1.0

Constructor Summary

BatchCIMClient()
Constructor to create a BatchCIMClient object.

Method Summary

int	associatorNames(CIMObjectPath objectName, java.lang.String assocClass, java.lang.String resultClass, java.lang.String role, java.lang.String resultRole) Enumerates the object paths to CIM Objects 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) Enumerate CIM Objects 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	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	deleteQualifierType(CIMObjectPath path) Deletes the CIM qualfier to the specified namespace.
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 the object paths to all instances 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 of the class specified in the 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	getQualifierType(CIMObjectPath name) Gets the CIM qualifier type specified in the CIM object path.
int	invokeMethod(CIMObjectPath name, java.lang.String methodName, CIMArgument[] inArgs, CIMArgument[] outArgs) Executes the specified method on the specified object.
int	referenceNames(CIMObjectPath objectName, java.lang.String resultClass, java.lang.String role) Enumerates the object paths to association objects that refer to a particular target CIM Object.
int	references(CIMObjectPath objectName, java.lang.String resultClass, java.lang.String role, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) Enumerates the association objects that refer to a particular target CIM Object.
int	setClass(CIMObjectPath name, CIMClass cc) Modifies the CIM class in the specified namespace.
int	setInstance(CIMObjectPath name, CIMInstance ci, boolean includeQualifiers, java.lang.String[] propertyList) Modifies some or all of the properties of the specified CIM instance in the specified namespace.
int	setQualifierType(CIMObjectPath name, CIMQualifierType qt) Adds the specified CIM qualifier type to the specified namespace if it does not already exist.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.wbem.client.BatchHandle

enumNameSpace, setInstance

Constructor Detail

BatchCIMClient

public BatchCIMClient()

Constructor to create a BatchCIMClient object. Creates a new BatchCIMClient object that can be used to build a list of CIM Operations to be executed as a batched request.

Method Detail

associatorNames

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

Enumerates the object paths to CIM Objects that are associated to a particular source CIM Object. If the source CIM object is a class, then associated class names are returned. If the target CIM object is an instance, then object paths to the instances of associated classes are returned.

Specified by:

associatorNames in interface BatchHandle

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). Thus, if the Role input parameter is set to Antecedent, then only Associations where the source Object is the Antecedent reference are examined.

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). Thus, if the resultRole input parameter is set to Dependent, then only Associations where the returned Object is the Dependent reference are examined.

Returns:

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

Throws:

CIMException

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

Enumerate CIM Objects that are associated to a particular source CIM Object. If the source CIM object is a class, then associated class names are returned. If the target CIM object is an instance, then entire instances of associated classes are returned.

Specified by:

associators in interface BatchHandle

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). Thus, if the Role input parameter is set to Antecedent, then only Associations where the source Object is the Antecedent reference are examined.

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). Thus, if the resultRole input parameter is set to Dependent, then only Associations where the returned Object is the Dependent reference are examined.

includeQualifiers - If true, all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included in the response. If false, no Qualifiers are present in each returned Object.

includeClassOrigin - If 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. The CLASSORIGIN attribute is defined in the DMTF's Specification for the Representation of CIM in XML. CLASSORIGIN is an XML tag identifying the following text as a class name. It is attached to a property or method (when specified in XML), to indicate the class where that property or method is first defined. Where the same property name is locally defined in another superclass or subclass, the Server will return the value for the property in the lowest subclass. *

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 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:

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

Throws:

CIMException

createClass

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

Adds the CIM class to the specified namespace.

Specified by:

createClass in interface BatchHandle

Parameters:

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

cc - CIMClass to be added

Returns:

the Operation ID.

Throws:

CIMException

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.

Specified by:

createInstance in interface BatchHandle

Parameters:

name - CIM object path that identifies the CIM instance to be added. Only the name space component is used. Any other information (e.g. keys) is ignored.

ci - CIM instance to be added. Its keys and properties may be initialized by either the client or server.

Returns:

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

Throws:

CIMException

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.

Specified by:

deleteClass in interface BatchHandle

Parameters:

path - The CIMObjectPath identifying the class to delete

Returns:

the Operation ID.

Throws:

CIMException

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.

Specified by:

deleteInstance in interface BatchHandle

Parameters:

path - The CIMObjectPath identifying the CIM instance to delete

Returns:

the Operation ID.

Throws:

CIMException

deleteQualifierType

public int deleteQualifierType(CIMObjectPath path)
                        throws CIMException

Deletes the CIM qualfier to the specified namespace.

Specified by:

deleteQualifierType in interface BatchHandle

Parameters:

path - the CIMObjectPath identifying the CIM qualifier to delete

Returns:

the Operation ID.

Throws:

CIMException

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.

Specified by:

enumerateClasses in interface BatchHandle

Parameters:

path - The CIMObjectPath identifying the class to be enumerated.

deep - If true, the enumeration returned will contain the contents of all subclasses derived from the specified class. If false, the enumeration will return only the contents of the first level children of the specified class.

localOnly - If true, only elements (properties, methods and qualifiers) defined or overridden within the class are included in the response. If false, all elements of the class definition are returned.

includeQualifiers - If true, 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 true, 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. The CLASSORIGIN attribute is defined in the DMTF's Specification for the Representation of CIM in XML. CLASSORIGIN is an XML tag identifying the following text as a class name. It is attached to a property or method (when specified in XML), to indicate the class where that property or method is first defined. Where the same property name is locally defined in another superclass or subclass, the Server will return the value for the property in the lowest subclass.

Returns:

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

Throws:

CIMException

See Also:

CIMClient.enumerateClassNames(CIMObjectPath, boolean), CIMClient.enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)

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. If none are found, then NULL is returned.

Specified by:

enumerateClassNames in interface BatchHandle

Parameters:

path - The CIMObjectPath identifying the class to be enumerated.

deep - If true, the enumeration returned will contain the names of all subclasses derived from the specified class. If false the enumeration will return only the names of the first level children of the specified class.

Returns:

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

Throws:

CIMException

enumerateInstanceNames

public int enumerateInstanceNames(CIMObjectPath path)
                           throws CIMException

Returns the object paths to all instances belonging to the class specified in the path. The objectpaths of all derived classes in the specified class heirarchy will also be returned. If none are found, then NULL is returned.

Specified by:

enumerateInstanceNames in interface BatchHandle

Parameters:

path - The CIMObjectPath identifying the class whose instances are to be enumerated. Only the name space and class name components are used. Any other information (e.g. keys) is ignored.

Returns:

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

Throws:

CIMException

enumerateInstances

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

Returns all instances of the class specified in the path. The method also returns all instances of classes derived from the specified class.

Specified by:

enumerateInstances in interface BatchHandle

Parameters:

path - The CIMObjectPath identifying the class whose instances are to be enumerated. Only the name space and class name components are used. Any other information (e.g. keys) is ignored.

deep - If true, all elements of the returned Instance are returned (subject to the contraints imposed by the other parameters). If false, each returned Instance includes only properties defined for the specified Class.

localOnly - If true, only properties and qualifiers overridden or defined in the returned Instance are included in the response. If false, all elements of the returned Instance 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 true, 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. The CLASSORIGIN attribute is defined in the DMTF's Specification for the Representation of CIM in XML. CLASSORIGIN is an XML tag identifying the following text as a class name. It is attached to a property or method (when specified in XML), to indicate the class where that property or method is first defined. Where the same property name is locally defined in another superclass or subclass, the Server will return the value for the property in the lowest subclass.

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 Deep 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:

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

Throws:

CIMException

enumQualifierTypes

public int enumQualifierTypes(CIMObjectPath path)
                       throws CIMException

Enumerates the qualifiers defined in a namespace. If none are found, then NULL is returned.

Specified by:

enumQualifierTypes in interface BatchHandle

Parameters:

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

Returns:

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

Throws:

CIMException

execQuery

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

Executes a query to retrieve objects. If none are found, then NULL is returned. 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. NOTE: This method operates as if localOnly is false, includeQualifiers is true, includeClassOrigin is true and propertyList is false; i.e. all qualifiers and all local and inherited properties with CLASSORIGIN attributes of each instance are returned.

Only queries on class instances are supported.

Specified by:

execQuery in interface BatchHandle

Parameters:

name - CIMObjectPath that identifies the class in which to query. Only the name space and class name components are used. Any other information (e.g. keys) is ignored.

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 (e.g. WQL). WQL level 1 is the only currently supported query language.

Returns:

the 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)

Throws:

CIMException

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. The entire class contents (and not just the class names) are returned.

Specified by:

getClass in interface BatchHandle

Parameters:

name - the CIMObjectPath that identifies the CIM class

localOnly - If true, only elements (properties, methods and qualifiers) defined or overridden within the class are included in the response. If false, all elements of the class definition are returned.

includeQualifiers - If true, 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 true, 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. The CLASSORIGIN attribute is defined in the DMTF's Specification for the Representation of CIM in XML. CLASSORIGIN is an XML tag identifying the following text as a class name. It is attached to a property or method (when specified in XML), to indicate the class where that property or method is first defined. Where the same property name is locally defined in another superclass or subclass, the Server will return the value for the property in the lowest subclass.

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 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 class, then it will not be included in that class). 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:

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

Throws:

CIMException

See Also:

CIMClient.enumerateClasses(CIMObjectPath, boolean, boolean, boolean), CIMClient.enumerateClassNames(CIMObjectPath, boolean)

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.

Specified by:

getInstance in interface BatchHandle

Parameters:

name - CIM Object Path that identifies this CIM instance. This must include all of the keys.

localOnly - If true, only properties and qualifiers overridden or defined in the returned Instance are included in the response. If false, all elements of the returned Instance are returned.

includeQualifiers - If true, 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 true, CLASSORIGIN attribute MUST be present on all appropriate elements in each returned Object. If false, no CLASSORIGIN attributes are present in each returned Object. The CLASSORIGIN attribute is defined in the DMTF's Specification for the Representation of CIM in XML. CLASSORIGIN is an XML tag identifying the following text as a class name. It is attached to a property or method (when specified in XML), to indicate the class where that property or method is first defined. Where the same property name is locally defined in another superclass or subclass, the Server will return the value for the property in the lowest subclass. *

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 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:

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

Throws:

CIMException

See Also:

CIMClient.enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean), CIMClient.enumerateInstanceNames(CIMObjectPath)

getQualifierType

public int getQualifierType(CIMObjectPath name)
                     throws CIMException

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

Specified by:

getQualifierType in interface BatchHandle

Parameters:

name - CIM object path that identifies the CIM qualifier type

Returns:

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

Throws:

CIMException

invokeMethod

public int invokeMethod(CIMObjectPath name,
                        java.lang.String methodName,
                        CIMArgument[] inArgs,
                        CIMArgument[] outArgs)
                 throws CIMException

Executes the specified method on the specified object.

Specified by:

invokeMethod in interface BatchHandle

Parameters:

name - CIM object path of the object whose method must be invoked. It must include all of the keys.

methodName - the string name of the method to be invoked

inArgs - the input parameters specified as a array of CIMArgument.

outArgs - The output parameters specified as a array of CIMArgument. The caller should allocate an array large enough to hold all returned parameters, but should not initialize any array element.

Returns:

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

Throws:

CIMException

referenceNames

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

Enumerates the object paths to association objects that refer to a particular target CIM Object. If the target CIM object is a class, association class names are returned. If the target CIM object is an instance, then object paths to the association instances are returned.

Specified by:

referenceNames in interface BatchHandle

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. Thus, if the Role input parameter is set to Antecedent, then only Association instances where the target Object is the Antecedent reference are returned.

Returns:

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

Throws:

CIMException

references

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

Enumerates the association objects that refer to a particular target CIM Object. If the target CIM object is a class, association class names are returned. If the target CIM object is an instance, then association instances are returned.

Specified by:

references in interface BatchHandle

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. Thus, if the Role input parameter is set to Antecedent, then only Association instances where the target Object is the Antecedent reference are returned.

includeQualifiers - If true, all Qualifiers for each Object (including Qualifiers on the Object and on any returned Properties) MUST be included in the response. If false, no Qualifiers are present in each returned Object.

includeClassOrigin - If true, 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. The CLASSORIGIN attribute is defined in the DMTF's Specification for the Representation of CIM in XML. CLASSORIGIN is an XML tag identifying the following text as a class name. It is attached to a property or method (when specified in XML), to indicate the class where that property or method is first defined. Where the same property name is locally defined in another superclass or subclass, the Server will return the value for the property in the lowest subclass. *

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 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:

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

Throws:

CIMException

setClass

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

Modifies the CIM class in the specified namespace.

Specified by:

setClass in interface BatchHandle

Parameters:

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

cc - CIMClass to be modified

Returns:

the Operation ID.

Throws:

CIMException

setInstance

public int setInstance(CIMObjectPath name,
                       CIMInstance ci,
                       boolean includeQualifiers,
                       java.lang.String[] propertyList)

Modifies some or all of the properties of the specified CIM instance in the specified namespace.

Parameters:

name - CIM object path that identifies the CIM instance to be modified. It must include all of the keys.

ci - CIM instance to be modified. Its properties may be initialized by either the client or server.

includeQualifiers - If true, the Qualifiers are modified or created as specified in CIM Instance ci. A Qualifier is created if found in ci but not in its class definition. If the Qualifier is not found in ci, the previously created Qualifier (i.e. one not found in its class definition) is removed. If false, no Qualifiers are modified, created or removed.

propertyList - If the PropertyList input parameter is not NULL, the members of the array define one or more Property names. The Provider will modify or initialize only the values for the Property names in PropertyList. The Server will not update any other Property. Order is not important. The value of the specified Property is found in CIMInstance ci. If the specified Property value is not found in ci, then its value will be reinitialized by the Server so that any previous changes to the Property in ci are lost. If PropertyList contains invalid Property names, the entire operation fails (i.e. no Property values of ci are modified). PropertyList may contain duplicate Property names. The Server must ignore them but otherwise process the request normally. If PropertyList is an empty array, then no Property values in ci are updated. If PropertyList is NULL, then ci contains all Property values to be updated by the client or Server. This argument can be used to perform the SetProperty operation as defined by the CIM operations over HTTP spec at http://www.dmtf.org/.

Returns:

the Operation ID.

setQualifierType

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

Adds the specified CIM qualifier type to the specified namespace if it does not already exist. Otherwise, it sets the value qualifier type to the one passed in.

Specified by:

setQualifierType in interface BatchHandle

Parameters:

name - CIM object path that identifies the CIM qualifier type

qt - the CIM qualifier type to be added

Returns:

the Operation ID.

Throws:

CIMException