定义 JMS 队列连接工厂配置。

Name Type Default Description

connectionManagerRef

对顶级 connectionManager 元素的引用（字符串）。

连接工厂的连接管理器。

containerAuthDataRef

对顶级 authData 元素的引用（字符串）。

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

id

字符串

唯一配置标识。

jaasLoginContextEntryRef

对顶级 jaasLoginContextEntry 元素的引用（字符串）。

用于认证的 JAAS 登录上下文入口。如果服务器正在运行时更新，那么会针对新连接请求应用更新；正使用的连接不会受影响。

jndiName

string

资源的 JNDI 名称。

recoveryAuthDataRef

对顶级 authData 元素的引用（字符串）。

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

connectionManager

连接工厂的连接管理器。

Name Type Default Description

agedTimeout

具有秒精度的时间段

-1

池维护可以废弃某个连接之前的时间量。值为 -1 时会禁用此超时。值 0 指示废弃每个连接，这会禁用连接池。. 指定后跟时间单位的正整数，时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如，以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如，1m30s 相当于 90 秒。

connectionTimeout

具有秒精度的时间段

30s

连接请求超时之前的时间量。如果值为 -1，那么将禁用此超时，这意味着将无限期等待。如果值为 0，那么表示立即连接，这意味着不等待。. 指定后跟时间单位的正整数，时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如，以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如，1m30s 相当于 90 秒。

maxIdleTime

具有秒精度的时间段

30m

池维护期间可废弃某个未使用或空闲的连接之前的时间量（如果这样做不会使池大小减小到小于最小大小）。值为 -1 时会禁用此超时。. 指定后跟时间单位的正整数，时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如，以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如，1m30s 相当于 90 秒。

maxPoolSize

int
Min: 0

50

池的物理连接的最大数目。值为 0 意味着不受限制。优化设置取决于应用程序特征。对于其中每个线程包含与数据库的连接的应用程序，您可从“coreThreads”属性的 1:1 映射开始。

minPoolSize

int
Min: 0

池中要维持的最小物理连接数。池未进行预填充。时效超时可以覆盖此最小值。

purgePolicy

  • EntirePool

  • FailingConnectionOnly

  • ValidateAllConnections

EntirePool

指定在池中检测到旧连接时要销毁哪些连接。
EntirePool
当检测到失效连接时，会将池中的所有连接都标记为失效，当不再使用这些连接时，会将其关闭。
FailingConnectionOnly
当检测到失效连接时，会仅关闭发现存在错误的连接。
ValidateAllConnections
当检测到失效连接时，会测试连接并关闭发现存在错误的连接。

reapTime

具有秒精度的时间段

3m

池维护线程各次运行之间的时间量。值为 -1 会禁用池维护。. 指定后跟时间单位的正整数，时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如，以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如，1m30s 相当于 90 秒。

高级属性

autoCloseConnections

布尔型

true

在 Servlet 请求、企业 Bean 实例、受管执行程序任务、上下文任务或者受管完成阶段结束之后，在使连接保持打开状态的应用程序之后尝试清除。当在这些应用程序工件之一中获得不可共享的连接，并在连接结束时保持打开状态时，容器将尝试关闭连接句柄。容器还可能关闭不支持 DissociatableManagedConnection 的可共享连接。应用程序始终应遵循按规范定义的编程模型，并在适当的时间关闭连接，而不是依赖于容器，即使启用了此选项也是如此。

enableContainerAuthForDirectLookups

布尔型

false

如果设置为 true，那么连接将使用容器认证。如果设置为 false，那么连接将使用应用程序认证。

enableSharingForDirectLookups

布尔型

true

如果设置为 true，那么将共享连接。如果设置为 false，那么不会共享连接。

maxConnectionsPerThread

int
Min: 0

限制每个线程上打开的连接数。

numConnectionsPerThreadLocal

int
Min: 0

为每个线程高速缓存指定数目的连接。 通过为每个线程保留指定数量的数据库连接，此设置可以提高大型多核 (8 +) 机器的性能。 为了获得最佳性能，如果有 n 个应用程序线程，请将最大池连接数设置为 numConnectionsPerThreadLocal 属性值的至少 n 倍。 对所有连接请求使用相同的凭证。 例如，如果使用 20 个应用程序线程，请将最大池连接数设置为 20 个或更多。 如果将 numConnectionPerThreadLocal 属性的值设置为 2，并且有 20 个应用程序线程，那么将最大池连接数设置为 40 或更多。 如果设置 numConnectionsPerThreadLocal 不会提高性能，因为使用 numConnectionsPerThreadLocal 不会使应用程序连接使用模式受益，请从配置中除去该属性或将值设置为 0。

containerAuthData

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

Name Type Default Description

krb5Principal

string

要使用的 Kerberos principal 名称或者 Kerberos 服务名称。

krb5TicketCache

文件路径

将存储 Kerberos 主体名称或者服务名称的 Kerberos 凭证的文件位置。也称为 Kerberos 凭证高速缓存 (ccache)

password

可逆向编码的密码（字符串）

连接至 EIS 时所使用的用户密码。可采用明文或编码格式存储该值。建议您对该密码进行编码。为此，请将 securityUtility 工具与编码选项配合使用。

user

string

连接至 EIS 时所使用的用户名。

jaasLoginContextEntry

用于认证的 JAAS 登录上下文入口。如果服务器正在运行时更新，那么会针对新连接请求应用更新；正使用的连接不会受影响。

Name Type Default Description

loginModuleRef

对顶级 jaasLoginModule 元素的引用的列表（以逗号分隔的字符串）。

hashtable,userNameAndPassword,certificate,token

对 JAAS 登录模块的标识的引用。

name

string
Required

JAAS 配置条目的名称。

properties.wasJms

JMS 队列连接工厂用于为点到点消息传递创建与 JMS 队列的相关联 JMS 提供程序的连接。

Name Type Default Description

busName

string

defaultBus

连接至传统 WebSphere Application Server 中的服务集成总线时使用的总线的名称。

nonPersistentMapping

  • BestEffortNonPersistent

  • ExpressNonPersistent

  • ReliableNonPersistent

ExpressNonPersistent

适用于使用此连接工厂发送的非持久 JMS 消息的可靠性。

password

可逆向编码的密码（字符串）

建议使用容器管理认证别名而非配置此属性。

persistentMapping

  • AssuredPersistent

  • ReliablePersistent

ReliablePersistent

适用于使用此连接工厂发送的持久 JMS 消息的可靠性。

readAhead

  • AlwaysOff

  • AlwaysOn

  • Default

Default

预先读取是优先将消息指定给使用者的优化。它会更快地处理客户请求。

remoteServerAddress

string

此远程服务器地址包含以逗号分隔的三元组，语法为 hostName:portNumber:chainName，用于连接至引导服务器。例如，Merlin:7276:BootstrapBasicMessaging。如果未指定 hostName，那么缺省值为 localhost。如果未指定 portNumber，那么缺省值为 7276。如果未指定 chainName，那么缺省值为 BootstrapBasicMessaging。请参阅信息中心，以了解更多信息。

targetTransportChain

string

传输链将指定通信协议，这些通信协议可用来与传统 WebSphere Application Server 中的服务集成总线进行通信。

temporaryQueueNamePrefix

string

temp

该前缀最多为十二个字符，用于表示使用此队列连接工厂的应用程序创建的临时队列。

userName

string

建议使用容器管理认证别名而非配置此属性。

properties.wmqJms

WebSphere MQ JMS 队列连接工厂

Name Type Default Description

CCSID

int
Min: 1

819

连接的编码字符集标识。

applicationName

string

向队列管理器注册应用程序时使用的名称。

arbitraryProperties

string

能够指定其他位置未定义的属性

ccdtURL

string

一个 URL，用于标识包含客户机通道定义表 (CCDT) 的文件的名称和位置并指定该文件的访问方式。

channel

string

要使用的 MQI 通道的名称。

clientId

string

连接的客户机标识。

connectionNameList

string

用于通信的 TCP/IP 连接名称（主机名（端口））的列表。ConnectionNameList 将取代主机名和端口属性。

failIfQuiesce

布尔型

true

队列管理器处于停顿状态时，对某些方法的调用是否失败

headerCompression

  • NONE

  • SYSTEM

NONE

可用于压缩连接上的头数据的方法列表

hostName

string

队列管理器所在的系统的主机名或 IP 地址。如果指定了 ConnectionNameList 属性，那么该属性会取代主机名和端口属性。

localAddress

string

对于与队列管理器的连接，此属性指定下列其中一项或全部：(1) 要使用的本地网络接口，(2) 要使用的本地端口或本地端口范围

messageCompression

  • NONE

  • RLE

NONE

可用于压缩连接上的消息数据的方法列表。

password

可逆向编码的密码（字符串）

创建与队列管理器的连接时要使用的缺省密码。（建议使用容器管理的认证别名而不是配置此属性）

pollingInterval

具有毫秒精度的时间段

如果会话中每个消息侦听器在其队列中都没有合适的消息，那么此值是每个消息侦听器再次尝试从其队列中获取消息前经过的最大时间间隔（以毫秒计）。如果经常出现没有合适消息可供会话中任何消息侦听器使用的情况，那么请考虑增大此属性的值。仅当 TRANSPORT 值为 BIND 或 CLIENT 时，此属性才有意义。. 指定后跟时间单位的正整数，时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如，以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如，1s500ms 相当于 1.5 秒。

port

int
Min: 1

1414

队列管理器侦听的端口。如果指定了 ConnectionNameList 属性，那么该属性会取代主机名和端口属性。

providerVersion

  • 6

  • 7

  • 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
Min: 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
Min: 0
Max: 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

  • BINDINGS

  • CLIENT

CLIENT

与队列管理器的连接是使用客户机方式还是使用绑定方式。如果指定了值 BINDINGS_THEN_CLIENT，那么资源适配器先尝试以绑定方式进行连接。如果此连接失败，请尝试以客户机方式建立连接。

userName

string

创建与队列管理器的连接时要使用的缺省用户名。（建议使用容器管理的认证别名而不是配置此属性）

recoveryAuthData

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

Name Type Default Description

krb5Principal

string

要使用的 Kerberos principal 名称或者 Kerberos 服务名称。

krb5TicketCache

文件路径

将存储 Kerberos 主体名称或者服务名称的 Kerberos 凭证的文件位置。也称为 Kerberos 凭证高速缓存 (ccache)

password

可逆向编码的密码（字符串）

连接至 EIS 时所使用的用户密码。可采用明文或编码格式存储该值。建议您对该密码进行编码。为此，请将 securityUtility 工具与编码选项配合使用。

user

string

连接至 EIS 时所使用的用户名。