Installing IBM MQ classes for .NET Framework

IBM MQ classes for .NET Framework, including samples, is installed with IBM MQ. There is a prerequisite of Microsoft.NET Framework on Windows.

The latest version of IBM MQ classes for .NET Framework is installed by default as part of the standard IBM MQ installation in the Java and .NET Messaging and Web Services feature. For installation instructions, see Installing IBM MQ server on Windows or Installing an IBM MQ client on Windows systems.

From IBM MQ Version 9.2.0, to run IBM MQ classes for .NET Framework we must install Microsoft.NET Framework V4.6.2 or later.

Existing applications that are compiled with Microsoft.NET Framework V3.5 can be run without recompiling by adding the following tag in the app.config file of the application:
<configuration>
 <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.2"/>
 </startup>
</configuration>
Note: If the Microsoft .NET Framework V4.6.2 or higher is not installed before you install IBM MQ, then the IBM MQ product installation continues without error, but the IBM MQ classes for .NET is not available. If the.NET Framework is installed after you install IBM MQ, then the IBM MQ.NET assemblies must be registered by running the WMQInstallDir\bin\amqiRegisterdotNet.cmd script, where WMQInstallDir is the directory where IBM MQ is installed. This script installs the required assemblies in the Global Assembly Cache (GAC). A set of amqi*.log files that record the actions that are taken are created in the %TEMP% directory. It is not necessary to rerun the amqiRegisterdotNet.cmd script if .NET is upgraded to V4.6.2 or higher from an earlier version, for example, from .NET V3.5.

In a multiple installation environment, if you previously installed the IBM MQ classes for .NET as a support pack, we cannot install IBM MQ unless you first uninstall the support pack. The IBM MQ classes for .NET feature that is installed with IBM MQ contains the same functions as the support pack.

Sample applications, including source files, are also supplied; see Sample applications for .NET.

For information about using the IBM MQ custom channel for the Microsoft WCF with .NET, see Developing Microsoft Windows Communication Foundation (WCF) applications with IBM MQ

Parent topic: Getting started with IBM MQ classes for .NET


Related concepts