C++ Profiles
Each custom C++ virtual user (VU) contains multiple profiles. A profile lets you:
- Set environment variables at runtime for each of the engine processes.
- Specify any additional binaries that are required to build and execute the code in your custom VU.
- Set command line options at compilation and runtime (Java only).
Expand a C++ custom VU in the Workspace tree, then click a profile to display the profile view:
The Default Profile
Each custom C++ VU contains a default profile and one or more runtime profiles. The selected runtime profile is determined by the version of Visual Studio chosen in the Compilers and IDEs preferences.
When you start a test, the selected runtime profile is merged with the default profile. Because settings in the default profile are automatically shared across all other runtime profiles, you can put common settings in the default profile.
If there is a clash, runtime profile settings take precedence over default profile settings.
So, for example, a C++ custom VU might be built with both the Visual Studio 2015 (vc14) and Visual Studio 2017 (vc15) compilers. As there might be different versions of some libraries for each of the compilers, these libraries should be placed in the appropriate runtime profile (intel.win32.vc14
and intel.win32.vc15
respectively). However, there might be other libraries where both compilers can use the same version; these libraries should be placed in the default profile.
Libraries and DLLs
For C++ custom VUs, you can specify any libraries and DLLs that are required to build or run your custom VU.
Click the Add button in the upper right corner of the C++ tab. In the Browse window that appears, select one or more
.dll
or .lib
files.
For portability, .dll
and .lib
files that you add to the table are automatically copied to your workspace directory and can be found in the files/
folder. Therefore, when you export your workspace or move it to a different location, the .dll
and .lib
files remain with it. The paths listed in the table reflect the new location of the .dll
and .lib
files after copying.
For each file, there are three options available:
Option | Description |
---|---|
Transfer to injector | The file is transferred to each injector at the start of the test. |
Link with library when building | The file is added to the list of libraries to link against in the Visual Studio project when you Build the Workspace |
Load library at runtime | The library is loaded by each engine process at the start of the test |
Generally, library (.lib
) files need to be linked with when building, whereas DLLs need to be transferred to the injectors, then loaded by each engine at runtime.
To remove a library from the list, select the library to be removed, then click the Remove button.
Environment Tab
This tab lets you provide any environment variables that you will need to access from your C++ custom VU scripts. Any environment variables specified in this area will be passed to the engine processes running on each injector.
- Click the
in the upper right corner of the Environment tab to add an environment variable.
To read more about the Environment tab and specifying environment variables, please see Setting Runtime Environment Variables.