TotalView Users Guide - CI Wiki

Setting Process and Thread Focus
A P/T set is a list that contains one or more P/T identifiers. (The next section,
“Specifying Arenas” on page 259, explains what a P/T identifier is.) Tcl
lets you create lists in the following ways:
� You can enter these identifiers within braces ({}).
� You can use Tcl commands that create and manipulate lists.
These lists 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 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 GUI, the default set is determined by the current
Process Window.) This set is displayed as the default CLI prompt. (For information
on this prompt, see “About the CLI Prompt” on page 207.)
You can change the focus on which a command acts by using the dfocus
command. If the CLI executes the dfocus command as a unique command,
it changes the default P/T set. For example, if the default focus is process 1,
the following command changes the default focus to process 2:
dfocus p2
After TotalView executes this command, all commands that follow focus on
process 2.
In the GUI, you set the focus by displaying a Process Window that contains this process.
Do this by using the P+ and P– buttons in the tab bar at the bottom, by making a selection
in the Processes/Ranks Tab, or by clicking on a process in the Root Window.
If you begin a command with dfocus, TotalView changes the target only for
the command that follows. After the command executes, TotalView
restores the former default. The following example shows both of these
ways to use the dfocus command. Assume that the current focus is process
1, thread 1. The following commands change the default focus to group 2
and then step the threads in this group twice:
dfocus g2
dstep
dstep
In contrast, if the current focus is process 1, thread 1, the following commands
step group 2 and then step process 1, thread 1:
dfocus g2 dstep
dstep
Some commands only operate at the process level; that is, you cannot
apply them to a single thread (or group of threads) in the process, but must
apply them to all or to none.
258 Chapter 13: Using Groups, Processes, and Threads