Go to main content
Oracle Developer Studio 12.6 Man Pages

Exit Print View

Updated: June 2017
 
 

tha (1)

Name

tha - graphical tool for viewing profiling data in a Thread Analyzer experiment

Synopsis

tha [ options ] [ experiment-list ]
tha [-j | --jdkhome jvm-path] [-Jjvm-options]
    [-f | --fontsize size] [-u | --userdir dir_path]
    [-v | --verbose] [experiment-list]
tha -V | -version
tha -? | -h | --help

Description

The tha command invokes a graphical data analysis tool for analyzing the various Thread Analyzer experiments collected by the Collector using the collect(1) command. Thread Analyzer is a version of the Performance Analyzer customized for examining Thread Analyzer experiments.

The Collector gathers thread analysis information to create a Thread Analyzer experiment during the execution of a process. Thread Analyzer reads in such an experiment and displays any errors detected. Thread Analyzer supports data race detection and deadlock detection. For further information, see the Help in Thread Analyzer and the Thread Analyzer User's Guide in the documentation library at https://docs.oracle.com/cd/E60778_01/.

A command line utility called er_print is also available for displaying data from Thread Analyzer experiments in text form. See the er_print(1) man page.

Options

-j | --jdkhome jvmpath

Specify the path to the Java virtual machine (JVM) software for running Thread Analyzer. The default path is taken first by examining environment variables for a path to the JVM, in the order JDK_HOME, and then JAVA_PATH. If neither environment variable is set, the version found on your PATH is used. If none is found, /usr/java/bin/java is tried.

-Jjvm-option

Specify JVM software options. Multiple -J arguments can be supplied. Note that there is no space between the -J flag and the jvm-option. Examples:

 
tha -J-d64 -- run the 64-bit analyzer (valid for Java 7 only)
tha -J-Xmx2G -- run with maximum JVM memory of 2 GB 
          (Default, 1 GB)
tha -J-d64 -J-Xmx8G -- run the 64-bit analyzer with maximum 
          JVM memory of 8 GB
-f | --fontsize size

Specify the font size to be used by Thread Analyzer.

-u | --userdir dir_path

Specify the path to the user directory in which to store user settings.

-v | --verbose

Print version information and Java runtime arguments before starting.

-V | --version

Print version information and exit.

-? | -h | --help

Print usage information and exit.

Operands

experiment-list

Specify one or more experiments or groups to open. To specify more than one experiment, provide a space-separated list of experiment names, experiment group names, or both. If you specify more than one experiment, the data in the experiments is aggregated. Comparison of data is not supported for data races and deadlocks.

Usage

Starting Thread Analyzer

To start Thread Analyzer and open an experiment called test.1.er, type the following on the command line:

% tha test.1.er

If you do not specify any experiment names when invoking Thread Analyzer, the initial view is the Welcome screen. You can open experiments from the Welcome screen or by using Thread Analyzer's File menu and toolbar buttons to open experiments.

See Also

analyzer(1), collect(1), discover(1), er_archive(1), er_cp(1), er_export(1), er_mv(1) , er_print(1), er_rm(1), er_src(1), tha(1), libtha(3)

Thread Analyzer User's Guide

Performance Analyzer manual