The Failure Emulator profiler includes a number of options that work at runtime and define the specifics of profiler functioning.
You can view and modify these options in the following dialogs –
In the Profiler Options dialog that is displayed when you run the profiler (see Setting Profiler Options Before the Run).
In the Options dialog. To invoke it, select Options > Options from AQTime’s main menu. Then choose Profilers > Tracing > Failure Emulator from the tree on the left.In the Options dialog. To invoke it, select Tools > Options from Visual Studio’s main menu. Then choose AQTime > Profilers > Tracing > Failure Emulator from the tree on the left.In the Options dialog. To invoke it, select AQTime > Options from Embarcadero RAD Studio’s main menu. Then choose Profilers > Tracing > Failure Emulator from the tree on the left.
You can also invoke this dialog by pressing Configure Current Profiler on the Standard toolbar when the profiler is selected.
The options are –
- Thread model - Specifies which thread model AQTime uses to trace the call stack for functions that emulate the application’s failures. For more information on supported values, see Profiling Multiple Threads and Profiling COM Logical Threads.
- Failure Emulations table - Specifies failures to be emulated by the Failure Emulator profiler.
The table has the following columns:
Column Name Description Name A string identifier of the failure. The name can contain any symbols. For example, it can include letters, digits, underscores, spaces and so on.
The check box next to the failure name specifies whether the failure is enabled and will be emulated during the subsequent run. To exclude an item from the list of emulated failures, clear its check box.
Parameters The list of the failure’s parameters.
You specify parameters when you add a new failure to the list via the Add New Failure Emulation wizard. To change parameters of the existing failure, select the Parameters cell, click the ellipsis button in it and specify new parameters for the failure in the subsequent Edit Failure Parameters dialog.
Work Count The number of times the failure is emulated. By default, Work Count is 0 and means that AQTime emulates the failure all the time the specified conditions are met and the ordinal number of the failure is greater than the number specified in the Skip Count column. Skip Count The number of times the failure conditions are ignored before emulating the failure. In other words, if you specify 2 as the value of this column, AQTime ignores the failure conditions two times and emulate the failure on the third time the specified conditions are met. The default value is 0.
For information on how to add a new item to the list of failure emulations, see the description of the Add New Failure Emulation dialog. For information on available emulation types and their parameters, see Failure Emulation Reference.
The Failure Emulator profiler also includes a number of options that affect the profiler result display. They are located on the Profiler toolbar (by default, it is displayed at the top of the Report panel)(by default, it is displayed at the top of the Report panel). For information on them, see Profiler Toolbar - Failure Emulator Profiler Items.