'Absent File' Failure Emulation

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

About 'Absent File' Failure Emulation

Use this failure emulation to check whether your application handles errors that occur when it tries to access a nonexistent file. AQTime will catch all the attempts of your application to access the file and then make the application “think” that the file does not exist.

Note: This emulation type cannot be used to simulate errors with statically linked DLLs (that is, with DLLs that are imported to the executable while it is starting). These links are traced by the operating system and are not handled by your application’s code.

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

  • Click the ellipsis button in the Parameters cell.

  • In the subsequent Edit 'Absent 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 (or a mask for several files). You can either enter this 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