CallStack property

Contains the ABL procedure call stack at the time that a method call or property access raises an error.

Data type: CHARACTER

Access: PUBLIC Readable

Applies to: Progress.Lang.ProError class, System.Exception class (OpenEdge-enhanced)

Returns the contents of the call stack as a string at the time the ABL error object or .NET Exception object was thrown. If the error occurs from the user interface, the procedure containing the latest WAIT-FOR statement will be at the top of the call stack.

Note: The StackTrace property of a .NET Exception object also provides a stack trace from the implementation of the .NET object being called (the stack of managed routine names and offsets).

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 session startup parameter.

Caution: The ERROR-STACK-TRACE default value is FALSE because maintaining a call stack for error handling requires overhead that is not warranted in a production environment.

For more information, see ERROR-STACK-TRACE attribute reference entry. For more information on -errorstack, see OpenEdge Deployment: Startup Command and Parameter Reference.

The call stack contains one entry for each item on the stack starting with the last item, which is where the error occurred. An entry is delimited with the newline character. Each entry contains three values, separated by whitespace:

Main block (.p), internal procedure, user-defined function, or method name
Complete path of containing file
Line number where the error occurred

For a main block (.p): complete-path-of-.p-file         complete-path-of-.p-file:line-number   For an internal procedure: internal-procedure-name          complete-path-of-.p-file:line-number   For a user-defined function: user-defined-function-name       complete-path-of-.p-file:line-number   For a method: method-name                      complete-path-of.cls-file:line-number

line-number

The line number in the source code file where the call was made. If there is no explicit source code line, then line-number will be replaced by the word “IMPLICIT.” For example, if the AVM implicitly invoked a call to a super class constructor, “IMPLICIT” appears where the line number would normally appear.

See also: ERROR-STACK-TRACE attribute

OpenEdge Release 10.2B

Copyright © 2009 Progress Software Corporation