|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Interface for any CIMOM Handle. The implementation must take care of communicating with the CIMOM.
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 |
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 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 |
getQualifierType(CIMObjectPath name)
Gets the CIM qualifier type specified in the CIM object path. |
int |
invokeMethod(CIMObjectPath name,
java.lang.String methodName,
CIMArgument[] inParams,
CIMArgument[] 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 |
setQualifierType(CIMObjectPath name,
CIMQualifierType qt)
Create or add the specified CIM qualifier type to the specified namespace. |
Method Detail |
public int associatorNames(CIMObjectPath objectName, java.lang.String assocClass, java.lang.String resultClass, java.lang.String role, java.lang.String resultRole) throws CIMException
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).
CIMException
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
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
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.
CIMException
public int createClass(CIMObjectPath name, CIMClass cc) throws CIMException
name
- CIM object path that identifies the CIM
class to be addedcc
- CIMClass to be added
CIMException
public int createInstance(CIMObjectPath name, CIMInstance ci) throws CIMException
name
- CIM object path that identifies the CIM
instance to be addedci
- CIM instance to be added
CIMException
public int deleteClass(CIMObjectPath path) throws CIMException
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.
path
- The CIMObjectPath identifying the class to delete
CIMException
public int deleteInstance(CIMObjectPath path) throws CIMException
KEY
qualifier.
path
- The CIMObjectPath identifying the CIM instance to delete
CIMException
public int deleteQualifierType(CIMObjectPath path) throws CIMException
path
- the CIMObjectPath identifying the CIM qualifier
to delete
CIMException
public int enumerateClasses(CIMObjectPath path, boolean deep, boolean localOnly, boolean includeQualifiers, boolean includeClassOrigin) throws CIMException
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.
CIMException
CIMClient.enumerateClassNames(CIMObjectPath, boolean)
,
CIMClient.enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
public int enumerateClassNames(CIMObjectPath path, boolean deep) throws CIMException
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.
CIMException
public int enumerateInstanceNames(CIMObjectPath path) throws CIMException
path
- The CIMObjectPath identifying the class whose instances are
to be enumerated.
CIMException
public int enumerateInstances(CIMObjectPath path, boolean deep, boolean localOnly, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) throws CIMException
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.
CIMException
public int enumNameSpace(CIMObjectPath path, boolean deep) throws CIMException
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.
CIMException
public int enumQualifierTypes(CIMObjectPath path) throws CIMException
path
- The CIMObjectPath identifying the namespace whose
qualifier definitions are to be enumerated.
CIMException
public int execQuery(CIMObjectPath name, java.lang.String query, java.lang.String ql) throws CIMException
Only queries on class instances are supported.
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.
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)
CIMException
public int getClass(CIMObjectPath name, boolean localOnly, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) throws CIMException
name
- the CIMObjectPath that identifies the CIM classlocalOnly
- 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.
CIMException
CIMClient.enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
,
CIMClient.enumerateClassNames(CIMObjectPath, boolean)
public int getInstance(CIMObjectPath name, boolean localOnly, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) throws CIMException
name
- CIM Object Path that identifies this CIM instancelocalOnly
- 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.
CIMException
CIMClient.enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean, String[])
,
CIMClient.enumerateInstanceNames(CIMObjectPath)
public int getQualifierType(CIMObjectPath name) throws CIMException
name
- CIM object path that identifies the CIM qualifier type
CIMException
public int invokeMethod(CIMObjectPath name, java.lang.String methodName, CIMArgument[] inParams, CIMArgument[] outParams) throws CIMException
name
- CIM object path that identifies the methodmethodName
- the string name of the method to be invokedinParams
- 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.
CIMException
public int referenceNames(CIMObjectPath objectName, java.lang.String resultClass, java.lang.String role) throws CIMException
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.
CIMException
public int references(CIMObjectPath objectName, java.lang.String resultClass, java.lang.String role, boolean includeQualifiers, boolean includeClassOrigin, java.lang.String[] propertyList) throws CIMException
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
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.
CIMException
public int setClass(CIMObjectPath name, CIMClass cc) throws CIMException
name
- CIM object path that identifies the CIM
class to be modifiedcc
- CIMClass to be modified
CIMException
public int setInstance(CIMObjectPath name, CIMInstance ci) throws CIMException
name
- CIM object path that identifies the CIM
instance to be modifiedci
- CIM instance to be modified
CIMException
public int setQualifierType(CIMObjectPath name, CIMQualifierType qt) throws CIMException
name
- CIM object path that identifies the CIM
qualifier typeqt
- the CIM qualifier type to be added
CIMException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |