JMS 激活规范 (jmsActivationSpec)
定义 JMS 激活规范配置。
属性名称 | 数据类型 | 缺省值 | 描述 |
---|---|---|---|
authDataRef | 对顶级 authData 元素的引用(字符串)。 | 激活规范的缺省认证数据。 | |
id | 字符串 | 唯一配置标识。 | |
maxEndpoints | int
最小值: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 对象的查询名称,这些对象用于连接到端点(消息驱动的 Bean)可从其接收消息的 JMS 提供程序。 destination string 对 JMS 目标的引用 destinationLookup string 可使用此属性指定以管理方式定义的 javax.jms.Queue 或 javax.jms.Topic 对象的查询名称,这些对象用于定义端点(消息驱动的 Bean)可从其接收消息的 JMX 队列或主题。 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 int 最小值:1
最大值:2147483647
在单个批次中从消息传递引擎接收的最多消息条数。 maxConcurrency int 最小值:1
最大值:2147483647
5 最大端点数,会将消息并行传递给这些端点。增大该数字会提高性能,但是它也会增大在指定时间使用的线程数。如果必须为所有失败的传递维持消息顺序,请将“最大并行端点数”值设置为 1。 messageSelector string 使用 JMS 消息选择器来确定消息驱动的 bean 接收的消息。该值是用于选择可用消息子集的字符串。 readAhead - AlwaysOff
- Default
- AlwaysOn
Default 预先读取是优先将消息指定给使用者的优化。它会更快地处理客户请求。 - AlwaysOff
- AlwaysOff
- Default
- Default
- AlwaysOn
- AlwaysOn
remoteServerAddress string 此远程服务器地址包含以逗号分隔的三元组,语法为 hostName:portNumber:chainName,用于连接至引导服务器。例如,Merlin:7276:BootstrapBasicMessaging。如果未指定 hostName,那么缺省值为 localhost。如果未指定 portNumber,那么缺省值为 7276。如果未指定 chainName,那么缺省值为 BootstrapBasicMessaging。请参阅信息中心,以了解更多信息。 retryInterval 具有秒精度的时间段 30s 两次尝试连接至消息传递引擎(无论是初始连接,还是后来尝试建立更好的连接)之间的延迟(以秒计)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 shareDurableSubscription string 控制持久预订是否可在连接之间共享。 subscriptionDurability - DurableShared
- Durable
- NonDurable
- NonDurableShared
NonDurable MS 主题预订的类型。此值可为下列任一值:Durable DurableShared NonDurable NonDurableShared - DurableShared
- DurableShared
- Durable
- Durable
- NonDurable
- NonDurable
- NonDurableShared
- NonDurableShared
subscriptionName string 持久(及共享非持久)所需的预订名。使用持久(及共享非持久)主题预订时的必需字段。此预订名在给定客户机标识内必须唯一。 targetTransportChain - InboundSecureMessaging
- InboundBasicMessaging
InboundBasicMessaging 传输链指定通信协议,这些通信协议可用来与完整概要文件服务器中的服务集成总线通信。 - InboundSecureMessaging
- InboundSecureMessaging
- InboundBasicMessaging
- InboundBasicMessaging
- properties.wmqJms
描述: WebSphere MQ JMS 激活规范必需: false数据类型: 属性名称 数据类型 缺省值 描述 CCSID int 最小值:1
819 连接的编码字符集标识。 applicationName string 向队列管理器注册应用程序时使用的名称。 brokerCCDurSubQueue string 一个队列的名称,将从此队列中检索连接使用者的非持久预订消息 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)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 cleanupLevel - SAFE
- FORCE
- NONDUR
- NONE
- STRONG
SAFE 基于代理程序的预订存储器的清除级别。 - SAFE
- SAFE
- FORCE
- FORCE
- NONDUR
- NONDUR
- NONE
- NONE
- STRONG
- STRONG
clientId string 连接的客户机标识 cloneSupport - ENABLED
- DISABLED
DISABLED 是否允许同时运行同一个持久主题订户的两个或更多个实例 - ENABLED
- ENABLED
- DISABLED
- DISABLED
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
- NONE
NONE 可用于压缩连接上的头数据的方法列表 - SYSTEM
- SYSTEM
- NONE
- NONE
hostName string localhost 队列管理器所在的系统的主机名或 IP 地址。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。 localAddress string 对于与队列管理器的连接,此属性指定下列其中一项或全部:(1) 要使用的本地网络接口,(2) 要使用的本地端口或本地端口范围 maxMessages int 最小值:0
1 一次可分配给服务器会话的最大消息数。如果激活规范正在 XA 事务中向 MDB 传送消息,那么会使用值 1 而不理会此属性的设置。 maxPoolDepth int 最小值:0
10 激活规范上的 maxPoolDepth 属性定义可用 MDB(消息驱动的 Bean)实例的数目。减小此属性的值会减少当前可交付的消息数。 messageBatchSize int 最小值:0
要在一个批次中处理的最大消息数 messageCompression - RLE
- NONE
NONE 可用于压缩连接上的消息数据的方法列表 - RLE
- RLE
- NONE
- NONE
messageRetention 布尔型 连接使用者是否保留输入队列中不想要的消息。 messageSelection - CLIENT
- BROKER
CLIENT 确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。 - CLIENT
- CLIENT
- BROKER
- BROKER
messageSelector string 确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。如果 brokerVersion 值为 1,那么不支持使用代理程序来选择消息 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 秒。 port int 最小值:1
1414 队列管理器侦听的端口。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。 providerVersion - 7
- 6
- unspecified
unspecified 应用程序计划连接至的队列管理器的版本、发行版、修改级别和修订包。 - 7
- 7
- 6
- 6
- unspecified
- unspecified
queueManager string 要连接至的队列管理器的名称 receiveCCSID int 最小值:0
0 用于对队列管理器消息转换设置目标编码字符集标识的目标属性。除非 RECEIVECONVERSION 设置为 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)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,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 int 最小值:0
最大值:999999999
0 重新协商 SSL 使用的密钥之前,SSL 连接发送和接收的总字节数 startTimeout 具有毫秒精度的时间段 10s 配置一个持续时间(以毫秒计),执行必须在此持续时间内开始. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 statusRefreshInterval 具有毫秒精度的时间段 1m 刷新长期运行的事务的时间间隔(以毫秒计),该事务检测订户何时失去与队列管理器的连接。仅当 subscriptionStore 值为 QUEUE 时,此属性才有意义。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 subscriptionDurability - Durable
- NonDurable
是使用持久预订还是非持久预订来将消息传递至预订该主题的 MDB - Durable
- Durable
- NonDurable
- NonDurable
subscriptionName string 持久预订的名称 subscriptionStore - MIGRATE
- BROKER
- QUEUE
BROKER 确定 WebSphere MQ JMS 类用于存储有关活动预订的持久数据的位置。 - MIGRATE
- MIGRATE
- BROKER
- BROKER
- QUEUE
- QUEUE
transportType - CLIENT
- BINDINGS
CLIENT 与队列管理器的连接是使用客户机方式还是使用绑定方式。 - CLIENT
- CLIENT
- BINDINGS
- BINDINGS
wildcardFormat - CHAR
- TOPIC
TOPIC 要使用的通配符语法版本。 - CHAR
- CHAR
- TOPIC
- TOPIC