Class CIMClient


  • public class CIMClient
    extends java.lang.Object
    A CIM client providing the main interface for a CIM client application to interact with a CIM server.

    Each CIMClient instance is connected to a single target CIM server and can be used to interact with all CIM namespaces within that server.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String CIM_XML
      Protocol identifier for CIM Operations over HTTP.
      static java.lang.String CQL
      QueryLanguage identifier for CIM Query Language (CQL).
      static java.lang.String ITSANM_CIMXML
      TODO Proposal: Constants ITSANM_CIMXML, ITSANM_SOAP, ITSANM_LOCAL never used, remove them.
      static java.lang.String ITSANM_LOCAL  
      static java.lang.String ITSANM_SOAP  
      static java.lang.String WQL
      QueryLanguage identifier for WBEM Query Language (WQL).
      static java.lang.String WQL1
      WBEM Query Language level 1.
      static java.lang.String WQL2
      WBEM Query Language level 2.
      static java.lang.String WQL3
      WBEM Query Language level 3.
      static java.lang.String WQL4
      WBEM Query Language level 4.
    • Constructor Summary

      Constructors 
      Constructor Description
      CIMClient​(CIMNameSpace pNameSpace, java.security.Principal pPrincipal, java.lang.Object pCredential)
      Initializes this CIMClient with connection information to a target CIM server and a default namespace, using the specified principal and credential, and using the default protocol CIM_XML (CIM Operations over HTTP).
      CIMClient​(CIMNameSpace pNameSpace, java.security.Principal pPrincipal, java.lang.Object pCredential, java.lang.String pProtocol)
      Initializes this CIMClient with connection information to a target CIM server and a default namespace, using the specified principal, credential and protocol.
      CIMClient​(CIMNameSpace pNameSpace, java.security.Principal pPrincipal, java.lang.Object pCredential, java.lang.String pProtocol, SessionProperties pProperties)
      Initializes this CIMClient with connection information to a target CIM server and a default namespace, using the specified principal, credential and protocol.
      CIMClient​(CIMOMHandle pCimomHandle)
      Initializes this CIMClient from an existing CIMOMHandle.
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      void addCIMListener​(CIMListener pListener)
      Adds the specified CIMListener to start receiving indications from the CIM server.
      java.util.Enumeration associatorNames​(CIMObjectPath pObjectPath)
      Enumerates the CIM objects on the target CIM server that are at the other end of all associations connecting to a source CIM object at this end of these associations, and returns CIM object paths to these objects.
      java.util.Enumeration associatorNames​(CIMObjectPath pObjectPath, java.lang.String pAssociationClass, java.lang.String pResultClass, java.lang.String pRole, java.lang.String pResultRole)
      Enumerates the CIM objects on the target CIM server that are at the other end of all associations connecting to a source CIM object at this end of these associations, and returns CIM object paths to these objects.
      java.util.Enumeration associators​(CIMObjectPath pObjectPath, java.lang.String pAssociationClass, java.lang.String pResultClass, java.lang.String pRole, java.lang.String pResultRole, boolean pIncludeQualifiers, boolean pIncludeClassOrigin, java.lang.String[] pPropertyList)
      Enumerates the CIM objects on the target CIM server that are at the other end of all associations connecting to a source CIM object at this end of these associations, and returns copies of these CIM objects.
      void close()
      Closes the connection to the CIM server.
      void close​(boolean pKeepEnumerations)
      Closes the connection to the CIM server.
      void createClass​(CIMObjectPath pClassPath, CIMClass pNewClass)
      Creates a CIM class on the target CIM server.
      CIMObjectPath createInstance​(CIMObjectPath pNamespacePath, CIMInstance pNewInstance)
      Creates a CIM instance in the specified namespace on the target CIM server.
      void createNameSpace​(CIMNameSpace pNameSpace)
      Creates a CIM namespace on the target CIM server.
      void createQualifierType​(CIMObjectPath pNamespacePath, CIMQualifierType pQualifierType)
      Creates or replaces a CIM qualifier declaration on the target CIM server.
      void deleteClass​(CIMObjectPath pClassPath)
      Deletes a CIM class on the target CIM server.
      void deleteInstance​(CIMObjectPath pInstancePath)
      Deletes a CIM instance on the target CIM server.
      void deleteNameSpace​(CIMNameSpace pNameSpace)
      Deletes a CIM namespace from the target CIM server.
      void deleteQualifierType​(CIMObjectPath pQualifierPath)
      Deletes a CIM qualifier declaration on the target CIM server.
      java.util.Enumeration enumClass​(CIMObjectPath pClassPath)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumClass​(CIMObjectPath pClassPath, boolean pDeepInheritance)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumClass​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumerateClasses()
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath, boolean pDeepInheritance)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly, boolean pIncludeQualifiers)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly, boolean pIncludeQualifiers, boolean pIncludeClassOrigin)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
      java.util.Enumeration enumerateClassNames()
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns CIM class paths to these classes.
      java.util.Enumeration enumerateClassNames​(CIMObjectPath pClassPath)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns CIM class paths to these classes.
      java.util.Enumeration enumerateClassNames​(CIMObjectPath pClassPath, boolean pDeepInheritance)
      Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns CIM class paths to these classes.
      java.util.Enumeration enumerateInstanceNames​(CIMObjectPath pClassPath)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns CIM instance paths to these instances.
      java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
      java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath, boolean pDeepInheritance)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
      java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
      java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly, boolean pIncludeQualifiers)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
      java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly, boolean pIncludeQualifiers, boolean pIncludeClassOrigin)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
      java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly, boolean pIncludeQualifiers, boolean pIncludeClassOrigin, java.lang.String[] pPropertyList)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
      java.util.Enumeration enumInstances​(CIMObjectPath pClassPath, boolean pDeepInheritance)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
      java.util.Enumeration enumInstances​(CIMObjectPath pClassPath, boolean pDeepInheritance, boolean pLocalOnly)
      Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
      java.util.Enumeration enumNameSpace​(CIMObjectPath pNamespacePath, boolean pDeep)
      Enumerates the CIM namespaces on the target CIM server, and returns CIM instance paths to the CIM_Namespace instances representing them.
      java.util.Enumeration enumQualifierTypes​(CIMObjectPath pNamespacePath)
      Enumerates the CIM qualifier declarations in a namespace on the target CIM server.
      java.util.Enumeration execQuery​(CIMObjectPath pNamespacePath, java.lang.String pQuery, java.lang.String pQueryLanguage)
      Executes a query on the target CIM server.
      CIMClass getClass​(CIMObjectPath pClassPath)
      Gets a copy of a CIM class from the target CIM server.
      CIMClass getClass​(CIMObjectPath pClassPath, boolean pLocalOnly)
      Gets a copy of a CIM class from the target CIM server.
      CIMClass getClass​(CIMObjectPath pClassPath, boolean pLocalOnly, boolean pIncludeQualifiers)
      Gets a copy of a CIM class from the target CIM server.
      CIMClass getClass​(CIMObjectPath pClassPath, boolean pLocalOnly, boolean pIncludeQualifiers, boolean pIncludeClassOrigin)
      Gets a copy of a CIM class from the target CIM server.
      CIMClass getClass​(CIMObjectPath pClassPath, boolean pLocalOnly, boolean pIncludeQualifiers, boolean pIncludeClassOrigin, java.lang.String[] pPropertyList)
      Gets a copy of a CIM class from the target CIM server.
      CIMInstance getIndicationHandler​(CIMListener pListener)
      This methods return an instance of CIM_IndicationHandler, since CIM over HTTP is used as transport an instance of CIM_IndicationHandlerCIMXML is returned.
      CIMInstance getIndicationListener​(CIMListener pListener)
      This methods return an instance of CIM_IndicationDestination, since CIM over HTTP is used as transport an instance of CIM_ListenerDestinationCIMXML is returned.
      CIMInstance getInstance​(CIMObjectPath pInstancePath)
      Gets a copy of a CIM instance from the target CIM server.
      CIMInstance getInstance​(CIMObjectPath pInstancePath, boolean pLocalOnly)
      Gets a copy of a CIM instance.
      CIMInstance getInstance​(CIMObjectPath pInstancePath, boolean pLocalOnly, boolean pIncludeQualifiers)
      Gets a copy of a CIM instance from the target CIM server.
      CIMInstance getInstance​(CIMObjectPath pInstancePath, boolean pLocalOnly, boolean pIncludeQualifiers, boolean pIncludeClassOrigin)
      Gets a copy of a CIM instance from the target CIM server.
      CIMInstance getInstance​(CIMObjectPath pInstancePath, boolean pLocalOnly, boolean pIncludeQualifiers, boolean pIncludeClassOrigin, java.lang.String[] pPropertyList)
      Gets a copy of a CIM instance from the target CIM server.
      java.util.Locale getLocale()
      Gets the current locale information of the CIM client.
      CIMNameSpace getNameSpace()
      Gets the default CIM namespace associated with this CIM client.
      CIMValue getProperty​(CIMObjectPath pInstancePath, java.lang.String pPropertyName)
      Gets a copy of a property value of a CIM instance on the target CIM server.
      CIMQualifierType getQualifierType​(CIMObjectPath pQualifierPath)
      Gets a copy of a CIM qualifier declaration from the target CIM server.
      SessionProperties getSessionProperties()
      Gets the session properties of the CIM client.
      CIMValue invokeMethod​(CIMObjectPath pObjectPath, java.lang.String pMethodName, java.util.Vector pInputArguments, java.util.Vector pOutputArguments)
      Invokes the specified CIM method on a CIM object (instance or class) on the target CIM server.
      CIMValue invokeMethod​(CIMObjectPath pObjectPath, java.lang.String pMethodName, CIMArgument[] pInputArguments, CIMArgument[] pOutputArguments)
      Deprecated.
      It is not recommended to use this method, since the number of output parameters may be extended by the CIM provider in the future.
      BatchResult performBatchOperations​(BatchHandle pBatchHandle)
      Performs the operations specified in the BatchHandle object.
      java.util.Enumeration referenceNames​(CIMObjectPath pObjectPath)
      Enumerates the CIM asociation objects on the target CIM server that reference a particular CIM object, and returns CIM object paths to these objects.
      java.util.Enumeration referenceNames​(CIMObjectPath pObjectPath, java.lang.String pResultClass, java.lang.String pRole)
      Enumerates the CIM asociation objects on the target CIM server that reference a particular CIM object, and returns CIM object paths to these objects.
      java.util.Enumeration references​(CIMObjectPath pObjectPath)
      Enumerates the CIM asociation objects on the target CIM server that reference a particular CIM object, and returns copies of these objects.
      java.util.Enumeration references​(CIMObjectPath pObjectPath, java.lang.String pResultClass, java.lang.String pRole, boolean pIncludeQualifiers, boolean pIncludeClassOrigin, java.lang.String[] pPropertyList)
      Enumerates the CIM asociation objects on the target CIM server that reference a particular CIM object, and returns copies of these objects.
      void removeCIMListener​(CIMListener pListener)
      Removes the specified CIMListener, to stop receiving indications from the CIM server.
      void setClass​(CIMObjectPath pClassPath, CIMClass pModifiedClass)
      Modifies a CIM class on the target CIM server.
      void setInstance​(CIMObjectPath pInstancePath, CIMInstance pModifiedInstance)
      Modifies a CIM instance on the target CIM server.
      void setInstance​(CIMObjectPath pInstancePath, CIMInstance pModifiedInstance, boolean pIncludeQualifiers, java.lang.String[] pPropertyList)
      Modifies a CIM instance on the target CIM server.
      void setLocale​(java.util.Locale pLocale)
      Modifies the locale information of the CIM client.
      void setProperty​(CIMObjectPath pInstancePath, java.lang.String pPropertyName)
      Modifies a property value of a CIM instance on the target CIM server.
      void setProperty​(CIMObjectPath pInstancePath, java.lang.String pPropertyName, CIMValue pNewValue)
      Modifies a property value of a CIM instance on the target CIM server.
      void setQualifierType​(CIMObjectPath pNamespacePath, CIMQualifierType pQualifierType)
      Creates or replaces a CIM qualifier declaration on the target CIM server.
      void setSessionProperties​(SessionProperties pProperties)
      Sets the session properties for the CIM client.
      void useHttp11​(boolean pValue)
      Control the use of HTTP 1.1.
      void useMPost​(boolean pValue)
      Control the use of HTTP MPost request.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • ITSANM_CIMXML

        public static final java.lang.String ITSANM_CIMXML
        TODO Proposal: Constants ITSANM_CIMXML, ITSANM_SOAP, ITSANM_LOCAL never used, remove them.
        See Also:
        Constant Field Values
      • CIM_XML

        public static final java.lang.String CIM_XML
        Protocol identifier for CIM Operations over HTTP.
        See Also:
        Constant Field Values
      • WQL

        public static final java.lang.String WQL
        QueryLanguage identifier for WBEM Query Language (WQL).
        See Also:
        Constant Field Values
      • CQL

        public static final java.lang.String CQL
        QueryLanguage identifier for CIM Query Language (CQL).
        See Also:
        Constant Field Values
      • WQL1

        public static final java.lang.String WQL1
        WBEM Query Language level 1. TODO Proposal: WQL1 constant is never used, remove it.
        See Also:
        Constant Field Values
      • WQL2

        public static final java.lang.String WQL2
        WBEM Query Language level 2. TODO Proposal: WQL2 constant is never used, remove it.
        See Also:
        Constant Field Values
      • WQL3

        public static final java.lang.String WQL3
        WBEM Query Language level 3. TODO Proposal: WQL3 constant is never used, remove it.
        See Also:
        Constant Field Values
      • WQL4

        public static final java.lang.String WQL4
        WBEM Query Language level 4. TODO Proposal: WQL4 constant is never used, remove it.
        See Also:
        Constant Field Values
    • Constructor Detail

      • CIMClient

        public CIMClient​(CIMNameSpace pNameSpace,
                         java.security.Principal pPrincipal,
                         java.lang.Object pCredential)
                  throws CIMException
        Initializes this CIMClient with connection information to a target CIM server and a default namespace, using the specified principal and credential, and using the default protocol CIM_XML (CIM Operations over HTTP). The global session properties are applied.
        Parameters:
        pNameSpace - Namespace identifying target CIM server and default CIM namespace name. Must not be null. The host and port attributes identify the target CIM server to connect to. Must be valid. The namespace attribute identifies the default namespace name to be used if object paths in subsequent method invocations do not provide a namespace name. Must be valid.
        pPrincipal - Principal (e.g. userid) used to log on to the CIM Server. Must not be null.
        pCredential - Credential (e.g. password) used to log on to the CIM Server. Must not be null.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
        See Also:
        CIMClient(CIMNameSpace, Principal, Object, String, SessionProperties)
      • CIMClient

        public CIMClient​(CIMNameSpace pNameSpace,
                         java.security.Principal pPrincipal,
                         java.lang.Object pCredential,
                         java.lang.String pProtocol)
                  throws CIMException
        Initializes this CIMClient with connection information to a target CIM server and a default namespace, using the specified principal, credential and protocol. The global session properties are applied.
        Parameters:
        pNameSpace - Namespace identifying target CIM server and default CIM namespace name. Must not be null. The host and port attributes identify the target CIM server to connect to. Must be valid. The namespace attribute identifies the default namespace name to be used if object paths in subsequent method invocations do not provide a namespace name. Must be valid.
        pPrincipal - Principal (e.g. userid) used to log on to the CIM Server. Must not be null.
        pCredential - Credential (e.g. password) used to log on to the CIM Server. Must not be null.
        pProtocol - Identifier for the CIM client protocol to be used. Must be valid. Valid identifiers are the following constants:
        • CIM_XML - CIM Operations over HTTP
        and also the name of any Java class that implements CIMOMHandle.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
        See Also:
        CIMClient(CIMNameSpace, Principal, Object, String, SessionProperties)
      • CIMClient

        public CIMClient​(CIMNameSpace pNameSpace,
                         java.security.Principal pPrincipal,
                         java.lang.Object pCredential,
                         java.lang.String pProtocol,
                         SessionProperties pProperties)
                  throws CIMException
        Initializes this CIMClient with connection information to a target CIM server and a default namespace, using the specified principal, credential and protocol. TODO Proposal: Allow the name of the Interop namespace to be passed (add a new ctor that does this).
        Parameters:
        pNameSpace - Namespace identifying target CIM server and default CIM namespace name. Must not be null. The host and port attributes identify the target CIM server to connect to. Must be valid. The namespace attribute identifies the default namespace name to be used if object paths in subsequent method invocations do not provide a namespace name. Must be valid.
        pPrincipal - Principal (e.g. userid) used to log on to the CIM Server. Must not be null.
        pCredential - Credential (e.g. password) used to log on to the CIM Server. Must not be null.
        pProtocol - Identifier for the CIM client protocol to be used. Must be valid. Valid identifiers are the following constants:
        • CIM_XML - CIM Operations over HTTP
        and also the name of any Java class that implements CIMOMHandle.
        pProperties - The session properties to apply. Might be either the global session properties or a connection specific property instance. If null the global properties are used.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
        See Also:
        CIMOMHandle, SessionProperties, SessionProperties.getGlobalProperties()
      • CIMClient

        public CIMClient​(CIMOMHandle pCimomHandle)
                  throws CIMException
        Initializes this CIMClient from an existing CIMOMHandle.

        A CIMOMHandle can be obtained from a CIMClientFactory. This allows to extend the CIM client (for instance with an additional protocol) without changing the interface to the CIM client application.

        Parameters:
        pCimomHandle -
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_INVALID_PARAMETER
        See Also:
        CIMOMHandle, CIMClientFactory
    • Method Detail

      • associatorNames

        public java.util.Enumeration associatorNames​(CIMObjectPath pObjectPath,
                                                     java.lang.String pAssociationClass,
                                                     java.lang.String pResultClass,
                                                     java.lang.String pRole,
                                                     java.lang.String pResultRole)
                                              throws CIMException
        Enumerates the CIM objects on the target CIM server that are at the other end of all associations connecting to a source CIM object at this end of these associations, and returns CIM object paths to these objects.

        If the source CIM object is an instance, then the associated instances are enumerated. If the source CIM object is a class, then the associated classes are enumerated.

        Parameters:
        pObjectPath - CIM object path to the source CIM object (instance or class) whose associated CIM objects are to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The source CIM object must exist.
        pAssociationClass - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM association class name, and the set of objects will be restricted by removing any objects that are not associated to the source CIM object via the specified class or one of its subclasses. When combined with other object restriction filters, all restrictions are accumulated.
        pResultClass - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM class name, and the set of objects will be restricted by removing any objects that do not satisfy the following conditions: (1) If the source CIM object is an instance, the enumerated objects are CIM instances of the specified class or one of its subclasses. (2) If the source CIM object is a class, the enumerated objects are the specified class or one of its subclasses. When combined with other object restriction filters, all restrictions are accumulated.
        pRole - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM property name, and the set of objects will be restricted by removing any objects that are not associated to the source object via an association in which the source object plays the specified pRole (i.e. the name of the reference in the association class that refers to the source object must match the value of this parameter). When combined with other object restriction filters, all restrictions are accumulated.
        pResultRole - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM property name, and the set of objects will be restricted by removing any objects that are not associated to the source object via an association in which the returned object plays the specified pRole (i.e. the name of the reference in the association class that refers to the returned object must match the value of this parameter). When combined with other object restriction filters, all restrictions are accumulated.
        Returns:
        A CIMEnumeration object containing zero or more CIMObjectPath objects referencing the enumerated classes or instances using global CIM class or instance paths.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
      • associatorNames

        public java.util.Enumeration associatorNames​(CIMObjectPath pObjectPath)
                                              throws CIMException
        Enumerates the CIM objects on the target CIM server that are at the other end of all associations connecting to a source CIM object at this end of these associations, and returns CIM object paths to these objects.

        This method produces the same results as associatorNames(pObjectPath, null, null, null, null)

        Parameters:
        pObjectPath - CIM object path to the source CIM object (instance or class) whose associated CIM objects are to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The source CIM object must exist.
        Returns:
        A CIMEnumeration object containing zero or more CIMObjectPath objects referencing the enumerated classes or instances using global CIM class or instance paths.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
        See Also:
        associatorNames(CIMObjectPath, String, String, String, String)
      • associators

        public java.util.Enumeration associators​(CIMObjectPath pObjectPath,
                                                 java.lang.String pAssociationClass,
                                                 java.lang.String pResultClass,
                                                 java.lang.String pRole,
                                                 java.lang.String pResultRole,
                                                 boolean pIncludeQualifiers,
                                                 boolean pIncludeClassOrigin,
                                                 java.lang.String[] pPropertyList)
                                          throws CIMException
        Enumerates the CIM objects on the target CIM server that are at the other end of all associations connecting to a source CIM object at this end of these associations, and returns copies of these CIM objects.

        If the source CIM object is an instance, then the associated instances are enumerated. If the source CIM object is a class, then the associated classes are enumerated.

        Parameters:
        pObjectPath - CIM object path to the source CIM object (instance or class) whose associated CIM objects are to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The source CIM object must exist.
        pAssociationClass - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM association class name, and the set of objects will be restricted by removing any objects that are not associated to the source CIM object via the specified class or one of its subclasses. When combined with other object restriction filters, all restrictions are accumulated.
        pResultClass - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM class name, and the set of objects will be restricted by removing any objects that do not satisfy the following conditions: (1) If the source CIM object is an instance, the enumerated objects are CIM instances of the specified class or one of its subclasses. (2) If the source CIM object is a class, enumerated objects are the specified class or one of its subclasses. When combined with other object restriction filters, all restrictions are accumulated.
        pRole - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM property name, and the set of objects will be restricted by removing any objects that are not associated to the source object via an association in which the source object plays the specified pRole (i.e. the name of the reference in the association class that refers to the source object must match the value of this parameter). When combined with other object restriction filters, all restrictions are accumulated.
        pResultRole - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM property name, and the set of objects will be restricted by removing any objects that are not associated to the source object via an association in which the returned object plays the specified pRole (i.e. the name of the reference in the association class that refers to the returned object must match the value of this parameter). When combined with other object restriction filters, all restrictions are accumulated.
        pIncludeQualifiers - If false, no qualifiers will be included. If true, all qualifiers for each object will be included in the objects returned.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to retrieve qualifier information is to use the class operations (for example, getClass) instead, and to set this parameter to false.
        pIncludeClassOrigin - If true, class origin information will be present in the returned objects. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned objects.
        pPropertyList - An array of CIM property names that allows to restrict the set of properties in the returned objects (classes or instances). If null, the set of properties will not be restricted by this parameter. If not null, the set of properties will be restricted such that any properties missing from this list will not be present in the returned objects. In this case, the members of the array must define zero or more property names of the specified class. This may include inherited property names or property names explicitly defined in the specified class, but must not include property names defined in subclasses of the specified class. Duplicate property names are tolerated and the duplicates are ignored.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance or CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
        See Also:
        CIMProperty.getOriginClass(), CIMMethod.getOriginClass(), CIMInstance, CIMClass
      • enumInstances

        public java.util.Enumeration enumInstances​(CIMObjectPath pClassPath,
                                                   boolean pDeepInheritance)
                                            throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.

        This method produces the same results as enumerateInstances(pClassPath, pDeepInheritance, false, false, false, null)

        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pDeepInheritance - Allows to restrict the set of properties present in the returned instances. If true, the set of properties will not be restricted by this parameter. If false, the set of properties will be restricted such that any properties in subclasses of the specified class are removed. When combined with other property restriction filters, all restrictions are accumulated. Note: There is an erroneous interpretation of this parameter which consists in believing that the parameter removes all instances of subclasses from the enumerated set of instances. This is wrong as it does not remove such instances, instead it removes their subclass properties.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean, String[])
      • enumInstances

        public java.util.Enumeration enumInstances​(CIMObjectPath pClassPath,
                                                   boolean pDeepInheritance,
                                                   boolean pLocalOnly)
                                            throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.

        This method produces the same results as enumerateInstances(pClassPath, pDeepInheritance, localOnly, false, false, null)

        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pDeepInheritance - Allows to restrict the set of properties present in the returned instances. If true, the set of properties will not be restricted by this parameter. If false, the set of properties will be restricted such that any properties in subclasses of the specified class are removed. When combined with other property restriction filters, all restrictions are accumulated. Note: There is an erroneous interpretation of this parameter which consists in believing that the parameter removes all instances of subclasses from the enumerated set of instances. This is wrong as it does not remove such instances, instead it removes their subclass properties.
        pLocalOnly - Allows to restrict the set of properties present in the returned instances. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean, String[])
      • enumerateInstances

        public java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath,
                                                        boolean pDeepInheritance,
                                                        boolean pLocalOnly)
                                                 throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.

        This method produces the same results as enumerateInstances(pClassPath, pDeepInheritance, localOnly, false, false, null)

        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pDeepInheritance - Allows to restrict the set of properties present in the returned instances. If true, the set of properties will not be restricted by this parameter. If false, the set of properties will be restricted such that any properties in subclasses of the specified class are removed. When combined with other property restriction filters, all restrictions are accumulated. Note: There is an erroneous interpretation of this parameter which consists in believing that the parameter removes all instances of subclasses from the enumerated set of instances. This is wrong as it does not remove such instances, instead it removes their subclass properties.
        pLocalOnly - Allows to restrict the set of properties present in the returned instances. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean, String[])
      • enumerateInstances

        public java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath,
                                                        boolean pDeepInheritance,
                                                        boolean pLocalOnly,
                                                        boolean pIncludeQualifiers,
                                                        boolean pIncludeClassOrigin,
                                                        java.lang.String[] pPropertyList)
                                                 throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.
        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pDeepInheritance - Allows to restrict the set of properties present in the returned instances. If true, the set of properties will not be restricted by this parameter. If false, the set of properties will be restricted such that any properties in subclasses of the specified class are removed. When combined with other property restriction filters, all restrictions are accumulated. Note: There is an erroneous interpretation of this parameter which consists in believing that the parameter removes all instances of subclasses from the enumerated set of instances. This is wrong as it does not remove such instances, instead it removes their subclass properties.
        pLocalOnly - Allows to restrict the set of properties present in the returned instances. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        pIncludeQualifiers - If false, no qualifiers will be included. If true, all qualifiers for each object will be included in the objects returned.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to retrieve qualifier information is to use the class operations (for example, getClass) instead, and to set this parameter to false.
        pIncludeClassOrigin - If true, class origin information will be present in the returned objects. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned objects.
        pPropertyList - An array of CIM property names that allows to restrict the set of properties in the returned objects (classes or instances). If null, the set of properties will not be restricted by this parameter. If not null, the set of properties will be restricted such that any properties missing from this list will not be present in the returned objects. In this case, the members of the array must define zero or more property names of the specified class. This may include inherited property names or property names explicitly defined in the specified class, but must not include property names defined in subclasses of the specified class. Duplicate property names are tolerated and the duplicates are ignored. When combined with other property restriction filters, all restrictions are accumulated.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        CIMProperty.getOriginClass(), CIMMethod.getOriginClass()
      • enumerateInstances

        public java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath)
                                                 throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.

        This method produces the same results as enumerateInstances(pClassPath, true, true, false, false, null)

        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated the pLocalOnly parameter. It is recommended that CIM client applications set pLocalOnly to false. Therefore, it is not recommended that CIM client applications use this flavor of enumerateInstances.

        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean, String[])
      • enumerateInstances

        public java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath,
                                                        boolean pDeepInheritance)
                                                 throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.

        This method produces the same results as enumerateInstances(pClassPath, pDeepInheritance, false, false, false, null)

        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pDeepInheritance - Allows to restrict the set of properties present in the returned instances. If true, the set of properties will not be restricted by this parameter. If false, the set of properties will be restricted such that any properties in subclasses of the specified class are removed. When combined with other property restriction filters, all restrictions are accumulated. Note: There is an erroneous interpretation of this parameter which consists in believing that the parameter removes all instances of subclasses from the enumerated set of instances. This is wrong as it does not remove such instances, instead it removes their subclass properties.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean, String[])
      • enumerateInstances

        public java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath,
                                                        boolean pDeepInheritance,
                                                        boolean pLocalOnly,
                                                        boolean pIncludeQualifiers)
                                                 throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.

        This method produces the same results as enumerateInstances(pClassPath, pDeepInheritance, pLocalOnly, pIncludeQualifiers, false, null)

        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pDeepInheritance - Allows to restrict the set of properties present in the returned instances. If true, the set of properties will not be restricted by this parameter. If false, the set of properties will be restricted such that any properties in subclasses of the specified class are removed. When combined with other property restriction filters, all restrictions are accumulated. Note: There is an erroneous interpretation of this parameter which consists in believing that the parameter removes all instances of subclasses from the enumerated set of instances. This is wrong as it does not remove such instances, instead it removes their subclass properties.
        pLocalOnly - Allows to restrict the set of properties present in the returned instances. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        pIncludeQualifiers - If false, no qualifiers will be included. If true, all qualifiers for each object will be included in the objects returned.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to retrieve qualifier information is to use the class operations (for example, getClass) instead, and to set this parameter to false.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean, String[])
      • enumerateInstances

        public java.util.Enumeration enumerateInstances​(CIMObjectPath pClassPath,
                                                        boolean pDeepInheritance,
                                                        boolean pLocalOnly,
                                                        boolean pIncludeQualifiers,
                                                        boolean pIncludeClassOrigin)
                                                 throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns copies of these instances.

        This method produces the same results as enumerateInstances(pClassPath, pDeepInheritance, pLocalOnly, pIncludeQualifiers, pIncludeClassOrigin, null)

        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pDeepInheritance - Allows to restrict the set of properties present in the returned instances. If true, the set of properties will not be restricted by this parameter. If false, the set of properties will be restricted such that any properties in subclasses of the specified class are removed. When combined with other property restriction filters, all restrictions are accumulated. Note: There is an erroneous interpretation of this parameter which consists in believing that the parameter removes all instances of subclasses from the enumerated set of instances. This is wrong as it does not remove such instances, instead it removes their subclass properties.
        pLocalOnly - Allows to restrict the set of properties present in the returned instances. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        pIncludeQualifiers - If false, no qualifiers will be included. If true, all qualifiers for each object will be included in the objects returned.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to retrieve qualifier information is to use the class operations (for example, getClass) instead, and to set this parameter to false.
        pIncludeClassOrigin - If true, class origin information will be present in the returned objects. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned objects.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateInstances(CIMObjectPath, boolean, boolean, boolean, boolean, String[])
      • enumerateInstanceNames

        public java.util.Enumeration enumerateInstanceNames​(CIMObjectPath pClassPath)
                                                     throws CIMException
        Enumerates the CIM instances on the target CIM server that are of the specified class or its subclasses and returns CIM instance paths to these instances.
        Parameters:
        pClassPath - CIM class path to the CIM class whose instances will be enumerated. Instances of its subclasses in the same namespace will also be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        Returns:
        A CIMEnumeration object containing zero or more CIMObjectPath objects referencing the enumerated instances using intra-namespace CIM instance paths (model paths).
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
      • getInstance

        public CIMInstance getInstance​(CIMObjectPath pInstancePath,
                                       boolean pLocalOnly)
                                throws CIMException
        Gets a copy of a CIM instance.

        This method produces the same results as getInstance(pInstancePath, pLocalOnly, false, false, null)

        Parameters:
        pInstancePath - CIM instance path to the CIM instance to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM instance must exist.
        pLocalOnly - Allows to restrict the set of properties present in the returned instance. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        Returns:
        A CIMInstance object.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        getInstance(CIMObjectPath, boolean, boolean, boolean, String[])
      • getInstance

        public CIMInstance getInstance​(CIMObjectPath pInstancePath,
                                       boolean pLocalOnly,
                                       boolean pIncludeQualifiers)
                                throws CIMException
        Gets a copy of a CIM instance from the target CIM server.

        This method produces the same results as getInstance(pObjectPath, pLocalOnly, pIncludeQualifiers, false, null)

        Parameters:
        pInstancePath - CIM instance path to the CIM instance to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM instance must exist.
        pLocalOnly - Allows to restrict the set of properties present in the returned instance. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        pIncludeQualifiers - If false, no qualifiers will be included. If true, all qualifiers of the instance will be included in the instance returned.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to retrieve qualifier information is to use the class operations (for example, getClass) instead, and to set this parameter to false.
        Returns:
        A CIMInstance object.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        getInstance(CIMObjectPath, boolean, boolean, boolean, String[])
      • getInstance

        public CIMInstance getInstance​(CIMObjectPath pInstancePath,
                                       boolean pLocalOnly,
                                       boolean pIncludeQualifiers,
                                       boolean pIncludeClassOrigin)
                                throws CIMException
        Gets a copy of a CIM instance from the target CIM server.

        This method produces the same results as getInstance(pInstancePath, pLocalOnly, pIncludeQualifiers, pIncludeClassOrigin, null)

        Parameters:
        pInstancePath - CIM instance path to the CIM instance to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM instance must exist.
        pLocalOnly - Allows to restrict the set of properties present in the returned instance. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        pIncludeQualifiers - If false, no qualifiers will be included. If true, all qualifiers of the instance will be included in the instance returned.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to retrieve qualifier information is to use the class operations (for example, getClass) instead, and to set this parameter to false.
        pIncludeClassOrigin - If true, class origin information will be present in the returned instance. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned instance.
        Returns:
        A CIMInstance object.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        getInstance(CIMObjectPath, boolean, boolean, boolean, String[])
      • getInstance

        public CIMInstance getInstance​(CIMObjectPath pInstancePath,
                                       boolean pLocalOnly,
                                       boolean pIncludeQualifiers,
                                       boolean pIncludeClassOrigin,
                                       java.lang.String[] pPropertyList)
                                throws CIMException
        Gets a copy of a CIM instance from the target CIM server.
        Parameters:
        pInstancePath - CIM instance path to the CIM instance to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM instance must exist.
        pLocalOnly - Allows to restrict the set of properties present in the returned instance. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted in a way that dependens on the CIM server implementation. When combined with other property restriction filters, all restrictions are accumulated.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. It is recommended that CIM client applications set pLocalOnly to false and not to rely on pLocalOnly filtering. To minimize the impact of implementing this recommendation in CIM client applications, a CIM server may choose to treat the value of pLocalOnly as false, regardless how it is actually set in an operation. Details: In DSP0200 V1.0, the pLocalOnly parameter was specified ambiguously. In DSP0200 V1.1, the definition of the pLocalOnly parameter was modified with the intent to clarify the ambiguity, so that it now restricted the set of properties to those of the specified class (removing any properties of its superclasses). This change introduced backward compatibility problems for CIM client applications when working with CIM servers that implemented pLocalOnly support with the (quite common) interpretation of the V1.0 definition that restricted the set of properties to those defined in the CIM class of each instance and its superclasses. In DSP0200 V1.2, a CIM server must consistently support a single interpretation of the pLocalOnly parameter, but which one is left open.
        pIncludeQualifiers - If false, no qualifiers will be included. If true, all qualifiers of the instance will be included in the instance returned.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to retrieve qualifier information is to use the class operations (for example, getClass) instead, and to set this parameter to false.
        pIncludeClassOrigin - If true, class origin information will be present in the returned instance. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned instance.
        pPropertyList - An array of CIM property names that allows to restrict the set of properties in the returned instance. If null, the set of properties will not be restricted by this parameter. If not null, the set of properties will be restricted such that any properties missing from this list will not be present in the returned instance. In this case, the members of the array must define zero or more property names of the specified instance. Duplicate property names are tolerated and the duplicates are ignored. When combined with other property restriction filters, all restrictions are accumulated.
        Returns:
        A CIMInstance object.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        CIMProperty.getOriginClass(), CIMMethod.getOriginClass()
      • createInstance

        public CIMObjectPath createInstance​(CIMObjectPath pNamespacePath,
                                            CIMInstance pNewInstance)
                                     throws CIMException
        Creates a CIM instance in the specified namespace on the target CIM server.

        The namespace must exist on the CIM server. The class of the CIM instance must exist in the namespace.

        Dependent on the semantics of the CIM class, this may result in also creating the real world resource represented by the CIM instance.

        Parameters:
        pNamespacePath - CIM namespace path of the CIM namespace. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. Must not be null.
        pNewInstance - CIM instance definition. Must be a valid instance definition for the underlying CIM class according to the CIM Infrastructure Specification [DSP0004]. The new instance definition specifies property values as follows: (1) Any property specified in newInstance must be a property of the class (including of its superclasses). If so, its value (including null) is used for the CIM instance to be created. (2) For any properties of the class not specified in newInstance, the default value defined in the class will be used. If no default value has been defined in the class, null is used. The CIM provider is free to override the rules above, for example in order to create key values dynamically. In any case, the new CIM instance in the target namespace will have exactly the properties of its class (that is, including those of any superclasses). Any class origin and propagated information in newInstance will be ignored (it is reconstructed by the CIM server). Any qualifiers included in newInstance may be ignored (it is recommended that CIM servers ignore them).
        Deprecation Note: The CIM Infrastructure Specification [DSP0004] V2.3 has deprecated instance level qualifiers. The preferred way to create or modify qualifier information is to use the class operations (for example, createClass) instead. Must not be null.
        Returns:
        A CIMObjectPath object referencing the newly created CIM instance using an intra-namespace instance path (model path). The instance path is returned in case one or more of the new keys of the instance are allocated dynamically during the creation process rather than used from newInstance.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_ALREADY_EXISTS
        CIM_ERR_FAILED
      • createQualifierType

        public void createQualifierType​(CIMObjectPath pNamespacePath,
                                        CIMQualifierType pQualifierType)
                                 throws CIMException
        Creates or replaces a CIM qualifier declaration on the target CIM server.

        TODO Proposal: Deprecate this method because there is no such CIM operation, and there is SetQualifierType() with the same semantics.

        If the qualifier declaration does not exist, it will be created. If it exists, it will be replaced.

        The CIM namespace must exist.

        Parameters:
        pNamespacePath - CIM namespace path. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. Must not be null. Also, the class attribute must not be null. TODO Proposal: It turns out the code ignores the class attribute, but requires it to be non-null. Remove this check.
        pQualifierType - CIM qualifier declaration. Must be a valid qualifier declaration according to the CIM Infrastructure Specification [DSP0004].
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
      • deleteQualifierType

        public void deleteQualifierType​(CIMObjectPath pQualifierPath)
                                 throws CIMException
        Deletes a CIM qualifier declaration on the target CIM server.

        Note that a CIM server is not obliged to verify whether the qualifier is still used in the namespace.

        The CIM qualifier declaration must exist.

        Parameters:
        pQualifierPath - CIM qualifier path (a class path used to specify the qualifier name in the class attribute). Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. Must not be null.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
      • getClass

        public CIMClass getClass​(CIMObjectPath pClassPath,
                                 boolean pLocalOnly)
                          throws CIMException
        Gets a copy of a CIM class from the target CIM server.

        This method produces the same results as getClass(pClassPath, pLocalOnly, true, false, null)

        Parameters:
        pClassPath - CIM class path to the CIM class to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pLocalOnly - Allows to restrict the set of properties present in the returned class. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted to those defined or overridden within the definition of the specified class. When combined with other property restriction filters, all restrictions are accumulated.
        Returns:
        A CIMClass object.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        getClass(CIMObjectPath, boolean, boolean, boolean, String[])
      • getClass

        public CIMClass getClass​(CIMObjectPath pClassPath,
                                 boolean pLocalOnly,
                                 boolean pIncludeQualifiers)
                          throws CIMException
        Gets a copy of a CIM class from the target CIM server.

        This method produces the same results as getClass(pClassPath, pLocalOnly, pIncludeQualifiers, false, null)

        Parameters:
        pClassPath - CIM class path to the CIM class to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pLocalOnly - Allows to restrict the set of properties present in the returned class. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted to those defined or overridden within the definition of the specified class. When combined with other property restriction filters, all restrictions are accumulated.
        pIncludeQualifiers - If false, no CIM qualifiers will be included. If true, all CIM qualifiers for the specified class (including qualifiers on the class and on any returned properties, methods or method parameters) will be included in the returned class.
        Returns:
        A CIMClass object.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        getClass(CIMObjectPath, boolean, boolean, boolean, String[])
      • getClass

        public CIMClass getClass​(CIMObjectPath pClassPath,
                                 boolean pLocalOnly,
                                 boolean pIncludeQualifiers,
                                 boolean pIncludeClassOrigin)
                          throws CIMException
        Gets a copy of a CIM class from the target CIM server.

        This method produces the same results as getClass(pClassPath, pLocalOnly, pIncludeQualifiers, pIncludeClassOrigin, null)

        Parameters:
        pClassPath - CIM class path to the CIM class to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pLocalOnly - Allows to restrict the set of properties present in the returned class. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted to those defined or overridden within the definition of the specified class. When combined with other property restriction filters, all restrictions are accumulated.
        pIncludeQualifiers - If false, no CIM qualifiers will be included. If true, all CIM qualifiers for the specified class (including qualifiers on the class and on any returned properties, methods or method parameters) will be included in the returned class.
        pIncludeClassOrigin - If true, class origin information will be present in the returned class. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned class.
        Returns:
        A CIMClass object.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        getClass(CIMObjectPath, boolean, boolean, boolean, String[])
      • getClass

        public CIMClass getClass​(CIMObjectPath pClassPath,
                                 boolean pLocalOnly,
                                 boolean pIncludeQualifiers,
                                 boolean pIncludeClassOrigin,
                                 java.lang.String[] pPropertyList)
                          throws CIMException
        Gets a copy of a CIM class from the target CIM server.
        Parameters:
        pClassPath - CIM class path to the CIM class to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist.
        pLocalOnly - Allows to restrict the set of properties present in the returned class. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted to those defined or overridden within the definition of the specified class. When combined with other property restriction filters, all restrictions are accumulated.
        pIncludeQualifiers - If false, no CIM qualifiers will be included. If true, all CIM qualifiers for the specified class (including qualifiers on the class and on any returned properties, methods or method parameters) will be included in the returned class.
        pIncludeClassOrigin - If true, class origin information will be present in the returned class. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned class.
        pPropertyList - An array of CIM property names that allows to restrict the set of properties in the returned class. If null, the set of properties will not be restricted by this parameter. If not null, the set of properties will be restricted such that any properties missing from this list will not be present in the returned class. In this case, the members of the array must define zero or more property names of the specified class. Duplicate property names are tolerated and the duplicates are ignored. When combined with other property restriction filters, all restrictions are accumulated.
        Returns:
        A CIMClass object.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        CIMProperty.getOriginClass(), CIMMethod.getOriginClass()
      • invokeMethod

        public CIMValue invokeMethod​(CIMObjectPath pObjectPath,
                                     java.lang.String pMethodName,
                                     java.util.Vector pInputArguments,
                                     java.util.Vector pOutputArguments)
                              throws CIMException
        Invokes the specified CIM method on a CIM object (instance or class) on the target CIM server.
        Parameters:
        pObjectPath - CIM object path to the CIM object (instance or class) on which the method is to be invoked. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM object must exist. If the CIM method is static, pObjectPath must reference a CIM class. If the CIM method is not static, pObjectPath must reference a CIM instance.
        pMethodName - Name of the CIM method to be invoked. The method must be defined on the class.
        pInputArguments - Input parameters of the CIM method, as a vector containing a CIMArgument member for each parameter. The set of parameters must match the CIM method definition for its input parameters. Must not be null. If a method has no input parameters, an empty vector must be supplied.
        pOutputArguments - Output parameters of the CIM method, as a vector containing a CIMArgument member for each parameter. The caller supplies an empty vector, and the set of parameters returned will match the CIM method definition for its output parameters. Must not be null. If a method has no output parameters, an empty vector will be returned.
        Returns:
        A CIMValue object representing the return value of the CIM method.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_NOT_FOUND
        CIM_ERR_METHOD_NOT_FOUND
        CIM_ERR_METHOD_NOT_AVAILABLE
        CIM_ERR_FAILED
      • invokeMethod

        public CIMValue invokeMethod​(CIMObjectPath pObjectPath,
                                     java.lang.String pMethodName,
                                     CIMArgument[] pInputArguments,
                                     CIMArgument[] pOutputArguments)
                              throws CIMException
        Deprecated.
        It is not recommended to use this method, since the number of output parameters may be extended by the CIM provider in the future. Instead, use invokeMethod(CIMObjectPath, String, Vector, Vector).
        Invokes the specified CIM method on a CIM object (instance or class) on the target CIM server.
        Parameters:
        pObjectPath - CIM object path to the CIM object (instance or class) on which the method is to be invoked. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM object must exist. If the CIM method is static, pObjectPath must reference a CIM class. If the CIM method is not static, pObjectPath must reference a CIM instance.
        pMethodName - Name of the CIM method to be invoked. The method must be defined on the class.
        pInputArguments - Input parameters of the CIM method, as a vector containing a CIMArgument member for each parameter. The set of parameters must match the CIM method definition for its input parameters. Must not be null. If a method has no input parameters, an empty vector must be supplied.
        pOutputArguments - Output parameters of the CIM method, as a vector containing a CIMArgument member for each parameter. The caller supplies an empty vector, and the set of parameters returned will match the CIM method definition for its output parameters. Must not be null. If a method has no output parameters, an empty vector will be returned.
        Returns:
        A CIMValue object representing the return value of the CIM method.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_NOT_FOUND
        CIM_ERR_METHOD_NOT_FOUND
        CIM_ERR_METHOD_NOT_AVAILABLE
        CIM_ERR_FAILED
      • addCIMListener

        public void addCIMListener​(CIMListener pListener)
                            throws CIMException
        Adds the specified CIMListener to start receiving indications from the CIM server.

        The CIMListener must differentiate itself from other CIMListener instances through the hashCode().

        TODO Clarify: CIMListener does not have a hashcode() method.
        Parameters:
        pListener - CIMListener to be added. Must not be null.
        Throws:
        java.lang.IllegalArgumentException - if the listener is null.
        CIMException - with one of these CIM status codes:
        CIM_ERR_FAILED
      • removeCIMListener

        public void removeCIMListener​(CIMListener pListener)
                               throws CIMException
        Removes the specified CIMListener, to stop receiving indications from the CIM server.
        Parameters:
        pListener - CIMListener to be added. Must not be null.
        Throws:
        java.lang.IllegalArgumentException - if the listener is null.
        CIMException - with one of these CIM status codes:
        CIM_ERR_FAILED
      • getIndicationListener

        public CIMInstance getIndicationListener​(CIMListener pListener)
                                          throws CIMException
        This methods return an instance of CIM_IndicationDestination, since CIM over HTTP is used as transport an instance of CIM_ListenerDestinationCIMXML is returned.

        TODO Docu: Improve documentation.

        Parameters:
        pListener - CIMListener for which the CIM_IndicationHandler subclass is being returned, which is used to deliver indications to the specific listener. Unique listeners should return unique values in their hashCode methods in order to be differenciate themself from other CIMListeners.
        Returns:
        CIMInstance an instance of the CIM_IndicationDestination
        Throws:
        java.lang.IllegalArgumentException - if the listener is null.
        CIMException - if unsuccessful, one of the error codes must be returned. CIM_ERR_ACCESS_DENIED CIM_ERR_INVALID_PARAMETER CIM_ERR_FAILED (some unspecified error) or the CIMListener server fails to load
      • getIndicationHandler

        public CIMInstance getIndicationHandler​(CIMListener pListener)
                                         throws CIMException
        This methods return an instance of CIM_IndicationHandler, since CIM over HTTP is used as transport an instance of CIM_IndicationHandlerCIMXML is returned.

        TODO Docu: Improve documentation.

        Parameters:
        pListener - CIMListener for which the CIM)IndicationHandler subclass is being returned, which is used to deliver indications to the specific listener. Unique listeners should return unique values in their hashCode methods in order to be differenciate themself from other CIMListeners.
        Returns:
        CIMInstance an CIM Instance of the indication handler.
        Throws:
        java.lang.IllegalArgumentException - if the listener is null.
        CIMException - if unsuccessful, one of the error codes must be returned. CIM_ERR_ACCESS_DENIED CIM_ERR_INVALID_PARAMETER CIM_ERR_FAILED (some unspecified error) or the CIMListener server fails to load
      • close

        public void close​(boolean pKeepEnumerations)
                   throws CIMException
        Closes the connection to the CIM server.
        Parameters:
        pKeepEnumerations - If true all open enumeration will be preserved, if false all enumerations are invalidated
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_FAILED
      • deleteNameSpace

        public void deleteNameSpace​(CIMNameSpace pNameSpace)
                             throws CIMException
        Deletes a CIM namespace from the target CIM server.
        Parameters:
        pNameSpace - CIM namespace to be deleted. The namespace attribute must be a valid namespace name according to the CIM Infrastructure Specification [DSP0004]. All other attributes are ignored. Must not be null. The namespace must exist on the target CIM server and must not contain any elements.
        Throws:
        java.lang.IllegalArgumentException - if a null namespace is passed as an argument
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_ALREADY_EXISTS
        CIM_ERR_FAILED
      • enumQualifierTypes

        public java.util.Enumeration enumQualifierTypes​(CIMObjectPath pNamespacePath)
                                                 throws CIMException
        Enumerates the CIM qualifier declarations in a namespace on the target CIM server.

        The namespace must exist.

        Parameters:
        pNamespacePath - CIM namespace path. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. Must not be null.
        Returns:
        A CIMEnumeration object containing zero or more CIMQualifierType objects.
        Throws:
        java.lang.IllegalArgumentException - if a null namespace is passed as an argument
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
      • enumClass

        public java.util.Enumeration enumClass​(CIMObjectPath pClassPath)
                                        throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.

        This method produces the same results as enumerateClasses(pClassPath, false, true, true, false)

        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        Returns:
        A CIMEnumeration object containing zero or more CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
      • enumClass

        public java.util.Enumeration enumClass​(CIMObjectPath pClassPath,
                                               boolean pDeepInheritance)
                                        throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.

        This method produces the same results as enumerateClasses(pClassPath, pDeepInheritance, true, true, false)

        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        pDeepInheritance - Controls the set of returned subclasses. If true, all subclasses of the specified class will be returned, down to the leaves of the class hierarchy. If false, only immediate subclasses of the specified class will be returned. Note that this definition of pDeepInheritance applies only to the methods for class enumeration and is different from its usage in the methods for instance enumeration.
        Returns:
        A CIMEnumeration object containing zero or more CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
      • enumClass

        public java.util.Enumeration enumClass​(CIMObjectPath pClassPath,
                                               boolean pDeepInheritance,
                                               boolean pLocalOnly)
                                        throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.

        This method produces the same results as enumerateClasses(pClassPath, pDeepInheritance, pLocalOnly, true, false)

        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        pDeepInheritance - Controls the set of returned subclasses. If true, all subclasses of the specified class will be returned, down to the leaves of the class hierarchy. If false, only immediate subclasses of the specified class will be returned. Note that this definition of pDeepInheritance applies only to the methods for class enumeration and is different from its usage in the methods for instance enumeration.
        pLocalOnly - Allows to restrict the set of properties present in the returned classes. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted to those defined or overridden within the definition of the specified class.
        Returns:
        A CIMEnumeration object containing zero or more CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
      • enumerateClasses

        public java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath)
                                               throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.

        This method produces the same results as enumerateClasses(pClassPath, false, true, true, false)

        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        Returns:
        A CIMEnumeration object containing zero or more CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
      • enumerateClasses

        public java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath,
                                                      boolean pDeepInheritance)
                                               throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.

        This method produces the same results as enumerateClasses(pClassPath, pDeepInheritance, true, true, false)

        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        pDeepInheritance - Controls the set of returned subclasses. If true, all subclasses of the specified class will be returned, down to the leaves of the class hierarchy. If false, only immediate subclasses of the specified class will be returned. Note that this definition of pDeepInheritance applies only to the methods for class enumeration and is different from its usage in the methods for instance enumeration.
        Returns:
        A CIMEnumeration object containing zero or more CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
      • enumerateClasses

        public java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath,
                                                      boolean pDeepInheritance,
                                                      boolean pLocalOnly)
                                               throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.

        This method produces the same results as enumerateClasses(pClassPath, pDeepInheritance, pLocalOnly, true, false)

        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        pDeepInheritance - Controls the set of returned subclasses. If true, all subclasses of the specified class will be returned, down to the leaves of the class hierarchy. If false, only immediate subclasses of the specified class will be returned. Note that this definition of pDeepInheritance applies only to the methods for class enumeration and is different from its usage in the methods for instance enumeration.
        pLocalOnly - Allows to restrict the set of properties present in the returned classes. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted to those defined or overridden within the definition of the specified class.
        Returns:
        A CIMEnumeration object containing zero or more CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
      • enumerateClasses

        public java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath,
                                                      boolean pDeepInheritance,
                                                      boolean pLocalOnly,
                                                      boolean pIncludeQualifiers)
                                               throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.

        This method produces the same results as enumerateClasses(pClassPath, pDeepInheritance, pLocalOnly, pIncludeQualifiers, false)

        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        pDeepInheritance - Controls the set of returned subclasses. If true, all subclasses of the specified class will be returned, down to the leaves of the class hierarchy. If false, only immediate subclasses of the specified class will be returned. Note that this definition of pDeepInheritance applies only to the methods for class enumeration and is different from its usage in the methods for instance enumeration.
        pLocalOnly - Allows to restrict the set of properties present in the returned classes. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted to those defined or overridden within the definition of the specified class.
        pIncludeQualifiers - If false, no CIM qualifiers will be included. If true, all CIM qualifiers for the specified class (including qualifiers on the class and on any returned properties, methods or method parameters) will be included in the returned classes.
        Returns:
        A CIMEnumeration object containing zero or more CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateClasses(CIMObjectPath, boolean, boolean, boolean, boolean)
      • enumerateClasses

        public java.util.Enumeration enumerateClasses​(CIMObjectPath pClassPath,
                                                      boolean pDeepInheritance,
                                                      boolean pLocalOnly,
                                                      boolean pIncludeQualifiers,
                                                      boolean pIncludeClassOrigin)
                                               throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns copies of these classes.
        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        pDeepInheritance - Controls the set of returned subclasses. If true, all subclasses of the specified class will be returned, down to the leaves of the class hierarchy. If false, only immediate subclasses of the specified class will be returned. Note that this definition of pDeepInheritance applies only to the methods for class enumeration and is different from its usage in the methods for instance enumeration.
        pLocalOnly - Allows to restrict the set of properties present in the returned classes. If false, the set of properties will not be restricted by this parameter. If true, the set of properties will be restricted to those defined or overridden within the definition of the specified class.
        pIncludeQualifiers - If false, no CIM qualifiers will be included. If true, all CIM qualifiers for the specified class (including qualifiers on the class and on any returned properties, methods or method parameters) will be included in the returned classes.
        pIncludeClassOrigin - If true, class origin information will be present in the returned classes. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned classes.
        Returns:
        A CIMEnumeration object containing zero or more CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        CIMProperty.getOriginClass(), CIMMethod.getOriginClass()
      • enumerateClassNames

        public java.util.Enumeration enumerateClassNames​(CIMObjectPath pClassPath)
                                                  throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns CIM class paths to these classes.

        This method produces the same results as enumerateClassNames(pClassPath, false)

        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        Returns:
        A CIMEnumeration object containing zero or more CIMObjectPath objects referencing the enumerated classes using intra-namespace CIM class paths (class names).
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
        See Also:
        enumerateClassNames(CIMObjectPath, boolean)
      • enumerateClassNames

        public java.util.Enumeration enumerateClassNames​(CIMObjectPath pClassPath,
                                                         boolean pDeepInheritance)
                                                  throws CIMException
        Enumerates the CIM classes on the target CIM server that are subclasses of the specified class, and returns CIM class paths to these classes.
        Parameters:
        pClassPath - CIM class path to the CIM class whose subclasses will be enumerated. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. If the classname attribute is an empty string, enumeration starts at the top of the class hierarchy, so that the immediate subclasses are the top level classes of the hierarchy. If the classname attribute is a valid class name, the class must exist in the namespace and enumeration starts at that class.
        pDeepInheritance - Controls the set of returned subclasses. If true, all subclasses of the specified class will be returned, down to the leaves of the class hierarchy. If false, only immediate subclasses of the specified class will be returned. Note that this definition of pDeepInheritance applies only to the methods for class enumeration and is different from its usage in the methods for instance enumeration.
        Returns:
        A CIMEnumeration object containing zero or more CIMObjectPath objects referencing the enumerated classes using intra-namespace CIM class paths (class names).
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
      • enumNameSpace

        public java.util.Enumeration enumNameSpace​(CIMObjectPath pNamespacePath,
                                                   boolean pDeep)
                                            throws CIMException
        Enumerates the CIM namespaces on the target CIM server, and returns CIM instance paths to the CIM_Namespace instances representing them. TODO Proposal: Deprecate this method and define a better one, since it is ill defined: (1) caller has to know the Interop namespace name (2) only instance paths are returned (3) the "deep" argument is not used
        Parameters:
        pNamespacePath - CIM namespace path of the namespace used to enumerate the CIM_NameSpace instances. The Interop namespace of a CIM server is supposed to support this. The name of the Interop namespace can be obtained by SLP discovery. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used.
        pDeep - Not used.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstancePath objects referencing the enumerated CIM_NameSpace instances using intra-namespace CIM instance paths (model paths).
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_FAILED
      • execQuery

        public java.util.Enumeration execQuery​(CIMObjectPath pNamespacePath,
                                               java.lang.String pQuery,
                                               java.lang.String pQueryLanguage)
                                        throws CIMException
        Executes a query on the target CIM server.
        Parameters:
        pNamespacePath - CIM namespace path of the namespace used to run the query against. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used.
        pQuery - Query in the specified query language.
        pQueryLanguage - Identifier for the query language. CIM clients can interrogate which query languages a CIM server supports, as described in the CIM Operations over HTTP specification [DSP0200] (4.5.2 "Determining CIM Server Capabilities through the HTTP Options"). Typical identifiers for query languages are:
        • CQL - CIM Query Language
        • WQL - WBEM Query Language
        Returns:
        An enumeration containing the query result
        Throws:
        CIMException
      • performBatchOperations

        public BatchResult performBatchOperations​(BatchHandle pBatchHandle)
                                           throws CIMException
        Performs the operations specified in the BatchHandle object.

        This is a multi-operation as specified in the CIM Operations over HTTP specification [DSP0200]. The operations are executed by the server one by one in the specified order. The next operation is started only once the previous operation has completed. It is not defined whether the CIM server stops processing the sequence upon any error encountered, or continues with the next operation in a "best effort" way of processing.

        Multi-operations do not guarantee any transactional capabilities. For example, there is no guarantee that the single operations either all fail or all succeed.

        Not all CIM servers support multi-operations. CIM client applications can figure out support for multi-operations as described in CIM Operations over HTTP specification [DSP0200] (4.5.2 "Determining CIM Server Capabilities through the HTTP Options").

        Parameters:
        pBatchHandle - Batch handle with the set of operations to be performed.
        Returns:
        A BatchResult object with the results of these operations.
        Throws:
        CIMException - with any one of the possible CIM status codes.
      • referenceNames

        public java.util.Enumeration referenceNames​(CIMObjectPath pObjectPath)
                                             throws CIMException
        Enumerates the CIM asociation objects on the target CIM server that reference a particular CIM object, and returns CIM object paths to these objects.

        This method produces the same results as referenceNames(pObjectPath, null, null)

        Parameters:
        pObjectPath - CIM object path to the CIM object (instance or class) referenced by the association objects to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The referenced CIM object must exist.
        Returns:
        A CIMEnumeration object containing zero or more CIMObjectPath objects referencing the enumerated association classes or instances using global CIM class or instance paths.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
        See Also:
        referenceNames(CIMObjectPath, String, String)
      • referenceNames

        public java.util.Enumeration referenceNames​(CIMObjectPath pObjectPath,
                                                    java.lang.String pResultClass,
                                                    java.lang.String pRole)
                                             throws CIMException
        Enumerates the CIM asociation objects on the target CIM server that reference a particular CIM object, and returns CIM object paths to these objects.

        If the referenced CIM object is an instance, then the association instances are enumerated. If the referenced CIM object is a class, then the association classes are enumerated.

        Parameters:
        pObjectPath - CIM object path to the CIM object (instance or class) referenced by the association objects to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The referenced CIM object must exist.
        pResultClass - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM association class name, and the set of objects will be restricted by removing any objects that do not satisfy the following conditions: (1) If the referenced CIM object is an instance, the enumerated objects are CIM instances of the specified class or one of its subclasses. (2) If the referenced CIM object is a class, the enumerated objects are the specified class or one of its subclasses. When combined with other object restriction filters, all restrictions are accumulated.
        pRole - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM property name, and the set of objects will be restricted by removing any objects that are not associations in which the referenced object plays the specified pRole (i.e. the name of the reference in the association class that refers to the referenced object must match the value of this parameter). When combined with other object restriction filters, all restrictions are accumulated.
        Returns:
        A CIMEnumeration object containing zero or more CIMObjectPath objects referencing the enumerated association classes or instances using global CIM class or instance paths.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
      • references

        public java.util.Enumeration references​(CIMObjectPath pObjectPath,
                                                java.lang.String pResultClass,
                                                java.lang.String pRole,
                                                boolean pIncludeQualifiers,
                                                boolean pIncludeClassOrigin,
                                                java.lang.String[] pPropertyList)
                                         throws CIMException
        Enumerates the CIM asociation objects on the target CIM server that reference a particular CIM object, and returns copies of these objects.

        If the referenced CIM object is an instance, then the association instances are enumerated. If the referenced CIM object is a class, then the association classes are enumerated.

        Parameters:
        pObjectPath - CIM object path to the CIM object (instance or class) referenced by the association objects to be returned. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The referenced CIM object must exist.
        pResultClass - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM association class name, and the set of objects will be restricted by removing any objects that do not satisfy the following conditions: (1) If the referenced CIM object is an instance, the enumerated objects are CIM instances of the specified class or one of its subclasses. (2) If the referenced CIM object is a class, the enumerated objects are the specified class or one of its subclasses. When combined with other object restriction filters, all restrictions are accumulated.
        pRole - Allows to restrict the set of returned objects. If null, the set of objects will not be restricted. If not null, must be a valid CIM property name, and the set of objects will be restricted by removing any objects that are not associations in which the referenced object plays the specified pRole (i.e. the name of the reference in the association class that refers to the referenced object must match the value of this parameter). When combined with other object restriction filters, all restrictions are accumulated.
        pIncludeQualifiers - If false, no qualifiers will be included. If true, all qualifiers for each object will be included in the objects returned.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to retrieve qualifier information is to use the class operations (for example, getClass) instead, and to set this parameter to false.
        pIncludeClassOrigin - If true, class origin information will be present in the returned objects. Class origin information indicates the class in which a CIM property, method, or reference was first defined in the class hierarchy. It can be retrieved from the Java objects representing these CIM elements by means of the getOriginClass() method. If false, class origin information will not be present in the returned objects.
        pPropertyList - An array of CIM property names that allows to restrict the set of properties in the returned objects (classes or instances). If null, the set of properties will not be restricted by this parameter. If not null, the set of properties will be restricted such that any properties missing from this list will not be present in the returned objects. In this case, the members of the array must define zero or more property names of the specified class. This may include inherited property names or property names explicitly defined in the specified class, but must not include property names defined in subclasses of the specified class. Duplicate property names are tolerated and the duplicates are ignored.
        Returns:
        A CIMEnumeration object containing zero or more CIMInstance or CIMClass objects.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
        See Also:
        CIMProperty.getOriginClass(), CIMMethod.getOriginClass(), CIMInstance, CIMClass
      • setClass

        public void setClass​(CIMObjectPath pClassPath,
                             CIMClass pModifiedClass)
                      throws CIMException
        Modifies a CIM class on the target CIM server.
        Parameters:
        pClassPath - CIM class path to the CIM class to be modified. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM class must exist. Must not be null.
        pModifiedClass - CIM class definition of the modified class. Must be a valid class definition according to the CIM Infrastructure Specification [DSP0004] and must not be null. The CIM server will behave as if the previous class definition was completely removed and re-created from the modified definition. If a superclass was defined on the previous class, the modified definition must observe the following restrictions: (1) The modified definition must not define a different superclass, and the superclass must exist. (2) Qualifiers with the DisableOverride flavor must not be defined in the modified definition. Any class origin and propagated information in modifiedClass will be ignored (it is reconstructed by the CIM server).
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_NOT_FOUND
        CIM_ERR_INVALID_SUPERCLASS
        CIM_ERR_CLASS_HAS_CHILDREN
        CIM_ERR_CLASS_HAS_INSTANCES
        CIM_ERR_FAILED
      • setInstance

        public void setInstance​(CIMObjectPath pInstancePath,
                                CIMInstance pModifiedInstance)
                         throws CIMException
        Modifies a CIM instance on the target CIM server.

        This method produces the same results as setInstance(pInstancePath, modifiedInstance, true, null)

        Parameters:
        pInstancePath - CIM instance path to the CIM instance to be modified. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM instance must exist. Must not be null.
        pModifiedInstance - CIM instance defining the new values for the properties. Must be a valid instance definition for the underlying CIM class according to the CIM Infrastructure Specification [DSP0004]. The instance may contain a subset of all properties. Any class origin and propagated information in modifiedInstance will be ignored (it is reconstructed by the CIM server). Any qualifiers included in modifiedInstance may be ignored (it is recommended that CIM servers ignore them).
        Deprecation Note: The CIM Infrastructure Specification [DSP0004] V2.3 has deprecated instance level qualifiers. The preferred way to modify qualifier information is to use the class operations (for example, setClass) instead. Must not be null.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
        See Also:
        setInstance(CIMObjectPath, CIMInstance, boolean, String[])
      • setInstance

        public void setInstance​(CIMObjectPath pInstancePath,
                                CIMInstance pModifiedInstance,
                                boolean pIncludeQualifiers,
                                java.lang.String[] pPropertyList)
                         throws CIMException
        Modifies a CIM instance on the target CIM server.

        The set of property values to be modified is determined by pPropertyList. Out of that set, the properties of the instance are attempted to be modified as follows:

        • For any properties contained in modifiedInstance, the value specified there will be used as the new value (this is true also for the null value).
        • For any properties not specified in modifiedInstance, the class defined default value will be used as the new value. If there is no class defined default value, null is used as the new value.
        Whether or not a modification attempt actually results in a changed property value in the instance on the CIM server depends on a number of factors:
        • If the property has its WRITE qualifier effectively being false, the modification request will be silently ignored. This is always the case for any key properties.
        • If the property value is dynamically created by a CIM provider (for instance, for volatile properties), the modification request may or may not be honored.

        Parameters:
        pInstancePath - CIM instance path to the CIM instance to be modified. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. The CIM instance must exist. Must not be null.
        pModifiedInstance - CIM instance defining the new values for the properties. Must be a valid instance definition for the underlying CIM class according to the CIM Infrastructure Specification [DSP0004]. The instance may contain a subset of all properties. Any class origin and propagated information in modifiedInstance will be ignored (it is reconstructed by the CIM server). Any qualifiers included in modifiedInstance may be ignored (it is recommended that CIM servers ignore them).
        Deprecation Note: The CIM Infrastructure Specification [DSP0004] V2.3 has deprecated instance level qualifiers. The preferred way to modify qualifier information is to use the class operations (for example, setClass) instead. Must not be null.
        pIncludeQualifiers - The behavior of this parameter is not specified. A CIM client application can not rely on it to have any impact on the operation. It is recommended that the CIM server ignore any qualifiers included in the modified instance.
        Deprecation Note: The CIM Operations over HTTP specification [DSP0200] V1.2 has deprecated this parameter. The preferred way to modify qualifier information is to use the class operations (for example, setClass) instead, and to set this parameter to false.
        pPropertyList - An array of CIM property names that allows to restrict the set of properties being modified. If null, the set of properties will not be restricted by this parameter. If not null, the set of properties will be restricted such that any properties missing from this list will not be modified. Duplicate property names are tolerated and the duplicates are ignored.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_INVALID_CLASS
        CIM_ERR_NOT_FOUND
        CIM_ERR_FAILED
      • setQualifierType

        public void setQualifierType​(CIMObjectPath pNamespacePath,
                                     CIMQualifierType pQualifierType)
                              throws CIMException
        Creates or replaces a CIM qualifier declaration on the target CIM server.

        If the qualifier declaration does not exist, it will be created. If it exists, it will be replaced.

        The CIM namespace must exist.

        Parameters:
        pNamespacePath - CIM namespace path. Must be an intra-server or intra-namespace object path within the target CIM server. In the latter case, the default namespace name is added to this parameter before being used. Must not be null. Also, the class attribute must not be null. TODO Proposal: It turns out the code ignores the class attribute, but requires it to be non-null. Remove this check.
        pQualifierType - CIM qualifier declaration. Must be a valid qualifier declaration according to the CIM Infrastructure Specification [DSP0004].
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_ACCESS_DENIED
        CIM_ERR_NOT_SUPPORTED
        CIM_ERR_INVALID_NAMESPACE
        CIM_ERR_INVALID_PARAMETER
        CIM_ERR_FAILED
      • useMPost

        public void useMPost​(boolean pValue)
        Control the use of HTTP MPost request.
        Parameters:
        pValue - If true, use the HTTP MPost request. Else, use the HTTP Post request.
      • useHttp11

        public void useHttp11​(boolean pValue)
        Control the use of HTTP 1.1.
        Parameters:
        pValue - If true, use HTTP 1.1. Else, use HTTP 1.0.
      • getNameSpace

        public CIMNameSpace getNameSpace()
        Gets the default CIM namespace associated with this CIM client.
        Returns:
        A CIMNameSpace object containing the default namespace in its namespace attribute.
      • setLocale

        public void setLocale​(java.util.Locale pLocale)
        Modifies the locale information of the CIM client.

        The locale information of the CIM client is used to construct the Content-Language and Accept-Language HTTP headers. The CIM server uses these headers to translate any translatable property and qualifier values, and any localized messages.

        Parameters:
        pLocale - The new locale information. Must not be null.
        Throws:
        CIMException - with one of these CIM status codes:
        CIM_ERR_INVALID_PARAMETER
      • getLocale

        public java.util.Locale getLocale()
        Gets the current locale information of the CIM client. The initial locale information (that is, without any invocations of setLocale) is the value Locale.getDefault().
        Returns:
        Current locale information.
      • getSessionProperties

        public SessionProperties getSessionProperties()
        Gets the session properties of the CIM client. If this CIM client is associated with the global properties this method returns null
        Returns:
        The session properties
      • setSessionProperties

        public void setSessionProperties​(SessionProperties pProperties)
        Sets the session properties for the CIM client.
        Parameters:
        pProperties - The session properties