Progress.Lang.Error interface

The Progress.Lang.Error interface describes a common set of properties and methods that built-in ABL error classes implement. This interface cannot be implemented by a user-defined class. For user-defined classes, create a subclass of the Progress.Lang.AppError class to create your own type of ABL error object. See the Progress.Lang.AppError class for more information.

The Progress.Lang.Error interface defines the properties and methods shown in the following table:

Table 1. Properties and methods
Member Description
CallStack property Returns a string representing the call stack at the time the error object was created. For Progress.Lang.StopError, this property is always populated. For all other error objects, if the ERROR-STACK-TRACE attribute of the SESSION handle is false, then this property returns the Unknown value (?). To enable the call stack, set SESSION:ERROR-STACK-TRACE property to TRUE directly, or use the -errorstack startup parameter.
NumMessages property This property indicates how many error messages the error object contains.
Severity property The Severity property is not used by ABL system errors and returns zero if accessed. It is provided as a mechanism to assign severity rankings to your various application errors (Progress.Lang.AppError).
GetMessage( MessageIndex ) method Returns the error message for the error at the specified index position in the object’s message list,beginning with one (1). If there is no error message at the indicated index, the method returns the empty string.
GetMessageNum( MessageIndex ) method Returns the error message number for the error at the specified index position in the object’s message list. For the Progress.Lang.SysError and Progress.Lang.SoapFaultError objects, the method returns the unique message number for the system generated error. If there is no error message at the index, the method returns 0. If the object is a .NET Exception, the method also returns 0.