Configuration options

WebSphere® MQ File Transfer Edition provides a set of properties files that contain key information about your setup and are required for operation. These properties files are located 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 WebSphere MQ File Transfer Edition 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 WebSphere MQ File Transfer Edition command.

The name of a set of configuration options is typically the name of the coordination queue manager, but it is not required that this is the case. To change the name of a set of configuration options, you can change the name of the directory containing that set of configuration options. In the following examples the name of the set of configuration options is represented as coordination_qmgr_name.

Configuration options for a Server or Client installation

When you perform a Server or Client installation and choose to configure the product, directories and properties files are created in the following structure in the configuration directory. You can also create or change these directories and properties files with the following commands: fteSetupCoordination, fteSetupCommands, fteChangeDefaultConfiguration, and fteCreateAgent.
config_directory/
       wmqfte.properties
       coordination_qmgr_name/
              coordination.properties
              command.properties
              agent_name/
                     agent.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 log files and the lock file of the agent. There can be more than one agent directory in the agents directory of a set of configuration options.

In addition to the properties files created in the configuration directory, the Server or Client installation creates an install.properties file in the product installation directory, which points to the location of the configuration directory.

Configuration options for a Remote Tools and Documentation installation

When you perform a Remote Tools and Documentation installation and choose to configure the product, directories and properties files are created in the following structure in the configuration directory. You can also create or change these directories and properties files with the following commands: fteSetupCoordination, fteSetupCommands, and fteChangeDefaultConfiguration.
config_directory/
       wmqfte.properties
       coordination_qmgr_name/
              coordination.properties
              command.properties
              databaselogger.properties
The coordination_qmgr_name directory is a configuration options directory. There can be more than one configuration options directory in the configuration directory.

In addition to the properties files created in the configuration directory, the Remote Tools and Documentation installation creates an install.properties file in the product installation directory, which points to the location of the configuration directory.

Properties files

install.properties
The install.properties file specifies the path to your WebSphere MQ File Transfer Edition configuration directory. This data directory contains configuration files and log files. If you administer WebSphere MQ File Transfer Edition from the WebSphere MQ Explorer, WebSphere MQ File Transfer Edition uses the information in the install.properties file to set the path to your configuration directory. For more information about the install.properties file, see The install.properties file.
wmqfte.properties
The wmqfte.properties file specifies the name of your default set of configuration options. This entry points WebSphere MQ File Transfer Edition 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 wmqfte.properties file, see The wmqfte.properties file.
coordination.properties
The coordination.properties file specifies the connection details to the coordination queue manager. Because several WebSphere MQ File Transfer Edition 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 WebSphere MQ File Transfer Edition 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.
databaselogger.properties
The databaselogger.properties file specifies the configuration properties for the database logger. For more information about the databaselogger.properties file, see Database logger configuration properties for WebSphere MQ File Transfer Edition.

Properties files and code pages

The content of all the WebSphere MQ File Transfer Edition 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.

Concept Concept

Feedback

Timestamp icon Last updated: Tuesday, 30 January 2018
http://www.ibm.com/support/knowledgecenter/SSEP7X_7.0.4/com.ibm.wmqfte.doc/configuration_options.htm