应用程序客户机的 IBM MQ 提供程序队列连接工厂设置
使用此面板查看或更改所选队列连接工厂的配置属性,以供 IBM MQ Java™ 消息服务 (JMS) 提供程序使用。这些配置属性控制如何创建 JMS 提供程序和 IBM MQ 之间的连接。
要查看此 Application Client Resource Configuration Tool (ACRCT) 页面,单击打开。展开所选 JAR 文件并单击 。右键单击队列连接工厂,并单击新建。以下字段出现在常规选项卡上。
。在您浏览 EAR 文件后,单击- 指定的属性值必须与您配置 JMS 资源的 IBM MQ 时指定的值匹配。有关为 JMS 资源配置 IBM MQ 的更多信息,请参阅 IBM MQ 信息中心的“使用 Java”部分。
- 在 IBM MQ 中,名称最大长度为 48 个字符,但通道名例外,通道名的最大长度为 20 个字符。
JMS 提供程序的队列连接工厂具有以下属性。
名称
在 WebSphere® Application Server 中,为了进行管理而提供的用于识别此队列连接工厂的名称。此名称在跨 WebSphere 管理域的 JMS 连接工厂中是唯一的。
信息 | 值 |
---|---|
数据类型 | 字符串 |
描述
在 WebSphere Application Server 中,为了进行管理而提供的对此连接工厂的描述。
信息 | 值 |
---|---|
数据类型 | 字符串 |
缺省值 | Null |
JNDI 名称
应用程序客户机运行时使用此字段检索配置信息。
用户标识
如果调用应用程序未显式提供用户标识和密码,那么将带有密码属性的用户标识用于认证。
如果您指定用户标识属性的值,那么您还必须指定密码属性的值。
如果调用应用程序未显式提供用户标识和密码,那么使用连接工厂用户标识和密码属性;例如,如果调用应用程序使用方法 createQueueConnection()。JMS 客户机将用户标识和密码传递到 JMS 服务器。
信息 | 值 |
---|---|
数据类型 | 字符串 |
密码
如果调用应用程序未显式提供用户标识和密码,那么将带有用户标识属性的密码用于认证。
如果您指定用户标识属性的值,那么您还必须指定密码属性的值。
信息 | 值 |
---|---|
数据类型 | 字符串 |
缺省值 | Null |
重新输入密码
确认密码。
队列管理器
此连接工厂的 IBM MQ 队列管理器的名称。
此工厂创建的连接与该队列管理器连接。
信息 | 值 |
---|---|
数据类型 | 字符串 |
输入主机名和端口信息
缺省情况下会选中此单选按钮,如果选中了此单选按钮,那么它会启用主机名和端口属性并禁用连接名称列表属性。
信息 | 值 |
---|---|
数据类型 | 单选按钮 |
缺省值 | 已选中 |
主机
仅对于客户机连接,运行 IBM MQ 队列管理器的主机的名称。
信息 | 值 |
---|---|
数据类型 | 字符串 |
缺省值 | Null |
范围 | 有效的 TCP/IP 主机名 |
端口
用于连接至 IBM MQ 队列管理器的 TCP/IP 端口号(仅用于客户机连接)。
必须在 IBM MQ 队列管理器上配置此端口。
信息 | 值 |
---|---|
数据类型 | 整数 |
缺省值 | Null |
范围 | 在 IBM MQ 队列管理器上配置的有效 TCP/IP 端口号。 |
输入连接名称列表信息
如果选中,那么此单选按钮会启用连接名称列表属性并禁用主机和端口名称属性。如果要连接至多实例队列管理器,请选中此单选按钮。
信息 | 值 |
---|---|
数据类型 | 单选按钮 |
缺省值 | 未选中 |
连接名称列表
可用于连接至多实例队列管理器的主机和端口信息的逗号分隔列表。
host[(port)],[host[(port)]]
其中 port 是可选的,如果未设置,那么缺省值是 1414。例如:hostname1,hostname2(1415)
有关多实例队列管理器的进一步信息,请参阅 IBM MQ 信息中心。
此属性只能用于连接至多实例队列管理器。它不能用于连接至一列不同队列管理器,因为这样做可能导致事务完整性问题。
通道
用于连接至 IBM MQ 队列管理器的通道名(仅用于客户机连接)。
信息 | 值 |
---|---|
数据类型 | 字符串 |
缺省值 | Null |
范围 | 1 到 20 个 ASCII 字符 |
传输类型
指定是使用 IBM MQ 客户机连接还是使用 JNDI 绑定来连接到 IBM MQ 队列管理器。外部 JMS 提供程序控制 JMS 客户机和 JMS 服务器之间的通信协议。当您使用非 ASF 非持久性、非持续性、非事务性消息传递时,或者当您要满足安全性问题,而客户机对于队列管理器节点是本地时,调整传输类型。
信息 | 值 |
---|---|
数据类型 | 枚举 |
单位 | 不适用 |
缺省值 | BINDINGS |
范围 |
|
建议 |
注: 由于 WebSphere Application Server V6.1 含有 Java 5 运行时,所以不能在 WebSphere Application Server V6.1 中使用
IBM MQ 5.3 JMS。因此,不能使用 IBM MQ 5.3 队列管理器来建立跨内存连接。如果您先前使用 IBM MQ 5.3 和 BINDINGS 来进行连接,并且在迁移至 WebSphere Application Server V6.1
时改为使用 CLIENT 网络连接,那么可能会导致性能下降。
![]() |
客户机标识
用于连接到 IBM MQ 队列管理器的 JMS 客户机标识。
信息 | 值 |
---|---|
数据类型 | 字符串 |
CCSID
用于与 IBM MQ 队列管理器配合使用的编码字符集标识。
此编码字符集标识 (CCSID) 必须是 IBM MQ 支持的其中一个 CCSID。
信息 | 值 |
---|---|
数据类型 | 字符串 |
有关受支持 CCSID 以及将消息数据从一个编码字符集转换为另一个编码字符集的更多信息,请参阅 IBM MQ 信息中心的“系统管理”部分和“应用程序编程参考”部分。
消息保留
选中此复选框以指定将不需要的消息留在队列中。否则,将根据那些不需要的消息的处置选项来处理它们。
信息 | 值 |
---|---|
数据类型 | 枚举 |
单位 | 不适用 |
缺省值 | 未选中 |
范围 |
|
临时模型
当连接工厂还未存在时,用于创建临时连接工厂的模型定义的名称。
信息 | 值 |
---|---|
数据类型 | 字符串 |
范围 | 1 到 48 个 ASCII 字符 |
临时队列前缀
用于进行动态队列命名的前缀。
信息 | 值 |
---|---|
数据类型 | 字符串 |
如果停顿,那么失败
如果队列管理器已发生控制故障,那么指定应用程序是否从方法调用返回。
信息 | 值 |
---|---|
数据类型 | 复选框 |
缺省值 | 已选中 |
本地服务器地址
指定本地服务器地址。
信息 | 值 |
---|---|
数据类型 | 字符串 |
轮询时间间隔
指定异步消息传递期间扫描所有接收方之间的时间间隔(以毫秒计)
信息 | 值 |
---|---|
数据类型 | 整数 |
单位 | 毫秒 |
缺省值 | 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 信息中心。