In the main Puma window, click on Collect Performance Data.
The Data Collection window appears, with the Choose Target Program
dialog box overlying it.
Choosing a Target Program |
 |
The first task is to identify the target program from
which Puma will collect performance data. For this purpose, use the
Choose Target Program dialog box (Title not available).
To invoke a new program, you need to supply an executable
filename. On the Choose Target Program dialog box, follow these steps:
Click on Invoke Program. Other items
on the dialog box become highlighted.
In the Program Name box, type vanderbilt.
If you wanted
to use another example program, or if you hadn't copied
vanderbilt to your current directory, you could have entered
a full pathname or clicked on File List to select the target
from a list in a dialog box.
In the Program Arguments box, type 2.
Click on OK.
The Choose Target Program dialog box closes and uncovers the Data
Collection window.
Note: If you initially invoke Puma from the shell with a program name and
(optional) program arguments, such as
Puma starts up with the Select Target Program dialog box open and
with those items filled in. You need only click OK on the Select
Target Program dialog box to confirm.
Examining the Data Collection Window |
|
The Data Collection window (shown in Title not available) controls all aspects of
data collection.
Notice the Context pane on the Data Collection window.
Here Puma identifies the target program, its working directory,
and the name of the file to which Puma will write the collected
data. You can change any of these items before
starting data collection by using the Context pulldown menu.
Similarly, you can use the Options menu to change data-collection options
such as the sampling interval or the treatment of dynamically loaded libraries.
For now, this tutorial uses the default context and options for data collection.
Starting Data Collection |
|
Click on the Invoke... button at the bottom of the window.
Puma invokes the program vanderbilt and begins collecting
data on its performance.
After a moment, the histograms in the Target Program Time Use
pane begin to move (Title not available).
The moving histograms give a current snapshot (left) and a cumulative view (right)
of the relative use of CPU time. The three bars correspond, respectively, to the
CPU time used by the target program, the CPU time used by the system on behalf of
the target program, and the combined CPU time of all processes other than the
target program. Above the pane, Puma displays a running count of the number of
data samples taken and the time elapsed.
The space above the `Target Program Time Use'' pane is used to display
notes on the progress of data collection.
Data collection ends when the target program's execution is complete.
At this point, the Invoke... button is highlighted again, and
the histograms are frozen at their final values.
Click on File:Close on the Data Collection window and return to
the main Puma window.
Printable version
