Collecting Data for the synprog Example

You can collect data either from the command line with the collect command or from the Performance Tools Collect window in the Performance Analyzer.

Using the Command Line

To collect data for synprog from the command line, type the following commands in a terminal window:

% cd /work-directory/synprog
% collect synprog
% collect -F on synprog icpu.popen.cpu so.sx.exec \
system.forkexec

Here, work-directory is the full path to the directory that you created for the examples. You must collect data in the synprog subdirectory because synprog loads some shared objects from this directory. If you do not, the shared objects cannot be located by synprog.

The data from the two collect commands is stored in the synprog subdirectory in two experiments, which are named test.1.er and test.2.er. If you make a mistake in recording the experiments and already have experiments with these names, you can remove them using the er_rm command and then re-record the experiments.

Using the Performance Tools Collect Window

Follow these steps to collect data for the synprog program by using the Performance Tools Collect window:

  1. Choose File and choose  Collect Experiment to open the Performance Tools Collect window with the Collect Experiment tab selected.

    You will run two experiments for the synprog program: test.1.er and test.2.er.

  2. test.1.er: Set the following fields in the Collect Experiment tab of the Performance Tools Collect window to run the test.1.er experiment.
    1. Identify the build target in the Target field by typing the path to the directory in which you downloaded the synprog example in the text field, or by clicking Browse and selecting the target using the Target dialog box. For example: /home/users/JohnSmith/analyzer_examples/synprog/synprog
    2. Make sure the name for the experiment in the Experiment Name field is test.1.er.
    3. Make sure the working directory is correctly identified in the Working Directory field.
    4. Click Run.
    5. The Input/Output tab provides you with data as the experiment progresses. After the experiment is finished, a dialog box asks what you want to do next. Click Open Experiment.

  3. test.2.er: Make sure you are in the Collect Experiment tab of the Performance Tools Collect window. Set the following fields in the Collect Experiment tab of the Performance Tools Collect window to run the test.2.er experiment.
    1. Identify the build target in the Target field by either typing the path to the directory in which you downloaded the synprog example in the text field, or by clicking Browse and selecting the target using the Target dialog box. For example: /home/users/JohnSmith/analyzer_examples/synprog/synprog
    2. Enter the following arguments in the Arguments field.
      icpu.popen.cpu so.sc.exec system.forkexec.
    3. Make sure the name for the experiment in the Experiment Name field is test.2.er.
    4. Make sure the Data Limit (MB) field is set to 2000.
    5. Make sure the working directory is correctly identified in the Working Directory field.
    6. Leave the default settings for the other fields or buttons in this tab.
    7. Click the Data to Collect tab of the Performance Tools Collect window.
    8. Check the Heap Tracing and the Record on Descendent Processes options in the Data to Collect tab.
    9. Click Run.

After You Collect the Data

When you have finished collecting data, open the first experiment, test.1.er, in the Performance Analyzer.

For information on the collect command, see the collect(1) man page. If you are already familiar with the collect command, you can type make collect instead of the commands given above.


Can't find what you are looking for? Submit your comments at http://www.sun.com/hwdocs/feedback.
Legal Notices