| 
 | |||||||||
| 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.
CIMExceptionCIMClient.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.
CIMExceptionCIMClient.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.
CIMExceptionCIMClient.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 | ||||||||