Progress.Lang.StopError class

(Technical Preview only in OpenEdge Release 11.7)

When enabled, and the AVM encounters certain unexpected error conditions, the AVM throws an instance of this Progress.Lang.StopError class containing messages associated with the originating error, and raises the STOP condition.

Progress.Lang.StopError inherits common error handling abilities from Progress.Lang.ProError, which implements the Progress.Lang.Error interface. You can therefore catch this object in a CATCH block to trap error messages associated with the STOP condition.

You cannot inherit from this class.

Serializable:

Yes

Constructors

The class constructors are reserved for system use only.

Super Class

Progress.Lang.SysError class

Interfaces

This class does not implement interfaces (beyond those it inherits from its base class).

Public Properties

This class does not contain properties (beyond those it inherits from its base class).

Public Methods

This class does not contain methods (beyond those it inherits from its base class).

Public Events

This class does not contain events.

Notes

In order to enable the AVM to throw Progress.Lang.StopError objects, you must specify the Catch STOP (-catchStop) startup parameter with the value 1 (-catchStop 1). Otherwise, the AVM raises the STOP condition only, without throwing the associated object.
By catching a StopError object with a CATCH block, you can trap the error messages associated with the error that caused the AVM to raise the STOP condition and throw the StopError object in the first place.
Note: You can instead trap the STOP condition using the ON STOP phrase on an associated block, but you can neither identify that an error caused the AVM to raise the STOP condition nor trap the associated error messages using this phrase.
StopError objects are put on the SESSION:FIRST-OBJECT chain when they are caught by a CATCH block.
Uncaught StopError objects are automatically deleted by the AVM and removed from the SESSION:FIRST-OBJECT chain.