Use this statement to signal an exception condition.

Syntax

SIGNAL exception-name

Remarks

SIGNAL allows you to raise an exception. For a description of how exceptions are handled, see Using exception handlers in procedures and triggers.

Use exception-name to specify the name of an exception declared using a DECLARE statement at the beginning of the current compound statement. The exception must correspond to a system-defined SQLSTATE or a user-defined SQLSTATE. User-defined SQLSTATE values must be in the range 99000 to 99999.

Permissions

None.

Side effects

None.

See also

• RESIGNAL statement
• BEGIN statement
• Using exception handlers in procedures and triggers

Standards and compatibility

Example

The following compound statement declares and signals a user-defined exception. If you execute this example from Interactive SQL, the message My exception signaled appears on the Messages tab in the Results area.

BEGIN
   DECLARE myexception EXCEPTION
   FOR SQLSTATE '99001';
   SIGNAL myexception;
   EXCEPTION
      WHEN myexception THEN
         MESSAGE 'My exception signaled'
         TO CLIENT;
END