'Locked File' Failure Emulation

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

About 'Locked File' Failure Emulation

Use this emulation type to check whether your application handles errors that occur when it tries to access a file locked by another process. AQTime will catch all the attempts of your application to access information in the specified file and make your application “think” that the file is locked by another process according to the specified Emulate lock of parameter.

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 'Locked 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 Locked 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 'Locked File' failure emulation:

  • Click the ellipsis button in the Parameters cell.

  • In the subsequent Edit 'Locked 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 name of a file. You can either enter the desired name manually or click the ellipsis button and select the desired file via the Select File dialog.

Emulate lock of

Specifies whether AQTime must emulate locking the file from writing or both from reading and writing. The available variants are: Writing and Reading and writing.

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