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).
- -i, -inst, --instrument
Prepare application objects and executable for measurement using the Score-P instrumenter. This action only exists for backward compatibility with the Scalasca 1.x release series.
Users are strongly encouraged to use the 'scorep' instrumenter command directly to take full advantage of its improved functionality.
- -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.
Display quick reference guide, then exit.
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 firstname.lastname@example.org. Make sure to include at least the following information in your bug report:
- The Scalasca Trace Tools version reported by '
- The Scalasca Trace Tools configuration reported by '
- The Score-P version reported by '
- The Score-P configuration reported by '
- 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.
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.
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.