Configuring transports to use the sift-and-pass-through capability

The sift-and-pass-through capability is provided by HCL OneTest API to filter the messages that a stub receives, separating traffic from client and server applications that need to use the live system as opposed to a virtual system.

About this task

The following table outlines the options to configure transports that use the sift-and-pass-through capability, which is provided by HCL OneTest API 8.0.1 or later.
Table 1. Transports that use the sift-and-pass-through capability
Transport Version of HCL OneTest API Options to configure transports

CICS®

8.5.0 or later

You can configure these transports to have a default pass-through action (see Table 2).

HTTP

8.0.1 or later

IMS

8.5.1.1 or later

Java application

8.5.0 or later

WebSphere® SI Bus

8.5.1 or later

MQ telemetry transport

8.6.0 or later

SAP System

8.6.0 or later

webMethods Integration Server

8.0.1 or later

JMS application 8.7.0 or later

WebSphere® MQ

8.0.1 or later

The options are as follows:
  • Configure a default pass-through action (see Table 2).
  • Configure a default stubbing mode for each new transport created (see the procedure below).
  • Modify the stubbing mode of each transport irrespective of the version of HCL OneTest API that was used to create it. For information about configuring the stubbing mode of WebSphere® MQ transports, see Stubbing settings for MQ transport.

Procedure

  1. Click Project > Preferences or Window > Preferences on the menu bar. The Preferences window is displayed.
  2. Click Virtualization. The Virtualization page is displayed.
  3. In the Pass Through section, double-click the transport to configure. The Pass Through Configuration window is displayed. In that window, the options that are in the Pass Through list depend on the transport that you selected.
  4. Specify the settings for the sift-and-pass-through capability. For details about the settings, see the following table.
    Table 2. Specifying the Pass through configuration options on the Virtualization page in the Preferences window
    Option Transport Description and instructions

    Discard

    HTTP

    IMS

    MQ telemetry transport

    WebSphere® SI Bus

    WebSphere® MQ

    JMS application

    HCL OneTest API discards any message that the stub cannot process and does not send a reply.

    Pass Through

    CICS®

    HTTP

    IMS

    Java application

    MQ telemetry transport

    SAP System

    WebSphere® SI Bus

    WebSphere® MQ

    JMS application

    webMethods Integration Server

    Any message passes through to the original target of the operation. Optional: In the Delay field, enter a delay (in milliseconds).

    Simulate Error

    CICS®

    HCL OneTest API simulates an exception or abend.

    For CICS® Transaction Gateway based stubs:
    1. Select a CICS® return code.
    2. Optional: If CICS® Abend is required, enter an abend code.
    For CICS® Transaction Server based stubs:
    1. Enter an abend code.

    Simulate Error

    HTTP

    HCL OneTest API sends a fake error message back to the client or server application.

    1. Optional: In the Delay field, enter a delay (in milliseconds).
    2. From the Status Code list, select a status code for the error.
    3. Optional: In the Status Text field, enter status text for the error.

    Simulate Error

    webMethods Integration Server

    HCL OneTest API sends a fake error message back to the client or server application.

    1. Optional: In the Delay field, enter a delay (in milliseconds).
    2. In the Exception list, click a supported exception type for the error.
    3. Optional: In the Message field, enter text for the error.
  5. Click OK to close the Pass Through Configuration window.
  6. If you want to modify other settings in the Preferences window before you close it, click Apply to save your changes. Otherwise, click OK to close the Preferences window.