The Failure Emulator profiler lets you check whether your application contains code that processes different application failures correctly. To start profiling an application with the Failure Emulator profiler, you need to set up emulated failures first. You can do this in two ways:

Setting Up Failures at Runtime (Right Before Profiling)

Setting Up Failures at Design Time (Anytime Before the Profiling)

Setting Up Failures at Runtime (Right Before Profiling)

To set up parameters for emulated failures right before the profiling run, follow the steps below:

Make sure that the Show profiler options when profiling starts option is enabled for the Failure Emulator profiler in the Show Again Flags dialog.
Start profiling the application. For this purpose, you can either click Run (and AQTime will automatically launch the profiled application after all the settings are specified) or launch the profiled application manually (outside of AQTime) and then attach to its process.
The Profiler Options dialog for the Failure Emulator profiler will appear.
Click Add to add a new failure. The Add New Failure Emulation wizard will appear.
Select the desired failure category in the list on the left and then select the failure type in the list on the right. Click Next.
Specify all required parameters for the selected failure on the second page of the wizard and then click Finish.
After you add all desired failures to the list, make sure that check boxes for failures you want to simulate are selected. To exclude a failure from the current run (but keep it in the list), unselect it in the list.
Click Run to start profiling the application.

Setting Up Failures at Design Time (Anytime Before the Profiling)

To set up parameters for emulated failures at design time, follow the steps below:

Select Options > Options from AQTime’s main menu.Select Tools > Options from Visual Studio’s main menu.Select AQTime > Options from Embarcadero RAD Studio’s main menu.
Choose the Profilers > Tracing > Failure Emulator Profiler group in the OptionsOptionsOptions dialog.
The Failure Emulator Options dialog will appear.
Click Add to add a new failure. The Add New Failure Emulation wizard will appear.
Select the desired failure category in the list on the left and then select the failure type in the list on the right. Click Next.
Specify all required parameters for the selected failure on the second page of the wizard and then click Finish.
After you add all desired failures to the list, make sure that check boxes for failures you want to simulate are selected. If you want to exclude a failure from the subsequent run (but keep it in the list), unselect it in the list.
Start profiling the application. For this purpose, you can either click Run (and AQTime will automatically launch the profiled application after all the settings are specified) or launch the profiled application manually (outside of AQTime) and then attach to its process.
The Profiler Options dialog for the Failure Emulator profiler will appear.
Make sure the dialog contains all the failure emulations you have specified.
Click Run to start profiling the application.

After the profiling is over, AQTime will generate results and open them in the Report panel. For more information on analyzing results generated by the Failure Emulator profiler, see Failure Emulator Profiler Results - Overview.

Failure Emulator Profiler - Setting Up Emulated Failures

Setting Up Failures at Runtime (Right Before Profiling)

Setting Up Failures at Design Time (Anytime Before the Profiling)

See Also