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.
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.