An object reference to an instance of a class that implements the Progress.Lang.Error interface. The instance describes an ERROR condition raised by an asynchronous call to a procedure or Web service operation. This attribute holds the Unknown value (?) if there is no ERROR or relevant STOP condition.
Note: If the object reference is to an instance of Progress.Lang.StopError, it describes a STOP condition raised from an unexpected error in the asynchronous call, not an ERROR condition itself.
The error or stop object the attribute references can be thrown by the server or raised in the client before anything is run on the server, for example, if there is an error in processing one of the parameters.
Compared to the ERROR-STATUS system handle , ERROR-OBJECT can accommodate user-defined error objects, thereby providing more information to the client.
Notes
Stop object support is available as a Technology Preview only in OpenEdge Release 11.7.
Error objects can be thrown by the server:
From an error CATCH block
Using the ROUTINE-LEVEL ON ERROR UNDO, THROW directive
Using a Progress.Lang.AppError object that is created as a result of a RETURN ERROR in the called procedure
StopError objects can be thrown by the server:
From a stop CATCH block
Whenever the server does not handle the corresponding STOP condition and the client has a relevant CATCH block on its portion of the call stack
If a StopError object is thrown from the server, its error messages continue to be available on the client from the serialized object even though they are written to the log file on the OpenEdge application server.
Stop object support is available as a Technology Preview only in OpenEdge Release 11.7.