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 目录中。

MFT coordination.properties 文件包含以下值:
表 1. 基本协调队列管理器属性
属性名 描述 缺省值
[MQ 9.2.0 2020 年 7 月]coordinationCredentialsKeyFile 包含加密凭证时使用的凭证密钥的文件的名称。 没有缺省值的字符串属性。
coordinationQMgr 协调队列管理器的名称。 没有缺省值
coordinationQMgrHost 协调队列管理器的主机名或 IP 地址。 没有缺省值
coordinationQMgrPort 用于以客户机方式连接协调队列管理器的端口号。 1414
coordinationQMgrChannel 用于与协调队列管理器连接的 SVRCONN 通道名称。 SYSTEM.DEF.SVRCONN

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

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

以下是 coordination.properties 文件内容的示例:
coordinationQMgr=ERIS
coordinationQMgrHost=kuiper.example.com
coordinationQMgrPort=2005
coordinationQMgrChannel=SYSTEM.DEF.SVRCONN
在此示例中， ERIS 是位于系统 kuiper.example.com上的 IBM® MQ 队列管理器的名称。 队列管理器 ERIS 是 Managed File Transfer 向其发送日志信息的队列管理器。

高级协调属性

Managed File Transfer 还提供了更高级的协调属性。 如果要使用以下任何属性，请手动编辑 coordination.properties 文件以添加所需的高级属性。 在 Windows上指定文件路径时，请确保将分隔符反斜杠 (\) 输入为双反斜杠 (\\) ，即转义反斜杠 (\)。 或者，可以使用单个正斜杠 (/) 字符作为分隔符。 有关 Java 属性文件中的字符转义的更多信息，请参阅 Oracle 文档 Properties 类的 Javadoc。

表 2. 高级协调属性: 代理程序
属性名 描述 缺省值
agentStatusJitterTolerance

消息视为过期之前，代理状态消息发布延迟的最大时间量。 该值度量单位为毫秒。

状态消息的期限取决于在协调队列管理器上发布的时间。 但是，在协调队列管理器上接收消息之前一段时间，代理会发出该消息，以允许在 IBM MQ 网络中传输所需的时间。 如果该传输所用时间始终相同，那么每隔 60 秒创建的消息，每隔 60 秒就会发布，而与实际传输时间无关。 但是，如果消息之间的传输时间不同，那么可能每隔 60 秒创建消息，但每隔诸如 61、59、58 和 62 秒等时间发布消息。 60 的最大偏差为抖动（在该示例中为 2 秒）。 该属性确定消息视为过期之前，由于抖动造成的最大延迟。

 3000
表 3. 高级协调属性: 代码页
属性名 描述 缺省值
coordinationCcsid 命令连接协作队列管理器所使用的代码页。 代理还使用该代码页执行至协调队列管理器的任何发布。 如果为 coordinationCcsid 指定值，那么还必须为 coordinationCcsidName 指定值。 1208
coordinationCcsidName coordinationCcsid 的 Java 说明。 如果为 coordinationCcsidName 指定值，那么还必须为 coordinationCcsid 指定值。 UTF8
表 4. 高级协调属性: 连接
属性名 描述 缺省值
javaLibraryPath 以绑定方式连接到队列管理器时， Managed File Transfer 必须有权访问 IBM MQ Java 绑定库。 缺省情况下， Managed File Transfer 会在 IBM MQ定义的缺省位置中查找绑定库。 如果绑定库位于不同位置，那么请使用该属性以指定绑定库的位置。 MQ_INSTALLATION_PATH/java/lib
表 5. 高级协调属性: 多实例队列管理器
属性名 描述 缺省值
coordinationQMgrStandby 用于由 coordinationQMgr 属性定义的多实例协调队列管理器的备用实例的客户机连接的主机名和端口号 (采用 IBM MQ CONNAME 格式)。 例如，host_name(port_number) 没有缺省值
表 6. 高级协调属性: 队列
属性名 描述 缺省值
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
表 7. 高级协调属性: 安全性
属性名 描述 缺省值
userIdForClientConnect 通过客户机连接流向 IBM MQ的用户标识。 如果指定了 java ，那么 JVM 报告的用户名将作为 IBM MQ 连接请求的一部分流动。 该属性的值可以为 None 或 java。 None
coordinationQMgrAuthenticationCredentialsFile 包含用于连接到协调队列管理器的 MQ 连接凭证的文件的路径。

[z/OS]有关创建认证凭证文件的详细信息，请参阅 在 z/OS® 上配置 MQMFTCredentials.xml。

[AIX、Linux 和 Windows]请参阅 配置 MQMFTCredentials.xml ，以获取有关此文件的位置和许可权的信息。

[AIX、Linux 和 Windows]有关创建认证凭证文件的更多详细信息，请参阅 MFT 和 IBM MQ 连接认证
表 8. 高级协调属性: SSL/TLS
属性名 描述 缺省值
coordinationSslCipherSpec 指定在命令和协调队列管理器之间交换数据时，使用的协议、散列算法和加密算法，以及加密密钥中使用的位数。

coordinationSslCipherSpec 的值为 CipherSpec 名称。 该 CipherSpec 名称与协调队列管理器通道中使用的 CipherSpec 名称相同。 Java的 "IBM MQ类中的 SSL/TLS "CipherSpecs和 "CipherSuites"和 "JMS 的 "IBM MQ类中的 SSL/TLS "CipherSpecs和 "CipherSuites"中包含有效的 "CipherSpec名称列表。

coordinationSslCipherSpec 类似于 coordinationSslCipherSuite。 如果指定了 coordinationSslCipherSuite 和 coordinationSslCipherSpec，那么使用 coordinationSslCipherSpec 的值。

 None
coordinationSslCipherSuite 指定命令和协调队列管理器交换数据方式的 SSL 方面。

coordinationSslCipherSuite 的值为 CipherSuite 名称。 CipherSuite 名称将映射到代理队列管理器通道中使用的 CipherSpec 名称。 更多信息，请参阅CipherSuite和CipherSpec名称映射。

coordinationSslCipherSuite 类似于 coordinationSslCipherSpec。 如果指定了 coordinationSslCipherSuite 和 coordinationSslCipherSpec，那么使用 coordinationSslCipherSpec 的值。

 None
coordinationSslPeerName 指定必须与协调队列管理器提供的名称相匹配的专有名称框架。 专有名称用于检查连接时协调队列管理器提供的标识证书。 None
coordinationSslTrustStore 指定命令信任的证书的位置。 coordinationSslTrustStore 的值为文件路径。 如果它是 Windows 文件路径，那么反斜杠字符 (\) 必须转义为 (\\)。

从 IBM WebSphere® MQ 7.5 或更高版本开始，此属性的值可以包含环境变量。

 None
coordinationSslTrustStoreType 您要使用的 SSL 密钥库的类型。 支持 JKS 和 PKCS#12 密钥库。 该属性的值可以为 jks 或 pkcs12。 jks
coordinationSslTrustStoreCredentialsFile 包含 coordinationSslTrustStore 凭证的文件的路径。

从 IBM WebSphere MQ 7.5开始，此属性的值可以包含环境变量。

 此属性的缺省值为 %USERPROFILE%\MQMFTCredentials.xml (在 Windows 上) 和 $HOME/MQMFTCredentials.xml (在其他平台上)。
coordinationSslKeyStore 指定命令专用密钥的位置。 coordinationSslKeyStore 的值为文件路径。 如果它是 Windows 文件路径，那么必须对反斜杠字符 (\) 进行转义 (\\)。 仅当协调队列管理器需要客户机认证时，才需要此属性。

从 IBM WebSphere MQ 7.5开始，此属性的值可以包含环境变量。

 None
coordinationSslKeyStoreType 您要使用的 SSL 密钥库的类型。 支持 JKS 和 PKCS#12 密钥库。 该属性的值可以为 jks 或 pkcs12。 jks
coordinationSslKeyStoreCredentialsFile 包含 coordinationSslKeyStore 凭证的文件的路径。

从 IBM WebSphere MQ 7.5开始，此属性的值可以包含环境变量。

 此属性的缺省值为 %USERPROFILE%\MQMFTCredentials.xml (在 Windows 上) 和 $HOME/MQMFTCredentials.xml (在其他平台上)。
coordinationSslFipsRequired 指定要在协调队列管理器级别启用 FIPS 支持。 该属性的值可以为 true 或 false。 有关更多信息，请参阅 MFT 中的 FIPS 支持。 false
表 9。 高级协调属性: 预订
属性名 描述 缺省值
coordinationSubscriptionTopic 使用此属性可指定 SYSTEM.FTE ，以获取有关 IBM MQ 网络状态的出版物。 所有工具仍将发布到 SYSTEM.FTE 主题，但是您可以更改 IBM MQ 拓扑以根据其内容将这些出版物分发到不同的主题。 然后，您可以使用此功能强制工具预订其他主题中的一个主题。

对于 IBM WebSphere MQ 7.5 和更高版本的修订包，需要针对 APAR IC96850 的临时修订， IBM MQ Explorer 和 fteListMonitors 命令才能识别该属性。

 SYSTEM.FTE