Display definitions for data sharing analysis filters.
Menu
Parallel > Thread Data Sharing Filters
Toolbar
Thread Data Sharing Filters
When a filter is set with one of the Filter dialog boxes, its parameters are displayed in the Thread Data Sharing Filters window. A preceding icon indicates the filter type:
Icon |
Filter Type |
|---|---|
 |
Data range filter |
 |
Code range filter |
 |
Function filter (code range filter) |
 |
Source file filter (code range filter) |
The window displays the filter state. A filter is only activated when the debugger can successfully evaluate it, this means when it can map the filter definition to an existing address. The icon color in the window indicates the filter state:
Blue icons indicate active filters.
Gray icons indicate filters disabled by user-input.
Red icons indicate filters that cannot be evaluated and activated . These filters are not set. To retry the evaluation, select Reevaluate from the pop-up menu.
Note
The number of active filters is displayed in the Thread Data Sharing Events window.
C++
Fortran:
When a filter is evaluated for Fortran applications, the filter is set on all objects that match the filter expression. For example, if the same function foo is defined in different DLLs, a function filter on foo would filter all foo functions in all DLLs. To filter foo in a single DLL only, use the context operator in the filter expression to select a single DLL.
When you set a filter using the popup menu of the Thread Data Sharing Events window, the debug extension will automatically add the context operator for the context in which the event occured.
Note
Pop-up Menu
- New
Opens a Filter dialog box where you can specify filtering options to exclude the detection of the selected event from further data sharing event detection. The filtered events will not be displayed for future analysis runs. However, events already displayed in the window will not be removed. You can choose one of the following filter types:
- Data Object Filter...
Opens the Data Range Filter Dialog Box.
- Code Range Filter...
Opens the Code Range Filter Dialog Box.
- Modify
Opens the Filter dialog box where you can edit all filter settings.
- Enable/Disable
Activates or inactivates the selected filter. The filter state is indicated by the preceding icon: inactive filters are displayed with a gray, active filters with a blue icon.
- Delete
Deletes the selected filter.
- Delete All
Deletes all filters.
- Reevaluate
- Evaluates a filter definition that is displayed with a red icon in the window. This occurs, for example, when the function specified for the filter is out of context at the moment the filter is defined. In this case, you can evaluate the filter definition when the program has reached the function. If the system can map the filter definition to an address then, the filter is activated and displayed with a blue icon.