While Running the Suitability Tool

The Suitability tool runs and examines your running serial program's executable target to provide approximate performance characteristics of your annotated parallel sites. This data helps you predict both the performance gain from running your parallel program on multiple cores and the likely impact of parallel overhead. After you change annotations or fix data sharing problems reported by the Dependencies tool, run the Suitability tool again to revise the program's predicted performance.

While the Suitability tool is running your program:

  • Analysis data is collected as the program runs. Non-GUI application output appears in the Application Output pane. A log of the collection messages appears in the Collection Log pane.

  • When data collection completes, data finalization prepares the data for display.

  • After finalization completes, the data appears in the Suitability Report window. Any annotation-related error the Suitability tool detects appears at the top of the Suitability Report window. If you see such errors, the displayed Suitability data may not be reliable. To view the source location associated with an error, click the button. To fix the error, read the displayed error message, modify your source code to fix the problem, rebuild your target executable, and run Suitability tool analysis again.

  • Updated information appears in the Summary window, including the collection times and links that allow you to view the application output and collection output messages.

During data collection, you can temporarily pause and later resume data collection. To manually skip uninteresting parts of your target while the target continues to run, you can:

  • Temporarily stop (pause) data collection. To do this, click the button under 3. Check Suitability in the Threading Workflow tab.

  • Resume data collection that you previously paused. To resume collection, click the button under 3. Check Suitability in the Threading Workflow tab.

Instead of manually clicking the and buttons, you can add the Pause Collection and Resume Collection annotations around uninteresting source code region(s). These annotations are recognized by all three Intel Advisor tools.

If you need to stop or cancel the collection, do one of the following:

  • Stop data collection and retain the collected data. To do this, click the click the button under 3. Check Suitability in the Threading Workflow tab. The tool will finalize any data that has been collected and display it in the Suitability Report.

  • Cancel data collection and discard the collected data. To do this, click the button under 3. Check Suitability in the Threading Workflow tab. The tool will discard all the data that has just been collected and instead display the previously collected data in the Suitability Report.

  • To interrupt data finalization, click the button.

Once data collection and analysis are complete, data appears in the Suitability Report window. In addition to the Suitability Report window, you can view details in the Suitability Source window.

For more complete information about compiler optimizations, see our Optimization Notice.