Error Message Format

This section provides information about how to interpret the LotusScript® Extensions (LC LSX) error messages. It describes the format of each error and what each component of the error message indicates.

Example Error Message

The following shows a sample error message:

Error: Two Fields cannot have the same name within a Form, Connector Notes®, Method -Create [Metadata]- (0x80000803)

Error Message Components

The error message shown previously can be broken down into the following components:

"Error: " -- This prefix is added to any error. It is not included for 'events' (informational messages).

"Two Fields cannot have the same name within a Form" -- This is the specific error message. This can be either an LC error message, or an external error message. In this case, it is an external error message.

"Connector 'Notes" -- This is the connector which generated the error message. This element is included only when the error occurs inside an LCConnection method; it is skipped otherwise.

"Method-Create [Metadata]" -- This is the LCConnection method in which the error occurred. It is only generated when the connector is included in the error message. It indicates the LCConnection method generating the error. In addition, for methods which accept a parameter indicating an object type (Create, Drop, or Catalog) or action type (Action), the object or action type is included in brackets for more information.

"(0x80000803)" -- This is the external error code generated by the external system. It is only included when the actual error was LCFAIL_EXTERNAL, which is true whenever the error is not an LC LSX error. When the value is between -65536 and 65536, the decimal value is used. When it is less or greater, the hex value is used.

Format of Errors

Errors appear in the following format:

  • Hex Value
  • Decimal Value
  • Constant
  • Text
  • Description