The installation.properties file

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.

This file is created by the installer, and can be changed by using the fteChangeDefaultConfigurationOptions command.

The installation.properties file is located in your MQ_DATA_PATH directory. For example on Windows, the default file location is MQ_DATA_PATH\mqft\installations\installation_name and on UNIX and Linux® systems, the default file location is /var/mqm/mqft/installations/installation_name.

The installation.properties file contains the following values:

Table 1. Basic properties
Property name	Description	Default value
commandMessagePriority	Sets the priority of both internal messages and command messages for the fteStopAgent, fteCancelTransfer and ftePingAgent commands. If you submit a large number of transfer requests to transfer many small files in quick succession, for example, the new transfer requests can become queued on the source agent's command queue. The external and internal messages have the default IBM MQ message priority so the internal messages are blocked by the new transfer requests. This can cause the transfer negotiation time to be exceeded and for the transfers to go into recovery. You can also use the commandMessagePriority property to set the priority of internal acknowledgement and acknowledgement-expected messages. To prioritize the internal IBM MQ Managed File Transfer messages above new transfer requests, set this property to a value between 1 (the lowest) and 9 (the highest). From IBM MQ 8.0.0, Fix Pack 3, the default value is changed to 8. This means that, if the IBM MQ attribute DEFPRTY (default priority) on an agent command queue is less than or equal to 7, internal negotiation messages are prioritized ahead of new transfer requests. If the value of the DEFPRTY attribute is set to either 8 or 9, to maintain the effectiveness of the commandMessagePriority property, you must change either DEFPRTY or the commandMessagePriority property.	Before IBM MQ 8.0.0, Fix Pack 3, the default value is the MQPRI_PRIORITY_AS_Q_DEF constant, which has a value of -1. From IBM MQ 8.0.0, Fix Pack 3, the default value is 8.
defaultProperties	The name of the default set of configuration options. This value is the name of a directory located in the configuration directory, which contains directories and properties files that specify configuration information.	No default
enableFunctionalFixPack	The fix pack function level to enable. By default, any new function included with a fix pack is not enabled. Set this property to a version identifier to enable the new features available with that version. You can specify the version identifier with or without period characters (.). For example, to use the function available with IBM MQ 8.0.0, Fix Pack 2, set this property to `8002` or `8.0.0.2`.	No default
messagePublicationFormat	Allows you to specify the message publication format used by MFT agents for their status XML messages. This property can be set to the following values: messagePublicationFormat=mixed This value is the default for Version 8.0. Messages are published with no format, except those published to the SYSTEM.FTE topic using the topic string /LOG which have a format of String). messagePublicationFormat=MQFMT_NONE MQMD.FORMAT is set to MQFMT_NONE. messagePublicationFormat=MQFMT_STRING MQMD.FORMAT is set to MQFMT_STRING. Before Version 8.0, MFT agents published XML status messages to the SYSTEM.FTE topic in a string format (MQFMT_STRING). If possible, applications that previously used Version 7.5 must be updated to process messages in the Version 8.0 format. If it is not possible to change an application, set the messagePublicationFormat property to string to revert to the Version 7.5 behavior.	messagePublicationFormat=mixed

The following text is an example of the contents of a installation.properties file.


defaultProperties=ERIS

ERIS is the name of a directory that is located in the same directory as the installation.properties file. The directory ERIS contains directories and properties files that describe a set of configuration options.