The following HPCPI session shows the basic commands for setting up and starting HPCPI to
collect data, and commands to analyze the data. The steps are numbered and described in the
sections that follow.

% module load hpcpi

#1 Load the HPCPI environment
# (or setenv PATH /opt/hpcpi/bin:$PATH)

% setenv HPCPIDB /tmp/hpcpidb #2 Set the DB environment variable
% mkdir -p $HPCPIDB

#3 Create the DB directory

% hpcpid

#4 Start the HPCPI daemon

% ./myApp

#5 Run the image you want to profile

% hpcpictl flush

#6 Flush the data

% hpcpiprof

#7 View per-image statistics

% hpcpiprof myApp

#8 View per-procedure statistics

% hpcpilist routine1 myapp

#9 View per-line statistics

% hpcpictl quit

#10 Stop the HPCPI daemon

Step 1: Loading the HPCPI Environment

The HPCPI daemon and utilities are installed in the /opt/hpcpi/bin directory by default. On
systems with the modules utility installed, you can enter the following command to add
/opt/hpcpi/bin

to your PATH environment variable:

% module load hpcpi

Alternatively, you can manually add /opt/hpcpi/bin to your PATH. For example, you can
enter the following command:

% setenv PATH /opt/hpcpi/bin:$PATH

Step 2: Setting the HPCPI Database Environment Variable (HPCPIDB)

The environment variable HPCPIDB enables you to set the default HPCPI database directory for
the HPCPI daemon and HPCPI utilities. Enter the appropriate shell command to set the HPCPIDB
environment variable to the directory you want to use for the HPCPI database. For example, you
can use a command similar to the following:

% setenv HPCPIDB my_directory

Simple HPCPI Session