Downloading and configuring Redistributable Managed File Transfer components

The Redistributable Managed File Transfer package provides the Redistributable Managed File Transfer Agent, which you can configure to connect to an existing IBM® MQ infrastructure and enable users to transfer files without needing to install IBM MQ. From IBM MQ 9.3.0, the redistributable package also includes the Redistributable Managed File Transfer Logger.

Before you begin

For information about redistributable license terms for the Redistributable Managed File Transfer Agent and Redistributable Managed File Transfer Logger, see IBM MQ Redistributable Components.

The Redistributable Managed File Transfer package components provide the functionality of Managed File Transfer with these exceptions:

For the Redistributable Managed File Transfer Agent, bindings mode connection to the coordination, command, and agent queue managers, is not supported, you must use client mode connection. When you are issuing commands, you must provide the parameters that are optional when you are using the Managed File Transfer that is installed as part of IBM MQ: queue manager host, port, name, and channel name.
The Redistributable Managed File Transfer Logger supports FILE type loggers only, connecting in client mode to the coordination queue manager only. Client mode connection to the coordination queue manager for a database logger is not supported. If you require a bindings mode connection, you must use a standard installation of IBM MQ.
From IBM MQ 9.3.0, the fteCreateCDAgent.cmd command is not included. For a complete list of available commands, see Installed MFT command sets.
Managed File Transfer Connect:Direct® is not supported.
IBM MQ Explorer is not included.

[Windows] You must install the Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019 libraries, available from Microsoft, on your system to use the Redistributable Managed File Transfer Agent. See The latest supported Visual C++ downloads.

[MQ 9.3.0 Jun 2022] From IBM MQ 9.3.0, the Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019 libraries are also required for the Redistributable Managed File Transfer Logger.

Note: Advanced Message Security is not supported with the Redistributable Managed File Transfer package.

About this task

You can optionally download the Redistributable Managed File Transfer package and configure the Redistributable Managed File Transfer Agent to connect to an existing IBM MQ infrastructure to allow users to transfer files between their local environment and the existing IBM MQ infrastructure without the need for them to install IBM MQ to get the Managed File Transfer functionality.

[MQ 9.3.0 Jun 2022] From IBM MQ 9.3.0, the Redistributable Managed File Transfer package also includes the Redistributable Managed File Transfer Logger, which enables you to set up a file logger to connect in client mode to the coordination queue manager.

Procedure

Download the IBM MQ redistributable Managed File Transfer Agent package from Fix Central.
1. Choose the package for your operating system.
  The archive or .zip file names describe the file contents and equivalent maintenance levels. The file names are in the following format:
  - V.R.M.F-IBM-MQFA-Redist-Win64
  - V.R.M.F-IBM-MQFA-Redist-LinuxX64
  - V.R.M.F-IBM-MQFA-Redist-LinuxS390X
  - V.R.M.F-IBM-MQFA-Redist-LinuxPPC64LE
  where V.R.M.F is the version number, for example 9.2.0.0 or 9.2.1.0.
2. Identify the directory where you want to extract the package, for example:
  - C:\MFTZ
  - /home/MFTZ
Extract the contents of the downloaded package:
- On Windows, use the Windows Explorer tools to extract.
- On Linux®, extract and untar as follows:
```
gunzip V.R.M.F-IBM-MQFA-Redist-LinuxX64.tar.gz
```
  and then
```
tar xvf V.R.M.F-IBM-MQFA-Redist-LinuxX64.tar
```
where V.R.M.F is the version number, for example 9.3.0.0 or 9.3.1.0.
The following directories are created:
- bin: Contains all the required MFT commands
- bin64: Contains required libraries that are needed for Windows 64-bit OS support
- java: Contains the IBM JRE and IBM MQ libraries
- licenses: Contains the license files
- META-INF: Contains files that have code signing information
- mqft: Contains ant and lib directories that are required for Ant support and for core MFT function support
- swtag: Contains swidtag file that is required by license managers to identify the installations on the machine

What to do next

You are ready to configure a Managed File Transfer Agent. For the next steps, see Creating the initial configuration for the Redistributable Managed File Transfer Agent.

[MQ 9.3.0 Jun 2022] From IBM MQ 9.3.0, you can also configure a Managed File Transfer Logger. For the next steps for configuring the logger, see Creating the initial configuration for the Redistributable Managed File Transfer Logger.