Jumpshots(1)

NAME
Jumpshots - Graphical Visualization Tools for Parallel Programs

DESCRIPTION
Jumpshots are graphical tools for understanding the performance of parallel programs. They are evolved from upshot and are written in Java. There are 2 versions of Jumpshots, Jumpshot-2 and Jumpshot-3 , distributed with MPE. Jumpshot-2 interprets CLOG tracefiles and Jumpshot-3 interprets SLOG tracefiles which is capable of handle big tracefiles (in GB range).

CONFIGURING & BUILDING JUMPSHOTS
Since Jumpshots are distributed with MPE, the top level MPE configure will configure both version of Jumpshots by default. Through the use of configure option --with-java=<JDK> in MPE configure, user can supply a user installed java installation to MPE to build both version of Jumpshots. Even though Jumpshot-3 can be built by both JDK 1.1 and JDK 1.2, Jumpshot-2 can only be built with JDK 1.1. Because of this limitation, user is advised to use JDK 1.1 when building Jumpshots for MPE. However user can build Jumpshot-2 and Jumpshot-3 separately from MPE with different versions of JDK. If user chooses to do that, be sure to install them back to the final install directory share/, otherwise the logviewer script won't work properly. A list of configure options is available by typing ./configure --help in the top-level jumpshot-2 and jumpshot-3 directories. For detailed information on building Jumpshot-2 , refer to the README in the top-level jumpshot-2 source directory at mpe/viewers/jumpshot-2. For details information on building Jumpshot-3 , refer to the README and UserGuide.txt in the top-level jumpshot-3 directory at mpe/viewers/jumpshot-3.

USAGE
Both versions of Jumpshots are installed in the final install directory, share/. End-users are not expected to call jumpshots directly, instead there is a display program selector script called logviewer located in bin/. This script will select the appropriate viewer based on the logfile's file extension, ie. log file format. For more information about logviewer, do "logviewer -help". For more details on the button definitions in Jumpshot-2 , click the help button on Jumpshot-2's main window to bring up the ASCII version of button definitions. For Jumpshot-3 , besides the ASCII version of button definitions available by clicking in the main window's help -> Manual buttons, there is also a HTML viewer which displays a step-by-step tour of Jumpshot-3 of how and what user can learn from a typical logfile. The HTML tour can be invoked by clicking the main window's help -> Tour buttons. New users of Jumpshots are advised to read the Tour document.

ADDITIONAL INFORMATION
Jumpshot-3 is written based on Jumpshot-2 but contains many enhanced new features not found in Jumpshot-2, and also contains a lot more graphic bugs fixed. So users are advised to use Jumpshot-3 whenever possible.

LOCATION
/home/MPI/mansrc/jumpshot