getExceptionHandlerStack

Product Information > JADE Encyclopaedia of Classes – Volume 2 > Chapter 1 - System Classes > getExceptionHandlerStack

getExceptionHandlerStack

getExceptionHandlerStack(oa: ObjectArray input);

The getExceptionHandlerStack method of the Process class populates a transient instance of the ObjectArray class with transient instances of the ExceptionHandlerDesc class that represent the exception handlers armed by the receiving process in the current node.

This method is not available on a Compact JADE node, where it would result in a 1068 - Feature not available exception.

In the array, locally armed exception handlers precede globally armed exception handlers. Within this grouping, the most recently armed exception handlers occur first.

The method displays only exception handlers the process has armed on the current node. For example, it does not display global exception handlers armed in a serverExecution method, unless executed from a serverExecution method.

The use of the getExceptionHandlerStack method is shown in the following code example. It is the responsibility of the calling method to delete the transient instances of the ExceptionHandlerDesc class.

showArmedExceptionHandlers();
vars
    oa: ObjectArray;
    o:  Object;
begin
    create oa transient;
    process.getExceptionHandlerStack(oa);
    foreach o in oa do
        write o.display;
    endforeach;
epilog
    oa.purge;
    delete oa;
end;