Home
Test Execution Specialist Guide
This guide describes tasks that you can perform on schedules, test execution with custom code, and Extending HCL OneTest™ Performance to support other protocols. This guide is intended for testers or test execution specialists.
Running schedules with performance testing
After you have added the user groups, tests, and other items to a schedule, and you are satisfied that it represents a realistic workload, you run the schedule.
Controlling execution of web analytic reports
When a schedule is in the running state, you can perform the following actions from the web analytics reports to cater to your need.
Changing the number of virtual users during a run
If the number of virtual users that was defined initially is incorrect, you can correct the number of users, and apply the change to one stage or to all of the remaining stages in the schedule.

Test Execution Specialist Guide
This guide describes tasks that you can perform on schedules, test execution with custom code, and Extending HCL OneTest™ Performance to support other protocols. This guide is intended for testers or test execution specialists.
- Running schedules with performance testing
  After you have added the user groups, tests, and other items to a schedule, and you are satisfied that it represents a realistic workload, you run the schedule.
  - Running a local schedule or test
    You can run a test locally or a A schedule, in this context, is used to refer to both VU Schedule and Rate Schedule. on remote locations with a default launch configuration.
  - Running a long run mode SAP GUI test
    When running a SAP GUI test that could last for many hours and could use up the operating system resources, you can choose to run the test with the Long Run Mode process. It is an external process that restarts automatically after the specified number of SAP sessions are over. So, tests of longer duration tests are more likely to finish.
  - Running long duration Citrix tests
    When tests exceed many hours, resource consumption issues can cause problems for the Citrix clients. The long run mode increases the reliability of long duration tests with the Citrix protocol by running the test using multiple processes.
  - Testing with Docker images
    HCL OneTest™ Performance, HCL OneTest UI, and HCL OneTest Performance Agents are available for download as Docker images. You can use them to fulfill the continuous testing aspects of your DevOps lifecycle.
  - Adjusting delays in HTTP tests
    You can configure HTTP tests to use client-side processing delays. Client-side processing delays wait for the first character or last character that is received in a response for a previous request in order to better emulate the work done on the client computer. You can also scale the recorded delays in HTTP tests to change the rate at which a test runs.
  - Setting a launch configuration
    Instead of using the default launch configuration, you can specify the file name for the execution results, the name of the folder for the execution results, and, for a test, the number of users.
  - Running a configured schedule
    If you do not use the default launch configuration, you can configure the schedule and then run it.
  - Configuring multiple host names for a location
    You can run several locations on the same computer by configuring multiple host names for a location. This configuration affects all tests running at that location; all tests will run with the configured port.
  - Automating tests from command line
    You can run a schedule from the command line. You can also set preferences to export results after the run completes from the command line or from the workbench. Together, these features let you run tests and analyze results without opening the workbench. You can even write scripts to process the exported results.
  - Controlling caches size
    If you use an infinite loop and the number of cached responses in a test increases exponentially, you can set a limit to cache for a user group in the schedule.
  - Increasing memory allocation
    The virtual users that access your web server require memory to prepare requests, send requests, and receive responses. Because the amount of memory is not automatically set on remote computers, you might receive an out-of-memory error. To correct this situation, increase the memory allocation for that computer.
  - Controlling execution of web analytic reports
    When a schedule is in the running state, you can perform the following actions from the web analytics reports to cater to your need.
    - Changing the number of virtual users during a run
      If the number of virtual users that was defined initially is incorrect, you can correct the number of users, and apply the change to one stage or to all of the remaining stages in the schedule.
    - Changing the rate during a run
      Typically, you specify the desired rate for the Rate Runner group in the Rate Schedule. However, due to various reasons, you might want to change the rate when the Rate Schedule is running.
    - Releasing virtual users from synchronization points
      To record the response time of the system under test at different points, you can release virtual users either all together or in staggered intervals. You can release virtual users from synchronization points during a run.
    - Changing the stage duration during a run
      Increase or decrease the duration of the current stage during a schedule run. You can change the duration of a stage that is set to run for a specified time, but not for a stage that is set to run until the work is complete. You can change the duration of a stage when the status is Running, but not when the status is Ramping or Settle Time.
    - Changing the log level during a run
      You can change the log level to determine problems during a run. By default, only warnings and severe errors are logged. Typically, you change this level only when requested to do so by IBM® Software Support.
    - Stopping test runs
      You can stop a test run before it is complete. For example, you might detect serious problems in the run and not want to wait for it to finish. When stopping the test run, you can choose to save the results and the test log of the run.
  - Debugging HTTP tests
    If a test does not behave as expected during playback, you can use the protocol data and test log to assist in debugging the test.
  - Debugging Citrix tests
    The Citrix dashboard is an optional panel that displays detailed information and control commands for each virtual user during the run of a schedule. This is useful for debugging your tests and allows you to pause, interact, resume, or stop the execution of individual virtual user sessions.
- Extending test execution with custom code
  You can extend how you run your tests by writing custom Java™ code and calling the code from the test. You can also specify that results from the tests that are affected by your custom code be included in reports.
- Extending HCL OneTest™ Performance to support other protocols
  The HCL OneTest™ Performance Extensibility Software Development Kit (SDK) enables you to create extensions to support testing new protocols without modifying the core product code. You can create an extension that provides functionality for testing other protocols in addition to the HTTP protocol support that is standard in HCL OneTest Performance.

Changing the number of virtual users during a run

If the number of virtual users that was defined initially is incorrect, you can correct the number of users, and apply the change to one stage or to all of the remaining stages in the schedule.

Procedure

From the test editor, click Run Test. The execution report is opened either in the internal or external browser, and the state of the run is shown as Running.
During the run, click Running > Change Users Number.

In Change number of users dialog box, select one of the following options:

Option	Description
Add users	If a schedule contains only percentage groups, the virtual users are added by proportion. For example, assume that your schedule contains three user groups, assigned at 20%, 30%, and 50%. If you add 10 virtual users, two added are to the first group, three are added to the second group, and five are added to the third group. If a schedule contains both absolute and percentage groups, the absolute groups are assigned first. For example, assume that your schedule has one user group that is fixed at 10 users, and only one virtual user is running in that group. You add 100 virtual users. Nine virtual users are added to the absolute group, and the remaining virtual users are apportioned among the percentage groups.
Remove users	Users are removed proportionately from user groups according to each user group's percentage value. The time at which users are asked to stop is controlled by the Change rate that you set in the schedule.
Apply to all remaining stages	Click to apply the change to all remaining stages in the schedule run, and clear to apply the change only to the current stage.

Click Change.
The number of users is changed for the specified stages.