Software requirements and installation instructions for the WebSphere MQ custom channel for WCF

This topic outlines the software requirements and installation information for the WebSphere® MQ custom channel for WCF.

The WebSphere MQ custom channel for WCF can only connect to WebSphere MQ V7 or higher queue managers.

Software requirements for the WCF custom channel for WebSphere MQ

This information lists the software requirements for the WCF custom channel for WebSphere MQ.

Runtime environment

  • Microsoft .NET Framework v3.0 or higher must be installed on the host machine.
  • Java and .NET Messaging and Web Services is installed by default as part of the WebSphere MQ 7.0.1 installer. Installs the .NET assemblies needed for the custom channel into the Global Assembly Cache.
Note: If the Microsoft .NET Framework v2.0 or higher is not installed before installing WebSphere MQ V7.0.1, then the WebSphere MQ product installation continues without error, but the WebSphere MQ custom channel is unavailable. If the .NET Framework is installed after installing WebSphere MQ 7.0.1, then the WebSphere MQ custom channel must be activated by running the WMQInstallDir\bin\amqiRegisterdotNet.cmd script, where WMQInstallDir is the directory where WebSphere MQ 7.0.1 is installed. This script installs the required assemblies in the Global Assembly Cache (GAC). A set of amqi*.log files recording the actions taken are created in the %TEMP% directory. It is not necessary to rerun the amqiRegisterdotNet.cmd script if .NET is upgraded to v3.0 or higher from an earlier version, for example, from .NET v2.0.

Development environment

  • Microsoft Visual Studio 2008 or Windows Software Development Kit for .NET 3.0 or later.
  • Microsoft .NET Framework V3.5 or higher must be installed on the host machine in order to build the sample solution files.
Note: If the Microsoft .NET Framework v2.0 or higher is not installed before installing WebSphere MQ V7.0.1, then the WebSphere MQ product installation continues without error, but the WebSphere MQ custom channel is unavailable. If the .NET Framework is installed after installing WebSphere MQ 7.0.1, then the WebSphere MQ custom channel must be activated by running the WMQInstallDir\bin\amqiRegisterdotNet.cmd script, where WMQInstallDir is the directory where WebSphere MQ 7.0.1 is installed. This script installs the required assemblies in the Global Assembly Cache (GAC). A set of amqi*.log files recording the actions taken are created in the %TEMP% directory. It is not necessary to rerun the amqiRegisterdotNet.cmd script if .NET is upgraded to v3.0 or higher from an earlier version, for example, from .NET v2.0.