Prerequisites
The prerequisites for WebSphere MQ transport for SOAP are:
- IBM Java 2 SDK and Runtime environment, V 1.4.2
- One or both of
- Apache Axis V1.1
- Microsoft .Net Framework redistributable V1.1 with Service Pack 1
- For .NET only, one of
- Microsoft .NET Framework SDK V1.1
- Microsoft Visual Studio .NET 2003
- On Windows 2000 only, Microsoft Internet Information Services
The IBM Java SDK and Runtime environment are included in the WebSphere MQ installation media. On AIX, Linux and Windows, they are installed automatically but on Solaris and HP-UX they must be selected at installation time.
A version of the Apache Axis runtime is also included in the WebSphere MQ installation media, in the prereqs/axis directory, together with a text file, axis_readme.txt, giving instructions on how to install it. It is not installed as part of the WebSphere MQ installation process. The supplied Axis.jar has been specifically patched (with code published on the Apache Axis Web site). We recommend that you use this version of the Axis runtime with WebSphere MQ transport for SOAP, rather than any other version that you might already have installed. Note that IBM does not provide technical support for Apache Axis. If you have technical problems with Axis, or any queries about it, you should contact the Apache Software Foundation. Contact details are given in .
On Windows 2000 only, have installed Microsoft Internet Information Services (IIS) to be able to deploy and run Microsoft .NET services. It is not necessary for it to remain installed if the services you are invoking will be using only WebSphere MQ SOAP transport but it is necessary that IIS has at least been installed at some stage previously before making a service deployment. If the Microsoft .NET framework has been installed before IIS, use the aspnet_regiis utility to register IIS to the framework. The location of the aspnet_regiis.exe utility might vary with different versions of the Microsoft .NET framework, but it is typically located in: %SystemRoot%/Microsoft.NET/Framework/version number/aspnet_regiis. If multiple versions are installed, use only the executable for the version of .NET you are using.
On Windows 2003 only, though you do not need to install IIS, you must run aspnet_regiis to register IIS to the framework.
The installation process does not check for the presence and availability of the prerequisite software items. You must verify that they are installed first.
For .NET only, register the WebSphere MQ transport for SOAP files with the Global Assembly Cache. If .NET is already installed when you install WebSphere MQ, registration is performed automatically at installation. If you install .NET after WebSphere MQ, the registration is performed automatically when the IVT is first run (see Testing your SOAP/WebSphere MQ installation), or we can run amqwregisterDotNet.cmd to perform registration. We can also run amqwregisterDotNet.cmd to force reregistration at any stage. Once made, this registration survives system restarts and subsequent reregistration is not normally necessary.