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