MFT coordination.properties 文件

coordination.properties 文件指定到协调队列管理器的连接详细信息。由于多个 Managed File Transfer 安装可能共享同一个协调队列管理器，因此您可以使用指向共享驱动器上的公共 coordination.properties 文件的符号链接。

coordination.properties 文件是由安装程序或 fteSetupCoordination 命令创建的。可以使用带有 -f 标志的 fteSetupCoordination 命令来更改此文件中的基本协调队列管理器属性。要更改或添加高级协调队列管理器属性，您必须在文本编辑器中编辑此文件。

coordination.properties 文件位于 MQ_DATA_PATH/mqft/config/coordination_qmgr_name 目录中。

coordination.properties 文件包含以下值：

表 1. 协调队列管理器属性
属性名	描述	缺省值
coordinationQMgr	协调队列管理器的名称。	没有缺省值
coordinationQMgrHost	协调队列管理器的主机名或 IP 地址。	没有缺省值
coordinationQMgrPort	用于以客户机方式连接协调队列管理器的端口号。	1414
coordinationQMgrChannel	用于与协调队列管理器连接的 SVRCONN 通道名称。	SYSTEM.DEF.SVRCONN

如果没有为 coordinationQMgrHost 属性指定值，那么缺省情况下使用绑定方式。

如果您为 coordinationQMgrHost 属性指定值，但未为 coordinationQMgrPort 和 coordinationQMgrChannel 属性指定值，那么缺省情况下使用端口号 1414 和通道 SYSTEM.DEF.SVRCONN。

表 2. 高级协调队列管理器属性
属性名	描述	缺省值
代理属性：
agentStatusJitterTolerance	消息视为过期之前，代理状态消息发布延迟的最大时间量。该值度量单位为毫秒。状态消息的期限取决于在协调队列管理器上发布的时间。但是，在协调队列管理器上接收消息之前一段时间，代理会发出该消息，以允许在 IBM® MQ 网络中传输所需的时间。如果该传输所用时间始终相同，那么每隔 60 秒创建的消息，每隔 60 秒就会发布，而与实际传输时间无关。但是，如果消息之间的传输时间不同，那么可能每隔 60 秒创建消息，但每隔诸如 61、59、58 和 62 秒等时间发布消息。 60 的最大偏差为抖动（在该示例中为 2 秒）。该属性确定消息视为过期之前，由于抖动造成的最大延迟。	3000
代码页属性：
coordinationCcsid	命令连接协作队列管理器所使用的代码页。代理还使用该代码页执行至协调队列管理器的任何发布。如果为 coordinationCcsid 指定值，那么还必须为 coordinationCcsidName 指定值。	1208
coordinationCcsidName	coordinationCcsid 的 Java 说明。如果为 coordinationCcsidName 指定值，那么还必须为 coordinationCcsid 指定值。	UTF8
连接属性：
javaLibraryPath	以绑定方式连接到队列管理器时， Managed File Transfer 必须有权访问 IBM MQ Java 绑定库。缺省情况下， Managed File Transfer 会在 IBM MQ定义的缺省位置中查找绑定库。如果绑定库位于不同位置，那么请使用该属性以指定绑定库的位置。	`MQ_INSTALLATION_PATH`/java/lib
多实例队列管理器属性：
coordinationQMgrStandby	用于由 coordinationQMgr 属性定义的多实例协调队列管理器的备用实例的客户机连接的主机名和端口号 (采用 IBM MQ CONNAME 格式)。例如，`host_name(port_number)`	没有缺省值
队列属性:
dynamicQueuePrefix	此属性定义用于生成临时队列名称的 IBM MQ 前缀。 dynamicQueuePrefix属性的格式与 "IBM MQMQOD 结构的 "DynamicQName字段格式相同。有关更多信息，请参阅创建动态队列。如果要将特定 IBM MQ 前缀用于需要代理程序响应的命令生成的临时应答队列，那么还可以在 command.properties 文件中定义此属性。	WMQFTE.*
modelQueueName	此属性定义要用于生成临时队列的 IBM MQ 模型队列。如果要将特定 IBM MQ 模型队列用于需要代理程序响应的命令生成的临时应答队列，那么还可以在 command.properties 文件中定义此属性。有关更多信息，请参阅 MFT command.properties 文件。	SYSTEM.DEFAULT.MODEL.QUEUE
安全属性：
userIdForClientConnect	通过客户机连接流向 IBM MQ的用户标识。如果指定了 `java` ，那么 JVM 报告的用户名将作为 IBM MQ 连接请求的一部分流动。该属性的值可以为 None 或 java。	None
coordinationQMgrAuthenticationCredentialsFile	包含用于连接到协调队列管理器的 MQ 连接凭证的文件的路径。	有关创建认证凭证文件的详细信息，请参阅在 z/OS® 上配置 MQMFTCredentials.xml。请参阅配置 MQMFTCredentials.xml ，以获取有关此文件的位置和许可权的信息。有关创建认证凭证文件的更多详细信息，请参阅 MFT 和 IBM MQ 连接认证
预订属性：
coordinationSubscriptionTopic	使用此属性可指定 SYSTEM.FTE ，以获取有关 IBM MQ 网络状态的出版物。所有工具仍将发布到 SYSTEM.FTE 主题，但是您可以更改 IBM MQ 拓扑以根据其内容将这些出版物分发到不同的主题。然后，您可以使用此功能强制工具预订其他主题中的一个主题。对于 IBM WebSphere® MQ 7.5 和更高版本的修订包，需要针对 APAR IC96850 的临时修订， IBM MQ Explorer 和 fteListMonitors 命令才能识别该属性。	SYSTEM.FTE

有关 SSL 属性，请参阅 MFT 的 SSL 属性。

以下是 coordination.properties 文件内容的示例:

coordinationQMgr=ERIS
coordinationQMgrHost=kuiper.example.com
coordinationQMgrPort=2005
coordinationQMgrChannel=SYSTEM.DEF.SVRCONN

在此示例中， ERIS 是位于系统 kuiper.example.com上的 IBM MQ 队列管理器的名称。队列管理器 ERIS 是 Managed File Transfer 向其发送日志信息的队列管理器。