Configuration options on distributed platforms

IBM® MQ Managed File Transfer provides a set of properties files that contain key information about your setup and are required for operation. These properties files are in the configuration directory that you defined when you installed the product.

You can have multiple sets of configuration options, each set of configuration options contains a set of directories and properties files. The values defined in these properties files are used as the default parameters for all IBM MQ Managed File Transfer commands, unless you explicitly specify a different value on the command line.

To change the default set of configuration options that you are using you can use the fteChangeDefaultConfigurationOptions command. To change the set of configuration options that you are using for an individual command you can use the -p parameter with any IBM MQ Managed File Transfer command.

The name of a set of configuration options is the name of the coordination queue manager, and it is recommended that this is not changed. However, it is possible to change the name of a set of configuration options but you must change the name of the config and logs directories. In the following examples, the name of the set of configuration options is represented as coordination_qmgr_name.

Configuration options directory structure

When you configure the product, directories and properties files are created in the following structure in the configuration directory. You can also change these directories and properties files with the following commands: fteSetupCoordination, fteSetupCommands, fteChangeDefaultConfiguration, and fteCreateAgent.


MQ_DATA_PATH/mqft/
    config/
       coordination_qmgr_name/
            coordination.properties
            command.properties
            agents/
               agent_name/
                    agent.properties
                    exits
            loggers/
               logger_name
                    logger.properties
    installations/
       installation_name/
            installation.properties

The coordination_qmgr_name directory is a configuration options directory. There can be more than one configuration options directory in the configuration directory. The agent_name directory is an agent directory. In addition to containing the agent.properties file, this directory contains the exits directory, which is the default location for user exit routines and various XML files generated by the fteCreateBridgeAgent and fteCreateCDAgent commands. There can be more than one agent directory in the agents directory of a set of configuration options.

Properties files

installation.properties: The installation.properties file specifies the name of your default set of configuration options. This entry points IBM MQ Managed File Transfer to a structured set of directories and property files that contain the configuration to use. Typically the name of a set of configuration options is the name of the associated coordination queue manager. For more information about the installation.properties file, see The installation.properties file.
coordination.properties: The coordination.properties file specifies the connection details to the coordination queue manager. Because several IBM MQ Managed File Transfer installations might share the same coordination queue manager, you can use a symbolic link to a common coordination.properties file on a shared drive. For more information about the coordination.properties file, see The coordination.properties file.
command.properties: The command.properties file specifies the command queue manager to connect to when you issue commands and the information that IBM MQ Managed File Transfer requires to contact that queue manager. For more information about the command.properties file, see The command.properties file.
agent.properties: Each agent has its own properties file, agent.properties, that must contain the information that an agent uses to connect to its queue manager. The agent.properties file can also contain properties that alter the behavior of the agent. For more information about the agent.properties file, see The agent.properties file.
logger.properties: The logger.properties file specifies the configuration properties for the loggers. For more information about the logger.properties file, see Logger configuration properties for IBM MQ Managed File Transfer.

Properties files and code pages

The content of all the IBM MQ Managed File Transfer properties files must remain in US English because of a limitation of Java. If you edit properties files on a non-US English system, you must use Unicode escape sequences.