User`s guide

11 Functions — Alphabetical List
11-176
mpiprofile info returns a profiling data structure with additional fields to the one
provided by the standard profile info in the FunctionTable entry. All these fields
are recorded on a per-function and per-line basis, except for the *PerLab fields.
Field Description
BytesSent Records the quantity of data sent
BytesReceived Records the quantity of data received
TimeWasted Records communication waiting time
CommTime Records the communication time
CommTimePerLab Vector of communication receive time for each lab
TimeWastedPerLab Vector of communication waiting time for each lab
BytesReceivedPerLab Vector of data received from each lab
The three *PerLab fields are collected only on a per-function basis, and can be turned off
by typing the following command in pmode:
mpiprofile on -messagedetail simplified
mpiprofile viewer is used in pmode after running user code with mpiprofile on.
Calling the viewer stops the profiler and opens the graphical profile browser with parallel
options. The output is an HTML report displayed in the profiler window. The file listing
at the bottom of the function profile page shows several columns to the left of each line of
code. In the summary page:
• Column 1 indicates the number of calls to that line.
• Column 2 indicates total time spent on the line in seconds.
• Columns 3–6 contain the communication information specific to the parallel profiler
mpiprofile('viewer', <profinfoarray>) in function form can be used from the
client. A structure <profinfoarray> needs be passed in as the second argument, which
is an array of mpiprofile info structures. See pInfoVector in the Examples section
below.
mpiprofile does not accept -timer clock options, because the communication timer
clock must be real.
For more information and examples on using the parallel profiler, see “Profiling Parallel
Code ”.