Launching the Visualizer from the Command Line

To start the Visualizer from the shell, use the following syntax:

    visualize [ -file filename | -persist ]

where:

-file filename

Reads data from filename instead of reading from standard input.

-persist

Continues to run after encountering an EOF on standard input. If you do not use this option, the Visualizer exits as soon as it reads all of the data from standard input.

By default, the Visualizer reads its input datasets from its standard input stream and exits when it reads an EOF on standard input. When started by TotalView, the Visualizer normally reads its data from a pipe, ensuring that the Visualizer exits when TotalView does. If you want the Visualizer to continue to run after it exhausts all input from the standard input stream, invoke it by using the -persist option.

If you want to read data from a file, invoke the Visualizer with the -file option. For example:

    visualize -file my_data_set_file

The Visualizer reads all the datasets in the file. This means that the images you see represent the last versions of the datasets in the file.

The Visualizer supports the generic X toolkit command-line options. For example, you can start the Visualizer with the Directory Window minimized by using the -iconic option. Your system manual page for the X server or the The "X Window System User's Guide" by O'Reilly & Associates lists the gen-eric X command-line options in detail.

You can also customize the Visualizer by setting X resources in your resource files or on the command line with the -xrm resource_setting option. The available resources are described in TotalView Command Syntax. Use of X resources to modify the default behavior of TotalView or the TotalView Visualizer is described in greater detail in X Resources.