Open topic with navigation

This command displays the contents of the state indicator in the active workspace.  The state indicator identifies those operations which are suspended or pendent for each suspension.

The optional parameter n specifies that only the first n or last ¯n lines of the output should be displayed.

The optional parameter -tid=tn specifies that the state indicator is to be displayed only for thread number tn.

The list consists of a line for each suspended or pendent operation beginning with the most recently suspended function or operator.  Each line may be:

• The name of a defined function or operator, followed by the line number at which the operation is halted, and followed by the * symbol if the operation is suspended. The name of the function or operator is its full pathname relative to the root namespace #. For example, #.UTIL.PRINT. In addition, the display of a function or operator which has dynamically changed space away from its origin is prefixed with its current space. For example, [⎕SE] TRAV.
• A primitive operator symbol.
• The Execute function symbol (⍎).
• The Evaluated Input symbol (⎕).
• The System Function ⎕DQ or ⎕SR (occurs when executing a callback function).

Examples

      )SI
#.PLUS[2]*
.
#.MATDIV[4]
#.FOO[1]*
⍎

This example indicates that at some point function FOO was executed and suspended on line 1. Subsequently, function MATDIV was invoked, with a function derived from the Inner Product or Outer Product operator (.) having defined function PLUS as an operand.

In the following, function foo in namespace x has called goo in namespace y. Function goo has then changed space (⎕CS) to namespace z where it has been suspended:

      )SI
[z] y.goo[2]*
x.foo[1]

Threads

In a multi-threading application, where parent threads spawn child threads, the state indicator assumes the structure of a branching tree. Branches of the tree are represented by indenting lines belonging to child threads. For example:

      )SI
·   #.Calc[1]
&5
·   ·   #.DivSub[1]
·   &7
·   ·   #.DivSub[1]
·   &6
·   #.Div[2]*
&4
#.Sub[3]
#.Main[4]

Here, Main has called Sub, which has spawned threads 4 and 5 with functions: Div and Calc. Function Div, after spawning DivSub in each of threads 6 and 7, has been suspended at line [2].

The state indicator for a particular thread tn may be displayed by specifying the parameter -tid=tn.

       ⎕←foo&¨10 10 10 10
┌→─────────┐
│9 10 11 12│
└~─────────┘
       )si
·   #.foo[1]
&9
·   #.foo[1]
&10
·   #.foo[1]
&11
·   #.foo[1]
&12
      )si -tid=11
#.foo[1]