Difference between revisions of "Error and Exception Handling"
Barrymavin (Talk | contribs) (→The Recital TRY...CATCH Statement) |
Yvonnemilne (Talk | contribs) (→Error and Exception Handling) |
||
| Line 1: | Line 1: | ||
==Error and Exception Handling== | ==Error and Exception Handling== | ||
| + | When an error occurs in a running application, Recital will stop execution, display an error message and create an ''error.mem'' file, unless an alternative error handling procedure has been specified. | ||
| + | |||
| + | ====Error.mem==== | ||
| + | The error.mem file includes the following information: | ||
| + | |||
| + | * The Recital Product version, release, platform and compile date information | ||
| + | * System information, such as maximum file size and maximum process stack | ||
| + | * Recital License information | ||
| + | * User and Node names and process ID | ||
| + | * The error number | ||
| + | * The error message | ||
| + | * The program line | ||
| + | * The program line number | ||
| + | * A stack trace of the programs and procedures called | ||
| + | * A list of all active public and private memory variables and classes | ||
| + | * Status of open tables, indexes and current records. | ||
| + | * Settings listing as per LIST STATUS | ||
| + | |||
| + | |||
| + | ====SET ERRORVERSION==== | ||
| + | The error.mem file will be named ''error.mem'' and will be overwritten by subsequent errors unless [[SET ERRORVERSION|set errorversion]] is ''on''. If set errorversion is ''on'', multiple numbered error.mem files are created with the following naming format: | ||
| + | |||
| + | error0001.mem | ||
| + | |||
| + | error0002.mem | ||
| + | |||
| + | error0003.mem | ||
| + | |||
| + | |||
| + | ====DB_ERRORDIR==== | ||
| + | The error.mem file(s) will be created in the directory that is current when the error occurs unless the [[DB_ERRORDIR]] environment variable is set. If set, DB_ERRORDIR points to a directory in which the error.mem file(s) will be created. | ||
| + | |||
===The ON ERROR statement=== | ===The ON ERROR statement=== | ||
===The TRY...CATCH Statement=== | ===The TRY...CATCH Statement=== | ||
===Summary=== | ===Summary=== | ||
Revision as of 16:07, 14 December 2009
Contents
Error and Exception Handling
When an error occurs in a running application, Recital will stop execution, display an error message and create an error.mem file, unless an alternative error handling procedure has been specified.
Error.mem
The error.mem file includes the following information:
- The Recital Product version, release, platform and compile date information
- System information, such as maximum file size and maximum process stack
- Recital License information
- User and Node names and process ID
- The error number
- The error message
- The program line
- The program line number
- A stack trace of the programs and procedures called
- A list of all active public and private memory variables and classes
- Status of open tables, indexes and current records.
- Settings listing as per LIST STATUS
SET ERRORVERSION
The error.mem file will be named error.mem and will be overwritten by subsequent errors unless set errorversion is on. If set errorversion is on, multiple numbered error.mem files are created with the following naming format:
error0001.mem
error0002.mem
error0003.mem
DB_ERRORDIR
The error.mem file(s) will be created in the directory that is current when the error occurs unless the DB_ERRORDIR environment variable is set. If set, DB_ERRORDIR points to a directory in which the error.mem file(s) will be created.
