Attaching the integration test client to test configuration modules

If you want to use the integration test client to test modules and their components but you don't want to use the invocation mechanism of the test client to perform your testing, you can attach the integration test client to the modules using a test configuration and then use a different invocation mechanism for testing your operations, such as JMS messages, Web services, or JSPs.

It is generally considered a "best practice" to attach the integration test client to your test configuration modules before you use your own invocation mechanism to invoke an operation. This enables the integration test client to deploy your module and start the server before your invocation progresses too far or even completes, which is essential for a short-running operation and generally desirable for a long-running operation. However, if you have a long-running operation and you only want to attach the integration test client to your test configuration modules at a particular point during the invocation, then you can invoke your operation before you attach the integration test client to the test configuration modules.
To attach the integration test client to a test configuration module:
  1. Complete one of the following steps:
    • If the integration test client is not open, right-click your module or assembly diagram in the Business Integration view and select Test > Attach. The integration test client opens and an Attach event is displayed in the Events area.
    • If the integration test client is already open for your module, click the Attach icon. An Attach event is displayed in the Events area.
  2. In the Events area, ensure that your Attach event is selected and then click Continue. If the Deployment Location wizard opens, follow the instructions in the topic "Deploying your module to the server."
  3. Invoke your operation using your preferred method, such as a JMS message, Web service, or JSP.
  4. If the test pauses at a manual Emulate event in the Events area, specify output parameter values in the value editor or select an exception to throw, then click Continue to continue the invocation. Information about specifying output parameter values and selecting exceptions for manual emulators is found in the topic "Specifying emulation values."
  5. If you want to save an execution trace of your attach session to an execution trace file, press Ctrl-S at any time. An example of the execution trace for an Attach event is shown in the following figure:
    Picture of an Attach event in the Events area.
    Information about saving execution traces is found in the topic "Saving execution traces."
It is important to note that you can only attach a single instance of the integration test client to the modules of one test configuration at a time.
Related tasks
Synchronizing Attach events with test configurations
Detaching the integration test client from test configuration modules

Feedback
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.