Recording TCP traffic

The HCL OneTest HTTP/TCP Proxy, enables HCL OneTest™ API to record general TCP traffic that is routed through the proxy or to route TCP traffic to stubs automatically when they start instead of routing traffic through the live system.

Before you begin

  1. In HCL OneTest API, create the required physical TCP server resource and logical TCP connection in your project. Completing this task enables HCL OneTest API to connect to the physical TCP server and to record logical resources.
    Note: In the Recording tab of the TCP Server window, click External Proxy Server in the Recording Mode list.
  2. Ensure that your HCL OneTest API project is connected to a valid instance of HCL Quality Server. Completing this task enables HCL OneTest API to issue commands to the HTTP/TCP proxy.
    Note: To ensure that the connection is working correctly, click Project > Project Settings on the menu bar, click the Server Settings tab on the Project Settings window, and verify that a green checkmark icon is displayed next to the URL field on the HCL Quality Server area of the tab. If there is no URL displayed or if there is a red cross icon next to the URL field, contact your HCL OneTest API project administrator.
  3. Ensure that a domain is selected on the Server Settings tab on the Project Settings window. If there are no domains, a domain must be created by a HCL Quality Server administrator. Recording occurs within a domain and the HTTP/TCP proxy can be registered with all domains or a single domain in the HCL Quality Server instance that you are using. Therefore, selecting a domain in HCL OneTest API enables the application to record TCP transport traffic.
    Note: If you are using HCL Quality Server or later and domain-level security is enabled, you can connect only to domains to which you have been granted access.
  4. Install and configure the HTTP/TCP proxy and ensure that the host name and port number of the proxy are entered under Port Forwarding Proxy in the Client tab of the TCP Server window. Completing this task enables HCL OneTest API to record TCP transport traffic.

About this task

The HCL OneTest API HTTP/TCP proxy supports any data that are sent over TCP/IP but it also supports richer functionality if the messages that are being sent are Financial Information eXchange (FIX) protocol messages.

This additional support enables content-based routing, that is, routing messages by deriving a destination from the actual content of each message rather than by using a specified end-point reference.


  1. Open the Recording Studio perspective.
  2. Create a recording monitor for the TCP traffic that you want to record.
  3. Start a recording session by clicking Start Recording (Start Recording) on the toolbar of the Events View window.
  4. In HCL Quality Server, open the Infrastructure Dashboard, expand the agent card, and from the Activities tab verify that recording has started.
  5. Wait for recorded events.
  6. Stop the recording session by clicking Pause recording (Pause recording) on the toolbar of the Events View window.

What to do next

After you finish recording, you can highlight one or more individual events. Click Save Events to create resources such as tests, stubs, and test data sets. For more information, see Creating an operation from recorded events, Creating tests from recorded events, and the Stub creation by using the Recording Studio for creating stubs.