Redistributable clients on Windows

The Windows 64-bit image is shipped in a Win64.zip file.

File names

The archive or .zip file names describe the file contents and equivalent maintenance levels.

For IBM® MQ 9.4 the client images are available under the following file names:

Long Term Support: 9.4.0 IBM MQ C and .NET redistributable client for Windows x64: 9.4.0.0-IBM-MQC-Redist-Win64.zip
Long Term Support: 9.4.0 IBM MQ JMS and Java redistributable client: 9.4.0.0-IBM-MQC-Redist-Java.zip

Choosing the runtime files to distribute with an application

A script file named genmqpkg is provided by the redistributable client under the bin directory.

You can use the genmqpkg script to generate a smaller subset of files that are tailored to the needs of the application, for which the files are intended to be distributed. You are asked a series of interactive Yes or No questions to determine the runtime requirements for an IBM MQ

application.

Finally, genmqpkg asks you to supply a new target directory, where the script duplicates the required directories and files.

Important: IBM support is only able to provide assistance with the full, unmodified set of files contained within the redistributable client packages.

Other considerations

On Windows, the default data path of a non-installed client is %HOMEDRIVE%%HOMEPATH%\IBM\MQ\data.

You can change the default directory of the data path, by using the MQ_OVERRIDE_DATA_PATH environment variable.

Note: You must create the directory first, as the directory is not created automatically.

A redistributable client runtime co-exists with a full IBM MQ client or server installation, provided that they are installed in different locations.

Important: Unpacking a redistributable image into the same location as a full IBM MQ installation is not supported.

Classpath changes

The classpath used by dspmqver, setmqenv, and crtmqenv commands adds the com.ibm.mq.allclient.jar and com.ibm.mq.jakarta.client.jar to the environment, immediately following the com.ibm.mq.jar, and com.ibm.mqjms.jar.

An example of dspmqver output from the redistributable client on Windows:

Name:        IBM MQ
Version:     9.4.0.0
Level:       p940-940-L220415
BuildType:   IKAP - (Production)
Platform:    IBM MQ for Windows (x64 platform)
Mode:        64-bit
O/S:         Windows 10 Professional x64 Edition, Build 7601: SP1
InstName:    MQNI09200004
InstDesc:    IBM MQ V9.4.0.0 (Redistributable)
Primary:     No
InstPath:    C:\Users\johndoe\Desktop\Redist
DataPath:    C:\Users\johndoe\IBM\MQ\data
MaxCmdLevel: 940