User Guide

  • 2020
  • 06/18/2020
  • Public Content
Contents

Pause Collection and Resume Collection Annotations

The Pause Collection and Resume Collection annotations let you stop and resume data collection to skip uninteresting parts of the target program's execution. If you pause data collection, the target executable continues to execute until you resume data collection. Pausing data collection minimizes the amount of data collected and speeds up the analysis of large applications.
In addition to these annotations, you can click certain buttons on the side command toolbar to pause or resume data collection:
  • You can start the Survey and Suitability tools with data collection either paused or enabled. For example, the
    Start Paused
    button starts executing the target being analyzed with data collection (analysis) disabled. Also, once the tool is started, you can pause and resume data collection by using the
    Pause
    or
    Resume
    buttons or by executing the equivalent Pause Collection and Resume Collection annotations.
  • You start the Dependencies tool with data collection enabled, but you can pause data collection either by using the
    Pause
    button or by executing the equivalent Pause Collection annotation. You can add Pause Collection and Resume Collection annotations as described below.

Pause Collection

This annotation completely stops the analysis of your program until the matching Resume Collection (disable-collection-pop) annotation is executed. Use this annotation to reduce the analysis overhead for certain uninteresting parts of your program. This annotation is recognized by the Dependencies, Survey, and Suitability tools. Because this annotation completely disables monitoring of most annotations, add it carefully in your source code, such as outside a parallel site. If there are multiple pushes, all have to be popped before re-enabling collection.
Syntax:
C/C++:
ANNOTATE_DISABLE_COLLECTION_PUSH;
Fortran:
call annotate_disable_collection_push()
C#:
Annotate.DisableCollectionPush();
This annotation takes no arguments.
For C/C++, this annotation does not have an argument list.

Resume Collection

This annotation resumes the analysis previously stopped by a Pause Collection (disable-collection-push) annotation. This annotation is recognized by the Dependencies, Survey, and Suitability tools. Because the Pause Collection annotation completely disables monitoring of most annotations, add this Resume Collection annotation carefully in your source code, such as outside a parallel site.
Syntax:
C/C++:
ANNOTATE_DISABLE_COLLECTION_POP;
Fortran:
call annotate_disable_collection_pop()
C#:
Annotate.DisableCollectionPop();
This annotation takes no arguments.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804