jmsActivationSpec - JMS 激活规范 (jmsActivationSpec)

定义 JMS 激活规范配置。

NameTypeDefaultDescription
id字符串唯一配置标识。
authDataRef对顶级 authData 元素的引用(字符串)。激活规范的缺省认证数据。
maxEndpointsint
Min: 0
500要分派至的最大端点数。
autoStart布尔型true配置与此激活规范相关联的消息端点是自动启动,还是需要使用恢复命令手动启动。

authData

激活规范的缺省认证数据。

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

properties.wasJms

JMS 激活规范与一个或多个消息驱动的 bean 关联,并为它们提供必需的配置以接收消息。

NameTypeDefaultDescription
acknowledgeMode
  • Auto-acknowledge
  • Dups-ok-acknowledge
Auto-acknowledge应答方式指示应如何应答消息驱动的 bean 接收到的消息。
Auto-acknowledge
Auto-acknowledge
Dups-ok-acknowledge
Dups-ok-acknowledge
busNamestringdefaultBus连接至完整概要文件服务器中的服务集成总线时,该总线的名称。
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.Queue目标的类型,即 javax.jms.Queue 或 javax.jms.Topic
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
maxConcurrencyint
Min: 1

Max: 2147483647
5最大端点数,会将消息并行传递给这些端点。增大该数字会提高性能,但是它也会增大在指定时间使用的线程数。如果必须为所有失败的传递维持消息顺序,请将“最大并行端点数”值设置为 1。
readAhead
  • AlwaysOn
  • AlwaysOff
  • Default
Default预先读取是优先将消息指定给使用者的优化。它会更快地处理客户请求。
AlwaysOn
AlwaysOn
AlwaysOff
AlwaysOff
Default
Default
retryInterval具有秒精度的时间段30s两次尝试连接至消息传递引擎(无论是初始连接,还是后来尝试建立更好的连接)之间的延迟(以秒计)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
subscriptionDurability
  • NonDurableShared
  • Durable
  • DurableShared
  • NonDurable
NonDurableMS 主题预订的类型。此值可为下列任一值:Durable DurableShared NonDurable NonDurableShared
NonDurableShared
NonDurableShared
Durable
Durable
DurableShared
DurableShared
NonDurable
NonDurable
targetTransportChain
  • InboundBasicMessaging
  • InboundSecureMessaging
InboundBasicMessaging传输链指定通信协议,这些通信协议可用来与完整概要文件服务器中的服务集成总线通信。
InboundBasicMessaging
InboundBasicMessaging
InboundSecureMessaging
InboundSecureMessaging
clientIdstring所有连接上持久(及共享非持久)主题预订所需的 JMS 客户机标识。如果应用程序要执行持久(及共享非持久)发布/预订消息传递,那么需要此标识。
connectionFactoryLookupstring可使用此属性指定通过管理方式定义的javax.jms.ConnectionFactory、javax.jms.QueueConnectionFactory 或 javax.jms.TopicConnectionFactory 对象的查询名称,这些对象用于连接到端点(消息驱动的 Bean)可从其接收消息的 JMS 提供程序。
destinationstring对 JMS 目标的引用
destinationLookupstring可使用此属性指定以管理方式定义的 javax.jms.Queue 或 javax.jms.Topic 对象的查询名称,这些对象用于定义端点(消息驱动的 Bean)可从其接收消息的 JMX 队列或主题。
destinationRef对顶级 adminObject 元素的引用(字符串)。对 JMS 目标的引用
maxBatchSizeint
Min: 1

Max: 2147483647
在单个批次中从消息传递引擎接收的最多消息条数。
messageSelectorstring使用 JMS 消息选择器来确定消息驱动的 bean 接收的消息。该值是用于选择可用消息子集的字符串。
remoteServerAddressstring此远程服务器地址包含以逗号分隔的三元组,语法为 hostName:portNumber:chainName,用于连接至引导服务器。例如,Merlin:7276:BootstrapBasicMessaging。如果未指定 hostName,那么缺省值为 localhost。如果未指定 portNumber,那么缺省值为 7276。如果未指定 chainName,那么缺省值为 BootstrapBasicMessaging。请参阅信息中心,以了解更多信息。
shareDurableSubscriptionstring控制持久预订是否可在连接之间共享。
subscriptionNamestring持久(及共享非持久)所需的预订名。使用持久(及共享非持久)主题预订时的必需字段。此预订名在给定客户机标识内必须唯一。

properties.wmqJms

WebSphere MQ JMS 激活规范

NameTypeDefaultDescription
destinationRef对顶级 adminObject 元素的引用(字符串)。目标
CCSIDint
Min: 1
819连接的编码字符集标识。
channelstringSYSTEM.DEF.SVRCONN要使用的 MQI 通道的名称。
cloneSupport
  • DISABLED
  • ENABLED
DISABLED是否允许同时运行同一个持久主题订户的两个或更多个实例
DISABLED
DISABLED
ENABLED
ENABLED
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.Queue目标类型 - javax.jms.Queue 或 javax.jms.Topic
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
headerCompression
  • SYSTEM
  • NONE
NONE可用于压缩连接上的头数据的方法列表
SYSTEM
SYSTEM
NONE
NONE
hostNamestringlocalhost队列管理器所在的系统的主机名或 IP 地址。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。
messageCompression
  • RLE
  • NONE
NONE可用于压缩连接上的消息数据的方法列表
RLE
RLE
NONE
NONE
pollingInterval具有毫秒精度的时间段5s如果会话中每个消息侦听器在其队列中都没有合适的消息,那么此值是每个消息侦听器再次尝试从其队列中获取消息前经过的最大时间间隔(以毫秒计)。如果经常出现没有合适消息可供会话中任何消息侦听器使用的情况,那么请考虑增大此属性的值。仅当 TRANSPORT 值为 BIND 或 CLIENT 时,此属性才有意义。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
poolTimeout具有毫秒精度的时间段5m未使用的服务器会话在由于不活动而被关闭前,在服务器会话池中保持打开状态的时间(以毫秒计). 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
portint
Min: 1
1414队列管理器侦听的端口。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。
providerVersion
  • unspecified
  • 6
  • 7
unspecified应用程序计划连接至的队列管理器的版本、发行版、修改级别和修订包。
unspecified
unspecified
6
6
7
7
rescanInterval具有毫秒精度的时间段5s当点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,WebSphere MQ JMS 类将按 WebSphere MQ 队列的 MsgDeliverySequence 属性所确定的顺序在该队列中搜索合适的消息。WebSphere MQ JMS 类找到合适的消息并将其传递给使用者后,WebSphere MQ JMS 类将从队列中其当前位置继续搜索下一条合适的消息。WebSphere MQ JMS 类将以此方式继续搜索队列,直到它到达队列末尾或者达到此属性值所确定的时间间隔(以毫秒计)为止。在这两种情况下,WebSphere MQ JMS 类将返回到队列开头并继续进行搜索,并且新的时间间隔开始。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
shareConvAllowed布尔型true通道定义匹配时,客户机连接能否与从同一进程指向同一队列管理器的其他顶级 JMS 连接共享其套接字
startTimeout具有毫秒精度的时间段10s配置一个持续时间(以毫秒计),执行必须在此持续时间内开始. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
transportType
  • BINDINGS
  • CLIENT
CLIENT与队列管理器的连接是使用客户机方式还是使用绑定方式。
BINDINGS
BINDINGS
CLIENT
CLIENT
failIfQuiesce布尔型true队列管理器处于停顿状态时,对某些方法的调用是否失败
maxMessagesint
Min: 0
1一次可分配给服务器会话的最大消息数。如果激活规范正在 XA 事务中向 MDB 传送消息,那么会使用值 1 而不理会此属性的设置。
maxPoolDepthint
Min: 0
10激活规范上的 maxPoolDepth 属性定义可用 MDB(消息驱动的 Bean)实例的数目。减小此属性的值会减少当前可交付的消息数。
messageSelection
  • BROKER
  • CLIENT
CLIENT确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。
BROKER
BROKER
CLIENT
CLIENT
receiveCCSIDint
Min: 0
0用于对队列管理器消息转换设置目标编码字符集标识的目标属性。除非 RECEIVECONVERSION 设置为 WMQ_RECEIVE_CONVERSION_QMG,否则会忽略此值
receiveConversion
  • QMGR
  • CLIENT_MSG
CLIENT_MSG用于确定队列管理器是否将执行数据转换的目标属性。
QMGR
QMGR
CLIENT_MSG
CLIENT_MSG
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
sparseSubscriptions布尔型false控制 TopicSubscriber 对象的消息检索策略
statusRefreshInterval具有毫秒精度的时间段1m刷新长期运行的事务的时间间隔(以毫秒计),该事务检测订户何时失去与队列管理器的连接。仅当 subscriptionStore 值为 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) 的文件的名称和位置并指定该文件的访问方式。
clientIdstring连接的客户机标识
connectionNameListstring用于通信的 TCP/IP 连接名称(主机名(端口))的列表。ConnectionNameList 将取代主机名和端口属性。
localAddressstring对于与队列管理器的连接,此属性指定下列其中一项或全部:(1) 要使用的本地网络接口,(2) 要使用的本地端口或本地端口范围
messageBatchSizeint
Min: 0
要在一个批次中处理的最大消息数
queueManagerstring要连接至的队列管理器的名称
subscriptionDurability
  • Durable
  • NonDurable
是使用持久预订还是非持久预订来将消息传递至预订该主题的 MDB
Durable
Durable
NonDurable
NonDurable
subscriptionNamestring持久预订的名称
messageRetention布尔型连接使用者是否保留输入队列中不想要的消息。
messageSelectorstring确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。如果 brokerVersion 值为 1,那么不支持使用代理程序来选择消息
sslCertStoresstring用于保存要在 SSL 连接上使用的证书撤销列表 (CRL) 的轻量级目录访问协议 (LDAP) 服务器
sslCipherSuitestring要用于 SSL 连接的密码套件
sslFipsRequired布尔型SSL 连接是否必须使用 IBM Java JSSE FIPS 提供程序 (IBMJSSEFIPS) 支持的密码套件。
sslPeerNamestring对于 SSL 连接,这是用于在队列管理器提供的数字证书中检查专有名称的模板
brokerCCDurSubQueuestring一个队列的名称,将从此队列中检索连接使用者的非持久预订消息
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调用通道发送出口程序时传递至这些出口程序的用户数据。