Captures the data from calling dcalltree in an associative Tcl array rather than writing the data to the console.
-show_details
Displays the data with all processes and threads displayed.
-hide_backtrace
Displays the data with only root and leaf nodes displayed.
-sortcolumn
Sorts the data display based on the data in a particular column. The possible arguments are Processes, Location, PC, Host, Rank, ID, and Status.
-save_as_csvfilename
Saves the backtrace data as a file of comma-separated values under the name filename.
-save_as_dotfilename
Saves the backtrace data as a dot file under the name filename. Dot is a plain text graph description language.
Description
The dcalltree command shows the state of processes and threads in a parallel job. Normally the output is written to the console, but the -data subcommand makes the data available as a Tcl associative array. The associative array has the following format:
{
{
Key <value>
Level <value>
Processes <value>
Location <value>
PC <value>
Host <value>
Rank <value>
ID <value>
Status <value>
}
{
...
}
}
If you are using TotalView for HPC, the data displayed by this command is similar to the data displayed in the Parallel Backtrace View window.
The -show_details and -hide_backtrace switches pull in opposite directions. The ‑show_details switch shows the maximum data, including all processes and threads. The -hide_backtrace command hides any intermediate nodes, displaying only the root and leaf nodes. If used together, this results in a display of root and leaf nodes and all threads. This reduction can help to de-clutter the data display if the number of processes and threads is large.
Command alias
Alias
Definition
Description
ct
dcalltree
Prints data to console
ctd
dcalltree -data
Puts data in a Tcl associative array
ctsd
dcalltree -show_details
Prints more complete data
ctshb
dcalltree -hide_backtrace
Prints data only on root and leaf nodes
Examples
dfocus group dcalltree
This example first changes the focus to the group using dfocus, then calls dcalltree with no switches. Note that the ID column is a compressed ptlist describing process and thread count, range, and IDs. See Compressed List Syntax (ptlist) for more information.