JMS 队列连接工厂 (jmsQueueConnectionFactory)
定义 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 连接至完整概要文件服务器中的服务集成总线时,该总线的名称。 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。请参阅信息中心,以了解更多信息。 targetTransportChain string 传输链指定通信协议,这些通信协议可用来与完整概要文件服务器中的服务集成总线通信。 temporaryQueueNamePrefix string temp 该前缀最多为十二个字符,用于表示使用此队列连接工厂的应用程序创建的临时队列。 userName string 建议使用容器管理认证别名而非配置此属性。
- properties.wmqJms
描述: WebSphere MQ JMS 队列连接工厂必需: false数据类型: 属性名称 数据类型 缺省值 描述 CCSID int 最小值:1
819 连接的编码字符集标识。 applicationName string 向队列管理器注册应用程序时使用的名称。 arbitraryProperties string 能够指定其他位置未定义的属性 ccdtURL string 一个 URL,用于标识包含客户机通道定义表 (CCDT) 的文件的名称和位置并指定该文件的访问方式。 channel string 要使用的 MQI 通道的名称。 clientId string 连接的客户机标识。 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
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
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 连接共享其套接字 sslCertStores string 用于保存要在 SSL 连接上使用的证书撤销列表 (CRL) 的轻量级目录访问协议 (LDAP) 服务器。 sslCipherSuite string 要用于 SSL 连接的密码套件。 sslFipsRequired 布尔型 SSL 连接是否必须使用 IBM Java JSSE FIPS 提供程序 (IBMJSSEFIPS) 支持的密码套件。 sslPeerName string 对于 SSL 连接,这是用于在队列管理器提供的数字证书中检查专有名称的模板。 sslResetCount int 最小值:0
最大值:999999999
重新协商 SSL 使用的密钥之前,SSL 连接发送和接收的总字节数。 targetClientMatching 布尔型 true 发送至入局消息的 JMSReplyTo 头字段所标识的队列的回复消息是否具有 MQRFH2 头(仅当入局消息具有 MQRFH2 头时)。 tempQPrefix string 用于构成 WebSphere MQ 动态队列的名称的前缀。 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 创建与队列管理器的连接时要使用的缺省用户名。(建议使用容器管理的认证别名而不是配置此属性)