Configuring HCL OneTest API for recording IMS Connect traffic

You can set up HCL OneTest™ API to record IBM® Information Management System Connect traffic.

About this task

Configuring HCL OneTest API for recording IMS™ Connect traffic involves modifying the registration.xml file of the HTTP/TCP proxy, which is a component of HCL Quality Server.


  1. You must set up port-forwarding in the HTTP/TCP proxy’s registration.xml file to forward IBM IMS Connect traffic into the proxy, and then to the actual IBM IMS Connect server. This file is in the httptcp folder in the HCL Quality Server installation directory.
  2. Add a forward bind line in the registration.xml file as shown:
       <forward bind="" destination="" type="imsconnect"/>
    Note: Version 8.5.1 or later supports two type values for configuring forward bind. In addition to the type value imsconnect, we now support ims. These values can be used as aliases to each other.
  3. If you are using a message exit other than the IBM-supplied sample exit HWSSMPL0 (also known by its irm-id of *SAMPLE*), define the message exit in registration.xml. Within the ims element, add a sub-element for each exit and specify the following attributes:
    • irm-id: This is the IRM-ID for the exit. The value must match the one that the client program places within the packets in the IRM header that it sends to IMS Connect. For example, the IRM-ID of the IMS sample user exit HWSSAMPL is *SAMPL1*.
      Note: The value of irm-id can be different from the exit name.
    • message-type: This attribute is reserved for future use. Specify ALL for the value.
    • message-format: This attribute is used to define the format of messages produced by the message exit. The only valid values are LLLL and LLZZ. LLLL indicates that the message exit prefixes each message with a 4-byte length, whereas LLZZ indicates that the message exit prefixes each message with a 2-byte length followed by two bytes of 00's. If the IMS data that is passed through the proxy server is formatted by a message exit that is not defined as outlined in this step, it is assumed that the format of the data is LLZZ.
    A sample definition for the IBM-supplied HWSSMPL0 exit and a user-defined exit named USER01 is as follows:
    <message-exit irm-id="*SAMPL1*" message-type="ALL" message-format="LLLL"/> 
    <message-exit irm-id="*USER01*" message-type="ALL" message-format="LLLL"/>