---

EXCEPTION_INIT Pragma

The EXCEPTION_INIT pragma associates a user-defined exception name with an Oracle Database error number. You can intercept any Oracle Database error number and write an exception handler for it, instead of using the OTHERS handler.

Syntax

exception_init_pragma ::=

Description of the illustration exception_init_pragma.gif

Keyword and Parameter Descriptions

error_number

Any valid Oracle Database error number. These are the same error numbers (always negative) returned by the function SQLCODE.

exception_name

A user-defined exception declared within the current scope.

Be sure to assign only one exception name to an error number.

PRAGMA

Signifies that the statement is a pragma (compiler directive). Pragmas are processed at compile time, not at run time. They pass information to the compiler.

Usage Notes

A EXCEPTION_INIT pragma can appear only in the same declarative part as its associated exception, anywhere after the exception declaration.

Examples

• Example 11-4, "Using PRAGMA EXCEPTION_INIT"

• Example 12-9, "Bulk Operation that Continues Despite Exceptions"

Related Topics

• Exception Declaration

• Exception Handler

• SQLCODE Function

• SQLERRM Function

• Associating a PL/SQL Exception with a Number (EXCEPTION_INIT Pragma)