HCL OneTest™ API, HCL OneTest™ Virtualization release notes for 10.0.0

Read about new features, system requirements, installation, known issues, known limitations, and support for HCL OneTest™ API, HCL OneTest™ Virtualization 10.0.0.


This offering includes the following installable components:
  • HCL OneTest™ API, a scripting-free environment for developing tests for SOA messaging and business process integration projects. Tests can be built by recording existing system behaviors or from requirements, by entering the data to send and the data that is expected in return. You can also create virtual services to remove test dependencies and enable earlier testing. Virtual services can be deployed by HCL OneTest™ Virtualization to provide on-demand virtualized test environments that can support all phases of the test development lifecycle.
  • HCL Quality Server, a server-based web application that provides a central repository for virtualized services. With HCL Quality Server, you can use virtual services that are published by HCL OneTest™ API to create, share, and deploy virtualized test environments in HCL OneTest™ Virtualization. It also contains technology-specific components that are used by HCL OneTest™ API for recording SOA message conversations, HTTP(S) and JDBC traffic, and for monitoring middleware systems under test with minimal reconfiguration of client applications.

What’s new in 10.0.0

The following sections list the new features, enhancements or other changes made in 10.0.0.

HCL OneTest™ Server

  • HCL OneTest™ Server is a server-based application that integrates with the desktop clients to manage test projects, playback tests, and view results. See HCL OneTest Server Overview.
  • The v10 Tech Preview support added in HCL OneTest™ API 9.5 was removed. HCL OneTest™ Server settings are now configured in the Server Settings tab of the Project Settings dialog box. All existing v10 Tech Preview settings will be lost. Sharing of reports is now done through HCL OneTest™ Server. The previous settings to use Unified Reporting running alongside HCL Quality Server were removed.
  • The Unified Reporting and Resource monitoring features were moved from HCL Quality Server to HCL OneTest™ Server. You can now choose to publish reports from HCL OneTest™ API to your project on HCL OneTest™ Server. For more information, see Publishing test results to HCL OneTest™ Server. You can also manage the system resource monitors from HCL OneTest™ Server. For more information, see Monitoring system resources.
  • HCL OneTest™ API projects can be configured to access secrets from HCL OneTest™ Server. Some of this configuration can be overridden when running HCL OneTest™ API resources by using ANT, IntegrationTesterCmd, RunTests, Maven and the HCL Quality Server REST API. For more information, see HCL OneTest™ API and HCL OneTest™ Server.

HCL Quality Server

  • The list of agents changed for a release was updated. See the Tools page of HCL Quality Server to see each tool and the version that it was last changed.
  • The product no longer requires a JRE to be separately installed and selected during install.
  • You can now stop the engine running on an agent from the Infrastructure dashboard in HCL Quality Server when you want to terminate a running stub that is using the engine.
  • To easily identify the engine used by a stub/project, a Process ID now displays in the Engines panel in the Infrastructure dashboard. For more information, see Viewing running agents.
  • You can do operations on the managed stubs from the HCL OneTest™ API command-line. For more information, see Publish stubs, Start a stub, and Stop a stub in Managing stubs.


Starting from 10.0.0 or later, you can use the menu from the HCL OneTest™ API Architectural School perspective for the Logical View and Physical View to check out or check in the test assets. For more information, see HCL OneTest™ API and Git.


  • The Synchronization Wizard's Summary page now shows all information, warning and error messages that occurred during the synchronization. For more information, see Adding a synchronization source.
  • The Synchronization Wizard was enhanced with a new Authorizations page that shows when you add a RAML or OpenAPI 3.0 definition as a synchronization source. Using the Authorizations page, you can now configure the required security scheme settings of the synchronized transports. For more information, see Adding a RAML definition as a synchronization source and Adding an OpenAPI 3.0 definition as a synchronization source.
  • OpenID Connect Offline Access support can be enabled in the HTTP Transport. When enabled, an access token is requested from the Authorization Server and used in requests made over the transport. For more information, see configuring the Experimental tab in Creating physical web server resources.
  • When CICS is restarted, the CICS DPL agent reconnects automatically if CICS comes back up within the agent time out period. Any recording sessions that were in progress continue, and any stubs that were running still function.
  • Starting in release 10.0.0, HCL OneTest™ API also captures attributes within user-defined folders in the RFH2 header. For more information, see WebSphere MQ message formats.
  • With the adoption of the OpenJDK™ 8 with OpenJ9 JRE the mapping between CipherSuites and IBM® WebSphere MQ CipherSpecs has changed. This change requires the WebSphere MQ client libraries to include APAR IV66840 (shipped in WebSphere MQ V7.0.1.13, V7.1.0.7, V7.5.0.5, and V8.0.0.2 client libraries) to be used for SSL based communications.
  • An IBM IMS™ Connect transport now defaults to strict encryption as all other options result in attempts to use nonexistent cipher suites.


  • The Tag name values are now sorted alphabetically in the Iterate Test Data action's Store tab. For more information about Iterate actions, see Iterate actions.
  • Deprecated features noted in HCL OneTest™ API 9.5.0 related to the HCL OneTest™ API Tools application, also known as the source control application were removed. Existing HCL OneTest™ API projects that rely on deprecated features might no longer work.

A list of fixes are documented. For more information, see Fix List.

System requirements

For system requirements, see the PDF documents on the HCL License & Delivery Portal.

Installing HCL OneTest™ API and HCL Quality Server 10.0.0

Installing HCL OneTest™ Virtualization 10.0.0

For information about installation, see Installing HCL OneTest™ Virtualization.

Known problems

Known problems are documented. For more information, see Known Issues.

Known limitations

The only known limitation is that the Logical View does not display a diagram. Instead, a tree view, similar to that used in the Test Factory and Test Lab is used to support the logical components of the SUT.

Contacting HCL support

HCL support provides you with technical assistance.