dset
Changes or views CLI variables
Format
Changes a CLI variable
dset debugger-var value
Views current CLI variables
dset [ debugger-var ]
Sets the default for a CLI variable
dset -set_as_default debugger-var value
Arguments
debugger-var
Name of a CLI variable.
value
Value to be assigned to debugger-var.
-set_as_default
Sets the value to use as the variable’s default. This option is most often used by system administrators to set site-specific defaults in the global .tvdrc startup script. Values set using this option replace the CLI built-in default.
Description
The
dset command sets the value of CLI debugger variables. CLI and TotalView variables are described in
Chapter 5, "TotalView Variables".
If you use the dset command with no arguments, the CLI displays the names and current values for all CLI variables in the global namespace. If you use only one argument, the CLI returns and displays that variable’s value.
The second argument defines the value that replaces a variable’s previous value. You must enclose it in quotation marks if it contains more than one word.
If you do not use an argument, the CLI only displays variables in the current namespace. To show all variables in a namespace, enter the namespace name immediately followed by a double colon; for example, TV::.
You can use an asterisk (*) as a wildcard character to tell the CLI to match more than one string; for example, TV::g* matches all variables in the TV:: namespace beginning with g. For example, to view all variables in the TV:: namespace, enter the following:
dset TV::
or:
dset TV::GUI::
You need to type the double colons at the end of this example when obtaining listings for a namespace. Without them, Tcl assumes that you are requesting information on a variable. For example, dset TV::GUI looks for a variable named GUI in the TV namespace.
Using -set_as_default
When you press a default button within a File > Preferences dialog box, TotalView reinitializes some settings to their original values. However, what happens if you set a value in your tvdrc file when you press a default button? In this case, setting a variable doesn't change what TotalView thinks the default is, so it still changes the setting back to its defaults.
The next time you invoke TotalView, TotalView will again use the value in your tvdrc.
You can tell TotalView that the value set in your tvdrc file is the default if you use the -set_as_default option. Now when you press a default button, it will use your value instead of its own.
If your TotalView administrator sets up a global .tvdrc file, TotalView reads values from that file and merges them with your preferences and other settings. If the value in the .tvdrc file changes, TotalView ignores the change because it has already set a value in your local preferences file. If the administrator uses the -set_as_default option, you can be told to press the default button to get the changes. If, however, the administrator doesn't use this option, the only way to get changes is by deleting your preferences file.
Examples
dset PROMPT "Fixme% "
Sets the prompt to Fixme% followed by a space.
dset *
Displays all CLI variables and their current settings.
dset VERBOSE
Displays the current setting for output verbosity.
dset EXECUTABLE_PATH ../test_dir;$EXECUTABLE_PATH
Places ../test_dir at the beginning of the previous value for the executable path.
dset -set_as_default TV::server_launch_string \
{/use/this/one/tvdsvr}
Sets the default value of the TV::server_launch_string. If you change this value, you can later select the Defaults button within the File > Preferences Launch String page to reset it to its original value.
dset TV::GUI::fixed_font_size 12
Sets the TotalView GUI to display information using a 12-point, fixed-width font. Commands such as this are often found in a startup file.
Related Topics