jumpshots(1)

NAME

Jumpshots - Graphical Visualization Tools for Parallel

Programs

DESCRIPTION

Jumpshots are graphical tools for understanding the per

formance 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 in

terprets CLOG tracefiles and Jumpshot-3 interprets SLOG trace

files 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 de

fault. 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. How

ever 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 directo

ry at mpe/viewers/jumpshot-3.

USAGE

Both versions of Jumpshots are installed in the final in

stall 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 defi

nitions 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 con

tains a lot more graphic bugs fixed. So users are advised to use

Jumpshot-3 whenever possible.

LOCATION

/home/MPI/mansrc/jumpshot

9/2/2000

Jumpshots(1)