/Jakarta Messaging IBM MQ classes for JMS配置文件

配置文件 IBM® MQ classes for JMS 以及 IBM MQ classes for Jakarta Messaging 用于指定用于配置的属性 IBM MQ classes for JMS 以及 IBM MQ classes for Jakarta Messaging。

注意： 配置文件中定义的属性也可设置为 JVM 系统属性。 如果某个属性既在配置文件中进行了设置，又设置为系统属性，那么系统属性优先。 因此，如果需要，可以通过在 java 命令中将配置文件中的任何属性设置为系统属性来将其覆盖。

配置 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging 文件的格式采用标准 Java 属性文件的格式。 在安装 IBM MQ classes for JMS 目录的子目录 bin 中，提供 jms.config 了一个名为 的示例配置文件。 该文件记录所有受支持的属性及其缺省值。

您可以选择 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging 配置文件的名称和位置。 启动应用程序时，请使用以下格式的 java 命令：
java -Dcom.ibm.msg.client.config.location= config_file_url application_name
在该命令中 ，config_file_url 是统一资源定位符（ URL ），用于指定 或 IBM MQ classes for Jakarta Messaging 配置 IBM MQ classes for JMS 文件的名称和位置。 支持以下类型的 URL：http、file、ftp 和 jar。
以下是 java 命令的示例：
java -Dcom.ibm.msg.client.config.location=file:/D:/mydir/myjms.config MyAppClass
此命令将配置文件 IBM MQ classes for JMS IBM MQ classes for Jakarta Messaging 或 识别为本地 Windows 系统上的 D:\mydir\mjms.config 文件。

当应用程序启动时， IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging 会读取配置文件的内容，并将指定的属性存储在内部属性存储库中。 如果命令 java 未指定配置文件，或配置文件无法找到，则所有属性 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging 均采用默认值。

配置文件 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging 可用于应用程序与队列管理器或代理之间任何受支持的传输协议。

覆盖 IBM MQ MQI client 配置文件中指定的属性

配置文件 IBM MQ MQI client 还可以指定用于配置的属性 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging。 然而，配置文件 IBM MQ MQI client 中指定的属性仅在应用程序以客户端模式连接到队列管理器时生效。

如有需要，您可以在配置文件 IBM MQ MQI client 中通过将其指定为属性来覆盖任何 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging 属性。 要在 IBM MQ MQI client 配置文件中覆盖某个属性，请在 或 IBM MQ classes for Jakarta Messaging IBM MQ classes for JMS 配置文件中使用以下格式的条目：
com.ibm.mq.cfg. stanza. propName = propValue
该条目中的变量具有以下含义：
节 (stanza)
IBM MQ MQI client 配置文件中包含该属性的节的名称
propName
IBM MQ MQI client 配置文件中指定的属性的名称
propValue
覆盖 IBM MQ MQI client 配置文件中指定的属性值的属性值

或者，您可以通过在 java 命令中将属性指定为系统属性来覆盖 IBM MQ MQI client 配置文件中的属性。 使用先前格式将属性指定为系统属性。

仅 IBM MQ MQI client 配置文件中的以下属性与相关 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging。 如果您指定或覆盖其他属性，那么将无效。 请特别注意 ，客户端配置文件中 CHANNELS 段落中的 ChannelDefinitionDirectory 和 ChannelDefinitionFile 未被使用。 有关如何使用CCDT与 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging.的详细信息 使用包含 IBM MQ 类别的客户端通道定义表用于JMS ，请参阅。
表 1. 客户机配置文件的哪节包含哪个属性
节 属性
客户机配置文件的 CHANNELS 节 Put1DefaultAlwaysSync
客户机配置文件的 CHANNELS 节 DefRecon
客户机配置文件的 CHANNELS 节 ReconDelay
客户机配置文件的 CHANNELS 节 PasswordProtection
客户端配置文件中的ClientExitPath节 ExitsDefaultPath
客户端配置文件中的ClientExitPath节 ExitsDefaultPath64
客户端配置文件中的ClientExitPath节 JavaExitsClasspath
客户机配置文件的 JMQI 节 useMQCSPauthentication
客户机配置文件的MessageBuffer 节 MaximumSize
客户机配置文件的MessageBuffer 节 PurgeTime
客户机配置文件的MessageBuffer 节 UpdatePercentage
TCP 客户端配置文件的段落 ClntRcvBuffSize
TCP 客户端配置文件的段落 ClntSndBuffSize
TCP 客户端配置文件的段落 Connect_Timeout
TCP 客户端配置文件的段落 KeepAlive
有关配置 IBM MQ MQI client 的更多详细信息，请参见 IBM MQ MQI client 配置文件， mqclient.ini