Verifying the IBM MQ transport for SOAP

Verify the IBM MQ transport for SOAP using the runivt command. The command runs a number of demonstration applications and ensures that the environment is correctly set up after installation. Note that the web services part of the transport for SOAP is deprecated, and, if you are a new user, you should not use this.


Before you begin

Before you run the runivt command, ensure that we have the following runtime environments:

  • To run on Axis only: you must have a Java SDK (within SOE) available on your system. You must also include the location of the java.exe and javac.exe commands in the systems PATH environment variable.
  • To run a test on .NET only (supported only on Windows ): you must have both a Java SDK and the .NET compilers and tools on your system. To do so, access either a Visual Studio command prompt or the Microsoft Windows SDK command prompt, then add the location of the java.exe and javac.exe files to the PATH environment variable.
  • To run all available the tests: for Windows platforms, the environment must be configured as described in the .NET test run. On UNIX and Linux platforms, the environment must be configured as described in the Axis only test run.


About this task

Instead of running the verification test on both .NET and Axis, you might want to run the test only on Axis, or only on .NET.

If you experience problems with the tests and want to start again:
  1. Stop the queue manager WMQSOAP.DEMO.QM using the immediate option.
  2. Stop the listener that has been started in a different window.
  3. Delete the queue manager.
  4. Delete the temporary samples directory you created and start again.

On UNIX and Linux platforms, you must run the command using an X Windows system session.

The runivt command changes the contents of the soap/samples directory. To keep the installation image unchanged, copy the samples directory to a temporary location, and run the verification test from the temporary location.

We can run the installation verification as many times as you like.

Carry out the following steps to verify the installation of IBM MQ transport for SOAP on .NET Framework 1, .NET Framework 2, and Axis 1.4:


Procedure

  1. Copy the ./tools/soap/samples directory tree to a temporary location.
  2. Start a command window with the temporary directory as the current directory.
  3. Use the runivt command to start the installation test. The runivt script compiles a test class, the sample client, and services before deploying and running them. For the test class, the sample client, and services to run, complete the installation steps outlined in Install WebSphere (r) MQ Web transport for SOAP and ensure that the command prompt used to run the runivt command has the required runtime environment set. Use any of the following methods to run the runivt command:

    • Run a test on Axis only: runivt Axis.
    • Run a test on .NET only (supported only on Windows ): runivt DotNet.
    • Run all available the tests: runivt.
    For more information about the runivt command syntax and parameters, see runivt: IBM MQ transport for SOAP installation verification test. The tests that we can run are listed in the file ivttests.txt on Windows and ivttests_unix.txt on UNIX and Linux platforms.