The installation.properties file

The installation.properties file specifies the name of your default set of configuration options. This entry points WebSphere® 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
[V7.5.0.2 Jul 2013]commandMessagePriority [V7.5.0.2 Jul 2013]

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® WebSphere 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 WebSphere MQ Managed File Transfer messages above new transfer requests, set this property to a value between 1 (the lowest) and 9 (the highest).

[V7.5.0.6 Mar 2016]From IBM WebSphere MQ Version 7.5.0, Fix Pack 6, the default value is changed to 8. This means that, if the IBM WebSphere 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.

[V7.5.0.2 Jul 2013]

Before IBM WebSphere MQ Version 7.5.0, Fix Pack 6, the default value is the MQPRI_PRIORITY_AS_Q_DEF constant, which has a value of -1.

[V7.5.0.6 Mar 2016]From IBM WebSphere MQ Version 7.5.0, Fix Pack 6, 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
[V7.5.0.1 Mar 2013]enableFunctionalFixPack [V7.5.0.1 Mar 2013]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. For details of the new function associated with each version, start with What's new in Version 7.5?.

You can specify the version identifier with or without period characters (.). [V7.5.0.2 Jul 2013]For example, to use the function available with IBM WebSphere MQ Version 7.5.0, Fix Pack 2, set this property to 7502 or 7.5.0.2.

[V7.5.0.6 Mar 2016]From IBM WebSphere MQ Version 7.5.0, Fix Pack 6, it is no longer necessary for enableFunctionalFixPack to be set when using the -d parameter on the fteShowAgentDetails command.

[V7.5.0.1 Mar 2013]No default
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.