test

Solaris WBEM SDK Developer's Guide

List of Error Messages

This section describes the WBEM error messages, sorted by unique identifier.


ABSTRACT_INSTANCE

Description:

This error message uses one parameter, {0}, which is replaced by the name of the abstract class.

Cause:

A create instance was attempted for the instance. However, the specified class is an abstract class, and abstract classes cannot have instances.

Solution:

Create instances for concrete classes.


CANNOT_ASSUME_ROLE

Description:

This error message uses two parameters:

  • {0} is replaced by the user name.

  • {1} is replaced by the role name.

Cause:

The specified principal cannot assume the specified role.

Solution:

Make sure that the user has the appropriate rights to assume the given role. If the user does not have the appropriate rights, contact your system administrator.


CHECKSUM_ERROR

Description:

This error message does not use parameters.

Cause:

The message could not be sent because it was damaged or corrupted. The damage could have occurred accidentally in transit or by a malicious third party.

Note -

This error message is displayed when the CIM Object Manager receives an invalid checksum. A checksum is the number of bits in a packet of data passed over the network. This number is used by the sender and the receiver of the information to ensure that the transmission is secure and that the data has not been corrupted or intentionally modified during transit.

An algorithm is run on the data before transmission. Then the checksum is generated and included with the data to indicate the size of the data packet. When the message is received, the receiver can recompute the checksum and compare it to the sender's checksum. If the checksums match, the transmission was secure and the data was not corrupted or modified.

Solution:

Resend the message using Solaris WBEM Services security features. For information about Solaris WBEM Services security, see "Administering Security" in the Solaris WBEM Services Administration Guide.


CIM_ERR_ACCESS_DENIED

Description:

This error message does not use parameters.

Cause:

This error message is displayed when a user does not have the appropriate privileges and permissions to complete an action.

Solution:

See your system administrator or the person who is responsible for your CIM Object Manager to request privileges to complete the operation.


CIM_ERR_ALREADY_EXISTS

Instance 1: CIM_ERR_ALREADY_EXISTS

Description:

This instance uses one parameter, {0}, which is replaced by the name of the duplicate class.

Cause:

The class you attempted to create uses the same name as an existing class.

Solution:

In CIM WorkShop, search for existing classes to see the class names that are in use. Then create the class by using a unique class name.

Instance 2: CIM_ERR_ALREADY_EXISTS

Description:

This instance uses one parameter, {0}, which is replaced by the name of the duplicate instance.

Cause:

The instance for a class you attempted to create uses the same name as an existing instance.

Solution:

In CIM WorkShop, search for existing instances to see the names that are in use. Then create the instance by using a unique name.

Instance 3: CIM_ERR_ALREADY_EXISTS

Description:

This instance uses one parameter, {0}, which is replaced by the name of the duplicate namespace.

Cause:

The namespace you attempted to create uses the same name as an existing namespace.

Solution:

In CIM WorkShop, search for existing namespaces to see the names that are in use. Then create the namespace by using a unique name.

Instance 4: CIM_ERR_ALREADY_EXISTS

Description:

This instance uses one parameter, {0}, which is replaced by the name of the duplicate qualifier type.

Cause:

The qualifier type you attempted to create uses the same name as an existing qualifier type of the property it modifies.

Solution:

In CIM WorkShop, search for qualifier types that exist for the property to see the names that are in use. Then create the qualifier type by using a unique name.


CIM_ERR_CLASS_HAS_CHILDREN

Description:

This error message uses one parameter, {0}, which is replaced by the class name.

Cause:

This exception is thrown by the CIM Object Manager to disallow invalidation of the subclasses by a super class deletion. Clients must explicitly delete the subclasses first. The check for subclasses is made before the check for class instances.

Solution:

Remove the subclasses of the given class.


CIM_ERR_CLASS_HAS_INSTANCES

Description:

This error message uses one parameter, {0}, which is replaced by the class name.

Cause:

This exception is thrown if you attempt to delete a class that has instances.

Solution:

Remove the instances of the given class.


CIM_ERR_FAILED

Description:

This error message uses one parameter, {0}, which is replaced by a message that explains the error condition and its possible cause.

Cause:

This error message is generic and can be displayed for many different error conditions.

Solution:

The solution varies depending on the error condition.


CIM_ERR_INVALID_PARAMETER

Description:

This error message uses one parameter, {0}, which is replaced by the name of the invalid parameter.

Cause:

The name of the parameter or the method is invalid.

Solution:

Fix the parameter.


CIM_ERR_INVALID_QUERY

Description:

This error message uses two parameters:

  • {0} is replaced by the invalid part of the query.

  • {1} is replaced by additional information, including the actual error in the query.

Cause:

The given query either has syntactical errors or semantic errors.

Solution:

Fix the errors based on the exception details. In addition, make sure that the query string and query language match.


CIM_ERR_INVALID_SUPERCLASS

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the specified subclass.

  • {1} is replaced by the name of the class for which a specified subclass does not exist.

Cause:

A class is specified to belong to a subclass from a superclass, but the superclass does not exist. The specified superclass might be misspelled, or a non-existent superclass name might have been specified in place of the intended superclass name. Or, the superclass and the subclass might have been interpolated. That is, the specified superclass may be a subclass of the subclass. In the previous example, CIM_Chassis is specified as the superclass of CIM_Container, but CIM_Chassis is a subclass of CIM_Container.

Solution:

Check the spelling and the name of the superclass to ensure that it is correct. Ensure that the superclass exists in the namespace.


CIM_ERR_LOW_ON_MEMORY

Description:

This error message does not use parameters.

Cause:

The CIM Object Manager is low on memory.

Solution:

Delete some class definitions and static instances to free up memory.


CIM_ERR_NOT_FOUND

Instance 1: CIM_ERR_NOT_FOUND

Description:

This instance uses one parameter, {0}, which is replaced by the name of the non-existent class.

Cause:

A class is specified, but it does not exist. The specified class might be misspelled, or a non-existent class name might have been accidentally specified in place of the intended class name.

Solution:

Check the spelling and the name of the class to ensure that it is correct. Ensure that the class exists in the namespace.

Instance 2: CIM_ERR_NOT_FOUND

Description:

This instance uses two parameters:

  • {0} is replaced by the name of the specified instance.

  • {1} is replaced by the name of the specified class.

Cause:

The instance does not exist.

Solution:

Create the instance.

Instance 3: CIM_ERR_NOT_FOUND

Description:

This instance uses one parameter, {0}, the name of the specified namespace.

Cause:

The specified namespace is not found. This error can occur if the name of the namespace was entered incorrectly due to a typing error or spelling mistake.

Solution:

Retype the name of the namespace. Ensure that you type and spell the namespace correctly.


CIM_ERR_QUERY_LANGUAGE_NOT_SUPPORTED

Description:

This error message uses one parameter, {0}, which is replaced by the invalid query language string.

Cause:

The requested query language is not recognized by CIM.

Solution:

Provide a supported query language.


CLASS_REFERENCE

Description:

This error message uses two parameters:

  • {0} parameter is replaced by the name of the class that was defined to participate in a reference.

  • {1} parameter is replaced by the name of the reference.

Cause:

A property was defined for a class to indicate that the class has a reference. However, the class is not an association. A class can only have a reference as a property if it is an association.

Solution:

Add the association qualifier or remove the reference.


INVALID_DATA

Description:

This error message does not use parameters.

Cause:

The security authenticator data is invalid or is not consistent with the security mechanism you are using.

Solution:

Make sure that your security modules are configured correctly.


INVALID_CREDENTIAL

Description:

This error message does not use parameters.

Cause:

This error message is displayed when you enter an invalid password, or if your CLASSPATH is not set up to include authentication checks for client applications.

Solution:

  • Use the correct password.

  • Make sure your CLASSPATH contains the following: /usr/sadm/lib/wbem/extension:/usr/sadm/lib/wbem/sunwbem.jar


INVALID_QUALIFIER_NAME

Description:

This error message uses one parameter, {0}, which is replaced by the MOF notation that depicts an empty qualifier name.

Cause:

A qualifier was created for a property, but a qualifier name was not specified.

Solution:

Include the qualifier name.


KEY_OVERRIDE

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the nonabstract class that is in an override relationship with a class that has one or more key qualifiers.

  • {1} is replaced by the name of the concrete class that has the key qualifier.

Cause:

A nonabstract class, referred to as a concrete class, is put into an override relationship with a concrete class that has one or more key qualifiers. In CIM, all concrete classes require at least one key qualifier, and a non-key class cannot override a class that has a key.

Solution:

Create a key qualifier for the non-key class.


KEY_REQUIRED

Description:

This error message uses one parameter, {0}, which is replaced by the name of the class that requires a key.

Cause:

A key qualifier was not provided for a concrete class. In CIM, all non-abstract classes, referred to as concrete classes, require at least one key qualifier.

Solution:

Create a key qualifier for the class.


METHOD_OVERRIDDEN

Description:

This error message uses three parameters:

  • {0} is replaced by the name of the method that is trying to override the method represented by parameter {1}.

  • {1} is replaced by the name of the method that has already been overridden by the method represented by parameter {2}.

  • {2} is replaced by the name of the method that has overridden parameter {1}.

Cause:

A method is specified to override another method that has already been overridden by a third method. Once a method has been overridden, it cannot be overridden again.

Solution:

Specify a different method to override.


NEW_KEY

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the key.

  • {1} is replaced by the name of the class that is trying to define a new key.

Cause:

A class is trying to define a new key when keys already have been defined in a superclass. Once keys have been defined in a superclass, new keys cannot be introduced into the subclasses.

Solution:

Do not define a new key.


NO_CIMOM

Description:

This error message uses one parameter, {0}, which is replaced by the name of the host that is expected to be running the CIM Object Manager.

Cause:

The CIM Object Manager is not running on the specified host.

Solution:

Ensure that the CIM Object Manager is running on the host to which you are trying to connect. If the CIM Object Manager is not running on that host, connect to a host running the CIM Object Manager.


NO_EVENT_PROVIDER

Description:

An event provider cannot be found.

Cause:

The property provider class is not found.

Solution:

Ensure that the class path of the CIM Object Manager contains the provider class parameters, the indication class for which the provider is being defined, and the name of the Java provider class. Ensure that the CIM Object Manager Solaris provider is set and the provider qualifier is correct.


NOT_EVENT_PROVIDER

Description:

This error message does not use parameters.

Cause:

The provider class present in the class path does not implement the EventProvider interface.

Solution:

Ensure that the provider is correct and register the provider implements.


NO_INSTANCE_PROVIDER

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the class for which the instance provider cannot be found.

  • {1} is replaced by the name of the instance provider class that was specified.

Cause:

The Java class of the specified instance provider is not found. This error message indicates that the class path of the CIM Object Manager is missing one or more of the following:

  • Name of the provider class

  • Parameters of the provider class

  • CIM class for which the provider is defined

Solution:

Set the CIM Object Manager environment variable. Ensure that the CIM Object Manager Solaris provider is set and the provider qualifier is correct.


NO_METHOD_PROVIDER

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the class for which the method provider cannot be found.

  • {1} is replaced by the name of the method provider class that was specified.

Cause:

The Java class of the specified method provider is not found. This error message indicates that the class path of the CIM Object Manager is missing one or more of the following:

  • Name of the provider class

  • Parameters of the provider class

  • CIM class for which the provider is defined

Solution:

Set the CIM Object Manager class path. Ensure that the CIM Object Manager Solaris Provider is set and the provider qualifier is correct.


NO_OVERRIDDEN_METHOD

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the method that has overridden the method represented by {1}.

  • {1} is replaced by the name of the method that has been overridden.

Cause:

The method of a subclass is trying to override the method of the superclass. However, the method that you are trying to override does not exist in the class hierarchy because it has not been defined.

When you override a method, you override its implementation and its signature.

Solution:

Ensure that the method exists in the superclass.


NO_OVERRIDDEN_PROPERTY

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the property that has overridden {1}.

  • {1} is replaced by the name of the overriding property.

Cause:

The property of a subclass is trying to override the property of the superclass. However, the property that you are trying to override does not exist in the class hierarchy because it has not been defined.

Solution:

Ensure that the property exists in the superclass.


NO_PROPERTY_PROVIDER

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the class for which the property provider cannot be found.

  • {1} is replaced by the name of the property provider class that was specified.

Cause:

The Java class of the specified property provider is not found. This error message indicates that the class path of the CIM Object Manager is missing one or more of the following:

  • Name of the provider class

  • Parameters of the provider class

  • CIM class for which the provider is defined

Solution:

Set the CIM Object Manager class path. Ensue that the CIM Object Manager is running on the host to which you are trying to connect. If the CIM Object Manager is not running on that host, connect to a host running the CIM Object Manager.


NO_QUALIFIER_VALUE

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the qualifier that modifies the element {1}.

  • {1} is the element to which the qualifier refers. Depending on the qualifier, {1} can be a class, property, method, or reference.

Cause:

A qualifier was specified for a property or method, but values were not included for the qualifier. For example, the qualifier VALUES requires a string array to be specified. If the VALUES qualifier is specified without the required string array, the NO_QUALIFIER_VALUE error message is displayed.

Solution:

Specify the required parameters for the qualifier. For information about what attributes are required for which qualifiers, see the DMTF CIM Specification at http://www.dmtf.org.


NO_SUCH_METHOD

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the specified method.

  • {1} is replaced by the name of the specified class.

Cause:

Most likely, the method was not defined for the specified class. If the method is defined for the specified class, another method name might have been misspelled or typed differently in the definition.

Solution:

Define the method for the specified class. Ensure that the method name and the class name are spelled correctly.


NO_SUCH_PRINCIPAL

Description:

This error message uses one parameter, {0}, which is replaced by the name of the principal, a user account.

Cause:

The specified user account cannot be found. The user name might have been misspelled, or a the user does not have a user account.

Solution:

Ensure that the user name is spelled and typed correctly upon login. Ensure that the user has a user account.


NO_SUCH_QUALIFIER1

Description:

This error message uses one parameter, {0}, which is replaced by the name of the undefined qualifier.

Cause:

A new qualifier was specified but it was not defined as part of the extension schema. The qualifier must be defined as part of the CIM Schema or part of an extension schema to be recognized as a valid qualifier for a property or method of a particular class.

Solution:

Define the qualifier as part of the extension schema, or use a standard CIM qualifier. For information about standard CIM qualifiers and the usage of qualifiers in the CIM Schema, see the DMTF CIM Specification at: http://www.dmtf.org.


NO_SUCH_QUALIFIER2

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the class, property, or method that the qualifier modifies.

  • {1} is replaced by the name of the qualifier that cannot be found.

Cause:

A new qualifier was specified to modify a property or method of a particular class. The qualifier was not defined as part of the extension schema. The qualifier must be defined as part of the CIM Schema or part of an extension schema to be recognized as a valid qualifier for a property or method of a particular class.

Solution:

Define the qualifier as part of the extension schema or use a standard CIM qualifier. For information about standard CIM qualifiers and the usage of qualifiers in the CIM schema, see the DMTF CIM Specification at: http://www.dmtf.org.


NO_SUCH_ROLE

Description:

This error message uses one parameter, {0}, which is replaced by the role name.

Cause:

The specified role cannot be found or is not a role identity.

Solution:

Make sure that the input role exists. If the role is required, contact your system administrator to set up the role.


NO_SUCH_SESSION

Description:

This error message uses one parameter, {0}, which is replaced by the session identifier.

Cause:

The session has been closed and is being used subsequently.

Solution:

Do not close the session.


NOT_HELLO

Description:

This error message does not use parameters.

Cause:

This error message is displayed if the data in the hello message, the first message sent to the CIM Object Manager, is corrupted.

Solution:

No action is available in response to this error message. For information about Solaris WBEM Services security features, see "Administering Security" in the Solaris WBEM Services Administration Guide.


NOT_INSTANCE_PROVIDER

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the instance for which the InstanceProvider interface is being defined.

  • {1} is replaced by the name of the Java provider class that does not implement the InstanceProvider interface. The InstanceProvider interface must be implemented to enumerate all instances of the specified class.

Cause:

The path to the Java provider class specified by the CLASSPATH environment variable does not implement the InstanceProvider interface.

Solution:

Ensure that the provider is correct and register the provider implements.


NOT_METHOD_PROVIDER

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the method for which the MethodProvider interface is being defined. The MethodProvider interface causes a specified method to be implemented in a program and enacted.

  • {1} is replaced by the name of the Java provider class that does not implement the MethodProvider interface.

Cause:

The Java provider class present in the class path does not implement the MethodProvider interface.

Solution:

Ensure that the Java provider class present in the class path implements the MethodProvider interface. Use the following command when you declare the provider: public Solaris implements MethodProvider.


NOT_PROPERTY_PROVIDER

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the method for which the PropertyProvider interface is being defined. The PropertyProvider interface is required to retrieve the values of the specified property.

  • {1} is replaced by the name of the Java provider class that does not implement the PropertyProvider interface.

Cause:

The Java provider class present in the class path does not implement the PropertyProvider interface.

Solution:

Ensure that the Java provider class present in the class path implements the PropertyProvider interface. Use the following command when you declare the provider: public Solaris implements PropertyProvider.


NOT_RESPONSE

Description:

This error message does not use parameters.

Cause:

This error message is displayed when the data in a first response message from the CIM Object Manager is corrupted.

Solution:

No action is available in response to this error message. For information about Solaris WBEM Services security features, see "Administering Security" in the Solaris WBEM Services Administration Guide.


PROPERTY_OVERRIDDEN

Description:

This error message uses three parameters:

  • {0} is replaced by the name of the property that is trying to override the property represented by parameter {1}.

  • {1} is replaced by the name of the property that already has been overridden.

  • {2} is replaced by the name of the property that has overridden the property represented by parameter {1}.

Cause:

A property is specified to override another method that has already been overridden by a third method. Once a property has been overridden, it cannot be overridden again.

Solution:

Specify a different property to override.


QUALIFIER_UNOVERRIDABLE

Description:

This error message uses two parameters:

  • {0} is replaced by the name of the qualifier with the DisableOverride flavor.

  • {1} is replaced by the name of the qualifier that is disabled by {0}.

Cause:

The qualifier that is being overridden has the DisableOverride flavor.

Solution:

Reset the ability of the qualifier to EnableOverride or to Override=True.


REF_REQUIRED

Description:

This error message uses one parameter, {0}, which is replaced by the name of the class.

Cause:

A class was defined to participate in an association, but no references were cited. The rules of the Common Information Model specify that an association must contain one or more references.

Solution:

Add references or remove the association qualifier.


SCOPE_ERROR

Description:

This error message uses three parameters:

  • {0} is replaced by the name of the class the specified qualifier modifies.

  • {1} is replaced by the name of the specified qualifier.

  • {2} is replaced by the type of attribute that the qualifier modifies.

Cause:

A qualifier was specified in a manner that conflicts with the qualifier type definition. The scope of the [READ] qualifier is the definition that directs the [READ] qualifier to modify a property. If the [READ] qualifier is used in a manner other than the direction of its scope, for example, if the [READ] qualifier is specified to modify a method, the SCOPE_ERROR message is returned.

Note -

The Common Information Model (CIM) Specification defines the types of CIM elements that a CIM qualifier can modify. This definition of the way in which a qualifier can be used is referred to as its scope. Most qualifiers, by definition, have a scope that directs them to modify properties or methods or both. Many qualifiers have a scope that directs them to modify parameters, classes, associations, indications, or schemas.

Solution:

Confirm the scope of the specified qualifier. Refer to the Qualifiers section of the DMTF CIM Specification at:http://www.dmtf.org for the standard definitions of CIM qualifiers. Use a different qualifier for the results you want to achieve, or change your program to use the qualifier according to its CIM definition.


TYPE_ERROR

Description:

This error message uses five parameters:

  • {0} is replaced by the name of the specified element, such as a property, method, or qualifier.

  • {1} is replaced by the name of the class to which the specified element belongs.

  • {2} is replaced by the type defined for the element.

  • {3} is replaced by the type of value assigned.

  • {4} is replaced by the actual value assigned.

Cause:

The value of a property parameter or method parameter and its defined type are mismatched.

Solution:

Match the value of the property or method with its defined type.


UNKNOWNHOST

Description:

This error message uses one parameter, {0}, which is replaced by the name of the host.

Cause:

A call was made to a specified host. The specified host is unavailable or cannot be located. It is possible that the host name was misspelled, the host computer was moved to a different domain, the host name has not been registered in the list of hosts that belong to the domain, or the host is temporarily unavailable due to system conditions.

Solution:

Check the spelling of the host name. Use the ping command to ensure that the host computer is responding. Check the system conditions of the host. Ensure that the host belongs to the specified domain.


VER_ERROR

Description:

This error message uses one parameter, {0}, which is replaced by the version number of the running CIM Object Manager.

Cause:

The CIM Object Manager does not support the version of the client that is trying to connect to it.

Solution:

Install the appropriate version.