JMS 连接工厂 (jmsConnectionFactory)
定义 JMS 连接工厂配置。
| 属性名称 | 数据类型 | 缺省值 | 描述 |
|---|---|---|---|
| connectionManagerRef | 对顶级 connectionManager 元素的引用(字符串)。 | 连接工厂的连接管理器。 | |
| containerAuthDataRef | 对顶级 authData 元素的引用(字符串)。 | 当绑定未使用 res-auth=CONTAINER 来指定资源引用的 authentication-alias 时应用的容器管理的认证的缺省认证数据。 | |
| id | string | 唯一配置标识。 | |
| jndiName | string | 资源的 JNDI 名称。 | |
| recoveryAuthDataRef | 对顶级 authData 元素的引用(字符串)。 | 用于事务恢复的认证数据。 |
- connectionManager
描述: 连接工厂的连接管理器。必需: False数据类型: 属性名称 数据类型 缺省值 描述 agedTimeout 精度为秒的时间段 -1 池维护可以废弃物理连接之前的时间量。值为 -1 时会禁用此超时。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 connectionTimeout 精度为秒的时间段 30s 连接请求超时之前的时间量。值为 -1 时会禁用此超时。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 maxConnectionsPerThread 整型 最小值:0
限制每个线程上打开的连接数。 maxIdleTime 精度为秒的时间段 30m 池维护期间可废弃未使用或空闲的连接之前的时间量(如果这样做不会使池大小减小到小于最小大小)。值为 -1 时会禁用此超时。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 maxPoolSize 整型 最小值:0
50 池的最大物理连接数。值为 0 时意味着不受限制。 minPoolSize 整型 最小值:0
池中要保留的最小物理连接数。池不会进行预填充。时效超时可以覆盖此最小值。 numConnectionsPerThreadLocal 整型 最小值:0
为每个线程高速缓存所指定数目的连接。 purgePolicy - ValidateAllConnections
- FailingConnectionOnly
- EntirePool
EntirePool 指定在池中检测到旧连接时要销毁哪些连接。 - ValidateAllConnections
- 当检测到失效连接时,会测试连接并关闭发现存在错误的那些连接。
- FailingConnectionOnly
- 当检测到失效连接时,会仅关闭发现存在错误的连接。
- EntirePool
- 当检测到失效连接时,会将池中的所有连接都标记为失效,而且当这些连接不再使用时,会予以关闭。
reapTime 精度为秒的时间段 3m 两次运行池维护线程之间的时间量。值为 -1 时会禁用池维护。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
- containerAuthData
描述: 当绑定未使用 res-auth=CONTAINER 来指定资源引用的 authentication-alias 时应用的容器管理的认证的缺省认证数据。必需: False数据类型: 属性名称 数据类型 缺省值 描述 password 可逆向编码的密码(字符串) 连接至 EIS 时要使用的用户密码。可以采用明文或编码格式存储该值。建议您对该密码进行编码。要对该密码进行编码,请将 securityUtility 工具与编码选项配合使用。 user string 连接至 EIS 时要使用的用户名称。
- properties.wasJms
描述: JMS 连接工厂用于创建与 JMS 目标的相关联 JMS 提供者的连接,以便进行点到点消息传递和发布/预订消息传递。必需: False数据类型: 属性名称 数据类型 缺省值 描述 busName string defaultBus 连接至完整概要文件服务器中的服务集成总线时使用的总线名称。 clientID string clientID 所有连接上持久(及共享非持久)主题预订所需的 JMS 客户机标识。如果应用程序要执行持久(及共享非持久)发布/预订消息传递,那么需要此标识。 durableSubscriptionHome string defaultME 持久预订主地址定义需要与其建立连接的 ME 名称。 nonPersistentMapping - BestEffortNonPersistent
- ReliableNonPersistent
- ExpressNonPersistent
ExpressNonPersistent 对使用此连接工厂发送的非持久性 JMS 消息应用的可靠性。 - BestEffortNonPersistent
- BestEffortNonPersistent
- ReliableNonPersistent
- ReliableNonPersistent
- ExpressNonPersistent
- ExpressNonPersistent
password 可逆向编码的密码(字符串) 建议使用容器管理的认证别名,而不配置此属性。 persistentMapping - AssuredPersistent
- ReliablePersistent
ReliablePersistent 对使用此连接工厂发送的持久 JMS 消息应用的可靠性。 - AssuredPersistent
- AssuredPersistent
- ReliablePersistent
- ReliablePersistent
readAhead - AlwaysOff
- Default
- AlwaysOn
Default 预读是一种优化措施,即抢先将消息指定给使用者。这会更快地处理使用者请求。 - AlwaysOff
- AlwaysOff
- Default
- Default
- AlwaysOn
- AlwaysOn
remoteServerAddress string 具有用来连接至引导服务器的三元组(用逗号分隔,语法为 hostName:portNumber:chainName)的远程服务器地址。例如,Merlin:7276:BootstrapBasicMessaging。如果未指定主机名,那么缺省值为 localhost。如果未指定端口号,那么缺省值为 7276。如果未指定链名,那么缺省值为 BootstrapBasicMessaging。有关更多信息,请参阅信息中心。 shareDurableSubscription string 控制持久预订是否可在连接之间共享。 targetTransportChain string 传输链指定通信协议,这些通信协议可用来与完整概要文件服务器中的服务集成总线通信。 temporaryQueueNamePrefix string temp 该前缀最多为十二个字符,用于表示使用此队列连接工厂的应用程序来创建的临时队列。 temporaryTopicNamePrefix string temp 该前缀最多为十二个字符,用于表示使用此主题连接工厂的应用程序创建的临时主题。 userName string 建议使用容器管理的认证别名,而不配置此属性。
- properties.wmqJms
描述: WebSphere MQ JMS 连接工厂必需: False数据类型: 属性名称 数据类型 缺省值 描述 CCSID 整型 最小值:1
819 连接的编码字符集标识。 applicationName string 应用程序用于向队列管理器注册的名称。 arbitraryProperties string 能够指定其他位置未定义的属性 brokerCCSubQueue string 连接使用者从中接收非持续预订消息的队列的名称 brokerControlQueue string 代理程序控制队列的名称 brokerPubQueue string 发送已发布消息的队列(流队列)的名称。 brokerQueueManager string 队列管理器的名称,代理程序正在此队列管理器上运行 brokerSubQueue string 非持续消息使用者从中接收消息的队列的名称 brokerVersion - 2
- 1
要使用的代理程序的版本 - 2
- 2
- 1
- 1
ccdtURL string 一个 URL,它标识客户机通道定义表 (CCDT) 所属文件的名称和位置,并指定可以如何访问此文件。 channel string 要使用的 MQI 通道的名称。 cleanupInterval 具有毫秒精度的时间段 在后台两次运行发布/预订清除实用程序之间的时间间隔(毫秒)。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 cleanupLevel - SAFE
- FORCE
- NONDUR
- 无
- STRONG
SAFE 基于代理程序的预订存储的清除级别。 - SAFE
- SAFE
- FORCE
- FORCE
- NONDUR
- NONDUR
- 无
- 无
- STRONG
- STRONG
clientId string 连接的客户机标识 cloneSupport - ENABLED
- 已禁用
已禁用 同一持久主题订户的两个或更多实例是否可以同时运行。 - ENABLED
- ENABLED
- 已禁用
- 已禁用
connectionNameList string 用于通信的 TCP/IP 连接名称(主机名(端口))的列表。ConnectionNameList 将取代主机名和端口属性。 failIfQuiesce 布尔型 true 如果队列管理器处于停顿状态,那么指示对某些方法的调用是否会失败。 headerCompression - SYSTEM
- 无
无 可用于在连接时压缩头数据的方法列表 - SYSTEM
- SYSTEM
- 无
- 无
hostName string 队列管理器所在系统的主机名或 IP 地址。指定了 ConnectionNameList 属性时,主机名和端口属性将被 ConnectionNameList 属性取代。 localAddress string 要连接至队列管理器,此属性指定下列一项或两项:(1) 要使用的本地网络接口;(2) 要使用的本地端口或者某个范围的本地端口 messageCompression - RLE
- 无
无 可用于在连接时压缩消息数据的方法列表。 - RLE
- RLE
- 无
- 无
messageSelection - CLIENT
- BROKER
CLIENT 确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。 - CLIENT
- CLIENT
- BROKER
- BROKER
password 可逆向编码的密码(字符串) 创建与队列管理器的连接时要使用的缺省密码。(建议使用容器管理的认证别名,而不配置此属性) pollingInterval 具有毫秒精度的时间段 此值是以毫秒计的最大时间间隔,如果会话中的每个消息侦听器在其队列中都没有合适的消息,那么在此时间过后,每个消息侦听器都将再次尝试从其队列中获取消息。如果在一个会话中频繁地发生任何消息侦听器都没有适当的消息可用,那么应考虑增大此属性的值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 port 整型 最小值:1
1414 队列管理器侦听的端口。指定了 ConnectionNameList 属性时,主机名和端口属性将被 ConnectionNameList 属性取代。 providerVersion - 7
- 6
- unspecified
unspecified 应用程序打算连接的队列管理器的版本、发行版、修改级别和修订包。 - 7
- 7
- 6
- 6
- unspecified
- unspecified
pubAckInterval 整型 最小值:0
25 WebSphere MQ JMS 类请求代理程序的应答之前,发布程序发布的消息数 queueManager string 要连接至的队列管理器的名称 receiveExit string 标识一个通道接收出口程序或一系列要连续运行的接收出口程序 receiveExitInit string 调用通道接收出口程序时,传递到这些程序的用户数据 rescanInterval 具有毫秒精度的时间段 5s 当点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,WebSphere MQ JMS 类将按 WebSphere MQ 队列的 MsgDeliverySequence 属性所确定的顺序在该队列中搜索合适的消息。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 securityExit string 标识通道安全性出口程序 securityExitInit string 调用通道安全性出口程序时,传递到该程序的用户数据 sendCheckCount 整型 最小值:0
在单个非事务 JMS 会话中,允许在两次检查异步放置错误之间发送的调用数。 sendExit string 标识一个通道发送出口程序,或者要连续运行的一系列发送出口程序。 sendExitInit string 调用通道发送出口程序时,传递至这些程序的用户数据。 shareConvAllowed 布尔型 true 如果通道定义匹配,客户机连接是否可以与从同一个流程至同一个队列管理器的其他顶级 JMS 连接共享其套接字 sparseSubscriptions 布尔型 False 控制 TopicSubscriber 对象的消息检索策略。 sslCertStores string 拥有要在 SSL 连接时使用的证书撤销列表 (CRL) 的轻量级目录访问协议 (LDAP) 服务器。 sslCipherSuite string 要用于 SSL 连接的密码套件。 sslFipsRequired 布尔型 SSL 连接是否必须使用 IBM Java JSSE FIPS 提供者 (IBMJSSEFIPS) 支持的密码套件。 sslPeerName string 对于 SSL 连接,这是用来检查由队列管理器提供的数字证书中的专有名称的模板。 sslResetCount 整型 最小值:0
最大值:999999999
0 在重新协商 SSL 所使用的密钥之前,SSL 连接所发送和接收的字节总数。 statusRefreshInterval 具有毫秒精度的时间段 1m 这是以毫秒计的时间间隔,用于检测订户与队列管理器之间的连接是否中断的长时间运行事务将按此时间间隔执行刷新。仅当预订存储器的值为 QUEUE 时,此属性才起作用。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 subscriptionStore - MIGRATE
- BROKER
- 队列
BROKER 确定 WebSphere MQ JMS 类是否存储有关活动预订的持久数据。 - MIGRATE
- MIGRATE
- BROKER
- BROKER
- 队列
- 队列
targetClientMatching 布尔型 true 是否仅当入局消息具有 MQRFH2 头时,发送至由该入局消息的 JMSReplyTo 头字段标识的队列的应答消息才具有 MQRFH2 头。 tempQPrefix string 用于构成 WebSphere MQ 动态队列名称的前缀。 tempTopicPrefix string 创建临时主题时,JMS 会生成一个格式为 TEMP/TEMPTOPICPREFIX/unique_id 的字符串,或者,如果让此属性保持为缺省值,那么只会生成格式为 TEMP/unique_id 的字符串。指定非空 TEMPTOPICPREFIX 允许定义特定模型队列,以便为在此连接下面创建的临时主题的订户创建受管队列。 temporaryModel string 用来创建 JMS 临时队列的模型队列的名称。JMS 层可以使用 SYSTEM.JMS.TEMPQ.MODEL 来创建可接受持久消息的队列,而缺省值则不能。SYSTEM.DEFAULT.MODEL.QUEUE 只能打开一次。SYSTEM.JMS.TEMPQ.MODEL 可以多次打开。建议不要使用 SYSTEM.DEFAULT.MODEL.QUEUE。 transportType - CLIENT
- BINDINGS
CLIENT 与队列管理器的连接是使用客户机方式还是使用绑定方式。 - CLIENT
- CLIENT
- BINDINGS
- BINDINGS
userName string 创建与队列管理器的连接时要使用的缺省用户名。(建议使用容器管理的认证别名,而不配置此属性) wildcardFormat - CHAR
- 主题
主题 要使用哪个版本的通配符语法。 - CHAR
- CHAR
- 主题
- 主题
参考主题