ORB (CORBA) Related Minor Codes and Their Meanings

Resolving The Problem

This document provides explanations of the minor error codes used by the IBM WebSphere Application Server Advanced Edition Java ORB. These minor codes are not CORBA-compliant. CORBA-compliant minor codes usually begin with an OMG-assigned identification code that consists of the vendor ID followed by digits that identify the minor code. However, the Java ORB minor codes do not contain the vendor ID.

Minor codes are associated with CORBA exceptions and provide greater detail about the errors that can occur. There is not a one-to-one mapping of exception names to minor codes. Rather, a minor code can be associated with several exception names. A minor code message can have different meanings depending on the exception that was thrown. Minor codes are scoped to System Exceptions in the range 0 to 4095. A minor code ID must be a unique number within the scope for each System Exception; however, there is no restriction that minor codes be unique across all System Exceptions. The following lists the System Exceptions and the corresponding minor error codes, where:

Minor code: The minor error code
Static variable: The name of the static variable for the minor error code
Explanation: A description of the problem that caused the error
User response: Actions to resolve the problem

org.omg.CORBA.BAD_PARAM

Minor code: 1
Static variable: com.sun.rmi.util.MinorCodes.NULL_PARAM
Explanation: A parameter with a value of NULL was received. The parameter is not valid.
User response: Ensure that parameters are initialized correctly.

org.omg.CORBA.COMM_FAILURE

Minor code: 1
Static variable: com.sun.rmi.util.MinorCodes.CONNECT_FAILURE
Explanation: The ORB could not establish a connection to the server on the host and port that was identified by the object reference.
User response: Ensure that the server is running and listening on the designated host and port.

Minor code: 2
Static variable: com.sun.rmi.util.MinorCodes.CONN_CLOSE_REBIND
Explanation: A client request could not be processed, because the server had notified the client to close the connection and a new connection could not be established.
User response: Ensure that the server is running and try the request again.

Minor code: 3
Static variable: com.sun.rmi.util.MinorCodes.WRITE_ERROR_SEND
Explanation: An error was encountered while writing the request to the output stream.

Minor code: 4
Static variable: com.sun.rmi.util.MinorCodes.GET_PROPERTIES_ERROR
Explanation: An exception was encountered while reading the initial services from a URL.
User response: Ensure that the initial services URL is valid.

Minor code: 6
Static variable: com.sun.rmi.util.MinorCodes.INVOKE_ERROR
Explanation: The ORB was unable to successfully connect to the server after several attempts.
User response: Ensure that the server is running.

org.omg.CORBA.DATA_CONVERSION

Minor code: 1
Static variable: com.sun.rmi.util.MinorCodes.BAD_HEX_DIGIT
Explanation: The object reference in string format contains at least one hexadecimal character that is not valid.
User response: Obtain the original object reference and reformat it as a string using the object_to_string method on the ORB.

Minor code: 2
Static variable: com.sun.rmi.util.MinorCodes.BAD_STRINGIFIED_IOR_LEN
Explanation: The length of the string-formatted object reference is not valid.
User response: Obtain the original object reference and reformat it as a string using the object_to_string method on the ORB.

Minor code: 3
Static variable: com.sun.rmi.util.MinorCodes.BAD_STRINGIFIED_IOR
Explanation: The string-formatted object reference is not valid.
User response: Obtain the original object reference and reformat it as a string using the object_to_string method on the ORB.

Minor code: 4
Static variable: com.sun.rmi.util.MinorCodes.BAD_MODIFIER
Explanation: The initial reference could not be resolved, because the host or the port is not valid or was not specified.
User response: Specify the correct host and port.

Minor code: 5
Static variable: com.sun.rmi.util.MinorCodes.CODESET_INCOMPATIBLE
Explanation: While processing the service context code sets for a request, an incompatible code set was encountered.

org.omg.CORBA.INTERNAL

Minor code: 8
Static variable: com.sun.rmi.util.MinorCodes.CREATE_LISTENER_FAILED
Explanation: The ORB could not establish a listener thread on the port identified by the object reference. The port was already in use or there was an error in creating the daemon thread.

Minor code: 9
Static variable: com.sun.rmi.util.MinorCodes.BAD_LOCATE_REQUEST_STATUS
Explanation: The locator performed a locate request for an object reference and returned a locate reply with a status that is not valid.

Minor code: 10
Static variable: com.sun.rmi.util.MinorCodes.STRINGIFY_WRITE_ERROR
Explanation: An exception was encountered while attempting to create a string-formatted object reference.

org.omg.CORBA.INV_OBJREF

Minor code: 1
Static variable: com.sun.rmi.util.MinorCodes.NO_PROFILE_PRESENT
Explanation: The object reference does not contain a profile.
User response: The current object reference is not valid. Obtain a valid object reference from the object supplier.

Minor code: 2
Static variable: com.sun.rmi.util.MinorCodes.BAD_CODE_SET
Explanation: An unsupported code set or a code set that is not valid was used to write the data to the input stream.
User response: Use a Unicode or ASCII code set.

org.omg.CORBA.MARSHAL

Minor code: 4
Static variable: com.sun.rmi.util.MinorCodes.READ_OBJECT_EXCEPTION
Explanation: An error was encountered while trying to read and convert a marshaled object reference into an in-memory object.
User response: Ensure that the object (passed as a parameter) is in one of the locations identified by the system CLASSPATH environment variable.

Minor code: 6
Static variable: com.sun.rmi.util.MinorCodes.CHARACTER_OUTOFRANGE
Explanation: While marshaling or unmarshaling an object, a character that is not compliant with ISO Latin-1 (8859.1) was encountered. The character is not in the range 0 to 255.

org.omg.CORBA.NO_IMPLEMENT

Minor code: 2
Static variable: com.sun.rmi.util.MinorCodes.GETINTERFACE_NOT_IMPLEMENTED
Explanation: The get_interface method is not implemented on the server.

Minor code: 3
Static variable: com.sun.rmi.util.MinorCodes.SEND_DEFERRED_NOTIMPLEMENTED
Explanation: Deferred sends are not supported by the ORB.

org.omg.CORBA.OBJ_ADAPTER

Minor code: 1
Static variable: com.sun.rmi.util.MinorCodes.NO_SERVER_SC_IN_DISPATCH
Explanation: The object reference could not be dispatched to the server, because an object adapter that matches the object key could not be found.
User response: Ensure that the object server still services the requested object.

Minor code: 2
Static variable: com.sun.rmi.util.MinorCodes.NO_SERVER_SC_IN_LOOKUP
Explanation: The requested object could not be located, because an object adapter that matches the adapter that matches the object key could not be found.
User response: Ensure the object server that processes the locate requests still services the requested object.

Minor code: 3
Static variable: com.sun.rmi.util.MinorCodes.NO_SERVER_SC_IN_CREATE_DEFAULT_SERVER
Explanation: The ORB was unable to create the default object adapter for an object in the server that processes the actual method call.

Minor code: 4
Static variable: com.sun.rmi.util.MinorCodes.ORB_CONNECT_ERROR
Explanation: An error was encountered while trying to connect to an object in the server that processes the actual method call.

org.omg.CORBA.OBJECT_NOT_EXIST

Minor code: 1
Static variable: com.sun.rmi.util.MinorCodes.LOCATE_UNKNOWN_OBJECT
Explanation: A locate request was performed and the response indicated that the object is not known to the locator.
User response: Ensure that the locator that processes the locate requests still services the requested object.

Minor code: 2
Static variable: com.sun.rmi.util.MinorCodes.BAD_SERVER_ID
Explanation: The server ID of the server that received the request does not match the server ID of the request object reference. The server that originally served the object is no longer identified by that server ID.
User response: Obtain a new object reference for the object from the server that is now servicing that object.

Minor code: 3
Static variable: com.sun.rmi.util.MinorCodes.BAD_IMPLID
Explanation: The implementation ID (identified by the object reference) does not match any implementation on the server.
User response: Obtain a new object reference for the object from the server that is now servicing that object.

Minor code: 4
Static variable: com.sun.rmi.util.MinorCodes.BAD_SKELETON
Explanation: A skeleton that matches the object reference (identified by the object key) could not be found on the server.

Minor code: 5
Static variable: com.sun.rmi.util.MinorCodes.SERVANT_NOT_FOUND
Explanation: The object adapter identified by the object key within the object reference could not locate the servant (an object on the server) to process the object request.
User response: Ensure that the servant is known to the object adapter.

org.omg.CORBA.UNKNOWN

Minor code: 1
Static variable: com.sun.rmi.util.MinorCodes.UNKNOWN_CORBA_EXC
Explanation: The server threw an unknown user exception.
User response: Ensure that all user exceptions that can be thrown are declared on the throws clause of the method.

Minor code: 3
Static variable: com.sun.rmi.util.MinorCodes.RUNTIMEEXCEPTION
Explanation: The server encountered an unknown application error.

Minor code: 4
Static variable: com.sun.rmi.util.MinorCodes.UNKNOWN_SERVER_ERROR
Explanation: The server threw an unknown exception.