5.10. The Configuration Dialogs

These dialog boxes enable manipulating the configuration that is usually stored in the file .itarc in the user's home directory upon program exit. The configuration consists of the global information found under the option File Default and the per file information found under the respective file name.

The global information consists of the recent file list and the list of search paths that find the source code files. The latter is stored in the option File Default/UserDefines SCLSearchPaths and contains a list of directories, separated by semi-colons (;). These directories are searched in the given order for source code files to be shown in the Source View dialog box (see Section 5.7).

The per file information holds all user-defined process groups, function groups and function group colors.

5.10.1. The Edit Configuration Dialog

This dialog box allows editing the configuration; for example, by changing values or removing entries from the configuration.

This dialog box together with the Load Configuration dialog box allows to store per trace file settings together with the trace file so that definitions of process groups and function groups are shared in a work group.

The entries are shown with check box like handles that are all checked by default. Unchecking entries removes them from the current configuration when the button OK is pressed. To edit a value double click on the respective entry.

Group definitions and color assignments are dragged and dropped from one trace file branch to another or even onto the branch File Default to make them available for each new trace file. The dialog box allows dragging and dropping every child node in the configuration tree, and thus the configuration is easily manipulated in a way that leads to surprising results. In such cases, start it again with a well-known configuration.

Generally, it is best to avoid moving options whose values are files or lists of files. For example, a cache file usually corresponds to a particular trace file, and hence, moving a UserDefines Cachefile to another trace file or the default section would not make sense, unless the intent is to reuse that cache file with a different trace. On the other hand, color definitions can typically be dragged and dropped from trace to trace or to default (the latter would define that color for all trace files, unless they provide their own definition). Moving group definitions, however, requires more attention, since group ids in one trace might not make sense in another. Examination and possible value editing can solve such issues.

Figure 5-14. The Edit Configuration Dialog

5.10.2. The Load Configuration Dialog

This dialog box allows to read configuration data from files into the program. The information to be loaded is chosen on a file per file basis. Directly saving a configuration in the Intel Trace Analyzer is not possible. To save portions of the .itarc, use a text editor and save in the usual manner.

The check box Merge with the current configuration allows choosing if the eventually present configuration in memory for chosen files should be replaced by or merged with the configuration from the selected file.