Error statement (LotusScript® Language)

Signals an error number and its corresponding message.

Syntax

Error errNumber [ , msgExpr ]

Elements

errNumber

A numeric expression whose value is a LotusScript® defined error number or a user-defined error number.

msgExpr

Optional.

A string expression containing an error message. This string replaces any existing message associated with the error number.

Usage

If errNumber is a LotusScript-defined error number, this Error statement simulates a LotusScript® error. If it is not, this statement creates a user-defined error. When the Error statement is executed, LotusScript® behaves as if a run-time error has occurred. If no error handling is in effect (set up by an On Error statement) for the specified error, execution ends and an error message is generated.

The error message generated is msgExpr if it is specified. If msgExpr is omitted, the error message is the LotusScript® error message for the specified error number, if that number designates a LotusScript® error. Otherwise the message "User-defined error" is generated.

User-defined errors must be in the range 1000-1999. Errors less than 1000 are reserved for the LotusScript® language; the constant ErrLast is the highest error number implemented. Errors greater than 1999 are reserved for IBM® products that use LotusScript®.

See LSERR.LSS for a list of LotusScript® errors.

Example