This chapter provides an introduction to the use of the Scalasca Trace Tools on the basis of the analysis of an example application. The most prominent features are addressed, and at times a reference to later chapters with more in-depth information on the corresponding topic is given.

Use of the Scalasca Trace Tools involves three phases: instrumentation of the target application, execution measurement collection and analysis, and examination of the analysis report. For instrumentation and measurement, the Scalasca Trace Tools 2.x release series leverages the Score-P infrastructure, while the Cube graphical user interface is used for analysis report examination. The Scalasca Trace Tools complement the functionality provided by Score-P and Cube with scalable automatic trace-analysis components, as well as convenience commands for controlling execution measurement collection and analysis, and analysis report post-processing.

Most of Scalasca's functionality can be accessed through the scalasca command, which provides action options that in turn invoke the corresponding underlying commands scorep, scan and square. These actions are:

scalasca -instrument

(or short skin) familiar to users of the Scalasca 1.x series is deprecated and only provided for backward compatibility. It tries to map the command-line options of the Scalasca 1.x instrumenter onto corresponding options of Score-P's instrumenter command scorep—as far as this is possible. However, to take full advantage of the functionality provided by Score-P, users are strongly encouraged to use the scorep instrumenter command directly. To assist in transitioning existing measurement configurations to Score-P, the Scalasca instrumentation wrapper prints the converted command that is actually executed to standard output.
scalasca -analyze

(or short scan) is used to control the Score-P measurement environment during the execution of the target application—supporting both runtime summarization and/or event trace collection, optionally including hardware-counter information—and to automatically initiate Scalasca's trace analysis after measurement completion if tracing was requested.
scalasca -examine

(or short square) is used to post-process the analysis report generated by a Score-P profiling measurement and/or Scalasca's automatic post-mortem trace analysis, and to start the Cube graphical user interface for analysis report examination.

To get a brief usage summary, call the scalasca command without arguments, or use scalasca --quickref to open the Scalasca Quick Reference (with a suitable PDF viewer). See also Section scalasca – Scalasca information and proxy command for a complete reference of the scalasca command.

Note: Under the hood, the Scalasca convenience commands leverage a number of other commands provided by Score-P as well as the CubeLib and CubeGUI components. Therefore, it is generally advisable to include the executable directories of appropriate installations of all those components in the shell search path ($PATH).

The following three sections provide a quick overview of each of these actions and how to use them during the corresponding step of the performance analysis, before a tutorial-style full workflow example is presented in Section A full workflow example.

Subsections: