MFT installation.properties 文件

installation.properties 文件指定一组缺省配置选项的名称。 此入口将 Managed File Transfer 指向包含要使用的配置的一组结构化目录和属性文件。 通常,一组配置选项的名称是关联的协调队列管理器的名称。

该文件由安装程序创建,可通过使用 fteChangeDefaultConfigurationOptions 命令进行更改。

installation.properties 文件位于您的 MQ_DATA_PATH 目录中。 例如,在 Windows上,缺省文件位置为 MQ_DATA_PATH\mqft\installations\installation_name ,而在 UNIXLinux® 系统上,缺省文件位置为 /var/mqm/mqft/installations/installation_name

[V9.1.0 2018 年 7 月]对于 Redistributable Managed File Transfer Agent,将在运行 fteCreateEnvironment 命令时设置数据路径。 如果您运行此命令并使用 -d 参数指定您选择的位置,那么将为此位置设置数据路径。 如果未使用 fteCreateEnvironment 命令指定位置,那么将在解压缩 Redistributable Managed File Transfer Agent 的根目录下创建目录 mftdataRedistributable Managed File Transfer Agentinstallation.properties 文件位于 MQ_DATA_PATH\mqft\installations\MFTZipInstall 目录中。

installation.properties 文件包含以下值:
表 1. 基本属性
属性名 描述 缺省值
commandMessagePriority

fteStopAgentfteCancelTransferftePingAgent 命令的内部消息和命令消息设置优先级。

例如,如果您提交大量传输请求以快速连续传输小文件,那么新传输请求会在源代理的命令队列中排队。 外部和内部消息具有缺省 IBM® MQ 消息优先级,因此内部消息将被新的传输请求阻止。 这可能导致超出传输协商时间以及恢复传输。

您还可以使用 commandMessagePriority 属性设置内部确认和期望确认消息的优先级。

要使内部 Managed File Transfer 消息优先于新的传输请求,请将此属性设置为介于 1 (最低) 和 9 (最高) 之间的值。

commandMessagePriority属性的默认值为 8。 这意味着,如果代理命令队列上的 IBM MQ 属性 DEFPRTY (缺省优先级) 小于或等于 7 ,那么将在新的传输请求之前对内部协商消息进行优先级划分。 如果将 DEFPRTY 属性的值设置为 8 或 9 以保持 commandMessagePriority 属性的有效性,必须更改 DEFPRTY 或 commandMessagePriority 属性。

对于 IBM MQ 9.0.0.0 和更高版本,缺省值为 8。

对于早期版本和APARIT06213 之前的版本,默认值是 MQPRI_PRIORITY_AS_Q_DEF 常量,其值为-1。

defaultProperties 缺省配置选项集的名称。 该值是位于配置目录中的目录名称,它包含指定配置信息的目录和属性文件。 没有缺省值
enableFunctionalFixPack 启用修订包功能级别。 缺省情况下,不会启用修订包中的任何新功能。 将该属性设置为版本标识,以启用该版本提供的新功能。

可以使用或不使用句点字符 (.) 指定版本标识。 例如,要使用 IBM MQ 8.0.0 Fix Pack 2提供的函数,请将此属性设置为 80028.0.0.2

没有缺省值
messagePublicationFormat
允许您指定 MFT 代理程序用于其状态 XML 消息的消息发布格式。 可以将该属性设置为以下值:
messagePublicationFormat=mixed
在不使用 MQMD FORMAT (MQFMT_NONE) 的情况下发布消息,在 /LOG 主题树下发布(采用 MQMD 格式 MQFMT_STRING 发布)的消息除外。
messagePublicationFormat=MQFMT_NONE
在不使用 MQMD FORMAT 的情况下发布消息。
messagePublicationFormat=MQFMT_STRING
采用字符串格式发布消息。

IBM MQ 8.0之前, MFT 代理程序将 XML 状态消息发布到 SYSTEM.FTE 主题 (MQFMT_STRING)。 如果可能,必须更新先前使用 IBM WebSphere® MQ 7.5 的应用程序以处理 IBM MQ 8.0 或更高格式的消息。 如果无法更改应用程序,可将messagePublicationFormat属性设置为 MQFMT_STRING,以恢复 "IBM WebSphere MQ 7.5行为。

messagePublicationFormat=mixed
[z/OS]特定于 z/OS:
[V9.1.0 2018 年 7 月][z/OS]productId 要针对其记录 MFT 使用情况的 [V9.1.0 2018 年 7 月][z/OS] 产品类型:
  • 独立 Managed File Transfer 产品。 (MFT 为 productID)。
  • IBM MQ Advanced 产品的一部分。 (ADVANCED 为 productID)。
  • IBM MQ Advanced for z/OS® Value Unit Edition 产品的一部分。 (ADVANCEDVUE 为 productID)。

请参阅 报告产品信息 ,以获取有关产品使用情况记录的更多信息。

[UNIX、Linux、Windows、IBM i]此属性在 Multiplatforms上被忽略。

[V9.1.0 2018 年 7 月][z/OS]MFT
以下文本是 installation.properties 文件的内容示例。
defaultProperties=ERIS
ERIS 是一个目录名称,与 installation.properties 文件位于同一个目录中。 目录 ERIS 包含描述一组配置选项的目录和属性文件。