• 9.1
• 07/08/2015
• Public Content
Contents

# Working with the Intel® Trace Analyzer and Collector Examples

﻿
You can find the Intel® Trace Analyzer and Collector examples directory at
<install_dir>/examples
. This topic explains how to create a trace file for the
vtjacobic
executable file. You can apply the same principles to other sample files and your own applications.
Compiling and Instrumenting Test Files on Linux* OS
Before analyzing sample trace files, set up your working directory as follows.
1. Copy the
examples
directory into a shared directory, which is accessible by all nodes of the cluster.
2. Clean up the directory content and compile and execute the C and Fortran executable files, entering the following commands:

gmake distclean
gmake all

The resulting output will look as follows:

vnallpair
vnallpairc
vnjacobic
vnjacobif
vtallpair
vtallpairc
vtcounterscopec
vtjacobic
vtjacobif

Note
The executable files listed above have already been linked with the appropriate Intel® Trace Collector libraries.
To analyze trace the
vtjacobic
executable, do the following:
1. Create a
vtjacobic_inst
directory and set the following environment variable:

setenv VT_LOGFILE_PREFIX vtjacobic_inst

This environment variable ensures that the trace files for the analysis appear in the created directory.
2. To run your MPI application, enter the command:

mpirun -n 4 -trace ./vtjacobic

The
vtjacobic_inst
directory should now contain the following files:

.                     vtjacobic.stf.dcl          vtjacobic.stf.msg.anc
..                     vtjacobic.stf.frm          vtjacobic.stf.pr.0
vtjacobic.prot         vtjacobic.stf.gop          vtjacobic.stf.pr.0.anc
vtjacobic.stf          vtjacobic.stf.gop.anc      vtjacobic.stf.sts
vtjacobic.stf.cache    vtjacobic.stf.msg

3. For details, refer to the Intel® MPI Library documentation.

## Compiling and Instrumenting Test Files on Windows* OS

1. Create a shared directory which is accessible to all nodes of the cluster and copy the
examples
directory into it.
2. Clean up the directory content:

nmake distclean

To compile and execute the C and Fortran executable files, enter the following command:

nmake all MPIDIR="<
install-dir>\MPI\em64t"

The following C and Fortran executable files appear under the
examples
directory:

mpiconstants.exe
vnallpair.exe
vnallpairc.exe
vnjacobic.exe
vnjacobif.exe
vtallpair.exe
vtallpairc.exe
vtcounterscopec.exe
vtjacobic.exe
vtjacobif.exe
vttimertest.exe

Note
The
MPIDIR
makefile variable is explicitly set to the directory of the Intel MPI Library that supports 64-bit address extensions.
For the executable files above, the following STF files are created:

timertest.stf
vtallpair.stf
vtallpairc.stf
vtcounterscopec.stf
vtjacobic.stf
vtjacobif.stf


## Analyzing Trace Data

To analyze trace files, do the following:
1. To analyze the newly created
vtjacobic.stf
trace file, enter the following commands.
On Linux* OS:

\$ traceanalyzer vtjacobic_inst/vtjacobic.stf

On Windows* OS:

> traceanalyzer vtjacobic.stf

Intel® Trace Analyzer displays the
Flat Profile
tab for
vtjacobic.stf
:
2. To view the
Event Timeline
chart, go to
Charts
>
Event Timeline
:

#### Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804