JMS 连接工厂 (jmsConnectionFactory)
定义 JMS 连接工厂配置。
属性名称 | 数据类型 | 缺省值 | 描述 |
---|---|---|---|
connectionManagerRef | 对顶级 connectionManager 元素的引用(字符串)。 | 连接工厂的连接管理器。 | |
containerAuthDataRef | 对顶级 authData 元素的引用(字符串)。 | 容器管理认证的缺省认证数据,当绑定没有为 res-auth=CONTAINER 的资源引用指定认证别名时适用。 | |
id | 字符串 | 唯一配置标识。 | |
jndiName | string | 资源的 JNDI 名称。 | |
recoveryAuthDataRef | 对顶级 authData 元素的引用(字符串)。 | 用于事务恢复的认证数据。 |
- connectionManager
描述: 连接工厂的连接管理器。必需: false数据类型: 属性名称 数据类型 缺省值 描述 agedTimeout 具有秒精度的时间段 -1 池维护可以废弃某个物理连接之前的时间量。值为 -1 时会禁用此超时。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 connectionTimeout 具有秒精度的时间段 30s 连接请求超时之前的时间量。值为 -1 时会禁用此超时。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 maxConnectionsPerThread int 最小值:0
限制每个线程上打开的连接数。 maxIdleTime 具有秒精度的时间段 30m 池维护期间可废弃某个未使用或空闲的连接之前的时间量(如果这样做不会使池大小减小到小于最小大小)。值为 -1 时会禁用此超时。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 maxPoolSize int 最小值:0
50 池的物理连接的最大数目。值为 0 意味着不受限制。 minPoolSize int 最小值:0
池中要维持的最小物理连接数。池未进行预填充。时效超时可以覆盖此最小值。 numConnectionsPerThreadLocal int 最小值:0
为每个线程高速缓存指定数目的连接。 purgePolicy - ValidateAllConnections
- FailingConnectionOnly
- EntirePool
EntirePool 指定在池中检测到失效连接时要销毁哪些旧连接。 - ValidateAllConnections
- 当检测到失效连接时,会测试连接并关闭发现存在错误的连接。
- FailingConnectionOnly
- 当检测到失效连接时,会仅关闭发现存在错误的连接。
- EntirePool
- 当检测到失效连接时,会将池中的所有连接都标记为失效,当不再使用这些连接时,会将其关闭。
reapTime 具有秒精度的时间段 3m 池维护线程各次运行之间的时间量。值为 -1 会禁用池维护。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
- containerAuthData
描述: 容器管理认证的缺省认证数据,当绑定没有为 res-auth=CONTAINER 的资源引用指定认证别名时适用。必需: false数据类型: 属性名称 数据类型 缺省值 描述 password 可逆向编码的密码(字符串) 连接至 EIS 时所使用的用户密码可采用明文或编码格式存储该值。建议您对该密码进行编码。为此,请将 securityUtility 工具与编码选项配合使用。 user string 连接至 EIS 时所使用的用户名
- properties.wasJms
描述: JMS 连接工厂用于为点到点和发布/预订消息传递创建与 JMS 目标的关联 JMS 提供程序的连接。必需: false数据类型: 属性名称 数据类型 缺省值 描述 busName string defaultBus 连接至完整概要文件服务器中的服务集成总线时,该总线的名称。 clientID string clientID 所有连接上持久(及共享非持久)主题预订所需的 JMS 客户机标识。如果应用程序要执行持久(及共享非持久)发布/预订消息传递,那么需要此标识。 durableSubscriptionHome string defaultME 持久预订本地名称定义 ME 名称,需要与该 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。如果未指定 hostName,那么缺省值为 localhost。如果未指定 portNumber,那么缺省值为 7276。如果未指定 chainName,那么缺省值为 BootstrapBasicMessaging。请参阅信息中心,以了解更多信息。 shareDurableSubscription string 控制持久预订是否可在连接之间共享。 targetTransportChain string 传输链指定通信协议,这些通信协议可用来与完整概要文件服务器中的服务集成总线通信。 temporaryQueueNamePrefix string temp 该前缀最多为十二个字符,用于表示使用此队列连接工厂的应用程序创建的临时队列。 temporaryTopicNamePrefix string temp 该前缀最多为十二个字符,用于表示使用此主题连接工厂的应用程序创建的临时主题。 userName string 建议使用容器管理认证别名而非配置此属性。
- properties.wmqJms
描述: WebSphere MQ JMS 连接工厂必需: false数据类型: 属性名称 数据类型 缺省值 描述 CCSID int 最小值: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)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 cleanupLevel - SAFE
- FORCE
- NONDUR
- NONE
- STRONG
SAFE 基于代理程序的预订存储器的清除级别。 - SAFE
- SAFE
- FORCE
- FORCE
- NONDUR
- NONDUR
- NONE
- NONE
- STRONG
- STRONG
clientId string 连接的客户机标识 cloneSupport - ENABLED
- DISABLED
DISABLED 是否允许同时运行同一个持久主题订户的两个或更多个实例。 - ENABLED
- ENABLED
- DISABLED
- DISABLED
connectionNameList string 用于通信的 TCP/IP 连接名称(主机名(端口))的列表。ConnectionNameList 将取代主机名和端口属性。 failIfQuiesce 布尔型 true 队列管理器处于停顿状态时,对某些方法的调用是否失败 headerCompression - SYSTEM
- NONE
NONE 可用于压缩连接上的头数据的方法列表 - SYSTEM
- SYSTEM
- NONE
- NONE
hostName string 队列管理器所在的系统的主机名或 IP 地址。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。 localAddress string 对于与队列管理器的连接,此属性指定下列其中一项或全部:(1) 要使用的本地网络接口,(2) 要使用的本地端口或本地端口范围 messageCompression - RLE
- NONE
NONE 可用于压缩连接上的消息数据的方法列表。 - RLE
- RLE
- NONE
- NONE
messageSelection - CLIENT
- BROKER
CLIENT 确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。 - CLIENT
- CLIENT
- BROKER
- BROKER
password 可逆向编码的密码(字符串) 创建与队列管理器的连接时要使用的缺省密码。(建议使用容器管理的认证别名而不是配置此属性) pollingInterval 具有毫秒精度的时间段 如果会话中每个消息侦听器在其队列中都没有合适的消息,那么此值是每个消息侦听器再次尝试从其队列中获取消息前经过的最大时间间隔(以毫秒计)。如果经常出现没有合适消息可供会话中任何消息侦听器使用的情况,那么请考虑增大此属性的值。仅当 TRANSPORT 值为 BIND 或 CLIENT 时,此属性才有意义。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 port int 最小值:1
1414 队列管理器侦听的端口。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。 providerVersion - 7
- 6
- unspecified
unspecified 应用程序计划连接至的队列管理器的版本、发行版、修改级别和修订包。 - 7
- 7
- 6
- 6
- unspecified
- unspecified
pubAckInterval int 最小值:0
25 WebSphere MQ JMS 类请求代理程序的应答之前,发布程序发布的消息数 queueManager string 要连接至的队列管理器的名称 receiveExit string 标识通道接收出口程序或要接连运行的一系列接收出口程序 receiveExitInit string 调用通道接收出口程序时传递至这些出口程序的用户数据 rescanInterval 具有毫秒精度的时间段 5s 当点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,WebSphere MQ JMS 类将按 WebSphere MQ 队列的 MsgDeliverySequence 属性所确定的顺序在该队列中搜索合适的消息. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 securityExit string 标识通道安全性出口程序 securityExitInit string 调用通道安全性出口程序时传递至该出口程序的用户数据 sendCheckCount int 最小值: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 int 最小值:0
最大值:999999999
0 重新协商 SSL 使用的密钥之前,SSL 连接发送和接收的总字节数。 statusRefreshInterval 具有毫秒精度的时间段 1m 刷新长期运行的事务的时间间隔(以毫秒计),该事务检测订户何时失去与队列管理器的连接。仅当 SUBSTORE 值为 QUEUE 时,此属性才有意义。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 subscriptionStore - MIGRATE
- BROKER
- QUEUE
BROKER 确定 WebSphere MQ JMS 类是否存储有关活动预订的持久数据。 - MIGRATE
- MIGRATE
- BROKER
- BROKER
- QUEUE
- QUEUE
targetClientMatching 布尔型 true 发送至入局消息的 JMSReplyTo 头字段所标识的队列的回复消息是否具有 MQRFH2 头(仅当入局消息具有 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 与队列管理器的连接是使用客户机方式还是使用绑定方式。如果指定了值 BINDINGS_THEN_CLIENT,那么资源适配器先尝试以绑定方式进行连接。如果此连接失败,请尝试以客户机方式建立连接。 - CLIENT
- CLIENT
- BINDINGS
- BINDINGS
userName string 创建与队列管理器的连接时要使用的缺省用户名。(建议使用容器管理的认证别名而不是配置此属性) wildcardFormat - CHAR
- TOPIC
TOPIC 要使用的通配符语法版本。 - CHAR
- CHAR
- TOPIC
- TOPIC