While Running the Survey Tool

The Survey tool runs and performs extensive analysis of your running serial program's executable target to help you choose possible places to add parallelism.

While the Survey tool is running your target 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 Survey Report window. When a target executes for a very short duration, it may not be possible for the Survey tool to collect sufficient data to provide a Survey Report. In this case, a message (Target executed too quickly or does not contain debug symbols) appears instead. Consider increasing the workload or data set of the target, check whether debug information was specified as a build option, or specify a different target (click the link for the Troubleshooting Survey Tool ... help topic listed below under See Also).

• New information appears in the dashboard-like 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 in the Survey Report window's command toolbar.

• Resume data collection that you previously paused. To resume collection, click the button in the Survey Report window's command toolbar.

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 get impatient, you can stop or cancel the collection by doing one of the following:

• Stop data collection and retain the collected data. To do this, click the button in the Survey Report window's command toolbar.

• Cancel data collection and discard the collected data. To do this, click the button in the Survey Report window's command toolbar.

• To interrupt data finalization, click the button. The collected data is retained. In this case, close the Result tab and re-open it:
  • To close a Result, right click its tab and select Close from the context menu.
  • To re-open a Result , click the appropriate icon in the Advisor Workflow, or use Solution Explorer, as described in Opening a Result.

Once data collection and analysis have completed, data appears in the Survey Report window. In addition to the Survey Report window, you can view details in the Survey source window.