Using Caché ObjectScript - InterSystems Documentation

Using %STACK to Display the Stack
Level Type Line Source
1 SIGN ON
2 DO ~DO ^StackTest
3 NEW ALL/EXCL NEW (E)
4 DO TEST+1^StackTest SET A=1 ~DO TEST1 QUIT ;level=2
5 NEW NEW A
6 DO TEST1+1^StackTest ~DO TEST2 ;level = 3
7 ERROR TRAP SET $ZTRAP="TrapTag^StackTest"
8 XECUTE TEST2+2^StackTest ~XECUTE "SET A=$$TEST3()"
9 $$EXTFUNC ^StackTest ~SET A=$$TEST3()
10 PARAMETER AA
11 DIRECT BREAK TEST3+1^StackTest ~BREAK
12 DO ^StackTest ~DO ^%STACK
Under the current execution stack display, %STACK prompts you for a stack display action. You can get help by entering
a question mark () at the “Stack Display Action” prompt.
14.3.2 Displaying the Process Execution Stack
Depending on what you enter at the “Stack Display Action” prompt, you can display the current process execution stack
in four forms:
• Without variables, by entering *F
• With a specific variable, by entering *V
• With all variables, by entering *P
• With all variables, preceded by a list of process state variables, by entering *A
14.3.2.1 Displaying the Stack without Variables
The process execution stack without variables appears when you first enter the %STACK utility or when you type the stack
action *F.
14.3.2.2 Displaying the Stack with a Specific Variable
Enter *V at the “Stack Display Action” prompt, followed by the name of the variable you want to track through the stack.
In the following example, the variable e is being tracked and the display is sent to the screen by pressing RETURN at the
“Device:” prompt.
Stack Display Action: *V
Variable(s):e
Display on Device:
14.3.2.3 Displaying the Stack with All Defined Variables
Enter *P to see the process execution stack together with the current values of all defined variables.
14.3.2.4 Displaying the Stack with All Variables, including State Variables
You can print all possible reports to screen, file or printer by entering *A at the “Stack Display Action” prompt. This report
prints the following:
• Process state variables
• Process execution stack with all variables
14.3.3 Understanding the Stack Display
Each item on the stack is called a frame. The following table describes the information provided for each frame.
Using Caché ObjectScript 165