TakeError (process specified error)

Top  Previous  Next


TakeError( error id ), PROC


Locates the specified error, calls the appropriate method to handle it, then returns the severity level.

error id

An integer constant, variable, EQUATE, or expression that indicates which error to process.

The TakeError method locates the specified error, then based on its severity level calls the appropriate (TakeLevel) method to process the error, then returns the severity level.

TakeError assumes SetErrors has already been called to save the current error state.


The ABERROR.INC file contains a list of default symbolic constants for the error id parameter.

By default, the error manager recognizes six different levels of error severity. The TakeError method calls a different virtual method (TakeLevel) for each severity level, which makes it easy to override the default error actions with your own application-specific error actions. The recognized severity EQUATEs are declared in ABERROR.INC. These severity levels and their default actions are:



no action, returns Level:Benign



displays message, returns Level:Benign or Level:Cancel



displays message, returns Level:Benign



displays message, halts the program



treated as Level:Fatal


any other value

treated as Level:Program

Return Data Type:     BYTE


See Also:     Errors, SetErrors, TakeBenign, TakeNotify, TakeUser, TakeFatal, TakeProgram, TakeOther, Throw