'Damaged File' Failure Emulation

Applies to AQTime 8.81, last modified on January 18, 2022

About 'Damaged File' Failure Emulation

Use this kind of failure emulation to check whether your application handles errors that occur when it tries to access a file, whose contents cannot be read. AQTime will catch all the attempts of your application to access the specified file and make the application “think” that the file is damaged.

Specifying Emulation Parameters

You can specify emulation parameters in the Profiler Options dialog which AQTime invokes upon running the Failure Emulator profiler or in the Failure Profiler Options dialog.

To create a new 'Damaged File' failure emulation and specify its parameters:

  • In the dialog, click Add.

  • On the first page of the subsequent Add New Failure Emulation wizard, select the Disk category from the list on the left, then select Damaged File from the list on the right and click Next.

  • On the second page of the wizard, specify all parameters for the selected failure emulation and click Finish.

To modify parameters of an existing 'Damaged File' failure emulation:

  • Click the ellipsis button in the Parameters cell.

  • In the subsequent Edit 'Damaged File' Failure Parameters dialog, modify the desired parameters and click OK.

AQTime saves your settings between profiler runs, so you will not have to define parameters next time you run the profiler.

Parameters

File name

The fully-qualified file name. You can either enter the desired name manually or click the ellipsis button and select the desired file via the Select File dialog.

Options

Specifies which type of special characters (wildcards or regular expressions) can be used within other parameters of the failure emulation. To choose the desired type, select it from the drop-down list:

  • Regular expressions are coded strings that define an infinite number of possible matches. For more information on regular expressions and how to use them in parameter values, see Regular Expressions Syntax.

  • Wildcards are special symbols that can be used to match characters in string values. AQTime supports two standard wildcards: the asterisk (*) and the question mark (?). For more information on wildcards and how to use them in parameter values, see Using Wildcards.

To insert a regular expression or a wildcard quickly, click and select an item from the menu that appears. The menu also provides a brief description of regular expressions and wildcards.

For information on using the Failure Emulator profiler, see Failure Emulator Profiler - Overview.

See Also

Disk Failure Emulation
Failure Emulation Reference
Failure Emulator Profiler - Overview

Highlight search results