Run Parameters Dialog (for Normal Mode)

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

This dialog appears when you select Run > Parameters from the main menuAQTime > Parameters from Visual Studio’s menuAQTime > Parameters from RAD Studio’s main menu and Normal is currently chosen in the Profiling Mode drop-down list box that is displayed on AQTime’s Standard toolbar.in the Profiling Mode drop-down list box that is displayed on Visual Studio’s AQTime toolbar.on RAD Studio’s AQTime Profiling Modes toolbar. The dialog sets run parameters (command-line arguments, the host application, work directory and user account) that will be used every time the profiling starts in Normal mode:

Run Parameters Dialog (for Normal Mode)

You can specify the following parameters:

Parameter Description
Select generic host application When profiling non-executable modules, specify a host application that will load these modules. The Select generic host application drop-down list box contains a list of predefined host applications available in your system. Select the application that will load your modules when you start a profiling session.

For example:

Notes:

  • If you want to use a custom host application, specify its executable in the Specify custom host application edit box.

  • In 64-bit versions of Windows, the “bitness” of a process and the module that is loaded into this process must be the same. That is, 32-bit modules can be loaded only into 32-bit processes and 64-bit modules can be loaded only into 64-bit processes. Remember this when specifying the host application for the module to be profiled. If the “bitness” of the host application and the module is not the same, AQTime will not start profiling.

Specify custom host application When profiling non-executable modules, specify an application that will load these modules. Enter the fully-qualified name of the desired host application’s executable in the Specify custom host application edit box or click the ellipsis button and browse for the desired executable file.

For example, if you are profiling a DLL, specify the application that loads your DLL. See Profiling Dynamic Link Libraries.

Notes:

  • You can select one of the predefined host applications from the Select generic host application drop-down list.

  • Do not enclose the specified file name in quotes.

  • Since AQTime will profile only the modules you selected, but not the host application, the application may be compiled without debug information.

  • To specify the application path, you can use environment variables. To refer to a variable, use the following syntax:

    $(variable_name)
     
    Example: $(MyPathVariable)/MyApplication.exe

  • In 64-bit versions of Windows, the “bitness” of a process and the module that is loaded into this process must be the same. That is, 32-bit modules can be loaded only into 32-bit processes and 64-bit modules can be loaded only into 64-bit processes. Remember this when specifying the host application for the module to be profiled. If the “bitness” of the host application and the module is not the same, AQTime will not start profiling.

Parameters The command-line parameters that AQTime will pass to your profiled application or to the host application (if specified) when launching it.
Note: If a parameter specifies a file name that contains spaces, you need to enclose it in quotes.
Work Directory The working directory of the profiled application. If this field is left blank, the working directory becomes the folder where your application’s executable or the host application (if specified) is stored.

To specify the name of the working directory, you can use environment variables. To refer to a variable, use the following syntax:

$(variable_name)

-- or --

%variable_name%

For example:

$(MyPathVariable)/My Working Folder
%MyPathVariable%/My Working Folder

User Account The name of the user account under which AQTime will start the profiled application. For more information, see Profiling Under Another User Account.
Domain The domain to which the specified User Account belongs. If the account is local and does not belong to a domain, specify the computer name.
Password The password of the specified User Account.
Local Environment Variables A list of environment variables for the profiled application. You can use this field to change the value of the existing environment variable, or specify a new value for the variable whose value has not been specified for the application yet.

Notes:

  • You can create references to existing environment variables. For this purpose, enclose the variable name in percent characters and specify it after the equal sign:

    ENV_VARIABLE_NAME=value%ENV_VARIABLE_NAME%

    After you start profiling, AQTime will add the “value” string to the beginning of the ENV_VARIABLE_NAME variable’s value.

  • AQTime omits spaces only at the beginning and at the end of the specified string. For instance, if you specify “Var=1” and “Var =2”, AQTime will treat these variables as different (as the second one contains a space at the end of the name).

  • Variable names are case-insensitive.

To specify the application path and working directory, you can use environment variables

See Also

Run Parameters Dialog
Specifying Parameters for the Profiled Application
Profiling Dynamic Link Libraries
Profiling Java Applications
Profiling Scripts Located on Web Pages
Profiling Under Another User Account

Highlight search results