APPENDIX A CONFIGURATION AND TROUBLESHOOTING

Error Messages
IBM® Lotus® Domino® Enterprise Connection Services (DECS) error messages are listed below.

Cannot use field [‘FIELDNAME’] as both a key and a data field

Fields provided for RealTime activities must be either key fields or data fields - a field cannot be used as both in a single Virtual Fields activity (although one field can be used as a key in one activity, and data in another activity). Remove any field that is used as both a key field and a data field from at least one of those lists.

Failure accessing shared RealTime Activities table

An internal error was encountered when attempting to access activity information. Record as much information as possible about the circumstances and contact Lotus technical support.

Failure encountered in monitoring process

Errors that are generated by the RealTime monitors in the IBM® Lotus® Domino® server are logged with this prefix. The complete error text from the RealTime error is appended.

Unexpected internal failure in RealTime monitoring

An internal error was encountered when attempting to access context information. Record as much information as possible about the circumstances and contact technical support.

Update of key field [‘FIELDNAME’] is not permitted

Key values in a document were altered, but the Virtual Fields activity indicated that changes to key fields should be blocked. Updates to both Notes and the back-end system were aborted.

This record has changed in the back-end database since being opened - action cancelled

The Virtual Fields activity option to check the external system for changes before writing changes to the back end was enabled, and the check indicated changes in the back end. Since the document was opened, another system or client changed the corresponding external record.

Cannot locate corresponding external record

The key values in the opened document being monitored by a Virtual Fields activity did not correspond to a record in the external system. This error can be suppressed by selecting the Virtual Fields activity option to create the external record if it doesn’t exist - instead of the error, a new record corresponding to the current IBM Lotus Notes document data will be created.

Failure compiling Filter Formula

The filter formula provided for the Virtual Fields activity failed compilation. The compilation error is generated with the error message. Fix or remove the filter formula to successfully run the Virtual Fields activity.

Failure compiling Pre-Open Formula: FORMULA COMPILATION ERROR

The pre-open formula provided for the Virtual Fields activity failed compilation. The compilation error is generated with the error message. Fix or remove the pre-open formula to successfully run the Virtual Fields activity.

Failure compiling Post-Update Formula: FORMULA COMPILATION ERROR

The post-update formula provided for the Virtual Fields activity failed compilation. The compilation error is generated with the error message. Fix or remove the post-update formula to successfully run the Virtual Fields activity.

Failure compiling Post-Create Formula: FORMULA COMPILATION ERROR

The post-create formula provided for the Virtual Fields activity failed compilation. The compilation error is generated with the error message. Fix or remove the post-create formula to successfully run the Virtual Fields activity.

Failure compiling Post-Delete Formula: FORMULA COMPILATION ERROR

The post-delete formula provided for the Virtual Fields activity failed compilation. The compilation error is generated with the error message. Fix or remove the post-delete formula to successfully run the Virtual Fields activity.

Unknown OS error: libdecsext.*

This is a Notes error reporting that Notes couldn’t load the DECS extension manager library. Check that you have properly installed and configured DECS. If problems persist, contact technical support.

Realtime service addin task initialization failed

This indicates that the LEI addin task startup encountered an error. Check that you have properly installed and configured LEI. If problems persist, contact Lotus software technical support.

Realtime service is unable to allocate addin task resources

The Realtime Service is unable to allocate additional resources. Check that you have properly installed and configured LEI. If problems persist, contact Lotus software technical support.

Realtime service cannot connect to external system

You may not have the proper connectivity software installed that is required for accessing the external data system. Refer to the Lotus Enterprise Integrator Installation Guide for information about the native software required for connectivity to each of the LEI supported data sources.

Realtime service cannot find external table/metadata

The metadata selected for this activity does not exist in the back end data source.

Realtime service cannot find external procedure/transaction

The document open event captured by LEI encountered an error. The error details are logged to the Domino server log.

Realtime service error retrieving external record

The document open event captured by LEI encountered an error. The error details are logged to the Administrator activity log for this activity.

Realtime service error inserting external record

The document creation event captured by LEI encountered an error. The error details are logged to the Administrator activity log for this activity.

Realtime service error updating external record

The document update event captured by LEI encountered an error. The error details are logged to the Administrator activity log for this activity.

Realtime service error deleting external record

The document deletion event captured by LEI encountered an error. The error details are logged to the Administrator activity log for this activity.

Realtime service cannot locate the corresponding record in the external system

The document key field values do not correspond to a record in the back end data source. The record in the external data system may have been deleted.

Realtime service unable to update document due to key field changes; changes to key fields have been disabled

The key fields in the external data have been modified since the document has been opened. To allow key field changes, select the appropriate setting for the option Key Field Updates in the Document Update options section of the activity Document.

Realtime service is unable to update document due to conflict; the external record has been modified since being opened

The external data has been modified by another application since the document has been opened. Close and reopen the document.

Realtime service error storing external attachment

There was a problem storing the attachment portion of the document to the external data store.

Realtime service error retrieving external attachment

There was a problem retrieving the attachment portion of the document from the external data store.

Realtime service cannot locate the attachment in the external system

There was a problem locating the attachment portion of the document in the external data store.

Realtime service data overflow accessing external record

For document Open events, this indicates that data in an external field was too long. Usually this is due to text longer than 64K. To avoid this problem, change the Notes field to Rich Text. (See the error in the Administrator activity log for this activity for information on which field caused the overflow.)

For document updates and inserts, this message indicates that the document data overflowed a back end field. You may need to change the data type in the back end to store large amounts of data.

Realtime service encountered invalid or corrupt Notes data in the external system

Information not yet available.

Realtime service error deleting external attachment

There was a problem deleting the attachment portion of the document from the external data store.

Realtime service error browsing the external system

There was a problem retrieving information about the names of tables in the database, or retrieving the data type information about the columns in a particular table.

Realtime service encountered an invalid external field configuration in form

Information not yet available.

Realtime service encountered a missing or invalid Data Connection Resource

You get this message when you are using the Domino Designer Data Connection Resource (DCR). The Data Connection Resource that was referred to by one or more of the fields on the form is not valid, or could not be located.

Realtime service error scanning the external system. Some external records may have been ignored

During a view refresh, an error occurred when retrieving document information from the external data store.

Realtime service error loading external agents/design elements

An error occurred while accessing a virtual agent.

Realtime service error retrieving external agent/design element

Information not yet available.

Realtime service error writing external agent/design element

Information not yet available.

Realtime service error deleting external agent/design element

Information not yet available.

This application uses a Realtime Service Activity which is currently not running. Contact your Notes administrator.

During an attempt to open or delete a document, a needed running Virtual Fields activity could not be found. Verify that the activity monitoring this database form is running. If so, fully refresh your view in the possibility that the external data source record has been deleted. Also check the activity log for any additional error information.




Feedback on Help or Product Usability?