Creating the IMS Connect transport

You create an IBM® IMS Connect transport when you create a logical IBM® IMS Connect resource in the Architecture school of the HCL OneTest API. Starting from V9.2.0, the IBM® IMS Connect transport supports forwarding proxy to assist with your testing.

Before you begin

Ensure that there is at least one environment in your project. If there are no environments, you must create one. See Environment properties, bindings, and tasks.

You must have set up the following components in the Logical view of the Architecture School perspective:
Note: In V8.5.1 or later, for operations that are configured with IMS transports, there is a new option for defining the available message types. Type 1 and 2 messages are supported.

Procedure

  1. Create a logical IMS Connect resource by completing the following steps:
    1. Open the Logical view of the Architecture school perspective and select a component in which to create the resource, or create it separately.
    2. Right-click the component and then select New > IBM > IBM IMS Connect.
  2. Set the binding for the IMS Connect physical resource by using one of the following steps:
    1. Open the Logical View of the Architecture school perspective, right-click the IBM® IMS Connect resource and select Set Binding in > Environment > Create new IBM IMS Connect.
    2. Open the Physical View of the Architecture school perspective, click IBM > IBM IMS Connect.
      The New IBM® IMS Connect window is displayed.Image of the New IMS Connect window.
  3. Click Settings to configure the basic transport settings.
    The settings are described in the following table:
    Field Description

    Name

    The name of the IMS Connect Transport.

    Host

    The host name or IP address of the IMS Connect server.

    Port

    The port number where the IMS Connect server is listening.

    The default port for IMS Connect is 9941. Retain or change this port to the one you have configured.

    Port Forwarding Proxy

    The Port Forwarding Proxy settings help you to specify a proxy through which HCL OneTest API connects to the computer that hosts the IMS Connect transport server. By using a port forwarding configuration in the HCL OneTest API TCP Proxy, you enable the messages sent by HCL OneTest API to pass through the proxy. This allows you to record them for later use in test and stub resources.

    Field Description
    Host

    The host name or IP address of the proxy through which to connect to the computer that hosts the IMS Connect transport server.

    Port

    The port number of the proxy through which to connect to the computer that hosts the IMS Connect transport server.

    Code Page

    A suggested value for use when saving events as tests or stubs by using the events generated by a transport monitor (the Save wizard of the Recording Studio). If the events are generated by an Operation monitor, then the value from the Operation editor is used as a "suggestion" when saving tests and stubs. If the generated tests or stubs contain byte arrays or COBOL Copybook data or both in the messages, then the value is used as the encoding value in the schema properties. The code page value is also displayed in the header of IMS messages.

    Note: The Code Page field was added to the IMS Connect transport editor to be used when messages are recorded since it is not possible to determine the code page from the raw TCP traffic. When you use a transport monitor to record, the Code Page field of the transport editor is used. When you use an operation monitor to record, the Code Page field from the Operation editor is used.
  4. Click SSL to configure the secure socket layer (SSL) settings for the transport. The SSL settings are described in the following table:
    Field Description
    Use SSL Select this check box to enable security for the transport.

    Selecting the check box makes the other controls on the SSL tab available. You can enable security for Testing (Client) or Virtualization (Server) or both.

    Server certificates to trust All available identity stores are displayed in the drop-down list. Select one of the following menu items:
    Field Description
    Trust All

    To accept any certificate presented by the server, regardless of its validity. This option is the default and assumes you are focused on testing an application rather than the security of the server.

    New

    To define a new identity store.

    Identity store To specify an identity store, that contains certificates that the client is to trust.
    Client identities to give to the server All available identity stores are displayed in the drop-down list. If you use mutual authentication, a suitable identity is selected from the chosen identity store. Select one of the following menu items:
    Field Description
    None

    If the server does not request an identity.

    New

    To define a new identity store.

    Identity store

    To use an existing identity store. Specify an alias in the Identity field.

    Certificate source All available identity stores are displayed in the drop-down list. You can select one of the following menu items:
    Field Description
    Generated

    To use a certificate that HCL OneTest API generates for you. The source for that certificate is displayed in the Signed by field.

    New

    To define a new identity store.

    Identity store

    To use a certificate from an identity store.

    Signed by If you chose Generated in the Certificate source field, this field holds the location of a certificate within the HCL OneTest API installation directory that is used to generate the new certificate. This is a read-only field.
    Identity If you specified an identity store in the Certificate source field, use this field to specify the alias of a key in that identity store.
    Certificate Authorities a stub will trust All available identity stores are displayed in the drop-down list. You can select one of the following menu items:
    Field Description
    Trust All

    To accept any certificate presented by the client.

    New

    To define a new identity store.

    Identity store

    To specify an identity store that contains certificates that the stub is to trust.

    Override default protocols If you are required to use a specific version of the secure sockets protocol, such as SSLv2 or TLSv1.2, enter that algorithm name here.
  5. Click Test Transport to verify the connection works.
  6. Click OK.

Results

The new physical IMS Connect transport broker is added to your project.