Top-Level (::) Namespace

ARGS(dpid)

Contains the arguments that TotalView passes to the process with TotalView ID dpid the next time you start the process.

Permitted Values: A string

Default: None

ARGS_DEFAULT

Contains the argument passed to a new process when no ARGS(dpid) variable is defined.

Permitted Values: A string

Default: None

BARRIER_STOP_ALL

Contains the value for the "stop_when_done" property for newly created action points. This property tells TotalView what else it should stop when a barrier point is satisfied. This property also tells TotalView what else it should stop when a thread encounters this action point. You can also set this value using the When barrier hit, stop value in the Action Points Page of the File > Preferences Dialog Box. The values that you can use are as follows:

group: TotalView will stop all processes in a thread's control group when a thread reaches a barrier created using this as a default.

process: TotalView will stop the process in which the thread is running when a thread reaches a barrier created using this default.

none: TotalView just stops the thread that hit a barrier created using this default.

This variable is the same as the TV::barrier_stop_all variable.

Permitted Values: group, process, or thread

Default: group

BARRIER_STOP_WHEN_DONE

Contains the default value that TotalView uses when a barrier point is satisfied. You can also set this value if you use the -stop_when_done command-line option or the When barrier done, stop value in the Action Points Page of the File > Preferences Dialog Box. The values you can use are as follows:

group: When a barrier is satisfied, TotalView stops all processes in the control group.

process: When a barrier is satisfied, TotalView stops the processes in the satisfaction set.

none: TotalView only stops the threads in the satisfaction set; other threads are not affected. For process barriers, there is no difference between process and none.

In all cases, TotalView releases the satisfaction set when the barrier is satisfied.

This variable is the same as the TV::barrier_stop_when_done variable.

Permitted Values: group, process, or thread

Default: group

CGROUP(dpid)

Contains the control group for the process with the TotalView ID dpid. Setting this variable moves process dpid into a different control group. For example, the following command moves process 3 into the same group as process 1:

dset CGROUP(3) $CGROUP(1) 

Permitted Values: A number

Default: None

COMMAND_EDITING

Enables some Emacs-like commands that you can use while editing text in the CLI. These editing commands are always available in the CLI window of the TotalView GUI. However, they are only available in the stand-alone CLI if the terminal in which you are running it supports cursor positioning and clear-to-end-of-line. The commands that you can use are:

^A: Moves the cursor to the beginning of the line.

^B: Moves the cursor one character backward.

^D: Deletes the character to the right of cursor.

^E: Moves the cursor to the end of the line.

^F: Moves the cursor one character forward.

^K: Deletes all text to the end of line.

^N: Retrieves the next entered command (only works after ^P).

^P: Retrieves the previously entered command.

^R or ^L: Redraws the line.

^U: Deletes all text from the cursor to the beginning of the line.

Rubout or Backspace: Deletes the character to the left of the cursor.

Permitted Values: true or false

Default: false

EXECUTABLE_PATH

Contains a colon-separated list containing the directories that TotalView searches when it looks for source and executable files.

Permitted Values: Any directory or directory path. To include the current setting, use $EXECUTABLE_PATH.

Default: . (dot)

GROUP(gid)

Contains a list containing the TotalView IDs for all members in group gid.

The first element in the list indicates what kind of group it is, as follows:

control

The group of all processes in a program

lockstep

A group of threads that share the same PC

process

A user-created process group

share

The group of processes in one program that share the same executable image

thread

A user-created thread group

workers

The group of worker threads in a program

Elements that follow are either pids (for process groups) or pid.tid pairs (for thread groups).

The gid is a simple number for most groups. In contrast, a lockstep group's ID number is of the form pid.tid. Thus, GROUP(2.3) contains the lockstep group for thread 3 in process 2. Note, however, that the CLI will not display lockstep groups when you use dset with no arguments--they are hidden variables.

The GROUP(id) variable is read-only.

Permitted Values: A Tcl array of lists indexed by the group ID. Each entry contains the members of one group.

Default: None

GROUPS

Contains a list that contains all TotalView groups IDs. Lockstep groups are not contained in this list. This is a read-only value and cannot be set.

Permitted Values: A Tcl list of IDs.

LINES_PER_SCREEN

Defines the number of lines shown before the CLI stops printing information and displays its more prompt. The following values have special meaning:

0

No more processing occurs, and the printing does not stop when the screen fills with data.

NONE

This is a synonym for 0.

AUTO

The CLI uses the tty settings to determine the number of lines to display. This may not work in all cases. For example, Emacs sets the tty value to 0. If AUTO works improperly, you will need to explicitly set a value.

Permitted Values: A positive integer, or the AUTO or NONE strings.

Default: Auto

MAX_LEVELS

Defines the maximum number of levels that the dwhere command will display.

Permitted Values: A positive integer.

Default: 512

MAX_LIST

Defines the number of lines that the dlist command will display.

Permitted Values: A positive integer

Default: 20

PROCESS(dpid)

Contains a list of information associated with a dpid. This is a read-only value and cannot be set.

Permitted Values: An integer

Default: None

PROMPT

Defines the CLI prompt. If you use brackets ([ ]) in the prompt, TotalView assumes the information within the brackets is a Tcl command and evaluates this information before it creates the prompt string.

Permitted Values: Any string. If you wish to access the value of PTSET, you must place the variable within brackets; that is, [dset PTSET].

Default: {[dfocus]> }

PTSET

Contains the current focus. This is a read-only value and cannot be set.

Permitted Values: A string

Default: d1.<

SGROUP(pid)

Contains the group ID of the share group for process pid. TotalView decides which share group this is by looking at the control group for the process and the executable associated with this process. You cannot directly modify this group.

Permitted Values: A number

Default: None

SHARE_ACTION_POINT

Indicates the scope in which TotalView places newly created action points. In the CLI, this is the dbarrier, dbreak, and dwatch commands. If this Boolean value is true, newly created action point are shared across the group. If it is false, a newly created action point is only active in the process in which it is set.

As an alternative to setting this variable, you can select the Plant in share group check box in the Action Points Page in the File > Preferences Dialog Box. You can override this value in the GUI by using selecting the Plant in share group checkbox in the Action Point > Properties Dialog Box.

Permitted Values: true or false

Default: true

STOP_ALL

Indicates a default property for newly created action points. This property tells TotalView what else it should stop when it encounters this action point. The values you can set are as follows:

group

Stops the entire control group when the action point is hit.

process

Stops the entire process when the action point is hit.

thread

Only stops the thread that hit the action point. Note that none is a synonym for thread.

Permitted Values: group, process, or thread

Default: group

TAB_WIDTH

Indicates the number of spaces used to simulate a tab character when the CLI displays information.

Permitted Values: A positive number. A value of -1 indicates that the CLI does not simulate tab expansion.

Default: 8

THREADS(pid)

Contains a list of all threads in the process pid, in the form {pid.1 pid.2 ...}. This is a read-only variable and cannot be set.

Permitted Values: A Tcl list.

Default: None

TOTALVIEW_ROOT_PATH

Names the directory in which the TotalView executable is located. This is a read-only variable and cannot be set. This variable is exported as TVROOT, and is can be used in launch strings.

Permitted Values: The location of the TotalView installation directory.

TOTALVIEW_TCLLIB_PATH

Contains a list containing the directories in which the CLI searches for TCL library components.

Permitted Values: Any valid directory or directory path. To include the current setting, use $TOTALVIEW_TCLLIB_PATH.

Default: The directory containing the CLI's Tcl libraries

TOTALVIEW_VERSION

Contains the version number and the type of computer architecture upon which TotalView is executing. This is a read-only variable and cannot be set.

Permitted Values: A string containing the platform and string.

Default: Platform-specific

VERBOSE

Controls the error message information displayed by the CLI. The values for this variable can be:

INFO

Prints errors, warnings, and informational messages. Informational messages include data on dynamic libraries and symbols.

WARNING

Only print errors and warnings.

ERROR

Only print error messages.

SILENT

Does not print error, warning, and informational messages. This also shuts off the printing of results from CLI commands. This should only be used when the CLI is run in batch mode.

Permitted Values: INFO, WARNING, ERROR, and SILENT

Default: INFO

WGROUP(pid)

The group ID of the thread group of worker threads associated with the process pid. This variable is read-only.

Permitted Values: A number

Default: None

WGROUP(pid.tid)

Contains one of the following:

• The group ID of the workers group in which thread pid.tid is a member
   
• 0 (zero), which indicates that thread pid.tid is not a worker thread

Storing a nonzero value in this variable marks a thread as a worker. In this case, the returned value is the ID of the workers group associated with the control group, regardless of the actual nonzero value that you had assigned to it.

Permitted Values: A number representing the pid.tid

Default: None