jmsTopicConnectionFactory - JMS 主题连接工厂 (jmsTopicConnectionFactory)

定义 JMS 主题连接工厂配置。

NameTypeDefaultDescription
id字符串唯一配置标识。
connectionManagerRef对顶级 connectionManager 元素的引用(字符串)。连接工厂的连接管理器。
containerAuthDataRef对顶级 authData 元素的引用(字符串)。容器管理认证的缺省认证数据,当绑定没有为 res-auth=CONTAINER 的资源引用指定认证别名时适用。
jndiNamestring资源的 JNDI 名称。
recoveryAuthDataRef对顶级 authData 元素的引用(字符串)。用于事务恢复的认证数据。

connectionManager

连接工厂的连接管理器。

NameTypeDefaultDescription
agedTimeout具有秒精度的时间段-1池维护可以废弃某个连接之前的时间量。值为 -1 时会禁用此超时。值 0 指示废弃每个连接,这会禁用连接池。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
connectionTimeout具有秒精度的时间段30s连接请求超时之前的时间量。值为 -1 时会禁用此超时。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
maxIdleTime具有秒精度的时间段30m池维护期间可废弃某个未使用或空闲的连接之前的时间量(如果这样做不会使池大小减小到小于最小大小)。值为 -1 时会禁用此超时。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
maxPoolSizeint
Min: 0
50池的物理连接的最大数目。值为 0 意味着不受限制。
minPoolSizeint
Min: 0
池中要维持的最小物理连接数。池未进行预填充。时效超时可以覆盖此最小值。
purgePolicy
  • FailingConnectionOnly
  • ValidateAllConnections
  • EntirePool
EntirePool指定在池中检测到失效连接时要销毁哪些旧连接。
FailingConnectionOnly
当检测到失效连接时,会仅关闭发现存在错误的连接。
ValidateAllConnections
当检测到失效连接时,会测试连接并关闭发现存在错误的连接。
EntirePool
当检测到失效连接时,会将池中的所有连接都标记为失效,当不再使用这些连接时,会将其关闭。
reapTime具有秒精度的时间段3m池维护线程各次运行之间的时间量。值为 -1 会禁用池维护。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
maxConnectionsPerThreadint
Min: 0
限制每个线程上打开的连接数。
numConnectionsPerThreadLocalint
Min: 0
为每个线程高速缓存指定数目的连接。
enableSharingForDirectLookups布尔型true如果设置为 true,那么将共享连接。如果设置为 false,那么不会共享连接。

containerAuthData

容器管理认证的缺省认证数据,当绑定没有为 res-auth=CONTAINER 的资源引用指定认证别名时适用。

NameTypeDefaultDescription
userstring连接至 EIS 时所使用的用户名
password可逆向编码的密码(字符串)连接至 EIS 时所使用的用户密码可采用明文或编码格式存储该值。建议您对该密码进行编码。为此,请将 securityUtility 工具与编码选项配合使用。

recoveryAuthData

用于事务恢复的认证数据。

NameTypeDefaultDescription
userstring连接至 EIS 时所使用的用户名
password可逆向编码的密码(字符串)连接至 EIS 时所使用的用户密码可采用明文或编码格式存储该值。建议您对该密码进行编码。为此,请将 securityUtility 工具与编码选项配合使用。

properties.wasJms

JMS 主题连接工厂用于为发布/预订消息传递创建与 JMS 目标的关联 JMS 提供程序的连接。

NameTypeDefaultDescription
busNamestringdefaultBus连接至完整概要文件服务器中的服务集成总线时,该总线的名称。
clientIDstringclientID所有连接上持久(及共享非持久)主题预订所需的 JMS 客户机标识。如果应用程序要执行持久(及共享非持久)发布/预订消息传递,那么需要此标识。
durableSubscriptionHomestringdefaultME持久预订本地名称定义 ME 名称,需要与该 ME 名称建立连接。
nonPersistentMapping
  • ReliableNonPersistent
  • ExpressNonPersistent
  • BestEffortNonPersistent
ExpressNonPersistent适用于使用此连接工厂发送的非持久 JMS 消息的可靠性。
ReliableNonPersistent
ReliableNonPersistent
ExpressNonPersistent
ExpressNonPersistent
BestEffortNonPersistent
BestEffortNonPersistent
persistentMapping
  • ReliablePersistent
  • AssuredPersistent
ReliablePersistent适用于使用此连接工厂发送的持久 JMS 消息的可靠性。
ReliablePersistent
ReliablePersistent
AssuredPersistent
AssuredPersistent
readAhead
  • AlwaysOn
  • AlwaysOff
  • Default
Default预先读取是优先将消息指定给使用者的优化。它会更快地处理客户请求。
AlwaysOn
AlwaysOn
AlwaysOff
AlwaysOff
Default
Default
temporaryTopicNamePrefixstringtemp该前缀最多为十二个字符,用于表示使用此主题连接工厂的应用程序创建的临时主题。
password可逆向编码的密码(字符串)建议使用容器管理认证别名而非配置此属性。
remoteServerAddressstring此远程服务器地址包含以逗号分隔的三元组,语法为 hostName:portNumber:chainName,用于连接至引导服务器。例如,Merlin:7276:BootstrapBasicMessaging。如果未指定 hostName,那么缺省值为 localhost。如果未指定 portNumber,那么缺省值为 7276。如果未指定 chainName,那么缺省值为 BootstrapBasicMessaging。请参阅信息中心,以了解更多信息。
shareDurableSubscriptionstring控制持久预订是否可在连接之间共享。
targetTransportChainstring传输链指定通信协议,这些通信协议可用来与完整概要文件服务器中的服务集成总线通信。
userNamestring建议使用容器管理认证别名而非配置此属性。

properties.wmqJms

WebSphere MQ JMS 主题连接工厂

NameTypeDefaultDescription
portint
Min: 1
1414队列管理器侦听的端口。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。
providerVersion
  • unspecified
  • 6
  • 7
unspecified应用程序计划连接至的队列管理器的版本、发行版、修改级别和修订包。
unspecified
unspecified
6
6
7
7
shareConvAllowed布尔型true通道定义匹配时,客户机连接能否与从同一进程指向同一队列管理器的其他顶级 JMS 连接共享其套接字
targetClientMatching布尔型true发送至入局消息的 JMSReplyTo 头字段所标识的队列的回复消息是否具有 MQRFH2 头(仅当入局消息具有 MQRFH2 头时)。
transportType
  • BINDINGS
  • CLIENT
CLIENT与队列管理器的连接是使用客户机方式还是使用绑定方式。如果指定了值 BINDINGS_THEN_CLIENT,那么资源适配器先尝试以绑定方式进行连接。如果此连接失败,请尝试以客户机方式建立连接。
BINDINGS
BINDINGS
CLIENT
CLIENT
CCSIDint
Min: 1
819连接的编码字符集标识。
failIfQuiesce布尔型true队列管理器处于停顿状态时,对某些方法的调用是否失败
headerCompression
  • SYSTEM
  • NONE
NONE可用于压缩连接上的头数据的方法列表
SYSTEM
SYSTEM
NONE
NONE
messageCompression
  • RLE
  • NONE
NONE可用于压缩连接上的消息数据的方法列表。
RLE
RLE
NONE
NONE
rescanInterval具有毫秒精度的时间段5s当点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,WebSphere MQ JMS 类将按 WebSphere MQ 队列的 MsgDeliverySequence 属性所确定的顺序在该队列中搜索合适的消息. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
sslResetCountint
Min: 0

Max: 999999999
0重新协商 SSL 使用的密钥之前,SSL 连接发送和接收的总字节数。
cleanupLevel
  • NONDUR
  • FORCE
  • SAFE
  • NONE
  • STRONG
SAFE基于代理程序的预订存储器的清除级别。
NONDUR
NONDUR
FORCE
FORCE
SAFE
SAFE
NONE
NONE
STRONG
STRONG
cloneSupport
  • DISABLED
  • ENABLED
DISABLED是否允许同时运行同一个持久主题订户的两个或更多个实例。
DISABLED
DISABLED
ENABLED
ENABLED
messageSelection
  • BROKER
  • CLIENT
CLIENT确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。
BROKER
BROKER
CLIENT
CLIENT
pubAckIntervalint
Min: 0
25WebSphere MQ JMS 类请求代理程序的应答之前,发布程序发布的消息数
sparseSubscriptions布尔型false控制 TopicSubscriber 对象的消息检索策略。
statusRefreshInterval具有毫秒精度的时间段1m刷新长期运行的事务的时间间隔(以毫秒计),该事务检测订户何时失去与队列管理器的连接。仅当 SUBSTORE 值为 QUEUE 时,此属性才有意义。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
subscriptionStore
  • BROKER
  • MIGRATE
  • QUEUE
BROKER确定 WebSphere MQ JMS 类是否存储有关活动预订的持久数据。
BROKER
BROKER
MIGRATE
MIGRATE
QUEUE
QUEUE
wildcardFormat
  • CHAR
  • TOPIC
TOPIC要使用的通配符语法版本。
CHAR
CHAR
TOPIC
TOPIC
applicationNamestring向队列管理器注册应用程序时使用的名称。
ccdtURLstring一个 URL,用于标识包含客户机通道定义表 (CCDT) 的文件的名称和位置并指定该文件的访问方式。
channelstring要使用的 MQI 通道的名称。
clientIdstring连接的客户机标识
connectionNameListstring用于通信的 TCP/IP 连接名称(主机名(端口))的列表。ConnectionNameList 将取代主机名和端口属性。
hostNamestring队列管理器所在的系统的主机名或 IP 地址。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。
password可逆向编码的密码(字符串)创建与队列管理器的连接时要使用的缺省密码。(建议使用容器管理的认证别名而不是配置此属性)
queueManagerstring要连接至的队列管理器的名称
tempTopicPrefixstring创建临时主题时,JMS 生成 TEMP/TEMPTOPICPREFIX/unique_id 形式的主题字符串,如果此属性保留缺省值,那么生成的主题字符串仅为 TEMP/unique_id。指定非空 TEMPTOPICPREFIX 允许定义特定模型队列,以便为在此连接下创建的临时主题的订户创建受管队列。
userNamestring创建与队列管理器的连接时要使用的缺省用户名。(建议使用容器管理的认证别名而不是配置此属性)
localAddressstring对于与队列管理器的连接,此属性指定下列其中一项或全部:(1) 要使用的本地网络接口,(2) 要使用的本地端口或本地端口范围
pollingInterval具有毫秒精度的时间段如果会话中每个消息侦听器在其队列中都没有合适的消息,那么此值是每个消息侦听器再次尝试从其队列中获取消息前经过的最大时间间隔(以毫秒计)。如果经常出现没有合适消息可供会话中任何消息侦听器使用的情况,那么请考虑增大此属性的值。仅当 TRANSPORT 值为 BIND 或 CLIENT 时,此属性才有意义。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
sendCheckCountint
Min: 0
在单个非事务 JMS 会话内检查异步放置错误之间允许进行发送调用的次数。
sslCertStoresstring用于保存要在 SSL 连接上使用的证书撤销列表 (CRL) 的轻量级目录访问协议 (LDAP) 服务器。
sslCipherSuitestring要用于 SSL 连接的密码套件。
sslFipsRequired布尔型SSL 连接是否必须使用 IBM Java JSSE FIPS 提供程序 (IBMJSSEFIPS) 支持的密码套件。
sslPeerNamestring对于 SSL 连接,这是用于在队列管理器提供的数字证书中检查专有名称的模板。
brokerCCSubQueuestring连接使用者从中接收非持久预订消息的队列的名称。
brokerControlQueuestring代理程序控制队列的名称
brokerPubQueuestring在其中发送已发布消息的队列(流队列)的名称。
brokerQueueManagerstring正在运行代理程序的队列管理器的名称
brokerSubQueuestring非持久消息使用者从中接收消息的队列的名称。
brokerVersion
  • 1
  • 2
要使用的代理程序的版本
1
1
2
2
cleanupInterval具有毫秒精度的时间段发布/预订清除实用程序的后台运行之间的时间间隔(以毫秒计)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
receiveExitstring标识通道接收出口程序或要接连运行的一系列接收出口程序
receiveExitInitstring调用通道接收出口程序时传递至这些出口程序的用户数据
securityExitstring标识通道安全性出口程序
securityExitInitstring调用通道安全性出口程序时传递至该出口程序的用户数据
sendExitstring标识通道发送出口程序或要接连运行的一系列发送出口程序
sendExitInitstring调用通道发送出口程序时传递至这些出口程序的用户数据
arbitraryPropertiesstring能够指定其他位置未定义的属性