Totalview® for HPC Reference Guide : PART I CLI Commands : Chapter 5 TotalView Variables : TV::GUI:: Namespace
TV::GUI:: Namespace
NOTE >> The variables in this section have meaning (and in some cases, a value) only when you are using the TotalView GUI.
TV::GUI::chase_mouse
When this variable is set to true, TotalView displays dialog boxes at the location of the mouse cursor. If this is set to false, TotalView displays them centered in the upper third of the screen.
Permitted Values: true or false
Default: true
TV::GUI::display_bytes_kb_mb
When true, the Memory Debugger displays memory block sizes in megabytes. If set to false, it displays memory blocks sizes in kilobytes.
Permitted Values: true or false
Default: true
TV::GUI::display_font_dpi
Indicates the video monitor DPI (dots per inch) at which fonts are displayed.
Permitted Values: An integer
Default: 75
TV::GUI::enabled
When true, you invoked the CLI from the GUI or a startup script. Otherwise, this read-only value is false.
Permitted Values: true or false
Default: true if you are running the GUI even though you are seeing this in a CLI window; false if you are only running the CLI
TV::GUI::fixed_font
Indicates the specific font TotalView uses when displaying program information such as source code in the Process Window or data in the Variable Window. This variable contains the value set when you select a Code and Data Font entry in the Fonts Page of the File > Preferences dialog box.
This is a read-only variable.
Permitted Values: A string naming a fixed font residing on your system
Default: While this is platform specific, here is a representative value:-adobe-courier-medium-r-normal--12-120-75-75-m-70-iso8859-1
TV::GUI::fixed_font_family
Indicates the specific font TotalView uses when displaying program information such as source code in the Process Window or data in the Variable Window. This variable contains the value set when you select a Code and Data Font entry of the Fonts Page of the File > Preferences dialog box.
Permitted Values: A string representing an installed font family
Default: fixed
TV::GUI::fixed_font_size
Indicates the point size at which TotalView displays fixed font text. This is only useful if you have set a fixed font family because if you set a fixed font, the value entered contains the point size.
Font sizes are indicated using printer points.
Permitted Values: An integer
Default: 12
TV::GUI::font
Indicates the specific font used when TotalView writes information as the text in dialog boxes and in menu bars. This variable contains the information set when you select a Select by full name entry in the Fonts Page of the File > Preferences dialog box.
Permitted Values: A string naming a fixed font residing on your system. While this is platform specific, here is a representative value:-adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1
Default: helvetica
TV::GUI::force_window_positions
Setting this variable to true tells TotalView that it should use the version 4 window layout algorithm. This algorithm tells the window manager where to set the window. It also cascades windows from a base location for each window type. If this is not set, which is the default, newer window managers such as kwm or Enlightenment can use their smart placement modes.
Dialog boxes still chase the pointer as needed and are unaffected by this setting.
Permitted Values: true or false
Default: false
TV::GUI::frame_offset_x
Not implemented.
TV::GUI::frame_offset_y
Not implemented.
TV::GUI::geometry_call_tree
Specifies the position at which TotalView displays the Tools > Call Tree Window. This position is set using a list containing four values: the window’s x and y coordinates. These are followed by two more values specifying the window’s width and height.
If you set any of these values to 0 (zero), TotalView uses its default value. This means, however, you cannot place a window at x, y coordinates of 0, 0. Instead, you’ll need to place the window at 1, 1.
If you specify negative x and y coordinates, TotalView aligns the window to the opposite edge of the screen.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_cli
Specifies the position at which TotalView displays the Tools > CLI Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_expressions
Specifies the position at which TotalView displays the Tools > Expression List Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_globals
Specifies the position at which TotalView displays the Tools > Program Browser Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_help
Specifies the position at which TotalView displays the Help Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_memory_stats
Specifies the position at which TotalView displays the Tools > Memory Statistics Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinate’s and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_message_queue
Specifies the position at which TotalView displays the Tools > Message Queue Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_message_queue_graph
Specifies the position at which TotalView displays the Tools > Message Queue Graph Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_modules
Specifies the position at which TotalView displays the Tools > Fortran Modules Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height.
Default: {0 0 0 0}
TV::GUI::geometry_process
Specifies the position at which TotalView displays the Process Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_ptset
No longer used.
TV::GUI::geometry_root
Specifies the position at which TotalView displays the Root Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_thread_objects
Specifies the position at which TotalView displays the Tools > Thread Objects Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_variable
Specifies the position at which TotalView displays the Variable Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::geometry_variable_stats
Specifies the position at which TotalView displays the Tools > Statistics Window.
See TV::GUI::geometry_call_tree for information on setting this list.
Permitted Values: A list containing four integers indicating the window’s x and y coordinates and the window’s width and height
Default: {0 0 0 0}
TV::GUI::hand_cursor_enabled
Specifies whether the cursor should change to a hand cursor when hovering over an element you can dive into in the source pane of the process window.
Permitted Values: true or false
Default: true
TV::GUI::heap_summary_refresh
Not user settable.
TV::GUI::inverse_video
Not implemented.
TV::GUI::keep_expressions
Deprecated.
TV::GUI::keep_search_dialog
When true, TotalView doesn’t remove the Edit > Find dialog box after you select that dialog box’s Find button. If you select this option, you will need to select the Close button to dismiss the Edit > Find box.
Permitted Values: true or false
Default: true
TV::GUI::old_root_window
When true, TotalView replaces the Root Window with the Root Window used in versions prior to TotalView for HPC 8.15. You can override this value using the following command-line options:
-oldroot sets this variable to true
-newroot sets this variable to false
NOTE >> Using the previous-version Root Window may affect performance of applications containing thousands of threads/processes.
Permitted Values: true or false
Default: false
TV::GUI::pop_at_breakpoint
When true, TotalView sets the Open (or raise) process window at breakpoint check box to be selected by default. If this variable is set to false, it sets that check box to be deselected by default.
Permitted Values: true or false
Default: false
TV::GUI::pop_on_error
When true, TotalView sets the Open process window on error signal check box in the File > Preferences’s Option Page to be selected by default. If you set this to false, TotalView sets that check box to be deselected by default.
Permitted Values: true or false
Default: true
TV::GUI::process_grid_wanted
When true, TotalView enables the Processes/Ranks Tab in the Process Window. Enabling this tab can significantly affect performance, particularly for large, massively parallel applications.
Permitted Values: true or false
Default: false
TV::GUI::show_startup_parameters
Setting this value to true tells TotalView to display that it should display the Process > Startup dialog box when you use a program name as an argument to the TotalView command.
Permitted Values: true or false
Default: true
TV:GUI:show_sys_thread_id
Setting this value to true tells TotalView to display the current thread’s system thread ID within the TotalView GUI.
Permitted Values: true or false
Default: true
TV::GUI::single_click_dive_enabled
When set, you can perform dive operations using the middle mouse button. Diving using a left-double-click still works. If you are editing a field, clicking the middle mouse performs a paste operation.
Permitted Values: true or false
Default: true
TV::GUI::toolbar_style
This value set defines toolbar display.
Permitted Values: icons_above_text, icons_besides_text, icons, or text
Default: icons_above_text
TV::GUI::tooltips_enabled
When true, variable tooltips are displayed in the Process Window Source Pane.
Permitted Values: true or false
Default: true
TV::GUI::ui_font
Indicates the specific font used when TotalView writes information as the text in dialog boxes and in menu bars. This variable contains the information set when you select a Select by full name entry in the Fonts Page of the File > Preferences dialog box.
Permitted Values: While this is platform specific, here is a representative value:-adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1
Default: helvetica
TV::GUI::ui_font_family
Indicates the family of fonts that TotalView uses when displaying such information as the text in dialog boxes and menu bars. This variable contains the information set when you select a Family in the Fonts Page of the File > Preferences dialog box.
Permitted Values: A string
Default: helvetica
TV::GUI::ui_font_size
Indicates the point size at which TotalView writes the font used for displaying such information as the text in dialog boxes and menu bars. This variable contains the information set when you select a User Interface Size in the Fonts Page of the File > Preferences dialog box.
Permitted Values: An integer
Default: 12
TV::GUI::using_color
Not implemented.
TV::GUI::using_text_color
Not implemented.
TV::GUI::using_title_color
Not implemented.
TV::GUI::version
This number indicates which version of the TotalView GUI is being displayed. This is a read-only variable.
Permitted Values: A number