应用程序客户机的 IBM MQ 提供程序主题连接工厂设置
使用此面板查看或更改所选主题连接工厂的配置属性,以供 IBM MQ Java™ 消息服务 (JMS) 提供程序使用。这些配置属性控制如何创建 JMS 提供程序和 IBM MQ 之间的连接。
要查看该 Application Client Resource Configuration Tool (ACRCT) 页面,单击文件 > 打开。在您浏览 EAR 文件后,单击打开。展开所选 JAR 文件 > 消息传递提供程序 > IBM MQ 提供程序。右键单击主题连接工厂,并单击新建。
- 指定的属性值必须与您配置 IBM MQ 产品 JMS 资源时指定的值相匹配。有关配置 IBM MQ JMS 资源的更多信息,请参阅 IBM MQ 信息中心的“使用 Java”部分。
- 在 IBM MQ 中,名称最大长度为 48 个字符,但通道名例外,通道名的最大长度为 20 个字符。
- BrokerControlQueue
- 对于 MA0C 代理,此值固定为 SYSTEM.BROKER.CONTROL.QUEUE,这是该代理要读取的队列。
- BrokerVersion
- 对于 MA0C 代理,将此值设置为 BASIC。
- ClientID
- 对于 MA0C 代理,可以任意设置此值(此值是一个字符串,它仅仅是客户机应用程序的标识)。
- 启用 XA
- 对于 MA0C 代理来说,将此值设置为 TRUE 或 FALSE(使用的设置是性能提高标志 - 在大部分情况下,您可能要将此值设置为“true”)。
- BrokerMessage Selection
- 对于 MA0C 代理,由于它依赖于客户端消息选择,所以此值固定为 CLIENT。
- 直接代理授权类型
- MA0C 代理不需要此值。
IBM MQ JMS 提供程序的主题连接工厂具有以下属性。
名称
在 WebSphere Application Server 中,为了进行管理而提供的用于识别此主题队列连接工厂的名称。此名称在 JMS 提供程序中必须唯一。
信息 | 值 |
---|---|
数据类型 | 字符串 |
描述
在 WebSphere Application Server 中,为了进行管理而提供的对此主题连接工厂的描述。
信息 | 值 |
---|---|
数据类型 | 字符串 |
JNDI 名称
用于将主题连接工厂绑定到应用程序服务器名称空间的 Java 命名和目录接口 (JNDI) 名称。
按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。
该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
信息 | 值 |
---|---|
数据类型 | 字符串 |
单位 | 美国英语 ASCII 字符 |
范围 | 1 到 45 个 ASCII 字符 |
用户标识
如果调用应用程序未显式提供用户标识和密码,那么将带有密码属性的用户标识用于认证。
如果您指定用户标识属性的值,那么您还必须指定密码属性的值。
如果调用应用程序未显式提供用户标识和密码,那么使用连接工厂用户标识和密码属性,例如,调用应用程序使用方法 createTopicConnection() 时。JMS 客户机将用户标识和密码传递到 JMS 服务器。
信息 | 值 |
---|---|
数据类型 | 字符串 |
密码
如果调用应用程序未显式提供用户标识和密码,那么将带有用户标识属性的密码用于认证。
如果您指定用户标识属性的值,那么您还必须指定密码属性的值。
信息 | 值 |
---|---|
数据类型 | 字符串 |
重新输入密码
确认密码。
队列管理器
此连接工厂的 IBM MQ 队列管理器的名称。此连接工厂创建的连接与该队列管理器连接。
信息 | 值 |
---|---|
数据类型 | 字符串 |
输入主机名和端口信息
缺省情况下会选中此单选按钮,如果选中了此单选按钮,那么它会启用主机名和端口属性并禁用连接名称列表属性。
信息 | 值 |
---|---|
数据类型 | 单选按钮 |
缺省值 | 已选中 |
主机
仅对于客户机连接,运行 IBM MQ 队列管理器的主机的名称。
信息 | 值 |
---|---|
数据类型 | 字符串 |
范围 | 有效的 TCP/IP 主机名 |
端口
用于连接至 IBM MQ 队列管理器的 TCP/IP 端口号(仅用于客户机连接)。
必须在 IBM MQ 队列管理器上配置此端口。
信息 | 值 |
---|---|
数据类型 | 整数 |
范围 | 在 IBM MQ 队列管理器上配置的有效 TCP/IP 端口号。 |
输入连接名称列表信息
如果选中,那么此单选按钮会启用连接名称列表属性并禁用主机和端口名称属性。如果要连接至多实例队列管理器,请选中此单选按钮。
信息 | 值 |
---|---|
数据类型 | 单选按钮 |
缺省值 | 未选中 |
连接名称列表
可用于连接至多实例队列管理器的主机和端口信息的逗号分隔列表。
host[(port)],[host[(port)]]
其中 port 是可选的,如果未设置,那么缺省值是 1414。例如: hostname1,hostname2(1415)
有关多实例队列管理器的进一步信息,请参阅 IBM MQ 信息中心。
此属性只能用于连接至多实例队列管理器。它不能用于连接至一列不同队列管理器,因为这样做可能导致事务完整性问题。
通道
用于和 IBM MQ 队列管理器的客户机连接的通道名(仅用于客户机连接)。
信息 | 值 |
---|---|
数据类型 | 字符串 |
范围 | 1 到 20 个 ASCII 字符 |
传输类型
将 IBM MQ 客户机连接还是将 JNDI 绑定用于到 IBM MQ 队列管理器的连接。
信息 | 值 |
---|---|
数据类型 | 枚举 |
缺省值 | BINDINGS |
范围 |
|
客户机标识
用于连接到 IBM MQ 队列管理器的 JMS 客户机标识。
信息 | 值 |
---|---|
数据类型 | 字符串 |
CCSID
用于与 IBM MQ 队列管理器配合使用的编码字符集标识。
此编码字符集标识 (CCSID) 必须是 IBM MQ 所支持的某个 CCSID。有关更多详细信息,请参阅主题目标的属性。
信息 | 值 |
---|---|
数据类型 | 字符串 |
单位 | 整数 |
范围 | 1 到 65535 |
代理控制队列
代理控制队列的名称,所有命令消息(发布消息以及删除发布消息的请求除外)都将发送到此队列。
信息 | 值 |
---|---|
数据类型 | 字符串 |
单位 | 美国英语 ASCII 字符 |
范围 | 1 到 48 个 ASCII 字符 |
代理队列管理器
提供发布者和订户消息代理的 IBM MQ 队列管理器的名称。
信息 | 值 |
---|---|
数据类型 | 字符串 |
单位 | 美国英语 ASCII 字符 |
范围 | 1 到 48 个 ASCII 字符 |
代理发布队列
用于接收缺省流的所有发布消息的代理输入队列的名称。
接收缺省流的所有发布消息的代理输入队列(流队列)的名称。应用程序还可将缺省流上要删除发布的请求发送到此队列。
信息 | 值 |
---|---|
数据类型 | 字符串 |
单位 | 美国英语 ASCII 字符 |
范围 | 1 到 48 个 ASCII 字符 |
代理预订队列
检索非持续预订消息的代理队列的名称。
检索非持久预订消息的代理队列的名称。订户在注册预订时指定队列名。
信息 | 值 |
---|---|
数据类型 | 字符串 |
单位 | 美国英语 ASCII 字符 |
范围 | 1 到 48 个 ASCII 字符 |
代理 CCSubQ
为 ConnectionConsmer 请求检索非持久预订消息的代理队列的名称。此属性仅适用于 Web 容器使用。
信息 | 值 |
---|---|
数据类型 | 字符串 |
单位 | 美国英语 ASCII 字符 |
范围 | 1 到 48 个 ASCII 字符 |
代理版本
消息代理是由 IBM MQ MA0C SupportPac 提供还是由更高版本的 WebSphere 系列消息代理产品提供。
信息 | 值 |
---|---|
数据类型 | 枚举 |
缺省值 | 高级 |
范围 |
|
清除级别
发布或预订清理实用程序提供的清理级别。
信息 | 值 |
---|---|
数据类型 | 枚举 |
缺省值 | SAFE |
范围 |
|
清除时间间隔
后台执行发布/预订清除实用程序之间的时间间隔(以毫秒计)。
信息 | 值 |
---|---|
数据类型 | 整数 |
单位 | 毫秒 |
缺省值 | 6000 |
消息选择
指定代理消息选择的执行位置。
信息 | 值 |
---|---|
数据类型 | 枚举 |
缺省值 | BROKER |
范围 |
|
发布确认时间间隔
要求代理确认的发布请求之间的时间间隔(以消息数计)。
信息 | 值 |
---|---|
数据类型 | 整数 |
缺省值 | 25 |
稀有预订
启用稀有预订。
信息 | 值 |
---|---|
数据类型 | 复选框 |
缺省值 | 未选中 |
状态刷新时间间隔
刷新发布或预订状态的事务之间的时间间隔(以毫秒计)。
信息 | 值 |
---|---|
数据类型 | 整数 |
缺省值 | 6000 |
预订存储
IBM MQ 用于存储与活动 JMS 预订相关的数据的位置。
信息 | 值 |
---|---|
数据类型 | 枚举 |
缺省值 | MIGRATE |
范围 |
|
多点广播
此连接工厂是否使用多点广播传输。
信息 | 值 |
---|---|
数据类型 | 枚举 |
缺省值 | NOT USED |
范围 |
|
直接认证
是否使用直接代理授权。
信息 | 值 |
---|---|
数据类型 | 枚举 |
缺省值 | NONE |
范围 |
|
代理主机名
用于与 IBM MQ 通信的代理的主机名。
信息 | 值 |
---|---|
数据类型 | 字符串 |
代理端口
用于与 IBM MQ 通信的代理的端口号。
信息 | 值 |
---|---|
数据类型 | 整数 |
缺省值 | 0 |
如果停顿,那么失败
如果队列管理器已发生控制故障,那么应用程序是否从方法调用返回。
信息 | 值 |
---|---|
数据类型 | 复选框 |
缺省值 | 已选中 |
本地服务器地址
本地服务器地址。
信息 | 值 |
---|---|
数据类型 | 字符串 |
轮询时间间隔
异步消息传递期间扫描所有接收方之间的时间间隔(以毫秒计)。
信息 | 值 |
---|---|
数据类型 | 整数 |
单位 | 毫秒 |
缺省值 | 5000 |
重新扫描时间间隔
扫描主题以查找无序地添加至主题的消息之间的时间间隔(以毫秒计)。
重新扫描时间间隔控制扫描已无序地添加至主题的消息,它与 IBM MQ 浏览光标相关。
信息 | 值 |
---|---|
数据类型 | 整数 |
单位 | 毫秒 |
缺省值 | 5000 |
SSL 密码套件
用于以 SSL 方式连接到 IBM MQ 的密码套件。
将此属性设置为您的 JSSE 提供程序提供的有效密码套件。该值必须与在 SVRCONN 通道上作为通道属性指定的 CipherSpec 匹配。
如果您设置 SSL 对等名称属性,那么必须设置此属性。
SSL 证书库
零个或多个证书撤销列表 (CRL) 服务器的列表,这些服务器用于检查 SSL 证书撤销情况。如果您为此属性指定值,那么必须使用 Java 2 V1.4 上的 IBM MQ JVM。
ldap://hostname:[port]
单个斜杠 (/) 在该值之后。如果省略 port,那么假设缺省 LDAP 端口为 389。连接时,对照指定的 CRL 服务器检查服务器提供的 SSL 证书。有关 CRL 安全性的更多信息,请参阅 IBM MQ 信息中心的“安全性”部分中有关“使用证书撤销列表”的信息。
SSL 对等名称
对于 SSL,专有名称框架必须与 IBM MQ 队列管理器提供的名称匹配。专有名称用于检查连接时服务器提供的标识证书。
如果未设置此属性,那么执行该证书检查。
如果未指定 SSL 密码套件属性,那么忽略 SSL 对等名称属性。
CN=QMGR.*, OU=IBM, OU=WEBSPHERE
给出的示例在连接时检查服务器提供的标识证书。要使连接成功,证书必须具有以 QMGR. 开头的公共名,并且必须至少有两个组织单元(OU)名称,第一个名称为 IBM®,第二个名称为 WEBSPHERE。检查不区分大小写。
有关专有名称及其与 IBM MQ 的配合使用的更多详细信息,请参阅 IBM MQ 信息中心中的“安全性”部分中有关“专有名称”的信息。
连接池
连接池设置的可选集合。
连接池属性对于所有 J2C 连接器是公共的。
应用程序服务器将连接和会话与 JMS 提供程序共享,以改进性能。此连接池独立于任何 IBM MQ 连接池。必须为应用程序正确地配置连接和会话池属性,否则也许不能获取需要的连接和会话行为。
如果对 JMS 资源的并发服务器端访问超出缺省值,那么更改连接池的大小。在每个队列或主题基础上设置连接池的大小。
信息 | 值 |
---|---|
数据类型 | 复选框 |
缺省值 | 已选中 |
客户机重新连接选项
指定通信或队列管理器失败时客户机方式连接是否自动重新连接。除非正在瘦客户机环境或受管客户机环境中使用连接工厂,否则会忽略此属性。
信息 | 值 |
---|---|
数据类型 | 下拉列表 |
缺省值 | 已禁用 |
范围 |
|
有关自动客户机重新连接的更多信息,请参阅 IBM MQ 信息中心。
客户机重新连接超时
通信或队列管理器失败后客户机方式连接尝试自动重新连接至队列管理器时所耗的最长时间(以秒计)。除非正在瘦客户机环境或受管客户机环境中使用连接工厂,否则会忽略此参数。是否使用此参数取决于客户机重新连接选项参数的值。
信息 | 值 |
---|---|
数据类型 | 整数 |
单位 | 秒 |
缺省值 | 1800 |
范围 | 大于零并且最高为 2147483647 的值 |
有关自动客户机重新连接的更多信息,请参阅 IBM MQ 信息中心。