Removes the top-most suspended expression evaluation.
dflush
Removes the computation indicated by a suspended evaluation ID and all those that precede it
dflushsusp-eval-id
Removes all suspended computations
dflush -all
Arguments
susp-eval-id
The ID returned or thrown by the dprintcommand or which is printed by the dwherecommand.
-all
Flushes all suspended evaluations in the current focus.
Description
The dflushcommand unwinds the stack to eliminate frames generated by suspended computations. Typically, these frames can occur when using the dprint -nowait command. Other possibilities are if an error occurred in a function call in an eval point, in an expression in a Tools > Evaluate window, or if you use a $stopfunction.
Use this command as follows:
• If you don’t use an argument, the CLI unwinds the top-most suspended evaluation in all threads in the current focus.
• If you use a susp-eval-id, the CLI unwinds each stack of all threads in the current focus, flushing all pending computations up to and including the frame associated with the ID.
• If you use the-all option, the CLI flushes all suspended evaluations in all threads in the current focus.
If no evaluations are suspended, the CLI ignores this command. If you do not indicate a focus, the default focus is the thread of interest.
Examples
The following example uses the dprint command to place five suspended routines on the stack. It then uses the dflush command to remove them. This example uses the dflush command in three different ways.
#
# Create 5 suspended functions
#
d1.<> dprint -nowait nothing2(7)
7
Thread 1.1 hit breakpoint 4 at line 310 in "nothing2(int)"
d1.<> dprint -nowait nothing2(8)
8
Thread 1.1 hit breakpoint 4 at line 310 in "nothing2(int)"
d1.<> dprint -nowait nothing2(9)
9
Thread 1.1 hit breakpoint 4 at line 310 in "nothing2(int)"
d1.<> dprint -nowait nothing2(10)
10
Thread 1.1 hit breakpoint 4 at line 310 in "nothing2(int)"
d1.<> dprint -nowait nothing2(11)
11
Thread 1.1 hit breakpoint 4 at line 310 in "nothing2(int)"