JMS 激活规范 (jmsActivationSpec)
定义 JMS 激活规范配置。
| 属性名称 | 数据类型 | 缺省值 | 描述 |
|---|---|---|---|
| authDataRef | 对顶级 authData 元素的引用(字符串)。 | 激活规范的缺省认证数据。 | |
| id | string | 唯一配置标识。 | |
| maxEndpoints | 整型 最小值:0 |
500 | 要分派至的最大端点数。 |
- authData
描述: 激活规范的缺省认证数据。必需: False数据类型: 属性名称 数据类型 缺省值 描述 password 可逆向编码的密码(字符串) 连接至 EIS 时要使用的用户密码。可以采用明文或编码格式存储该值。建议您对该密码进行编码。要对该密码进行编码,请将 securityUtility 工具与编码选项配合使用。 user string 连接至 EIS 时要使用的用户名称。
- properties.wasJms
描述: JMS 激活规范与一个或多个消息驱动的 bean 相关联,并为它们提供接收消息所必需的配置。必需: False数据类型: 属性名称 数据类型 缺省值 描述 acknowledgeMode - Dups-ok-acknowledge
- Auto-acknowledge
Auto-acknowledge 确认方式表明应该如何确认消息驱动的 bean 接收的消息。 - Dups-ok-acknowledge
- Dups-ok-acknowledge
- Auto-acknowledge
- Auto-acknowledge
busName string defaultBus 连接至完整概要文件服务器中的服务集成总线时使用的总线名称。 clientId string 所有连接上持久(及共享非持久)主题预订所需的 JMS 客户机标识。如果应用程序要执行持久(及共享非持久)发布/预订消息传递,那么需要此标识。 connectionFactoryLookup string 此属性可用于指定通过管理方式定义的 javax.jms.ConnectionFactory、javax.jms.QueueConnectionFactory 或 javax.jms.TopicConnectionFactory 对象的查找名称,这些对象用于连接到 JMS 提供者,而端点(消息驱动的 bean)可从该提供者接收消息。 目标 string 对 JMS 目标的引用 destinationLookup string 此属性可用于指定以管理方式定义的 javax.jms.Queue 或 javax.jms.Topic 对象的查找名称,这些对象定义 JMS 队列或主题,端点(消息驱动的 bean)可从该队列或主题接收消息。 destinationRef 对顶级 adminObject 元素的引用(字符串)。 对 JMS 目标的引用 destinationType - javax.jms.Topic
- javax.jms.Queue
javax.jms.Queue 目标的类型:javax.jms.Queue 或 javax.jms.Topic。 - javax.jms.Topic
- javax.jms.Topic
- javax.jms.Queue
- javax.jms.Queue
maxBatchSize 整型 最小值:1
最大值:2147483647
在一个消息批次中能够从消息传递引擎接收的最大消息数。 maxConcurrency 整型 最小值:1
最大值:2147483647
5 最大端点数,会将消息并行传递给这些端点。增大该数字会提高性能,但是它也会增大在指定时间使用的线程数。如果必须为所有失败的传递维持消息顺序,请将“最大并行端点数”值设置为 1。 messageSelector string 用于确定消息驱动的 bean 所接收消息的 JMS 消息选择器。值是用于选择一小部分可用消息的字符串。 readAhead - AlwaysOff
- Default
- AlwaysOn
Default 预读是一种优化措施,即抢先将消息指定给使用者。这会更快地处理使用者请求。 - AlwaysOff
- AlwaysOff
- Default
- Default
- AlwaysOn
- AlwaysOn
remoteServerAddress string 具有用来连接至引导服务器的三元组(用逗号分隔,语法为 hostName:portNumber:chainName)的远程服务器地址。例如,Merlin:7276:BootstrapBasicMessaging。如果未指定主机名,那么缺省值为 localhost。如果未指定端口号,那么缺省值为 7276。如果未指定链名,那么缺省值为 BootstrapBasicMessaging。有关更多信息,请参阅信息中心。 retryInterval 精度为秒的时间段 30s 尝试连接至消息传递引擎操作之间的延迟(以秒计),适合初始连接以及建立更好连接的任何后续尝试。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 shareDurableSubscription string 控制持久预订是否可在连接之间共享。 subscriptionDurability - DurableShared
- 持久
- NonDurable
- NonDurableShared
NonDurable MS 主题预订的类型。此值可为下列任一值:Durable DurableShared NonDurable NonDurableShared - DurableShared
- DurableShared
- 持久
- 持久
- NonDurable
- NonDurable
- NonDurableShared
- NonDurableShared
subscriptionName string 持久(及共享非持久)所需的预订名。使用持久(及共享非持久)主题预订时的必需字段。此预订名在给定客户机标识内必须唯一。 targetTransportChain - InboundSecureMessaging
- InboundBasicMessaging
InboundBasicMessaging 传输链指定通信协议,这些通信协议可用来与完整概要文件服务器中的服务集成总线通信。 - InboundSecureMessaging
- InboundSecureMessaging
- InboundBasicMessaging
- InboundBasicMessaging
- properties.wmqJms
描述: WebSphere MQ JMS 激活规范必需: False数据类型: 属性名称 数据类型 缺省值 描述 CCSID 整型 最小值:1
819 连接的编码字符集标识。 applicationName string 应用程序用于向队列管理器注册的名称。 brokerCCDurSubQueue string 为 ConnectionConsumer 检索非持续预订消息所使用的队列名称 brokerCCSubQueue string 连接使用者从中接收非持续预订消息的队列的名称 brokerControlQueue string 代理程序控制队列的名称 brokerPubQueue string 已发布消息发送到其中的队列(流队列)的名称 brokerQueueManager string 队列管理器的名称,代理程序正在此队列管理器上运行 brokerSubQueue string 非持续消息使用者从中接收消息的队列的名称 brokerVersion - 2
- 1
要使用的代理程序的版本 - 2
- 2
- 1
- 1
ccdtURL string 一个 URL,它标识客户机通道定义表 (CCDT) 所属文件的名称和位置,并指定可以如何访问此文件。 channel string SYSTEM.DEF.SVRCONN 要使用的 MQI 通道的名称。 cleanupInterval 具有毫秒精度的时间段 在后台两次运行发布/预订清除实用程序之间的时间间隔(毫秒)。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 cleanupLevel - SAFE
- FORCE
- NONDUR
- 无
- STRONG
SAFE 基于代理程序的预订存储的清除级别。 - SAFE
- SAFE
- FORCE
- FORCE
- NONDUR
- NONDUR
- 无
- 无
- STRONG
- STRONG
clientId string 连接的客户机标识 cloneSupport - ENABLED
- 已禁用
已禁用 同一持久主题订户的两个或更多实例是否可以同时运行 - ENABLED
- ENABLED
- 已禁用
- 已禁用
connectionNameList string 用于通信的 TCP/IP 连接名称(主机名(端口))的列表。ConnectionNameList 将取代主机名和端口属性。 destinationRef 对顶级 adminObject 元素的引用(字符串)。 目标 destinationType - javax.jms.Topic
- javax.jms.Queue
javax.jms.Queue 目标的类型 - javax.jms.Queue 或 javax.jms.Topic - javax.jms.Topic
- javax.jms.Topic
- javax.jms.Queue
- javax.jms.Queue
failIfQuiesce 布尔型 true 如果队列管理器处于停顿状态,那么指示对某些方法的调用是否会失败。 headerCompression - SYSTEM
- 无
无 可用于在连接时压缩头数据的方法列表 - SYSTEM
- SYSTEM
- 无
- 无
hostName string localhost 队列管理器所在系统的主机名或 IP 地址。指定了 ConnectionNameList 属性时,主机名和端口属性将被 ConnectionNameList 属性取代。 localAddress string 要连接至队列管理器,此属性指定下列一项或两项:(1) 要使用的本地网络接口;(2) 要使用的本地端口或者某个范围的本地端口 maxMessages 整型 最小值:0
1 一次可分配给服务器会话的最大消息数。如果激活规范正在 XA 事务中向 MDB 传送消息,那么会使用值 1 而不理会此属性的设置。 maxPoolDepth 整型 最小值:0
10 激活规范上的 maxPoolDepth 属性定义可用 MDB(消息驱动的 Bean)实例的数目。减小此属性的值会减少当前可交付的消息数。 messageBatchSize 整型 最小值:0
要在一个批处理中处理的最大消息数。 messageCompression - RLE
- 无
无 可用于压缩连接上的消息数据的方法列表 - RLE
- RLE
- 无
- 无
messageRetention 布尔型 连接使用者是否保留输入队列中不想要的消息 messageSelection - CLIENT
- BROKER
CLIENT 确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。 - CLIENT
- CLIENT
- BROKER
- BROKER
messageSelector string 确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。如果 brokerVersion 值为 1,那么不支持使用代理程序来选择消息 pollingInterval 具有毫秒精度的时间段 5s 此值是以毫秒计的最大时间间隔,如果会话中的每个消息侦听器在其队列中都没有合适的消息,那么在此时间过后,每个消息侦听器都将再次尝试从其队列中获取消息。如果在一个会话中频繁地发生任何消息侦听器都没有适当的消息可用,那么应考虑增大此属性的值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 poolTimeout 具有毫秒精度的时间段 5m 未使用的服务器会话在由于不活动而被关闭前,在服务器会话池中保持打开状态的时间(毫秒)。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 port 整型 最小值:1
1414 队列管理器侦听的端口。指定了 ConnectionNameList 属性时,主机名和端口属性将被 ConnectionNameList 属性取代。 providerVersion - 7
- 6
- unspecified
unspecified 应用程序打算连接的队列管理器的版本、发行版、修改级别和修订包。 - 7
- 7
- 6
- 6
- unspecified
- unspecified
queueManager string 要连接至的队列管理器的名称 receiveCCSID 整型 最小值:0
0 用于对队列管理器消息转换设置目标编码字符集标识的目标属性。除非接收转换设置为 WMQ_RECEIVE_CONVERSION_QMG,否则会忽略此值 receiveConversion - QMGR
- CLIENT_MSG
CLIENT_MSG 用于确定是否将由队列管理器执行数据转换的目标属性。 - QMGR
- QMGR
- CLIENT_MSG
- CLIENT_MSG
receiveExit string 标识一个通道接收出口程序或一系列要连续运行的接收出口程序 receiveExitInit string 调用通道接收出口程序时,传递到这些程序的用户数据 rescanInterval 具有毫秒精度的时间段 5s 当点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,WebSphere MQ JMS 类将按 WebSphere MQ 队列的 MsgDeliverySequence 属性所确定的顺序在该队列中搜索合适的消息。WebSphere MQ JMS 类找到合适的消息并将其传递给使用者后,WebSphere MQ JMS 类将从队列中其当前位置继续搜索下一条合适的消息。WebSphere MQ JMS 类将以此方式继续搜索队列,直到它到达队列末尾或者达到此属性值所确定的时间间隔(毫秒)为止。在这两种情况下,WebSphere MQ JMS 类将返回到队列开头并继续进行搜索,并且新的时间间隔开始。 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 securityExit string 标识通道安全性出口程序 securityExitInit string 调用通道安全性出口程序时,传递到该程序的用户数据 sendExit string 标识一个通道发送出口程序,或者要连续运行的一系列发送出口程序 sendExitInit string 调用通道发送出口程序时,传递至这些程序的用户数据 shareConvAllowed 布尔型 true 如果通道定义匹配,客户机连接是否可以与从同一个流程至同一个队列管理器的其他顶级 JMS 连接共享其套接字 sparseSubscriptions 布尔型 False 控制 TopicSubscriber 对象的消息检索策略 sslCertStores string 拥有要在 SSL 连接时使用的证书撤销列表 (CRL) 的轻量级目录访问协议 (LDAP) 服务器 sslCipherSuite string 要用于 SSL 连接的密码套件 sslFipsRequired 布尔型 SSL 连接是否必须使用 IBM Java JSSE FIPS 提供者 (IBMJSSEFIPS) 支持的密码套件。 sslPeerName string 对于 SSL 连接,这是用来检查由队列管理器提供的数字证书中的专有名称的模板 sslResetCount 整型 最小值:0
最大值:999999999
0 在重新协商 SSL 所使用的密钥之前,SSL 连接所发送和接收的字节总数 startTimeout 具有毫秒精度的时间段 10s 配置一个持续时间(毫秒),执行必须在此持续时间内开始。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 statusRefreshInterval 具有毫秒精度的时间段 1m 这是以毫秒计的时间间隔,用于检测订户与队列管理器之间的连接是否中断的长时间运行事务将按此时间间隔执行刷新。仅当预订存储器的值为 QUEUE 时,此属性才起作用。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 subscriptionDurability - 持久
- NonDurable
是使用持久预订还是非持久预订来将消息传递至预订该主题的 MDB - 持久
- 持久
- NonDurable
- NonDurable
subscriptionName string 持久预订的名称 subscriptionStore - MIGRATE
- BROKER
- 队列
BROKER 确定 WebSphere MQ JMS 类用于存储有关活动预订的持久数据的位置。 - MIGRATE
- MIGRATE
- BROKER
- BROKER
- 队列
- 队列
transportType - CLIENT
- BINDINGS
CLIENT 与队列管理器的连接是使用客户机方式还是使用绑定方式。 - CLIENT
- CLIENT
- BINDINGS
- BINDINGS
wildcardFormat - CHAR
- 主题
主题 要使用哪个版本的通配符语法。 - CHAR
- CHAR
- 主题
- 主题
参考主题