Configuring IMS Connect messages

You can configure IBM® Information Management System Connect messages.

About this task

This topic describes specific message fields for IBM IMS™ Connect only. For detailed instructions about defining messages, refer to HCL OneTest API reference.


You must create a test for an operation that is bound to a logical IBM IMS Connect server.


  1. In the Test Factory, open an IBM IMS Connect test and double-click the send request. The following graphic shows an example of a send request. IMS send message window
  2. Click Browse to select the IBM IMS Connect transport to use for sending messages.
  3. Using the Formatter list, ensure that IBM IMS Connect is selected.
  4. In version 8.5.1 or later, the Message Type field is available. The options are TYPE1 and TYPE2.
  5. In the Datastore field, type the logical name that IBM IMS Connect has for an IBM IMS instance. The datastore is used to route the transaction execution to an IBM IMS instance known to IBM IMS Connect. There is a many-to-many relationship between IBM IMS Connect and IBM IMS instances. For example, in a simple configuration such as 1 IBM IMS, 1 IBM IMS Connect, the datastore name is IMS1 by default.
  6. In the Client ID field, type the ID for IBM IMS Connect and IBM IMS to identify IBM IMS Connect clients. The clientId is also used for the names of asynchronous message queues (OTMA Tpipes) and other internal data structures in IBM IMS Connect and OTMA.

    The clientId value is a string of 1 to 8 uppercase alphanumeric (A through Z, 0 - 9) or special (@, #, $) characters.

    If you do not enter a value for Client ID, a default value is assigned.

    If a user is interacting asynchronously (for example, a Publish message action, followed by a Subscribe later in the test to pick up the result), use the same client ID for both steps.

  7. In the Transaction field, type the IBM IMS transaction code, which is a string of uppercase alphanumeric (A through Z, 0 - 9) or special (@, #, $) characters. The transcode property identifies the IBM IMS application (transaction) to be executed.
  8. In the Code Page field, type the code page number.
  9. In the RACF® Identity field, type the RACF ID. RACF can be enabled on a per-transaction basis on the server. To support RACF credentials, a RACF identity can be created (in the Physical View of Architecture School) and referenced here. The default is None.
  10. Click Ok to save the send message formatting.

    When you configure IMS Connect receive messages, you have the option of using the IBM IMS Connect formatter. This option is selected by default.