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

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

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


Software requirements for the WCF custom channel for IBM MQ

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


Runtime environment

  • Microsoft.NET Framework v3.5 or higher must be installed on the host machine.
  • Java and .NET Messaging and Web Services is installed by default as part of the IBM MQ Version 8.0 installer. Installs the .NET assemblies needed for the custom channel into the Global Assembly Cache.
Note: If the Microsoft.NET Framework v3.5 or higher is not installed before installing IBM MQ Version 8.0 or later, then the IBM MQ product installation continues without error, but the IBM MQ custom channel is unavailable. If the .NET Framework is installed after installing IBM MQ Version 8.0 or later, then the IBM MQ custom channel must be activated by running the WMQInstallDir\bin\amqiRegisterdotNet.cmd script, where WMQInstallDir is the directory where IBM MQ Version 8.0 or later 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.5 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.5 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 v3.5 or higher is not installed before installing IBM MQ Version 8.0 or later, then the IBM MQ product installation continues without error, but the IBM MQ custom channel is unavailable. If the .NET Framework is installed after installing IBM MQ Version 8.0 or later, then the IBM MQ custom channel must be activated by running the WMQInstallDir\bin\amqiRegisterdotNet.cmd script, where WMQInstallDir is the directory where IBM MQ Version 8.0 or later 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.5 or higher from an earlier version, for example, from .NET v2.0.