P/T Set and Arena Identifier Syntax
Create a P/T set in the CLI by either:
![*](p4-bullet.jpg)
Entering arena identifiers within braces (
{ }) to create a Tcl list.
![*](p4-bullet.jpg)
Using Tcl commands that create and manipulate the list of arena identifiers.
P/T sets are then used as arguments to a command. If you’re entering one element, you usually do not have to use the Tcl list syntax.
For example, the following list contains arena specifiers for process 2, thread 1, and process 3, thread 2:
{p2.1 p3.2}
If you do not explicitly specify a P/T set in the CLI, TotalView defines a target set for you. In the UI, the default is the process and thread in the Processes & Threads view. In the CLI, this default is indicated by the focus, which is shown in the default CLI prompt. (See
About the CLI Prompt.)
To save a P/T set definition for later use, assign the specifiers to a Tcl variable, for example:
set myset {g2.3 t3.1}
dfocus $myset dgo
The dfocus command returns the default focus, so you can save this value for later use, for example:
set save_set [dfocus]
Defining the Thread of Interest (TOI) in an Arena Specifier
The TOI is specified as p.t, where p is the TotalView process ID (DPID) and t is the TotalView thread ID (DTID). The p.t combination identifies the process of interest (POI) and thread of interest (TOI). The TOI is the primary thread acted on by a TotalView command. For example, while the dstep command always steps the TOI, it may also run the rest of the threads in the POI and step other processes in the group.
In addition to using numerical values, you can also use two special symbols:
![*](p4-bullet.jpg)
The less-than character (
<) indicates the
lowest numbered worker thread in a process, and is used instead of the DTID value. If, however, the arena explicitly names a thread group, the
< symbol means the lowest numbered member of the thread group. This symbol lets TotalView select the first user thread, which is not necessarily thread 1.
![*](p4-bullet.jpg)
A dot (
.) indicates the current set. Although you seldom use this symbol interactively, it can be useful in scripts.