scalasca - Man Page

scalasca [Options]
scalasca [Options] ACTION ACTION_ARGS

The scalasca command allows to query information about a Scalasca Trace Tools installation, but can also be used as a proxy command for measurement, analysis, post-processing, and report examination tasks.

When used without an ACTION argument, the scalasca command provides various Options to query and display information about the Scalasca Trace Tools installation, such as the version number, the configuration summary report, or installation-dependent path information. It is also possible to display a quick reference guide (if a suitable PDF viewer is found on the system).

By contrast, if an ACTION argument is given, the scalasca command acts as a proxy which simply delegates the requested operation to the underlying specific command. It can therefore be considered a single-entry-point convenience command that is easy to remember.

Since ACTION arguments enable the delegation of operations, please refer to the documentation of the respective underlying command for possible ACTION_ARGS. Also, note that ACTION_ARGS have to be provided after the ACTION argument.

-a,  --analyze,  --analyse

Run application under the control of the Scalasca measurement collection and analysis nexus scan(1).

-e,  --examine

Examine measurement analysis report using the Scalasca analysis report explorer square(1).  

-c,  --show-config

Print configuration summary, then exit.

-h,  --help

Print a brief usage summary, then exit.

-n,  --dry-run

Print the command(s) to be launched, but do not execute them.

--quickref

Display quick reference guide, then exit.

--remap-specfile

Show path to remapper specification file used for trace-analysis report post-processing, then exit.

-v,  --verbose

Enable verbose mode.

-V,  --version

Print version information, then exit.  

scalasca exits with status 0 on success, and greater than 0 if errors occur.

Please report bugs to scalasca@fz-juelich.de. Make sure to include at least the following information in your bug report:

• The Scalasca Trace Tools version reported by 'scalasca -V'.
• The Scalasca Trace Tools configuration reported by 'scalasca -c'.
• The Score-P version reported by 'scorep --version'.
• The Score-P configuration reported by 'scorep-info config-summary'.
• The exact command line of the failing command.
• The exact failure/error message.

Also, if the trace analysis fails, please archive a copy of the entire experiment archive directory including the event trace data, as this may be required to aid in debugging. However, ONLY PROVIDE TRACE DATA IF EXPLICITLY REQUESTED, as the data volume may be excessive.

scalasca --version
Displays the Scalasca Trace Tools version number.

scalasca --analyze mpiexec -n 4 foo args
Execute the instrumented MPI program foo with command-line arguments args, collecting a runtime summary (default). Results in an experiment directory scorep_foo_4_sum.

scalasca --examine -s -f filter scorep_foo_4_sum
Post-process measurement reports in scorep_foo_4_sum and generate a score report with the run-time measurement filter rules from the file filter applied.

scan(1), square(1)

The Score-P instrumentation and measurement system documentation is available online at https://www.score-p.org.

The full Scalasca Trace Tools documentation is available online at https://www.scalasca.org.

scout(1), square(1).