Skip Headers

Oracle9iAS TopLink Troubleshooting Guide
Release 2 (9.0.3)

Part Number B10068-01
Go To Documentation Library
Home
Go To Solution Area
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

2
Error Codes and Descriptions

This section lists each TopLink error code. Each error entry contains a description of the error, the probable cause, and the recommended action. Each error code corresponds to an exception class. See "Runtime and Development Exceptions" for more information.

Format:

A description shown in the actual exception thrown.

Cause: The most probable cause for the error.

Action: Suggestions for resolving the error.

Descriptor Exceptions (1 - 176)

Error code: 1

ATTRIBUTE_AND_MAPPING_WITH_INDIRECTION_ MISMATCH

Cause: <attributeName> is not declared as type ValueHolderInterface but the mapping uses indirection. Mapping is set to use indirection but the related attribute is not defined as type ValueHolderInterface. It is thrown on foreign reference mappings.

Action: If you want to use indirection on the mapping, change the attribute to type ValueHolderInterface. Otherwise, change the mapping associated with the attribute so that it does not use indirection.

Error code: 2

ATTRIBUTE_AND_MAPPING_WITHOUT_INDIRECTION_ MISMATCH

Cause: <attributeName> is declared as type ValueHolderInterface but the mapping is not using indirection. Attribute is defined to be of type ValueHolderInterface but the mapping is not set to use indirection. It is thrown on foreign reference mappings.

Action: If you do not want to use indirection on the mapping, change the attribute to not be of type ValueHolderInterface. Otherwise, change the mapping associated with the attribute to use indirection.

Error code: 6

ATTRIBUTE_NAME_NOT_SPECIFIED

Cause: Attribute name is missing or not specified in the mapping definition.

Action: Specify the attribute name in the mapping by calling method setAttributeName(String attribute name).

Error code: 7

ATTRIBUTE_TYPE_NOT_VALID

Cause: <attributeName> should be defined as type Vector, or a type that implements Map or Collection if using Java 2. It happens in one to many mapping, many to many mapping and collection mapping when mapping is set not to use indirection and attribute type is not declared of type java.util.Vector.

Action: Declare the attribute to be of type java.util.Vector.

Error code: 8

CLASS_INDICATOR_FIELD_NOT_FOUND

Cause: The class indicator field has not been defined, however the descriptor has been set to use inheritance. When using inheritance, a class indicator field or class extraction method must be set. The class indicator field is used to create the right type of domain object

Action: Either a class indicator field or class extraction method must be set.

Error code: 9

DIRECT_FIELD_NAME_NOT_SET

Cause: The direct field name from the target table is not set in the direct collection mapping. The field values form the collection in this mapping.

Action: Specify the direct field name by calling method setDirectFieldName(String fieldName).

Error code: 10

FIELD_NAME_NOT_SET_IN_MAPPING

Cause: The field name is not set in the mapping. It is thrown from direct to field mapping, array mapping and structure mapping.

Action: Specify the field name by calling method setFieldName(String fieldName).

Error code: 11

FOREIGN_KEYS_DEFINED_INCORRECTLY

Cause: One to one mapping foreign key defined incorrectly. Multiple foreign key fields were set for one to one mapping by calling method setForeignKeyFieldName(String fieldName).

Action: Use method addForeignKeyFieldName(String sourceForeignKeyName, String targetPrimaryKeyFieldName) to add multiple foreign key fields.

Error code: 12

IDENTITY_MAP_NOT_SPECIFIED

Cause: The descriptor must use an identity map to use the Check cache does exist option. Descriptor has been set to not use identity map but the existence checking is set to be done on identity map.

Action: Either use identity map or set the existence checking to some other option.

Error code: 13

ILLEGAL_ACCESS_WHILE_GETTING_VALUE_THRU_ INSTANCE_VARIABLE_ACCESSOR

Cause: <attributeName> instance variable in object <objectName> is inaccessible. Instance variable in the domain object is not accessible. This exception is thrown when TopLink tries to access the instance variable using Java reflection. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 14

ILLEGAL_ACCESS_WHILE_CLONING

Cause: Problem in cloning the object <domainObject>. Clone method <methodName> is not accessible. The method name specified using useCloneCopyPolicy(String cloneMethodName) or the clone() method to create clone on the domain object is not accessible by TopLink using Java reflection. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 15

ILLEGAL_ACCESS_WHILE_CONSTRUCTOR_INSTANTIATION

Cause: The domain class does not define a public default constructor, which is needed by TopLink to create new instances of the domain class.

Action: Define one or use different instantiation policy.

Error code: 16

ILLEGAL_ACCESS_WHILE_EVENT_EXECUTION

Cause: The descriptor callback method <eventMethodName> with DescriptorEvent as argument, is not accessible. This exception is thrown when TopLink tries to access the event method using Java reflection. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 17

ILLEGAL_ACCESS_WHILE_GETTING_VALUE_THRU_ METHOD_ACCESSOR

Cause: Trying to invoke inaccessible <methodName> on the object <objectName>. The underlying get accessor method to access an attribute in the domain object is not accessible. This exception is thrown when TopLink tries to access an attribute through method using Java reflection. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 18

ILLEGAL_ACCESS_WHILE_INSTANTIATING_METHOD_ BASED_PROXY

Cause: The method used by the Transformation mapping using a ValueHolder is illegal. This exception is thrown when TopLink tries to access the method using Java reflection. The problem is caused when method base value holder is getting instantiated.

Action: Inspect the internal exception and check the Java manuals.

Error code: 19

ILLEGAL_ACCESS_WHILE_INVOKING_ATTRIBUTE_METHOD

Cause: On transformation mapping the underlying attribute method used to retrieve value from the database row while reading transformation mapped attribute is not accessible.

Action: Inspect the internal exception and check the Java manuals.

Error code: 20

ILLEGAL_ACCESS_WHILE_INVOKING_FIELD_TO_METHOD

Cause: On transformation mapping the method <methodName> used to retrieve value from the object while writing transformation mapped attribute is not accessible. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 21

ILLEGAL_ACCESS_WHILE_INVOKING_ROW_EXTRACTION_ METHOD

Cause: Problem in extracting class from <row>; Static method <method> with <databaseRow> as argument, is not accessible. The method to extract class from row on the domain object is not accessible. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 22

ILLEGAL_ACCESS_WHILE_METHOD_INSTANTIATION

Cause: Problem in creating new instance; the method <methodName> to create instances on the domain class is not accessible. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 23

ILLEGAL_ACCESS_WHILE_OBSOLETE_EVENT_EXECUTION

Cause: The descriptor callback method <eventMethodName> with Session as argument, is inaccessible. This exception is thrown when TopLink tries to access the event method using Java reflection. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 24

ILLEGAL_ACCESS_WHILE_SETTING_VALUE_THRU_ INSTANCE_VARIABLE_ACCESSOR

Cause: The <attributeName> instance variable in the object <objectName> is not accessible through Java reflection. The error is thrown by Java and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 25

ILLEGAL_ACCESS_WHILE_SETTING_VALUE_THRU_ METHOD_ACCESSOR

Cause: Trying to invoke inaccessible method <setMethodName> on the object with parameter <parameter>. The attribute's set accessor method is not accessible through Java reflection. The error is thrown by Java and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 26

ILLEGAL_ARGUMENT_WHILE_GETTING_VALUE_ THRU_INSTANCE_VARIABLE_ACCESSOR

Cause: Trying to get a value for an instance variable <attributeName> of type <typeName> from the object. The specified object is not an instance of the class or interface declaring the underlying field. An object is accessed to get the value of an instance variable that does not exist.

Action: Inspect the internal exception and check the Java manuals.

Error code: 27

ILLEGAL_ARGUMENT_WHILE_GETTING_VALUE_THRU_ METHOD_ACCESSOR

Cause: Trying to invoke method <methodName> on the object <objectName>. The get accessor method declaration on the domain object differs from the one that is defined. The number of actual and formal parameters differ, or an unwrapping conversion has failed.

Action: Inspect the internal exception and check the Java manuals.

Error code: 28

ILLEGAL_ARGUMENT_WHILE_INSTANTIATING_METHOD_ BASED_PROXY

Cause: The method used by the method-based proxy in a Transformation mapping is getting illegal arguments when the value holder is getting instantiated. This exception is thrown when TopLink tries to access the method using Java reflection.

Action: Inspect the internal exception and check the Java manuals.

Error code: 29

ILLEGAL_ARGUMENT_WHILE_INVOKING_ATTRIBUTE_ METHOD

Cause: The number of actual and formal parameters differ, or an unwrapping conversion has failed. On transformation mapping the method used to retrieve value from the database row while reading transformation mapped attribute is getting illegal argument.

Action: Inspect the internal exception and check the Java manuals.

Error code: 30

ILLEGAL_ARGUMENT_WHILE_INVOKING_FIELD_TO_ METHOD

Cause: The number of actual and formal parameters differ for method <methodName> or an unwrapping conversion has failed. On transformation mapping the method used to retrieve value from the object while writing transformation mapped attribute is getting illegal argument. The error is purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 31

ILLEGAL_ARGUMENT_WHILE_OBSOLETE_EVENT_ EXECUTION

Cause: he number of actual and formal parameters for the descriptor callback method <eventMethodName> differs, or an unwrapping conversion has failed. The callback event method is invoked with illegal argument. This exception is thrown when TopLink tries to invoke the event method using Java reflection. The error is a purely Java exception and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 32

ILLEGAL_ARGUMENT_WHILE_SETTING_VALUE_THRU_ INSTANCE_VARIABLE_ACCESSOR

Cause: Illegal value is being assigned to the attribute instance variable. Trying to set a value <value> for an instance variable <attributeName> of type <typeName> in the object. The specified object is not an instance of the class or interface declaring the underlying field, or an unwrapping conversion has failed.

TopLink does the assignment of value by using Java reflection. Java throws the error and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 33

ILLEGAL_ARGUMENT_WHILE_SETTING_VALUE_THRU _METHOD_ACCESSOR

Cause: Illegal argument is being passed to the attribute's set accessor method. Trying to invoke method <setMethodName> on the object. The number of actual and formal parameters differs, or an unwrapping conversion has failed. Java throws the error and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 34

INSTANTIATION_WHILE_CONSTRUCTOR_INSTANTIATION

Cause: he class does not define a public default constructor, or the constructor raised an exception. The default constructor for the domain object is invoked to create new instance of the object while building new domain objects. If this Class represents an abstract class, an interface, an array class, a primitive type, or void; or if the instantiation fails for some other reason. Java throws the error and TopLink only wraps the reflection exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 35

INVALID_DATA_MODIFICATION_EVENT

Cause: This is an exception that an application should never encounter. The exception can occur at the time of developing TopLink. In cases where one writes new mapping it is possible to get this exception. In direct collection mapping and many to many mapping the target table and relational table are populated at the end of the commit process and if data modification event is sent to any other mapping then this exception is thrown.

Action: Contact Technical Support.

Error code: 36

INVALID_DATA_MODIFICATION_EVENT_CODE

Cause: This is an exception that an application should never encounter. The exception can occur at the time of developing TopLink. In cases where one writes new mapping it is possible to get this exception. In direct collection mapping and many to many mapping the target table and relational table are populated at the end of the commit process and if data modification event is sent to these two mappings with wrong event code then this exception is thrown.

Action: Contact Technical Support.

Error code: 37

INVALID_DESCRIPTOR_EVENT_CODE

Cause: This is an exception that an application should never encounter. The exception can occur at the time of developing TopLink. The exception means that descriptor event manager does not support the event code passed in the event.

Action: Contact Technical Support.

Error code: 38

INVALID_IDENTITY_MAP

Cause: Identity map constructor failed because an invalid identity map was specified. The identity map class given in the descriptor cannot be instantiated. The exception is Java exception thrown by Java reflection when TopLink is instantiating the identity map class. TopLink only wraps the Java exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 39

JAVA_CLASS_NOT_SPECIFIED

Cause: The descriptor does not define a Java class. The Java class is not specified in the descriptor.

Action: Specify the Java Class

Error code: 40

DESCRIPTOR_FOR_INTERFACE_IS_MISSING

Cause: A descriptor for the referenced interface is not added to the session.

Action: Add that descriptor to the session.

Error code: 41

MAPPING_FOR_SEQUENCE_NUMBER_FIELD

Cause: A non-read-only mapping is not defined for the sequence number field. A mapping is required so that TopLink can put and extract values for the primary key.

Action: Define a mapping.

Error code: 43

MISSING_CLASS_FOR_INDICATOR_FIELD_VALUE

Cause: Missing class for indicator field value <classFieldValue> of type <type>. There was no class entry found in the inheritance policy for the indicator field value read from the database. Probably the method addClassIndicator(Class class, Object typeValue) was not called for the field value. The class and typeValue is stored in the hashtable and later on the class is extracted from the hashtable by passing typeValue as a key. Remember Integer(1) is not equal to Float(1), this is another major reason for this problem when the type of typeValue is different.

Action: Check descriptor.

Error code: 44

MISSING_CLASS_INDICATOR_FIELD

Cause: The class indicator field is missing from the database row <row> that was read from the database. This is done in inheritance model where after reading rows from the database, child domain objects are to be constructed depending upon the type indicator values.

Action: Check the printed row to make sure the spelling is correct.

Error code: 45

MISSING_MAPPING_FOR_FIELD

Cause: Missing mapping for field <field>; a mapping for the field is not specified.

Action: Define a mapping for the field.

Error code: 46

NO_MAPPING_FOR_PRIMARY_KEY

Cause: A mapping for the primary key is not specified. There should be one non-read-only mapping defined for the primary key field.

Action: efine a mapping for the primary key.

Error code: 47

MULTIPLE_TABLE_PRIMARY_KEY_NOT_SPECIFIED

Cause: The multiple table primary key mapping must be specified when a custom multiple table join is used. If multiple tables are specified in the descriptor and the join expression is customized then the primary keys for all the tables must be specified. If the primary keys are not specified then the exception is caused.

Action: Call method addMultipleTablePrimaryKeyFieldName(String fieldNameInPrimaryTable, String fieldNameInSecondaryTable) on the descriptor to set the primary keys.

Error code: 48

MULTIPLE_WRITE_MAPPINGS_FOR_FIELD

Cause: There are multiple writable mappings for the field <fieldName> in the descriptor. Exactly one must be defined writable. The others must be specified as read-only. When multiple write mappings are defined for the field, TopLink cannot decide on which mapping to pick up for writing the value of the field in the database row hence the exception is thrown during the validation process of descriptors. The most common site for this problem is that sometimes the field has direct-to-field mapping and also one-to-one mapping. In this case if direct-to-field mapping has to be kept then one-to-one mapping should either be read-only or it should be target foreign key reference.

Action: Make one of those mappings read only.

Error code: 49

NO_ATTRIBUTE_TRANSFORMATION_METHOD

Cause: The attribute transformation method name in the transformation mapping is not specified. This method is invoked internally by TopLink to retrieve value to store in the domain object.

Action: Define a method and set the method name on the mapping by calling method setAttributeTransformation(String methodName).

Error code: 50

NO_FIELD_NAME_FOR_MAPPING

Cause: No field name is specified in direct-to-field mapping.

Action: Set the field by calling setFieldName(String FieldName).

Error code: 51

NO_FOREIGN_KEYS_ARE_SPECIFIED

Cause: Neither the selection criteria nor the foreign keys were specified on one-to-one mapping. If the selection criterion is not specified then TopLink tries to build one from the foreign keys specified in the mapping.

Action: Specify the fields.

Error code: 52

NO_REFERENCE_KEY_IS_SPECIFIED

Cause: No query key named: <queryKey> found in: <descriptor>; no reference key from the target table is specified on direct collection mapping.

Action: Specify the fields by calling method setReferenceKeyFieldName(String fieldName).

Error code: 53

NO_RELATION_TABLE

Cause: The relation table name is not set in this many-to-many mapping.

Action: Set relation table name by calling method setRelationTableName(String tableName).

Error code: 54

NO_SOURCE_RELATION_KEYS_SPECIFIED

Cause: There are no source relation keys specified in this many-to-many mapping.

Action: Add source relation keys to the mapping.

Error code: 55

NO_SUCH_METHOD_ON_FIND_OBSOLETE_METHOD

Cause: The descriptor callback method <selector> on the domain class was not found. It must take a Session or a DescriptorEvent as its argument. TopLink tries to invoke the method using Java reflection. It is a Java exception and TopLink is only wrapping the main exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 56

NO_SUCH_METHOD_ON_INITIALIZING_ ATTRIBUTE_METHOD

Cause: The method <attributeMethodName> with parameters <databaseRow> or <databaseRow, session> is not found. TopLink wraps the Java reflection exception that is caused when the method is being created from the method name. This method is set by calling setAttributeMethodName(String aMethodName).

Action: Inspect the internal exception and check the Java manuals.

Error code: 57

NO_SUCH_METHOD_WHILE_CONSTRUCTOR_ INSTANTIATION

Cause: Inaccessible constructor. TopLink wraps the Java reflection exception that is caused when it is creating a new instance of the domain.

Action: Inspect the internal exception and check the Java manuals.

Error code: 58

NO_SUCH_METHOD_WHILE_CONVERTING_TO_METHOD

Cause: Method <methodName> not found with parameters () or (Session). TopLink wraps the Java reflection exception that is caused when it is creating a Method type from the method names in transformation mapping.

Action: Inspect the internal exception and check the Java manuals.

Error code: 59

NO_SUCH_FIELD_WHILE_INITIALIZING_ATTRIBUTES_ IN_INSTANCE_VARIABLE_ACCESSOR

Cause: The instance variable <attributeName> is not defined in the domain class or it is not accessible. TopLink wraps the Java reflection exception that is caused when it is creating a Field type from the attribute name.

Action: Inspect the internal exception and check the Java manuals.

Error code: 60

NO_SUCH_METHOD_WHILE_INITIALIZING_ ATTRIBUTES_IN_METHOD_ACCESSOR

Cause: The accessor method <setMethodName> or <getMethodName> is not defined for the attribute in the domain class <javaClassName>, or it is not accessible. TopLink wraps the Java reflection exception that is caused when it is creating a Method type from the method name.

Action: Inspect the internal exception and check the Java manuals.

Error code: 61

NO_SUCH_METHOD_WHILE_INITIALIZING_ CLASS_EXTRACTION_METHOD

Cause: The static class extraction method <methodName> with <databaseRow> as argument does not exist, or is not accessible. Java reflection exception wrapped in TopLink exception is thrown when class extraction method is being created from the method name in inheritance policy.

Action: Inspect the internal exception and check the Java manuals.

Error code: 62

NO_SUCH_METHOD_WHILE_INITIALIZING_COPY_POLICY

Cause: The clone method <methodName> with no arguments does not exist, or is not accessible. Java reflection exception wrapped in TopLink exception is thrown when a method to create clones is being created from the method name in copy policy.

Action: Inspect the internal exception and check the Java manuals.

Error code: 63

NO_SUCH_METHOD_WHILE_INITIALIZING_ INSTANTIATION_POLICY

Cause: The instance creation method <methodName> with no arguments does not exist, or is not accessible. Java reflection exception wrapped in TopLink exception is thrown when a method to create new instances is being created from the method name in instantiation policy.

Action: Inspect the internal exception and check the Java manuals.

Error code: 64

NO_TARGET_FOREIGN_KEYS_SPECIFIED

Cause: The foreign keys in the target table are not specified in one-to-many mappings. These fields are not required if a selection criterion is given in the mapping but otherwise they must be specified.

Action: Set target foreign keys or selection criteria.

Error code: 65

NO_TARGET_RELATION_KEYS_SPECIFIED

Cause: There are no target relation keys specified in many-to-many mappings.

Action: Call method addTargetRelationKeyFieldName(String targetRelationKeyFieldName, String targetPrimaryKeyFieldName) to set the fields.

Error code: 66

NOT_DESERIALIZABLE

Cause: The object cannot be de-serialized from the byte array read from the database. The exception is thrown when serialized object mapping is converting byte array into object.

Action: Inspect the internal exception and check the Java manuals.

Error code: 67

NOT_SERIALIZABLE

Cause: The object cannot be serialized into byte array. The exception is thrown when serialized object mapping is object into byte array.

Action: Inspect the internal exception and check the Java manuals.

Error code: 68

NULL_FOR_NON_NULL_AGGREGATE

Cause: Value of aggregate in the source object <object> is null. Null values not allowed for aggregate mappings unless allow null is specified in aggregate mapping.

Action: Call method allowNull() on the mapping.

Error code: 69

NULL_POINTER_WHILE_GETTING_VALUE_THRU_ INSTANCE_VARIABLE_ACCESSOR

Cause: An object is accessed to get the value of an instance variable through Java reflection. This exception is thrown only on some VMs.

Action: Inspect the internal exception and check the Java manuals.

Error code: 70

NULL_POINTER_WHILE_GETTING_VALUE_THRU_ METHOD_ACCESSOR

Cause: The get accessor method is invoked to get the value of attribute through Java reflection. This exception is thrown only on some VMs.

Action: Inspect the internal exception and check the Java manuals.

Error code: 71

NULL_POINTER_WHILE_SETTING_VALUE_THRU_ INSTANCE_VARIABLE_ACCESSOR

Cause: Null Pointer Exception is thrown while setting value of <attributeName> instance variable in the object to value. An object is accessed to set the value of an instance variable through Java reflection. This exception is thrown only on some VMs.

Action: Inspect the internal exception and check the Java manuals.

Error code: 72

NULL_POINTER_WHILE_SETTING_VALUE_THRU_ METHOD_ACCESSOR

Cause: Null Pointer Exception is thrown while setting value through <setMethodName> method in the object with argument <argument>. The set accessor method is invoked to set the value of attribute through Java reflection. This exception is thrown only on some VMs.

Action: Inspect the internal exception and check the Java manuals.

Error code: 73

PARENT_DESCRIPTOR_NOT_SPECIFIED

Cause: Cannot find descriptor for parent class. The descriptor of a subclass has no parent descriptor.

Action: The method setParentClass(Class parentClass) on the subclass descriptor must be called.

Error code: 74

PRIMARY_KEY_FIELDS_NOT_SPECIFIED

Cause: The primary key fields are not set for this descriptor.

Action: Add primary key field names using method setPrimaryKeyFieldName(String fieldName) or setPrimaryKeyFieldName(String fieldName).

Error code: 75

REFERENCE_CLASS_NOT_SPECIFIED

Cause: The reference class is not specified in the foreign reference mapping.

Action: Set reference class by calling method setReferenceClass(Class aClass)

Error code: 77

REFERENCE_DESCRIPTOR_IS_NOT_AGGREGATE

Cause: The referenced descriptor for <className> should be set to aggregate descriptor. An aggregate mapping should always reference a descriptor that is aggregate.

Action: Call method descriptorIsAggregate() on the referenced descriptor.

Error code: 78

REFERENCE_KEY_FIELD_NOT_PROPERLY_SPECIFIED

Cause: The table for the reference field must be the reference table. If the reference field name specified in the direct collection mapping is qualified with the table name then the table name should match the reference table name.

Action: Qualify the field with the proper name or change the reference table name.

Error code: 79

REFERENCE_TABLE_NOT_SPECIFIED

Cause: The reference table name in the direct collection mapping is not specified.

Action: Use method setReferenceTableName(String tableName) on the mapping to set the table name.

Error code: 80

RELATION_KEY_FIELD_NOT_PROPERLY_SPECIFIED

Cause: The table for the relation key field must be the relation table. If the source and target relation fields name specified in the many to many mapping are qualified with the table name then the table name should match the relation table name.

Action: Qualify the field with the proper name or change the relation table name.

Error code: 81

RETURN_TYPE_IN_GET_ATTRIBUTE_ACCESSOR

Cause: The method <attributeMethodName> specified in the transformation mapping should have a return type set in the attribute because this method is used to extract value from the database row.

Action: Check the method and make appropriate changes.

Error code: 82

SECURITY_ON_FIND_METHOD

Cause: The descriptor callback method <selector> with DescriptorEvent as argument is not accessible. Java throws security exception when a Method type is created from the method name using Java reflection. The method is a descriptor event callback on the domain object that takes DescriptorEvent as its parameter.

Action: Inspect the internal exception and check the Java manuals.

Error code: 83

SECURITY_ON_FIND_OBSOLETE_METHOD

Cause: The descriptor callback method <selector> with <session> as argument is not accessible. Java throws security exception when a Method type is created from the method name using Java reflection. The method is a descriptor event callback on the domain object which takes class and session as its parameters.

Action: Inspect the internal exception and check the Java manuals.

Error code: 84

SECURITY_ON_INITIALIZING_ATTRIBUTE_METHOD

Cause: Access to the method <attributeMethodName> with parameters <databaseRow> or <databaseRow, Session> has been denied. Java throws security exception when a Method type is created from the attribute method name using Java reflection. The attribute method specified in the transformation mapping is used to extract value from the database row and set by calling setAttributeTransformation(String methodName).

Action: Inspect the internal exception and check the Java manuals.

Error code: 85

SECURITY_WHILE_CONVERTING_TO_METHOD

Cause: Method: <methodName> ACCESS DENIED with <> or <session> parameters. Java throws security exception when a Method type is created from the method name using Java reflection. These are the methods that will extract the field value from the domain object in the transformation mapping.

Action: Inspect the internal exception and check the Java manuals.

Error code: 86

SECURITY_WHILE_INITIALIZING_ATTRIBUTES_IN_ INSTANCE_VARIABLE_ACCESSOR

Cause: Access to the instance variable, <attributeName> in the class <javaClassName> is denied. Java throws security exception when creating Field type from the given attribute name using Java reflection.

Action: Inspect the internal exception and check the Java manuals.

Error code: 87

SECURITY_WHILE_INITIALIZING_ATTRIBUTES_IN_ METHOD_ACCESSOR

Cause: The methods <setMethodName> and <getMethodName> in the object <javaClassName> are inaccessible. Java throws security exception when creating Method type from the given attribute accessor method name using Java reflection.

Action: Inspect the internal exception and check the Java manuals.

Error code: 88

SECURITY_WHILE_INITIALIZING_CLASS_ EXTRACTION_METHOD

Cause: The static class extraction method <methodName> with DatabaseRow as argument is not accessible. Java throws security exception when creating Method type from the given class extraction method name using Java reflection. The method is used to extract class from the database row in inheritance policy.

Action: Inspect the internal exception and check the Java manuals.

Error code: 89

SECURITY_WHILE_INITIALIZING_COPY_POLICY

Cause: The clone method <methodName> with no arguments is not accessible. Java throws security exception when creating Method type from the given method name using Java reflection. This method on copy policy is used to create clones of the domain object.

Action: Inspect the internal exception and check the Java manuals.

Error code: 90

SECURITY_WHILE_INITIALIZING_INSTANTIATION_POLICY

Cause: The instance creation method <methodName> with no arguments is not accessible. Java throws security exception when creating Method type from the given method name using Java reflection. This method on instantiation policy is used to create new instances of the domain object.

Action: Inspect the internal exception and check the Java manuals.

Error code: 91

SEQUENCE_NUMBER_PROPERTY_NOT_SPECIFIED

Cause: Either the sequence field name or the sequence number name is missing. To use sequence generated ids both the sequence number name and field name properties must be set.

Action: To use sequence-generated ids, both the sequence number name and field name properties must be set.

Error code: 92

SIZE_MISMATCH_OF_FOREIGN_KEYS

Cause: The size of the primary keys on the target table does not match the size of the foreign keys on the source in one to one mapping.

Action: Check the mapping and the reference descriptor's primary keys.

Error code: 93

TABLE_NOT_PRESENT

Cause: The table <tableName> is not present in the descriptor.

Action: Check the qualified field names specified in the mappings and descriptor, if these fields are qualified with the table name then those fields should have right table.

Error code: 94

TABLE_NOT_SPECIFIED

Cause: No table is specified in the descriptor. Descriptor must have a table name defined.

Action: Call method addTableName(String tableName) or setTableName(String tableName) to set the tables on the descriptor.

Error code: 96

TARGET_FOREIGN_KEYS_SIZE_MISMATCH

Cause: The size of the foreign keys on the target table does not match the size of the source keys on the source table in one to many mapping.

Action: Check the mapping.

Error code: 97

TARGET_INVOCATION_WHILE_CLONING

Cause: Problem in cloning the object <domainObject> clone method. <methodName> triggered an exception. Java is throwing exception when clone method is invoked using Java reflection while cloning object. The clone method is specified on the copy policy that is usually invoked to create clones in unit of work.

Action: Inspect the internal exception and check the Java manuals.

Error code: 98

TARGET_INVOCATION_WHILE_EVENT_EXECUTION

Cause: The underlying descriptor callback method <eventMethodName> with DescriptorEvent as argument, throws an exception. Java is throwing exception when descriptor event method is invoked using Java reflection.

Action: Inspect the internal exception and check the Java manuals.

Error code: 99

TARGET_INVOCATION_WHILE_GETTING_VALUE_ THRU_METHOD_ACCESSOR

Cause: The method <methodName> on the object <objectName> is throwing an exception. Java is throwing exception while getting an attribute value from the object through method accessor.

Action: Inspect the internal exception and check the Java manuals.

Error code: 100

TARGET_INVOCATION_WHILE_INSTANTIATING_ METHOD_BASED_PROXY

Cause: Method has thrown an exception. Java is throwing exception while instantiating method based proxy. This happens while instantiating transformation mapping.

Action: Inspect the internal exception and check the Java manuals.

Error code: 101

TARGET_INVOCATION_WHILE_INVOKING_ ATTRIBUTE_METHOD

Cause: The underlying method throws an exception. Java is throwing exception while invoking attribute transformation method on transformation mapping. The method is invoked to extract value from the database row to set into the domain object.

Action: Inspect the internal exception and check the Java manuals.

Error code: 102

TARGET_INVOCATION_WHILE_INVOKING_FIELD_ TO_METHOD

Cause: The method <methodName> is throwing an exception. Java is throwing exception while invoking field transformation method on transformation mapping. The method is invoked to extract value from the domain object to set into the database row.

Action: Inspect the internal exception and check the Java manuals.

Error code: 103

TARGET_INVOCATION_WHILE_INVOKING_ROW_ EXTRACTION_METHOD

Cause: Problem in extracting class from row <row>, static method, <method> with <databaseRow as argument>. An exception was triggered Java is throwing exception while invoking class extraction method. The method is used to extract class type so that right kind of object can be created in inheritance model.

Action: Inspect the internal exception and check the Java manuals.

Error code: 104

TARGET_INVOCATION_WHILE_METHOD_INSTANTIATION

Cause: Problem in creating new instance. Creation method <methodName> caused an exception. Java is throwing exception while invoking instantiation method. The method is used to create new instances of the domain objects.

Action: Inspect the internal exception and check the Java manuals.

Error code: 105

TARGET_INVOCATION_WHILE_OBSOLETE_ EVENT_EXECUTION

Cause: The underlying descriptor callback method <eventMethodName> with <session> as argument, throws an exception. Java is throwing exception while invoking descriptor event method that takes session as its parameter.

Action: Inspect the internal exception and check the Java manuals.

Error code: 106

TARGET_INVOCATION_WHILE_SETTING_VALUE_THRU_ METHOD_ACESSOR

Cause: The method <setMethodName> on the object is throwing an exception. Java is throwing exception while invoking set accessor method on the domain object to set an attribute value into the domain object.

Action: Inspect the internal exception and check the Java manuals.

Error code: 108

VALUE_NOT_FOUND_IN_CLASS_INDICATOR_MAPPING

Cause: The indicator value is not found in the class indicator mapping in the parent descriptor for the class.

Action: Check addClassIndicator(Class childClass, Object typeValue) on the inheritance policy.

Error code: 109

WRITE_LOCK_FIELD_IN_CHILD_DESCRIPTOR

Cause: The child descriptor should not have a write lock field defined because it gets it from the parent descriptor.

Action: Check your child descriptor and remove the field.

Error code: 110

DESCRIPTOR_IS_MISSING

Cause: The descriptor for the reference class <className> is missing from the mapping.

Action: Check session to see if the descriptor for the reference class was added.

Error code: 111

MULTIPLE_TABLE_PRIMARY_KEY_MUST_BE_ FULLY_QUALIFIED

Cause: Multiple table primary key field names must be fully qualified. These fields names are given on the descriptor if it has more than one table.

Action: Specify the field names with table name.

Error code: 112

ONLY_ONE_TABLE_CAN_BE_ADDED_WITH_THIS_METHOD

Cause: Only one table can be added through this method.

Action: Use addTableName(String tableName) to add multiple tables to descriptor.

Error code: 113

NULL_POINTER_WHILE_CONSTRUCTOR_INSTANTIATION

Cause: Inaccessible constructor. Java is throwing this exception while invoking a default constructor to create new instances of the domain object.

Action: Inspect the internal exception and check the Java manuals.

Error code: 114

NULL_POINTER_WHILE_METHOD_INSTANTIATION

Cause: Problem in creating new instance <methodName> creation method is not accessible. Java is throwing an exception while calling a method to build new instance of the domain object. This method is given by the user to override the default behavior of creating new instances through class constructor.

Action: Inspect the internal exception and check the Java manuals.

Error code: 115

NO_ATTRBUTE_VALUE_CONVERSION_TO_FIELD_VALUE_PROVIDED

Cause: The field conversion value for the attribute value <attributeValue> was not given in the object type mapping.

Action: Check the attribute value and provide a corresponding field value in the mapping.

Error code: 116

NO_FIELD_VALUE_CONVERSION_TO_ATTRIBUTE_ VALUE_PROVIDED

Cause: The attribute conversion value for the <fieldValue> was not given in the object type mapping.

Action: Check the field value and provide a corresponding attribute value in the mapping.

Error code: 118

LOCK_MAPPING_CANNOT_BE_READONLY

Cause: The domain object <className> cannot have a read only mapping for the write lock fields when the version value is stored in the object.

Action: Check the mappings on write lock fields.

Error code: 119

LOCK_MAPPING_MUST_BE_READONLY

Cause: The domain object <className> should have a read only mapping for the write lock fields when the version value is stored in the cache.

Action: Check the mappings on write lock fields.

Error code: 120

CHILD_DOES_NOT_DEFINE_ABSTRACT_QUERY_KEY

Cause: The queryKey <queryKeyName> is defined in the parent descriptor but not in the child descriptor. The descriptor has not defined abstract query key.

Action: Any implementors of interface descriptor must define the query key defined by abstract query key in the interface descriptor.

Error code: 122

SET_EXISTENCE_CHECKING_NOT_UNDERSTOOD

Cause: The interface descriptor <parent> must have at least one abstract query key defined. The string given to the method setExistenceChecking(String token) is not understood.

Action: The string passed should be one of the following:

  • Check cache

  • Check database

  • Assume existence

  • Assume non-existence

Error code: 125

VALUE_HOLDER_INSTANTIATION_MISMATCH

Cause: The mapping for the attribute <mapping.getAttributeName()> uses indirection and must be initialized to a new ValueHolder.

Action: Ensure the mapping uses indirection and the attribute is initialized to a new valueHolder.

Error code: 126

NO_SUB_CLASS_MATCH

Cause: No sub-class matches this class <theClass> when inheritance is in aggregate relationship mapping.

Action: Verify the sub-class and the relationship mapping.

Error code: 127

RETURN_AND_MAPPING_WITH_INDIRECTION_MISMATCH

Cause: The get method return type for the attribute mapping.getAttributeName() is not declared as type ValueHolderInterface, but the mapping is using indirection.

Action: Ensure the get method returns a ValueHolder or change the mapping to not use indirection.

Error code: 128

RETURN_AND_MAPPING_WITHOUT_INDIRECTION_ MISMATCH

Cause: The get method return type for the attribute mapping.getAttributeName() is declared as type ValueHolderInterface, but the mapping is not using indirection.

Action: Ensure the mapping is using indirection or change the return type from ValueHolder

Error code: 129

PARAMETER_AND_MAPPING_WITH_INDIRECTION_ MISMATCH

Cause: The set method parameter type for the attribute mapping.getAttributeName() is not declared as type ValueHolderInterface, but the mapping is using indirection.

Action: Ensure the set method parameter is declared as a ValueHolder or the mapping is changed to not use indirection.

Error code: 130

PARAMETER_AND_MAPPING_WITHOUT_INDIRECTION_ MISMATCH

Cause: The set method parameter type for the attribute mapping.getAttributeName() is declared as type ValueHolderInterface, but the mapping is not using indirection.

Action: Ensure the mapping is changed to use indirection or the set method parameter is not declared as a ValueHolder.

Error code: 131

GET_METHOD_RETURN_TYPE_NOT_VALID

Cause: he get method return type for the attribute mapping.getAttributeName() should be declared as type Vector (or a type that implements Map or Collection, if using Java2).

Action: The get method return type for the attribute should be declared as type Vector (or a type that implementsMap or Collection, if using Java2).

Error code: 133

SET_METHOD_PARAMETER_TYPE_NOT_VALID

Cause: The set method parameter type for the attribute mapping.getAttributeName() should be declared as type Vector (or a type that implements Map or Collection, if using Java2).

Action: The set method parameter type for the attribute should be declared as type Vector (or a type that implements Map or Collection, if using Java2).

Error code: 135

ILLEGAL_TABLE_NAME_IN_MULTIPLE_TABLE_ FOREIGN_KEY

Cause: The table in the multiple table foreign key relationship refers to an unknown table.

Action: Verify the table name.

Error code: 138

ATTRIBUTE_AND_MAPPING_WITH_TRANSPARENT_ INDIRECTION_MISMATCH

Cause: The attribute mapping.getAttributeName() is not declared as a super-type of validTypeName, but the mapping is using transparent indirection.

Action: Verify the attribute's type and the mapping setup.

Error code: 139

RETURN_AND_MAPPING_WITH_TRANSPARENT_ INDIRECTION_MISMATCH

Cause: The get method return type for the attribute mapping.getAttributeName() is not declared as a super-type of validTypeName, but the mapping is using transparent indirection.

Action: Verify the attribute's type and the mapping setup.

Error code: 140

PARAMETER_AND_MAPPING_WITH_TRANSPARENT_ INDIRECTION_MISMATCH

Cause: The set method parameter type for the attribute mapping.getAttributeName() is not declared as a super-type of validTypeName, but the mapping is using transparent indirection.

Action: Verify the attribute's type and the mapping setup.

Error code: 141

FIELD_IS_NOT_PRESENT_IN_DATABASE

Cause: Field <fieldname> is not present in the table <tableName> in the database.

Action: Verify the field name for the attribute.

Error code: 142

TABLE_IS_NOT_PRESENT_IN_DATABASE

Cause: descriptor.getTableName() is not present in the database.

Action: Verify the table name for the descriptor.

Error code: 143

MULTIPLE_TABLE_INSERT_ORDER_MISMATCH

Cause: The multiple table insert order Vector specified aDescriptor.getMultipleTableInsertOrder(), has more/fewer tables than are specified in the descriptor aDescriptor.getTables(). All the tables must be included in the insert order Vector.

Action: Verify that all table names for the descriptor are present and that there are no extras.

Error code: 144

INVALID_USE_OF_TRANSPARENT_INDIRECTION

Cause: Transparent Indirection can only be used with CollectionMappings.

Action: Verify the mapping. It must be a collection mapping.

Error code: 145

MISSING_INDIRECT_CONTAINER_CONSTRUCTOR

Cause: The indirect container class must implement the constructor.

Action: Implement the constructor for the container.

Error code: 146

COULD_NOT_INSTANTIATE_INDIRECT_CONTAINER_CLASS

Cause: The indirect container class could not be instantiated using the constructor.

Action: Validate the constructor for the indirect container class.

Error code: 147

INVALID_CONTAINER_POLICY

Cause: This container policy should only be used in JDK1.1: containerPolicy. It was instantiated for javaClass.

Action: Validate the container policy being used.

Error code: 148

INVALID_CONTAINER_POLICY_WITH_TRANSPARENT_ INDIRECTION

Cause: The container policy is incompatible with transparent indirection.

Action: Change the container policy to be compatible with transparent indirection or do not use transparent indirection.

Error code: 149

INVALID_USE_OF_NO_INDIRECTION

Cause: No Indirection should not receive this message.

Action: Change to use no indirection.

Error code: 150

INDIRECT_CONTAINER_INSTANTIATION_MISMATCH

Cause: The mapping for the attribute mapping.getAttributeName() uses transparent indirection and must be initialized to an appropriate container.

Action: Initialize the mapping to an appropriate container.

Error code: 151

INVALID_MAPPING_OPERATION

Cause: Invalid mapping operation.

Action: Check the documentation for valid mapping operations.

Error code: 152

INVALID_INDIRECTION_POLICY_OPERATION

Cause: Invalid indirection policy operation.

Action: Check the documentation for valid indirection policy operations.

Error code: 153

REFERENCE_DESCRIPTOR_IS_NOT_ AGGREGATECOLLECTION

Cause: The reference descriptor for <className> should be set to aggregate collection descriptor.

Action: Set the reference descriptor to an aggregate collection descriptor.

Error code: 154

INVALID_INDIRECTION_CONTAINER_CLASS

Cause: Invalid indirection container class.

Action: Verify the container class.

Error code: 155

MISSING_FOREIGN_KEY_TRANSLATION

Cause: The mapping does not include a foreign key field linked to the primary key field.

Action: Link the foreign key to the appropriate primary key.

Error code: 156

TRUCTURE_NAME_NOT_SET_IN_MAPPING

Cause: The structure name is not set.

Action: Set the structure name appropriately.

Error code: 157

NORMAL_DESCRIPTORS_DO_NOT_SUPPORT_ NON_RELATIONAL_EXTENSIONS

Cause: Normal descriptors do not support non-relational extensions.

Action: Contact Technical Support.

Error code: 158

PARENT_CLASS_IS_SELF

Cause: The descriptor's parent class has been set to itself.

Action: Contact Technical Support.

Error code: 159

PROXY_INDIRECTION_NOT_AVAILABLE

Cause: An attempt to use proxy indirection has been made but JDK 1.3 is not being used.

Action: Proxy indirection is only supported in JDK 1.3

Error code: 160

INVALID_ATTRIBUTE_TYPE_FOR_PROXY_INDIRECTION

Cause: The attribute wasn't specified in the list of interfaces given to use Proxy Indirection.

Action: Verify the attribute

Error code: 161

INVALID_GET_RETURN_TYPE_FOR _PROXY_INDIRECTION

Cause: The return type for the indirection policy is invalid for the indirection policy.

Action: Verify that the parameter type of the attribute's get method is correct for the indirection policy.

Error code: 162

INVALID_SET_PARAMETER_TYPE_FOR_PROXY_ INDIRECTION

Cause: The parameter for the set method is incorrect for the indirection type.

Action: Verify that the parameter type of the attribute's set method is correct for the indirection policy.

Error code: 163

INCORRECT_COLLECTION_POLICY

Cause: The container policy is invalid for the collection type.

Action: Check that the container policy is correct for the collection type.

Error code: 164

INVALID_AMENDMENT_METHOD

Cause: The amendment method provided is invalid, not public, or cannot be found.

Action: Ensure the amendment method is public, static, returns void and has a single argument: Descriptor.

Error code: 165

ERROR_OCCURRED_IN_AMENDMENT_METHOD

Cause: The specified amendment method threw an exception.

Action: Examine the returned exception for further details.

Error code: 166

VARIABLE_ONE_TO_ONE_MAPPING_IS_NOT_DEFINED

Cause: There is no mapping for attribute.

Action: Validate the mapping and attribute.

Error code: 168

TARGET_INVOCATION_WHILE_CONSTRUCTOR_ INSTANTIATION

Cause: Constructor is missing.

Action: Make the required constructor.

Error code: 169

TARGET_INVOCATION_WHILE_CONSTRUCTOR_ INSTANTIATION_OF_FACTORY

Cause: Constructor is missing.

Action: Make the required constructor.

Error code: 170

ILLEGAL_ACCESS_WHILE_CONSTRUCTOR_ INSTANTIATION_OF_FACTORY

Cause: Permissions do not permit access to the constructor.

Action: Adjust the Java security permissions to permit access to the constructor.

Error code: 171

INSTANTIATION_WHILE_CONSTRUCTOR_ INSTANTIATION_OF_FACTORY

Cause: An instantiation failed inside the associated constructor.

Action: Determine which objects are being instantiated, and ensure all are being done properly.

Error code: 172

NO_SUCH_METHOD_WHILE_CONSTRUCTOR_ INSTANTIATION_OF_FACTORY

Cause: A message send invoked from inside the constructor is invalid because the method does not exist.

Action: Correct the message send ensuring that the message exists.

Error code: 173

NULL_POINTER_WHILE_CONSTRUCTOR_ INSTANTIATION_OF_FACTORY

Cause: A message is being sent from inside a constructor to a null object.

Action: Avoid sending a message to an object that is null.

Error code: 174

ILLEGAL_ACCESS_WHILE_METHOD_ INSTANTIATION_OF_FACTORY

Cause: A message is being sent to an object from inside a factory instantiation. Java has determined this message to be illegal.

Action: Determine why the message send is illegal, and replace the message with the proper legal one.

Error code: 175

TARGET_INVOCATION_WHILE_METHOD_ INSTANTIATION_OF_FACTORY

Cause: Error inside the factory associated with the invocation of a target.

Action: Determine the faulty target, and replace with the correct target, or proper message send.

Error code: 176

NULL_POINTER_WHILE_METHOD_ INSTANTIATION_OF_FACTORY

Cause: A message is being sent to null inside a factory instantiation.

Action: Avoid sending a message to null.

Builder Exceptions (1001 - 1042)

Error code: 1001

No such method

Cause: Tokens in the builder generated files are the subsets of all the tokens a Project Reader can understand. Each token has a related public method on TopLink. The exception would mean that the method name is incorrect.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1002

Could not find post load method <methodName> on class <aClass>

Cause: The post load method defined in descriptor properties is not defined on the related domain class.

Action: Must define the method on the specified class.

Error code: 1003

Cannot write parameter <object> of class <type>

Cause: While creating project class the parameter tokens are read from the file and are converted to actual types before sending them to the methods. An unknown type will cause this exception.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1004

Could not access method <method>

Cause: Java is throwing an illegal access reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals. If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1005

Invoking <applyResultMethod> raised exception <exception>

Cause: Java is throwing an invocation reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals. If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1006

Invalid arguments invoking: <applyResultMethod> with <receiver>

Cause: Java is throwing an invalid argument reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals. If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1007

Could not access <applyResultMethod> with <receiver>

Cause: Java is throwing reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals. If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1008

Parameter mismatch <method>; received <size> parameters

Cause: The number of parameters for the token read from the project or descriptor file do not match the number of parameters a related method can take.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1009

Accessing <methodName> on <className> with <parameters>

Cause: Java is throwing reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals. If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1010

Could not find section definition <section> when building section definitions for <target>

Cause: Invalid section name was found in the project or descriptor file.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1011

Could not convert <object> into an accessible Java class.

Cause: The parameter read from the file cannot be converted to a appropriate type.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1012

File not found

Cause: The project or descriptor file was not found.

Action: Check that the path was given correctly in a project reader and also the path is correct in project file.

Error code: 1013

Invalid class/method name format.

Cause: No one should actually be using the URL way of reading INI files. This is untested and undocumented feature.

Action: Use other ways of reading files.

Error code: 1015

Open failed for URL <url>

Cause: Open failed for URL.

Action: Inspect the internal exception and check the Java manuals.

Error code: 1016

Could not resolve INIFile location: <sourceString> using search paths <searchPaths>

Cause: The file was not found on the given search paths.

Action: Check your search paths.

Error code: 1017

Invoking <method> on <receiver>

Cause: Java is throwing reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals. If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1018

Invoking <method> on <receiver>

Cause: Java is throwing reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals. If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1019

Invalid character value; expecting $* format

Cause: An invalid character format was written to the file.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1020

Unexpected character: {

Cause: Unexpected character { found while reading vector values from the file.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1021

Unexpected character: }

Cause: Unexpected character } found while reading vector values from the file.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1022

Expecting object, found token <nextToken>

Cause: Unexpected token found while reading from the file.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1023

Unexpected word

Cause: Unexpected token found while reading from the file.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1024

setExistenceChecking <token>; not understood

Cause: Existence checking string specified on the descriptor is not understood.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1025

Class <className> not found

Cause: Java is throwing reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals. If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1026

Not enough INI elements. Found <count>.

Cause: If the line in an INI file is incomplete, i.e., it does not have enough tokens.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1027

Too many INI elements. Found <count>.

Cause: If the line in an INI file has more tokens then needed.

Action: If the project files are not manually edited and corrupted then this is usually an internal exception to TopLink and must be reported to Technical Support. But if the file was manually edited or corrupted then the files must be generated again.

Error code: 1028

Error writing <writeString>

Cause: Could not write into the file. Perhaps / are used and file or directory structure does not exist.

Action: Inspect the internal exception and check the Java manuals. Try using \\.

Error code: 1029

Illegal access exception

Cause: Java is throwing reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 1030

Invocation target exception

Cause: Java is throwing reflection exception while invoking the method on the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 1031

Attempting to instantiate <className> with default constructor.

Cause: Java is throwing reflection exception while instantiating the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 1032

Attempting to instantiate <className> with default constructor.

Cause: Java is throwing reflection exception while instantiating the object. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 1033

IO Exception in next token

Cause: Java is throwing reflection. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 1034

IOException on close.

Cause: Java is throwing reflection. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 1035

Invalid INI(URL) Method: <method>. Should return a string.

Cause: No one should actually be using the URL way of reading INI files. This is untested and undocumented feature.

Action: Use other ways of reading files.

Error code: 1036

Could not cast using <castString>.

Cause: An error occurred during an attempt to cast using the castString

Action: Validate the castString

Error code: 1037

A writer or a target file name must be specified

Cause: A writer or a target file name is not specified.

Action: A writer or a target file name must be specified.

Error code: 1039

IOException on open.

Cause: Java is throwing reflection. TopLink only wraps that exception.

Action: Inspect the internal exception and check the Java manuals.

Error code: 1040

Post Load Method Not Static

Cause: The method specified is not static.

Action: Modify the method to be static.

Error code: 1041

Project Not Found.

Cause: No projects were found in the specified directory.

Action: Verify the directory.

Error code: 1042

Multiple Projects With Name.

Cause: More than one project with the same name was found.

Action: Verify the project name.

Concurrency Exceptions (2001 - 2004)

Error code: 2001

WAIT_WAS_INTERRUPTED

Cause: In a multi threaded environment one of the waiting thread was interrupted.

Action: Usually such exceptions would mean restarting the application but it is totally dependent on the application.

Error code: 2002

WAIT_FAILURE_SERVER

Cause: Wait failure on ServerSession. When the number of non-pooled connections reach the threshold any more requests for such connection results in wait until some one releases the connection resource. If this wait was interrupted then an exception is thrown.

Action: Usually such exceptions would mean restarting the application but it is totally dependent on the application.

Error code: 2003

WAIT_FAILURE_CLIENT

Cause: Wait failure on ClientSession. When the number of pooled connections reach the threshold any more requests for such connection results in wait until some one releases the connection resource. If this wait was interrupted then an exception is thrown.

Action: Usually such exceptions would mean restarting the application but it is totally dependent on the application.

Error code: 2004

SIGNAL_ATTEMPTED_BEFORE_WAIT

Cause: A signal was attempted before wait on concurrency manager. This normally means that an attempt was made to commit or rollback a transaction before it was started, or to rollback a transaction twice.

Action: Check transactions in the application.

Conversion Exceptions (3001 - 3007)

Error code: 3001

COULD_NOT_BE_CONVERTED

Cause: The object <object> of class <objectClass> could not be converted to <javaClass>. The object cannot be converted to given type.

Action: Check that the object being converted is of right type or not.

Error code: 3003

INCORRECT_DATE_FORMAT

Cause: The date in <dateString> is in an incorrect format. Expected format is YYYY-MM-DD.

Action: Check the date format.

Error code: 3004

INCORRECT_TIME_FORMAT

Cause: The time in <timeString> is in an incorrect format. Expected format is HH:MM:SS.

Action: Check the time format.

Error code: 3005

INCORRECT_TIMESTAMP_FORMAT

Cause: The timestamp <timestampString> is in an incorrect format. Expected format is YYYY-MM-DD HH:MM:SS.NNNNNNNNN.

Action: Check the timestamp format.

Error code: 3006

COULD_NOT_CONVERT_TO_BYTE_ARRAY

Cause: The String object must be of even length to be converted to a ByteArray. This object could not be converted to a ByteArray

Action: Check the object being converted.

Error code: 3007

COULD_NOT_BE_CONVERTED_TO_CLASS

Cause: The object <object> of class <objectClass> could not be converted to <javaClass>. The class <javaClass> is not on the CLASSPATH.

Action: Check that the class <javaClass> is on the CLASSPATH.

Database Exceptions (4001 - 4018)

Error code: 4002

SQL_EXCEPTION

Cause: An SQL exception was encountered, thrown by the underlying JDBC bridge. TopLink only wraps that exception.

Action: One must inspect the internal exception thrown.

Error code: 4003

CONFIGURATION_ERROR_CLASS_NOT_FOUND

Cause: The driver class name was not found.

Action: Check the class name given in JDBCLogin.

Error code: 4005

DATABASE_ACCESSOR_NOT_CONNECTED

Cause: Session is not connected to the database while doing reading or writing on the database.

Action: An application may have to login again because the connection to the database might have been lost.

Error code: 4006

ERROR_READING_BLOB_DATA

Cause: Error reading blob data from the database. There are two possibilities for this exception, first is that the blob data was not read properly from the result set or the TopLink could not process the blob data using ByteArrayOutputStream.

Action: Check if the underlying driver support blobs properly or not and if it does then report this problem to Technical Support.

Error code: 4007

OULD_NOT_CONVERT_OBJECT_TYPE

Cause: Could not convert object type on internal error. java.sql.TYPES = <type>. The object from the result set cannot be converted to the type returned from the metadata information.

Action: Check if the underlying driver support the conversion type properly or not and if it does then report this problem to Technical Support.

Error code: 4008

LOGOUT_WHILE_TRANSACTION_IN_PROGRESS

Cause: An attempt has been made to logout while the transaction is still in progress. You cannot logout while a transaction is in progress.

Action: Wait until the transaction is over.

Error code: 4009

SEQUENCE_TABLE_INFORMATION_NOT_COMPLETE

Cause: The sequence information given to TopLink is not sufficiently complete to get the set of sequence numbers from the database. This usually happens on native sequencing on oracle database.

Action: Check the data given specially the sequence name given in TopLink.

Error code: 4011

ERROR_PREALLOCATING_SEQUENCE_NUMBERS

Cause: Error preallocating sequence numbers on the database; the sequence table information is not complete.

Action: Check if the sequence table was created on the database properly or not.

Error code: 4014

CANNOT_REGISTER_SYNCHRONIZATIONLISTENER_ FOR_UNITOFWORK

Cause: Cannot register Synchronization Listener: underlying_exception_string. When the TopLink Session is configured with an ExternalTransactionController, any unit of work requested by a client must operate within the context of a JTS external global transaction. When a unit of work is created and the external global transaction is not in existence or if the system cannot acquire a reference to it, this error is reported.

Action: Ensure that a JTS transaction is in progress before acquiring the unit of work.

Error code: 4015

SYNCHRONIZED_UNITOFWORK_DOES_NOT_ SUPPORT_COMMITANDRESUME

Cause: Synchronized UnitOfWork does not support the commitAndResume operation. When the TopLink Session is configured with an ExternalTransactionController, any unit of work requested by a client must operate within the context of a JTS external global transaction (see Error code: 4014). The JTS specification does not support the concept of "checkpointing" a transaction, that is, committing the work done and then continuing to work within the same transaction context (JTS does not support nested transactions, either). Thus, if client code invokes commitAndResume() on a "synchronized" unit of work, this error will be reported.

Action: None.

Error code: 4016

CONFIGURATION_ERROR_NEW_INSTANCE_ INSTANTIATION_EXCEPTION

Cause: Configuration error. Attempting to instantiate Driver: <javaClass>. Could not instantiate driver.

Action: Check the driver.

Error code: 4017

CONFIGURATION_ERROR_NEW_INSTANCE_ILLEGAL_ ACCESS_EXCEPTION

Cause: A configuration error occurred while attempting to instantiate Driver: <javaClass>. Could not instantiate driver.

Action: Check the driver.

Error code: 4018

TRANSACTION_MANAGER_NOT_SET_FOR_JTS_DRIVER

Cause: The transaction manager has not been set for the JTSSynchronizationListener.

Action: Set a transaction manager for the JTSSynchronizationListener.

Optimistic Lock Exceptions (5001 - 5007)

Error code: 5001

NO_VERSION_NUMBER_WHEN_DELETING

Cause: An attempt was made to delete the object <object> but it has no version number in the identity map. This object either was never read or has already been deleted.

Action: Logging SQL is very helpful in understanding the reason why the exception is thrown. The last delete will show the object we are deleting that throws an exception.

Error code: 5003

OBJECT_CHANGED_SINCE_LAST_READ_WHEN_DELETING

Cause: The object state has changed in the database. The object <object> cannot be deleted because it has changed or been deleted since it was last read. This usually means that the row in the table was changed by some other application.

Action: Refreshing an object will refresh the object with the new data from the database.

Error code: 5004

NO_VERSION_NUMBER_WHEN_UPDATING

Cause: An attempt has been made to update the object <object> but it has no version number in the identity map. It may not have been read before being updated or has been deleted.

Action: Logging SQL is very helpful in understanding the reason why the exception is thrown. The last update will show the object we are updating that throws an exception.

Error code: 5006

OBJECT_CHANGED_SINCE_LAST_READ_WHEN_UPDATING

Cause: The object state has changed in the database. The object <object> cannot be updated because it has changed or been deleted since it was last read. This usually means that the row in the table was changed by some other application.

Action: Refreshing an object will refresh the object with the new data from the database.

Error code: 5007

MUST_HAVE_MAPPING_WHEN_IN_OBJECT

Cause: The object <aClass> must have a non-read-only mapping corresponding to the version lock field. The mapping was not defined for the locking field. It is needed when the lock value is stored in the domain object than in a cache.

Action: Define a mapping for the field.

Error code: 5008

NEED_TO_MAP_JAVA_SQL_TIMESTAMP

Cause: A write lock value which is stored in a domain object is not an instance of java.sql.Timestamp.

Action: Change the value of the attribute to be an instance of java.sql.Timestamp.

Query Exceptions (6001 - 6092)

Error code: 6001

ADDITIONAL_SIZE_QUERY_NOT_SPECIFIED

Cause: Cursored SQL queries must provide an additional query to retrieve the size of the result set. Custom queries using cursor streams and not specifying the size query will cause this exception. The size query is used to retrieve the size of the number of object read from the database. This is done on JDBC 1.0 compatible drivers because it provides no way to extract the size of the result set read. Non custom queries using cursor streams will have default queries generated by TopLink.

Action: Specify a size query.

Error code: 6002

AGGREGATE_OBJECT_CANNOT_BE_DELETED

Cause: Aggregated objects cannot be written or deleted independent of their owners. There is no identity maintained on such objects.

Action: Application's discretion.

Error code: 6003

ARGUMENT_SIZE_MISMATCH_IN_QUERY_AND_ QUERY_DEFINITION

Cause: The number of arguments provided to the query for execution does not match the number of arguments provided with the query definition.

Action: Check the query and query execution.

Error code: 6004

BACKUP_CLONE_IS_ORIGINAL_FROM_PARENT

Cause: The object <clone> of class <clone.getClass()> with identity hashcode (System.identityHashCode()) <System.identityHashCode(clone)> is not from this unit of work space but from the parent session. The object was never registered in this unit of work but read from the parent session and related to an object registered in the unit of work.

Action: Ensure that you are correctly registering your objects. If you are still having problems, you can use the UnitOfWork.validateObjectSpace() method to help debug where the error occurred. Please see the manual and FAQ for more information.

Error code: 6005

BACKUP_CLONE_IS_ORIGINAL_FROM_SELF

Cause: The object clone of class <clone.getClass()> with identity hashcode (System.identityHashCode()) <System.identityHashCode(clone)> is the original to a registered new object. The unit of work clones registered new objects, so you must ensure that it is registered before it is reference by another object. If you do not want the new object to be cloned, used the UnitOfWork.registerNewObject(Object) API.

Action: Ensure that you are correctly registering your objects. If you are still having problems, you can use the UnitOfWork.validateObjectSpace() method to help debug where the error occurred. Please see the manual and FAQ for more information.

Error code: 6006

BATCH_READING_NOT_SUPPORTED

Cause: This mapping does not support batch reading. The optimization of batching the read of all the target rows is not supported for the mapping.

Action: The problem is a TopLink development problem and user should never encounter this unless the mapping is a new custom mapping. Contact Technical Support.

Error code: 6007

DESCRIPTOR_IS_MISSING

Cause: Missing descriptor for <reference Class>. The descriptor related to the class or the object is not found in the session.

Action: Check if the related descriptor was added to the session or the query is done on the right object or class.

Error code: 6008

DESCRIPTOR_IS_MISSING_FOR_NAMED_QUERY

Cause: Missing descriptor for <domain Class Name> for query named <queryName>. The descriptor where named query is defined is not added to the session.

Action: Check if the related descriptor was added to the session or the query is done on the right class.

Error code: 6013

INCORRECT_SIZE_QUERY_FOR_CURSOR_STREAM

Cause: The size query given on the queries returning cursor streams is not correct. The execution of the size query did not return any size.

Action: If the cursor stream query was custom query than check the size query specified else report this problem to Technical Support.

Error code: 6014

INVALID_QUERY

Cause: Objects cannot be written in unit of work using modify queries, they must be registered.

Action: Objects are registered in the unit of work and during commit unit of work will do the required changes to the database.

Error code: 6015

INVALID_QUERY_KEY_IN_EXPRESSION

Cause: The query key <key> does not exist. Usually this happens because of mis-spelled query key.

Action: Check the query key specified in the expression and make sure that a query key was added to the descriptor.

Error code: 6016

INVALID_QUERY_ON_SERVER_SESSION

Cause: Objects and the database cannot be changed through the server session; all changes must be done through a client session's unit of work. The objects cannot be changed on the server session by modifying queries. Objects are changed in the client sessions acquired from this server session.

Action: Use client session's unit of work to change the object.

Error code: 6020

NO_CONCRETE_CLASS_INDICATED

Cause: No concrete class indicated for the type in this row. The type indicator read from the database row has no entry in the type indicator hashtable or if class extraction method was used, it did not return any concrete class type. The exception is thrown when sub classes are being read.

Action: Check class extraction method if specified or check the descriptor to see if all the type indicator values were specified or not.

Error code: 6021

NO_CURSOR_SUPPORT

Cause: No cursor support provided for abstract class multiple table descriptors using expressions.

Action: Consider using custom SQL or multiple queries. <query>

Error code: 6023

OBJECT_TO_INSERT_IS_EMPTY

Cause: There are no fields to be insert into the table. The fields to insert into the table, <table> is empty. You must define at least one mapping for this table

Action: Must define at least one mapping for this table.

Error code: 6024

OBJECT_TO_MODIFY_NOT_SPECIFIED

Cause: An object to modify is required for a modify query.

Action: Ensure the query contains an object before executing.

Error code: 6026

QUERY_NOT_DEFINED

Cause: Query is not defined. When executing query on the session the parameter which takes query is null.

Action: Check if the query is passed properly.

Error code: 6027

QUERY_SENT_TO_INACTIVE_UNIT_OF_WORK

Cause: The unit of work has been released and is now inactive.

Action: The unit of work, once released, cannot be reused unless commitAndResume is called.

Error code: 6028

READ_BEYOND_QUERY

Cause: An attempt has been made to read from the cursor streams beyond its limits (beyond the end of the stream).

Action: Ensure the stream is being checked for an "end of stream" condition before attempting to retrieve more objects.

Error code: 6029

REFERENCE_CLASS_MISSING

Cause: The reference class in the query is not specified. A reference class must be provided.

Action: Check the query.

Error code: 6030

REFRESH_NOT_POSSIBLE_WITHOUT_CACHE

Cause: Refresh is not possible if caching is not set. The read queries which skip cache to read objects cannot be used to do refresh the object. Refreshing is not possible without identity.

Action: Check query.

Error code: 6031

SIZE_ONLY_SUPPORTED_ON_EXPRESSION_QUERIES

Cause: Did not find size query. Size only supported on expression queries, unless a size query is given.

Action: Cursor streams on custom query should also define size query.

Error code: 6032

SQL_STATEMENT_NOT_SET_PROPERLY

Cause: The SQL statement has not been properly set. The user should never encounter this unless queries have been customized.

Action: Contact Technical Support.

Error code: 6034

INVALID_QUERY_ITEM

Cause: Invalid query item expression.

Action: Validate the Expression being used.

Error code: 6041

SELECTION_OBJECT_CANNOT_BE_NULL

Cause: The selection object passed to a read object or refresh was null.

Action: Check setSelectionObject() on the read query.

Error code: 6042

UNNAMED_QUERY_ON_SESSION_BROKER

Cause: Data read and data modify queries is being executed without the session name. Only object-level queries can be directly executed by the session broker, unless the query is named.

Action: Session broker has no idea about such queries about which session to execute the query on. Specify the session name.

Error code: 6043

REPORT_RESULT_WITHOUT_PKS

Cause: ReportQuery without PKs cannot readObject. The report query result returned is without primary key values. An object from the result can only be created only if primary keys were also read.

Action: Check documentation on retrievePriamryKeys() on report query.

Error code: 6044

NULL_PRIMARY_KEY_IN_BUILDING_OBJECT

Cause: The primary key read from the row, <databaseRow> during the execution of the query was detected to be null; primary keys must not contain null.

Action: Check query and also the table on the database.

Error code: 6045

NO_DESCRIPTOR_FOR_SUBCLASS

Cause: The subclass has no descriptor defined for it.

Action: Check session if the descriptor was added or not or else check class extraction method.

Error code: 6046

CANNOT_DELETE_READ_ONLY_OBJECT

Cause: Cannot delete an object of read-only class. The class <className> is declared read-only in this unit of work. Thrown in unit of work when trying to delete an object that is marked as read only.

Action: Contact Technical Support.

Error code: 6047

INVALID_OPERATOR

Cause: The operator <data> used in the expression is not valid.

Action: Check ExpressionOperator class to see a list of all of the operators supported.

Error code: 6048

ILLEGAL_USE_OF_GETFIELD

Cause: Illegal use of getField <data> in expression. This is a TopLink development exception that users should not encounter.

Action: Report this problem to Technical Support.

Error code: 6049

ILLEGAL_USE_OF_GETTABLE

Cause: Illegal use of getTable <data> in expression. This is a TopLink development exception that users should not encounter.

Action: Report this problem to Technical Support.

Error code: 6050

REPORT_QUERY_RESULT_SIZE_MISMATCH

Cause: The number of attributes requested does not match the attributes returned from the database in report query. This usually happens if one gives custom query on the report query.

Action: Check the custom query if it is specified or report this problem to Technical Support.

Error code: 6051

CANNOT_CACHE_PARTIAL_OBJECT

Cause: Partial Objects are never put in the cache. Partial object queries are not allowed to maintain the cache or be edited. You must set dontMaintainCache().

Action: Call the dontMaintainCache() method before executing the query.

Error code: 6052

OUTER_JOIN_ONLY_VALID_FOR_ONE_TO_ONE

Cause: An outer join (getAllowingNull) is only valid for one to one mappings, and cannot be used for the mapping.

Action: Do not attempt to use getAllowingNull for mappings other than one to one.

Error code: 6054

CANNOT_ADD_TO_CONTAINER

Cause: Cannot add <anObject> to a <containerClass> using <policy>. This is TopLink development exception and user should never encounter this problem unless a custom container policy has been written.

Action: Contact Technical Support.

Error code: 6055

METHOD_INVOCATION_FAILED

Cause: The method invocation of <aMethod> on the object <anObject> threw a Java reflection exception while accessing method.

Action: Check Java documentation on the internal exception.

Error code: 6056

CANNOT_CREATE_CLONE

Cause: Cannot create a clone of <anObject> using <policy>. This is a TopLink development exception and user should never encounter this problem unless a custom container policy has been written.

Action: Report this problem to Technical Support.

Error code: 6057

METHOD_NOT_VALID

Cause: The method <methodName> is not valid to call on object <aReceiver>. This is a TopLink development exception and user should never encounter this problem unless a custom container policy has been written.

Action: Contact Technical Support.

Error code: 6058

METHOD_DOES_NOT_EXIST_IN_CONTAINER_CLASS

Cause: The method named <methodName> was not found in class <aClass>. Thrown when looking for clone method on the container class. The clone is needed to create clones of the container in unit of work.

Action: Define clone method on the container class.

Error code: 6059

COULD_NOT_INSTANTIATE_CONTAINER_CLASS

Cause: The class <aClass> cannot be used as the container for the results of a query since it cannot be instantiated. Thrown when new interface container policy is being created using Java reflection.

Action: Check Java documentation on the internal exception.

Error code: 6060

MAP_KEY_NOT_COMPARABLE

Cause: Could not use object <anObject> of type <objectClass> as a key into <aContainer> which is of type <containerClass>. Key cannot be compared with the keys currently in the map. Throws Java reflection exception while accessing method.

Action: Check Java documentation on the internal exception.

Error code: 6061

CANNOT_ACCESS_METHOD_ON_OBJECT

Cause: Cannot reflectively access the method <aMethod> for object: <anObject> of type <anObjectClass>. Throws Java reflection exception while accessing method.

Action: Check Java documentation on the internal exception.

Error code: 6062

CALLED_METHOD_THREW_EXCEPTION

Cause: The method <aMethod> was called reflectively on object <object> of class <objectClass> and threw an exception. Throws Java reflection exception while accessing method.

Action: Check Java documentation on the internal exception.

Error code: 6063

INVALID_OPERATION

Cause: Invalid operation <operation> on cursor. The operation is not supported.

Action: Check the class documentation and look for the corresponding method that should be used.

Error code: 6064

CANNOT_REMOVE_FROM_CONTAINER

Cause: Cannot remove <anObject> of type <anObjectClass> from <aContainerClass> using <policy>. This is TopLink development exception and user should never encounter this problem unless a custom container policy has been written.

Action: Contact Technical Support.

Error code: 6065

CANNOT_ADD_ELEMENT

Cause: Cannot add element to the collection container policy (cannot add <anObject> of type <anObjectClass> to a <aContainerClass>).

Action: Check Java documentation on the internal exception.

Error code: 6066

BACKUP_CLONE_DELETED

Cause: Deleted objects cannot have reference after being deleted. The object clone of class <clone.getClass()> with identity hashcode (System.identityHashCode()) <System.identityHashCode(clone)> has been deleted, but still has references.

Action: Ensure that you are correctly registering your objects. If you are still having problems, you can use the UnitOfWork.validateObjectSpace() method to help debug where the error occurred. Please see the manual and FAQ for more information.

Error code: 6068

CANNOT_COMPARE_TABLES_IN_EXPRESSION

Cause: Cannot compare table reference to <data> in expression

Action: Check the expression

Error code: 6069

INVALID_TABLE_FOR_FIELD_IN_EXPRESSION

Cause: Field has invalid table in this context for field <data> in expression.

Action: Check the expression

Error code: 6070

INVALID_USE_OF_TO_MANY_QUERY_KEY_IN_EXPRESSION

Cause: Invalid use of a query key representing a to-many relationship <data> in expression. Use anyOf rather than get.

Action: Use the anyOf operator instead of get.

Error code: 6071

INVALID_USE_OF_ANY_OF_IN_EXPRESSION

Cause: Invalid use of anyOf for a query key not representing a to-many relationship <data> in expression. Use get rather than anyOf.

Action: Use the get operator instead of anyOf.

Error code: 6072

CANNOT_QUERY_ACROSS_VARIABLE_ONE_TO_ ONE_MAPPING

Cause: Querying across a variable one-to-one mapping is not supported.

Action: Change the expression such that the query in not done across a variable one to one mapping.

Error code: 6073

ILL_FORMED_EXPRESSION

Cause: Ill-formed expression in query, attempting to print an object reference into a SQL statement for <queryKey>.

Action: Contact Technical Support.

Error code: 6074

CANNOT_CONFORM_EXPRESSION

Cause: This expression cannot determine if the object conforms in memory, you must set the query to check the database.

Action: Change the query such that it does not attempt to conform to the results of the query.

Error code: 6075

INVALID_OPERATOR_FOR_OBJECT_EXPRESSION

Cause: Object comparisons can only use the equal or notEqual operators, other comparisons must be done through query keys or direct attribute level comparisons.

Action: Ensure the query uses only equal and notEqual if object comparisons are being used.

Error code: 6076

UNSUPPORTED_MAPPING_FOR_OBJECT_COMPARISON

Cause: Object comparisons can only be used with 1:1 mappings; other mapping comparisons must be done through query keys or direct attribute level comparisons.

Action: Use a query key instead of attempting to compare objects across the mapping.

Error code: 6077

OBJECT_COMPARISON_CANNOT_BE_PARAMETERIZED

Cause: Object comparisons cannot be used in parameter queries.

Action: Change the query such that it does not attempt to use object when using parameterized queries.

Error code: 6078

INCORRECT_CLASS_FOR_OBJECT_COMPARISON

Cause: The class of the argument for the object comparison is incorrect.

Action: Ensure the class for the query is correct.

Error code: 6079

CANNOT_COMPARE_TARGET_FOREIGN_KEYS_ TO_NULL

Cause: Object comparison cannot be used for target foreign key relationships. Query on the source primary key instead.

Action: Query on source primary key.

Error code: 6080

INVALID_DATABASE_CALL

Cause: Invalid database call - the call must be an instance of DatabaseCall: <call>.

Action: Ensure the call being used is a DatabaseCall.

Error code: 6081

INVALID_DATABASE_ACCESSOR

Cause: Invalid database accessor - the accessor must be an instance of DatabaseAccessor: <accessor>.

Action: Ensure the accessor being used is a DatabaseAccessor.

Error code: 6082

METHOD_DOES_NOT_EXIST_ON_EXPRESSION

Cause: Method: <methodName> with argument types: <argTypes> cannot be invoked on Expression.

Action: Ensure the method being used is a supported method.

Error code: 6083

IN_CANNOT_BE_PARAMETERIZED

Cause: Queries using IN cannot be parameterized.

Action: Either disable the query prepare or binding.

Error code: 6084

REDIRECTION_CLASS_OR_METHOD_NOT_SET

Cause: The redirection query was not configured properly, the class or method name was not set.

Action: Check the configuration for the redirection class.

Error code: 6085

REDIRECTION_METHOD_NOT_DEFINED_CORRECTLY

Cause: The redirection query's method is not defined or define with the wrong arguments. It must be public static and have arguments DatabaseQuery, DatabaseRow, Session (the interface).

Action: Check the redirection query's method as above.

Error code: 6086

REDIRECTION_METHOD_ERROR

Cause: The redirection query's method invocation threw an exception.

Action: Check the redirection method for problems.

Error code: 6087

EXAMPLE_AND_REFERENCE_OBJECT_CLASS_MISMATCH

Cause: There is a class mismatch between the example object and the reference class specified for this query.

Action: Ensure the example and reference classes are compatible.

Error code: 6088

NO_ATTRIBUTES_FOR _REPORT_QUERY

Cause: A RepertQuery has been built with no attributes specified.

Action: Specify attribute for the query.

Error code: 6089

NO_EXPRESSION_BUILDER_CLASS_FOUND

Cause: The expression has not been initialized correctly. Only a single ExpressionBuilder should be used for a query. For parallel expressions, the query class must be provided to the ExpressionBuilder constructor, and the query's ExpressionBuilder must always be on the left side of the expression.

Action: Contact Technical Support.

Error code: 6090

CANNOT_SET_REPORT_QUERY_TO_CHECK_ CACHE_ONLY

Cause: Cannot set ReportQuery to Check Cache Only.

Action: Contact Technical Support.

Error code: 6091

TYPE_MISMATCH_BETWEEN_ATTRIBUTE_AND_ CONSTANT_ ON_EXPRESSION

Cause: The type of the constant, used for comparison in the expression, does not match the type of the attribute.

Action: Contact Technical Support.

Error code: 6092

MUST_INSTANTIATE_VALUEHOLDERS

Cause: Uninstantiated ValueHolder detected. You must instantiate the relevant Valueholders to perform this in-memory query.

Action: Instantiate the valueholders for the collection you want to query on.

Validation Exceptions (7001 - 7097)

Error code: 7001

LOGIN_BEFORE_ALLOCATING_CLIENT_SESSIONS

Cause: You attempted to allocate client sessions before logging into the server.

Action: Ensure you have called login() on your ServerSession or DatabaseSession.


Note:

This error also appears in multithreaded environments as a result of concurrency issues. Check that all of your threads are synchronized.


Error code: 7002

POOL_NAME_DOES_NOT_EXIST

Cause: The pool name used while acquiring client session from the server session does not exist.

Action: Check the pool name given while acquiring client session and all the existing pools on the server session.

Error code: 7003

MAX_SIZE_LESS_THAN_MIN_SIZE

Cause: The maximum number of connections in a connection pool should be more than the minimum number of connections.

Action: Check addConnectionPool(String poolName, JDBCLogin login, int minNumberOfConnections, int maxNumberOfConnections) on server session.

Error code: 7004

POOLS_MUST_BE_CONFIGURED_BEFORE_LOGIN

Cause: Pools must all be added before login on the server session has been done. Once logged in pools cannot be added.

Action: Check addConnectionPool(String poolName, JDBCLogin login, int minNumberOfConnections, int maxNumberOfConnections) on server session. This method should be called before login on server session.

Error code: 7008

JAVA_TYPE_IS_NOT_A_VALID_DATABASE_TYPE

Cause: The Java type <javaClass> is not a valid database type. The Java type of the field to be written to the database has no corresponding type on the database.

Action: Check table or stored procedure definition.

Error code: 7009

MISSING_DESCRIPTOR

Cause: The descriptor <className>is not found in the session. Verify that the descriptor has been properly registered with the session.

Action: Check if the related descriptor to the class was added to the session.

Error code: 7010

START_INDEX_OUT_OF_RANGE

Cause: This is a TopLink development exception and user should never encounter this problem. It happens when a copy of vector is created with start and end index.

Action: Report this problem to Technical Support.

Error code: 7011

STOP_INDEX_OUT_OF_RANGE

Cause: This is a TopLink development exception and user should never encounter this problem. It happens when a copy of vector is created with start and end index.

Action: Report this problem to Technical Support.

Error code: 7012

FATAL_ERROR_OCCURRED

Cause: This is a TopLink development exception and user should never encounter this problem. It happens when test cases are executed.

Action: Report this problem to Technical Support. This error commonly occurs if you attempt to commit() an invalid (or previously committed) UnitOfWork.

If ValidationException.cannotCommitUOWAgain() appears in the stack trace, ensure that call commit() on valid UnitOfWork instances.

Error code: 7013

NO_PROPERTIES_FILE_FOUND

Cause: TopLink.properties file cannot be found on the system CLASSPATH.

Action: Ensure that there is a TopLink.properties file located on the system CLASSPATH.

Error code: 7017

CHILD_DESCRIPTORS_DO_NOT_HAVE_IDENTITY_MAP

Cause: Child descriptors do not have an identity map; they share their parent's. An Identity map is added to the child descriptor. A child descriptor shares its parent's identity map.

Action: Check child descriptor and remove identity map from it.

Error code: 7018

FILE_ERROR

Cause: The user should never encounter this problem. It happens when test cases are executed.

Action: Contact Technical Support.

Error code: 7023

INCORRECT_LOGIN_INSTANCE_PROVIDED

Cause: The login instance provided to the login() method is incorrect. A JDBCLogin must be provided.

Action: It should be of type JDBCLogin.

Error code: 7024

INVALID_MERGE_POLICY

Cause: This is a TopLink development exception and users should never encounter it.

Action: Contact Technical Support.

Error code: 7025

ONLY_FIELDS_ARE_VALID_KEYS_FOR_ DATABASE_ROWS

Cause: The key on the database row is not either of type String or of type DatabaseField.

Action: Contact Technical Support.

Error code: 7027

SEQUENCE_SETUP_INCORRECTLY

Cause: Sequence <sequenceName> is setup incorrectly, increment does not match pre-allocation size.

Action: Contact Technical Support.

Error code: 7028

WRITE_OBJECT_NOT_ALLOWED_IN_UNIT_OF_WORK

Cause:

Action: The objects in the unit of work are written to database by registering and committing the unit of work.

Error code: 7030

CANNOT_SET_READ_POOL_SIZE_AFTER_LOGIN

Cause: You cannot set read pool size after the server session has already been logged in.

Action: The size should be set before login.

Error code: 7031

CANNOT_ADD_DESCRIPTORS_TO_SESSION_BROKER

Cause: You cannot add descriptors to session broker.

Action: Descriptors are added to the sessions contained in the session broker.

Error code: 7032

NO_SESSION_REGISTERED_FOR_CLASS

Cause: The descriptor related to the domain class <domainClass> was not found in any of the sessions registered in the session broker.

Action: Check sessions.

Error code: 7033

NO_SESSION_REGISTERED_FOR_NAME

Cause: The session with the given name <sessionName> is not registered in the session broker.

Action: Check session broker.

Error code: 7038

LOG_IO_ERROR

Cause: Error while logging message to session's log.

Action: Check the internal exception.

Error code: 7039

CANNOT_REMOVE_FROM_READ_ONLY_CLASSES_ IN_NESTED_UNIT_OF_WORK

Cause: Cannot remove from the set of read-only classes in a nested unit of work. A nested unit of work's set of read-only classes must be equal to or a superset of its parent's set of read-only classes.

Action: Contact Technical Support.

Error code: 7040

CANNOT_MODIFY_READ_ONLY_CLASSES_SET_ AFTER_USING_UNIT_OF_WORK

Cause: Cannot change the set of read-only classes in a unit of work after that unit of work has been used. Changes to the read-only set must be made when acquiring the unit of work or immediately after.

Action: Contact Technical Support.

Error code: 7042

LATFORM_CLASS_NOT_FOUND

Cause: The platform class <className> was not found and a reflection exception was thrown.

Action: Check internal exception.

Error code: 7043

NO_TABLES_TO_CREATE

Cause: <project> does not have any tables to create on the database.

Action: Validate the project and tables to be created.

Error code: 7044

LLEGAL_CONTAINER_CLASS

Cause: The container class specified <className> cannot be used as the container because it does not implement Collection or Map.

Action: The container class must implement either of these two interfaces.

Error code: 7047

ONTAINER_POLICY_DOES_NOT_USE_KEYS

Cause: Invalid Map class was specified for the container policy. The container specified (of class <aPolicyContainerClass>) does not require keys. You tried to use <methodName>.

Action: Use map class that implements Map interface.

Error code: 7048

METHOD_NOT_DECLARED_IN_ITEM_CLASS

Cause: The key method on the map container policy is not defined. The instance method <methodName> does not exist in the reference class <className> and therefore cannot be used to create a key in a Map.

Action:

Error code: 7051

MISSING_MAPPING

Cause: Missing attribute <attributeName> for descriptor <descriptor> called from <source>. This is a TopLink development exception and a user should never encounter it.

Action: Contact Technical Support.

Error code: 7052

ILLEGAL_USE_OF_MAP_IN_DIRECTCOLLECTION

Cause: The method useMapClass was called on a DirectCollectionMapping. It is illegal to call useMapClass() on a DirectCollectionMapping. TopLink cannot instantiate Java attributes mapped using a DirectCollectionMapping with a Map. The useMapClass() API is supported for OneToManyMappings and ManyToManyMappings. The Java2 Collection interface is supported using the useCollectionClass() method.

Action: Do not call useMapClass() on DirectCollectionMappings. Instead, use the useCollectionClass() API.

Error code: 7053

CANNOT_RELEASE_NON_CLIENTSESSION

Cause: Release attempted on a session that is not a client session. Only client sessions may be released.

Action: Modify code so that the client session is not released.

Error code: 7054

CANNOT_ACQUIRE_CLIENTSESSION_FROM_SESSION

Cause: Acquire attempted on a session that is not a client session. Client sessions may only be acquired from server sessions.

Action: Modify code so that the acquire in not attempted.

Error code: 7055

OPTIMISTIC_LOCKING_NOT_SUPPORTED

Cause: Optimistic Locking is not supported with stored procedure generation.

Action: Do not use OptimisticLocking with stored procedure generation.

Error code: 7056

WRONG_OBJECT_REGISTERED

Cause: The wrong object was registered into the unit of work. It should be the object from the parent cache.

Action: Ensure the object is from the parent cache

Error code: 7058

INVALID_CONNECTOR

Cause: The connector must be of type DefaultConnector.

Action: Ensure the connector is of type DefaultConnector.

Error code: 7059

INVALID_DATA_SOURCE_NAME

Cause: Invalid DataSource name: <name>.

Action: Verify the data source name.

Error code: 7060

CANNOT_ACQUIRE_DATA_SOURCE

Cause: Cannot acquire DataSource: <name> or an error has occurred in setting up the datasource.

Action: Verify the data source name. Check the nested SQL exception to determine the cause of the error. Typical problems include:

  • The connection pool was not configured in your config.xml.

  • The driver is not on the classpath.

  • The user or password is incorrect.

  • The database server url or driver name is not properly specified.

Error code: 7061

JTS_EXCEPTION_RAISED

Cause: Exception occurred within JTS.

Action: Examine the JTS exception returned and consult the JTS documentation.

Error code: 7062

FIELD_LEVEL_LOCKING_NOTSUPPORTED_ OUTSIDE_A_UNIT_OF_WORK

Cause: FieldLevelLocking not supported outside a unitOfWork. In order to use field level locking, a unit of work must be used for ALL writes.

Action: Use a unit of work for writing.

Error code: 7063

EJB_CONTAINER_EXCEPTION_RAISED

Cause: Exception occurred within EJB container.

Action: Examine the EJB exception returned and consult the JTS documentation.

Error code: 7064

EJB_PRIMARY_KEY_REFLECTION_EXCEPTION

Cause: Exception occurred in reflective EJB bean primary key extraction.

Action: Ensure your primary key object is defined correctly.

Error code: 7065

EJB_CANNOT_LOAD_REMOTE_CLASS

Cause: The remote class for the bean cannot be loaded/found for the bean.

Action: Ensure the correct class loader is set correctly.

Error code: 7066

EJB_MUST_BE_IN_TRANSACTION

Cause: Cannot create or remove beans unless a JTS transaction is present, bean=<bean>.

Action: Verify that the JTS transaction is present.

Error code: 7068

EJB_INVALID_PROJECT_CLASS

Cause: The platform class <platformName> was not found for the <projectName> using default class loader.

Action: Validate the project and platform.

Error code: 7069

SESSION_AMENDMENT_EXCEPTION_OCCURED

Cause: A exception occurred looking up or invoking the session amendment method, <amendmentMethod> on the class <amendmentClass>.

Action: Validate the amendment method and class.

Error code: 7070

EJB_TOPLINK_PROPERTIES_NOT_FOUND

Cause: A toplink.properties resource bundle must be located on the classpath in a TopLink directory.

Action: Validate the classpath and the location of the TopLink resource bundle.

Error code: 7071

CANT_HAVE_UNBOUND_IN_OUTPUT_ARGUMENTS

Cause: You cannot use input output parameters without using binding.

Action: Use binding on the StoredProcedureCall.

Error code: 7073

ORACLE_OBJECT_TYPE_NOT_DEFINED

Cause: Oracle object type with type name <typeName> is not defined.

Action: Verify that the Oracle object type is defined.

Error code: 7074

ORACLE_OBJECT_TYPE_NAME_NOT_DEFINED

Cause: Oracle object type <typeName> is not defined.

Action: Verify that the Oracle object type is defined.

Error code: 7075

ORACLE_VARRAY_MAXIMIM_SIZE_NOT_DEFINED

Cause: Oracle VARRAY type <typeName> maximum size is not defined

Action: Verify the maximum size for the Oracle VARRAY.

Error code: 7076

DESCRIPTOR_MUST_NOT_BE_INITIALIZED

Cause: When generating the project class the descriptors must not be initialized.

Action: Ensure the descriptors are not initialized before generating the project class.

Error code: 7077

EJB_INVALID_FINDER_ON_HOME

Cause: The Home Interface <homeClassName.toString()> specified during creation of BMPWrapperPolicy does not contain a correct findByPrimaryKey method. A findByPrimaryKey method must exist that takes the PrimaryKey class for this bean.

Action: Verify that a FindByPrimaryKey method exists and is correct.

Error code: 7078

EJB_NO_SUCH_SESSION_SPECIFIED_IN_PROPERTIES

Cause: The sessionName specified on the deployment descriptor does not match any session specified in the TopLink properties file.

Action: Contact Technical Support.

Error code: 7079

EJB_DESCRIPTOR_NOT_FOUND_IN_SESSION

Cause: The descriptor was not found in the session.

Action: Check the project being used for this session.

Error code: 7080

EJB_FINDER_EXCEPTION

Cause: A FinderException was thrown when trying to load an object from the class with the primary key.

Action: Contact Technical Support.

Error code: 7081

CANNOT_REGISTER_AGGREGATE_OBJECT_IN_ UNIT_OF_ WORK

Cause: The aggregate object cannot be directly registered in the unit of work. It must be associated with the source (owner) object.

Action: Contact Technical Support.

Error code: 7082

MULTIPLE_PROJECTS_SPECIFIED_IN_PROPERTIES

Cause: The TopLink properties file specified multiple project files for the server. Only one project file can be specified.

Action: Specify one of projectClass, projectFile, or xmlProjectFile.

Error code: 7083

O_PROJECT_SPECIFIED_IN_PROPERTIES

Cause: The TopLink properties file does not include any information on the TopLink project to use for the server. One project file must be specified.

Action: Specify one of projectClass, projectFile, or xmlProjectFile.

Error code: 7084

INVALID_FILE_TYPE

Cause: The specified file is not a valid type for reading. ProjectReader must be given the deployed XML Project file.

Action: Contact Technical Support.

Error code: 7085

CANNOT_CREATE_EXTERNAL_TRANSACTION_ CONTROLLER

Cause: Cannot create an instance of the external transaction controller specified in the properties file.

Action: Contact Technical Support.

Error code 7087:

EJB_SESSION_TYPE_CLASS_NOT_FOUND

Cause: SessionManager cannot load the class corresponding to session's type class name.

Action: Verify the class name of the session's type in the Session.xml or toplink.properties that it is fully qualified.

Error code 7088:

CANNOT_CREATE_EXTERNAL_TRANSACTION_ CONTROLLER

Cause: SessionManager cannot load the class corresponding to external transaction controller's class name.

Action: Verify the class name of the external transaction controller in Session.xml or toplink.properties that it is valid and fully qualified.

Error code 7089:

SESSION_AMENDMENT_EXCEPTION_OCCURED

Cause: SessionManager cannot load the class corresponding to the amendment class name or it cannot load the method on the amendment class corresponding to the amendment method name.

Action: Verify the class name of the amendment class in Session.xml or toplink.properties that it is fully qualified and the amendment method exists in the amendment class.

Error code 7091

SET_LISTENER_CLASSES_EXCEPTION

Cause: Cannot create the listener class that implements SessionEventListener for the internal use of SessionXMLProject.

Action: Contact Technical Support.

Error code 7092

EXISTING_QUERY_TYPE_CONFLICT

Cause: Add custom query with the same name and arguments to a session.

Action: Verify that no query is added to the session more than once or change the query name so that the query can be distinguished.

Error code 7093

QUERY_ARGUMENT_TYPE_NOT_FOUND

Cause: Cannot create an instance of the query argument type.

Action: Verify the argument type is a fully qualified class name and the argument class is included in the classpath environment.

Error code 7095

NO_SESSIONS_XML_FOUND

Cause: Session.XML or toplink.properties cannot be loaded.

Action: Add the path to the above file to the classpath environment.

Error code 7096

CANNOT_COMMIT_UOW_AGAIN

Cause: Invoke commit() on an inactive unit of work that was committed or released.

Action: Invoke commit() on a new unit of work or invoke commitAndResume() so that the unit of work can be reused. See Oracle9iAS TopLink Foundation Library Guide for more details on commitAndResume().

Error code 7097:

OPERATION_NOT_SUPPORTED

Cause: Invoke a nonsupport operation on an object.

Action: Do not use the operation indicated in the stack trace.

Error Code: 7099

PROJECT_XML_NOT_FOUND

Cause: The filename specified for the XML-based project is incorrect.

Action: Verify the name and location of the file.

Error Code: 7101

NO_TOPLINK_EJB_JAR_XML_FOUND

Cause: The toplink-ejb-jar.xml file was not found.

Action: Please refer to the TopLink examples located in <INSTALL DIR>\Examples.

EJBQL Exceptions (8001 - 8009)

Error Code: 8001

recognitionException

Cause: The TopLink EJBQL parser doesn't recognize a clause in the EJBQL string

Action: Validate the EJBQL string

Error Code: 8002

generalParsingException

Cause: TopLink has encountered a problem while parsing the EJBQL string.

Action: Check the internal exception for details on the root cause of this exception

Error Code: 8003

classNotFoundException

Cause: The class specified in the EJBQL string was not found

Action: Ensure that the class is on the appropriate classpath

Error Code: 8004

aliasResolutionException

Cause: TopLink was unable to resolve the alias used in the EJBQL string

Action: Validate the identifiers used in the EJBQL string

Error Code: 8005

resolutionClassNotFoundException

Cause: TopLink was unable to resolve the class for an alias. This means that the class specified can not be found

Action: Ensure the class is specified properly and is on the classpath

Error Code: 8006

missingDescriptorException

Cause: The class specified in the query has no TopLink descriptor

Action: Ensure the class has been mapped and is specified correctly in the EJBQL string

Error Code: 8009

expressionNotSupported

Cause: An unsupported expression was used in the EJBQL

Action: Change the query to use only supported expressions

Synchronization Exceptions (8050 - 8070)

Error Code: 8050

DROPPING_REMOTE_CONNECTION

Cause: A communication error over the communication framework

Action: Reconnect the server to this session. If using the default discovery system restart the session on the disconnected server

Error Code: 8051

ERROR_DOING_REMOTE_MERGE

Cause: The remote server's cache has become corrupt.

Action: Restart the session on the remote server or initialize identity maps

Error Code: 8052

ERROR_DOING_LOCAL_MERGE

Cause: The local shared cache has become corrupt.

Action: Restart the session on this server or initialize identity maps.

Error Code: 8053

ERROR_LOOKING_UP_LOCAL_HOST

Cause: Failed to get the IP address of the local machine for generating the SessionID.

Action: Contact network administrator.

Error Code: 8054

ERROR_BINDING_CONTROLLER

Cause: A Global Naming Service, such as JNDI, was unavailable at supplied URL.

Action: Check that the LocalHostURL points to the Service and verify that the Service is available.

Error Code: 8055

ERROR_LOOKING_UP_CONTROLLER

Cause: Failed to find the remote connection for a remote session.

Action: Verify that the Global Naming Service, such as JNDI, is running properly.

Error Code: 8056

ERROR_UNMARSHALLING_MSG

Cause: Message from remote system could not be read by this session.

Action: None, however some servers may not be connected.

Error Code: 8057

ERROR_GETTING_SYNC_SERVICE

Cause: Failed to create the specified Synchronization Service.

Action: Verify that you have specified an available Synchronization service in the current configuration file, or in your application code.

Error Code: 8058

ERROR_NOTIFYING_CLUSTER

Cause: Failed to send existence announcement to remote servers.

Action: Check that this machine has access to the network and restart Synchronization service.

Error Code: 8059

ERROR_JOINING_MULTICAST_GROUP

Cause: Failed to set socket to listen to the multicast group.

Action: Contact network administrator to verify that this machine has network access and can use Multicast protocols.

Error Code: 8070

ERROR_RECEIVING_ANNOUNCEMENT

Cause: Error occurred while attempting to receive a Multicast announcement.

Action: Verify that this machine is connected to the network and is capable of sending and receiving multicast packets.


Go to previous page Go to next page
Oracle
Copyright © 2002 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Solution Area
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index