dset

Changes or views CLI variables

MiniContents:

Arguments
Description
Examples

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

Set the value to be used 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 Etnus-supplied default.

Description:

The dset command sets the value of CLI debugger variables. You'll find a listing and description of CLI and TotalView variables in "TotalView Variables".

If you type dset with no arguments, the CLI displays the names and current values for all TotalView CLI variables in the global namespace. If you use only one argument, the CLI returns and displays the variable's value.

The second argument defines the value that will replace a variable's previous value. It must be enclosed in quotes 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, just enter the namespace name immediately followed by a double colon; for example, TV::.

You can use an asterisk (*) as a wildcard to indicate that the CLI should match more than one string; for example, TV::g* matches all variables beginning with g in the TV namespace. For example, to view all variables in the TV:: namespace, you would enter:

dset TV::

or:

dset TV::GUI::

The rightmost double colons are required when obtaining listings for a namespace. If you omit 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.

Examples:

dset PROMPT "Fixme% "

Sets the prompt to be 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 a user changes this value in any way, the user will be able to select the Defaults button within the File > Preferences's Launch String Page to reset it to this value.

dset TV::GUI::fixed_font_size 12

Sets the TotalView GUI so that it displays fixed fonts using a 12 font. Commands such as this are often found in a startup file.