定义 JMS 激活规范配置。
Name | Type | Default | Description |
---|---|---|---|
id | 字符串 | 唯一配置标识。 | |
authDataRef | 对顶级 authData 元素的引用(字符串)。 | 激活规范的缺省认证数据。 | |
maxEndpoints | int Min: 0 | 500 | 要分派至的最大端点数。 |
autoStart | 布尔型 | true | 配置与此激活规范相关联的消息端点是自动启动,还是需要使用恢复命令手动启动。 |
激活规范的缺省认证数据。
Name | Type | Default | Description |
---|---|---|---|
user | string | 连接至 EIS 时所使用的用户名 | |
password | 可逆向编码的密码(字符串) | 连接至 EIS 时所使用的用户密码可采用明文或编码格式存储该值。建议您对该密码进行编码。为此,请将 securityUtility 工具与编码选项配合使用。 |
JMS 激活规范与一个或多个消息驱动的 bean 关联,并为它们提供必需的配置以接收消息。
Name | Type | Default | Description |
---|---|---|---|
acknowledgeMode |
| Auto-acknowledge | 应答方式指示应如何应答消息驱动的 bean 接收到的消息。 Auto-acknowledge Auto-acknowledge Dups-ok-acknowledge Dups-ok-acknowledge |
busName | string | defaultBus | 连接至完整概要文件服务器中的服务集成总线时,该总线的名称。 |
destinationType |
| javax.jms.Queue | 目标的类型,即 javax.jms.Queue 或 javax.jms.Topic javax.jms.Queue javax.jms.Queue javax.jms.Topic javax.jms.Topic |
maxConcurrency | int Min: 1 Max: 2147483647 | 5 | 最大端点数,会将消息并行传递给这些端点。增大该数字会提高性能,但是它也会增大在指定时间使用的线程数。如果必须为所有失败的传递维持消息顺序,请将“最大并行端点数”值设置为 1。 |
readAhead |
| Default | 预先读取是优先将消息指定给使用者的优化。它会更快地处理客户请求。 AlwaysOn AlwaysOn AlwaysOff AlwaysOff Default Default |
retryInterval | 具有秒精度的时间段 | 30s | 两次尝试连接至消息传递引擎(无论是初始连接,还是后来尝试建立更好的连接)之间的延迟(以秒计)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
subscriptionDurability |
| NonDurable | MS 主题预订的类型。此值可为下列任一值:Durable DurableShared NonDurable NonDurableShared NonDurableShared NonDurableShared Durable Durable DurableShared DurableShared NonDurable NonDurable |
targetTransportChain |
| InboundBasicMessaging | 传输链指定通信协议,这些通信协议可用来与完整概要文件服务器中的服务集成总线通信。 InboundBasicMessaging InboundBasicMessaging InboundSecureMessaging InboundSecureMessaging |
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 目标的引用 | |
maxBatchSize | int Min: 1 Max: 2147483647 | 在单个批次中从消息传递引擎接收的最多消息条数。 | |
messageSelector | string | 使用 JMS 消息选择器来确定消息驱动的 bean 接收的消息。该值是用于选择可用消息子集的字符串。 | |
remoteServerAddress | string | 此远程服务器地址包含以逗号分隔的三元组,语法为 hostName:portNumber:chainName,用于连接至引导服务器。例如,Merlin:7276:BootstrapBasicMessaging。如果未指定 hostName,那么缺省值为 localhost。如果未指定 portNumber,那么缺省值为 7276。如果未指定 chainName,那么缺省值为 BootstrapBasicMessaging。请参阅信息中心,以了解更多信息。 | |
shareDurableSubscription | string | 控制持久预订是否可在连接之间共享。 | |
subscriptionName | string | 持久(及共享非持久)所需的预订名。使用持久(及共享非持久)主题预订时的必需字段。此预订名在给定客户机标识内必须唯一。 |
WebSphere MQ JMS 激活规范
Name | Type | Default | Description |
---|---|---|---|
destinationRef | 对顶级 adminObject 元素的引用(字符串)。 | 目标 | |
CCSID | int Min: 1 | 819 | 连接的编码字符集标识。 |
channel | string | SYSTEM.DEF.SVRCONN | 要使用的 MQI 通道的名称。 |
cloneSupport |
| DISABLED | 是否允许同时运行同一个持久主题订户的两个或更多个实例 DISABLED DISABLED ENABLED ENABLED |
destinationType |
| javax.jms.Queue | 目标类型 - javax.jms.Queue 或 javax.jms.Topic javax.jms.Queue javax.jms.Queue javax.jms.Topic javax.jms.Topic |
headerCompression |
| NONE | 可用于压缩连接上的头数据的方法列表 SYSTEM SYSTEM NONE NONE |
hostName | string | localhost | 队列管理器所在的系统的主机名或 IP 地址。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。 |
messageCompression |
| 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 秒。 |
port | int Min: 1 | 1414 | 队列管理器侦听的端口。如果指定了 ConnectionNameList 属性,那么该属性会取代主机名和端口属性。 |
providerVersion |
| 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 |
| CLIENT | 与队列管理器的连接是使用客户机方式还是使用绑定方式。 BINDINGS BINDINGS CLIENT CLIENT |
failIfQuiesce | 布尔型 | true | 队列管理器处于停顿状态时,对某些方法的调用是否失败 |
maxMessages | int Min: 0 | 1 | 一次可分配给服务器会话的最大消息数。如果激活规范正在 XA 事务中向 MDB 传送消息,那么会使用值 1 而不理会此属性的设置。 |
maxPoolDepth | int Min: 0 | 10 | 激活规范上的 maxPoolDepth 属性定义可用 MDB(消息驱动的 Bean)实例的数目。减小此属性的值会减少当前可交付的消息数。 |
messageSelection |
| CLIENT | 确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。 BROKER BROKER CLIENT CLIENT |
receiveCCSID | int Min: 0 | 0 | 用于对队列管理器消息转换设置目标编码字符集标识的目标属性。除非 RECEIVECONVERSION 设置为 WMQ_RECEIVE_CONVERSION_QMG,否则会忽略此值 |
receiveConversion |
| CLIENT_MSG | 用于确定队列管理器是否将执行数据转换的目标属性。 QMGR QMGR CLIENT_MSG CLIENT_MSG |
sslResetCount | int Min: 0 Max: 999999999 | 0 | 重新协商 SSL 使用的密钥之前,SSL 连接发送和接收的总字节数 |
cleanupLevel |
| 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 | 确定 WebSphere MQ JMS 类用于存储有关活动预订的持久数据的位置。 BROKER BROKER MIGRATE MIGRATE QUEUE QUEUE |
wildcardFormat |
| TOPIC | 要使用的通配符语法版本。 CHAR CHAR TOPIC TOPIC |
applicationName | string | 向队列管理器注册应用程序时使用的名称。 | |
ccdtURL | string | 一个 URL,用于标识包含客户机通道定义表 (CCDT) 的文件的名称和位置并指定该文件的访问方式。 | |
clientId | string | 连接的客户机标识 | |
connectionNameList | string | 用于通信的 TCP/IP 连接名称(主机名(端口))的列表。ConnectionNameList 将取代主机名和端口属性。 | |
localAddress | string | 对于与队列管理器的连接,此属性指定下列其中一项或全部:(1) 要使用的本地网络接口,(2) 要使用的本地端口或本地端口范围 | |
messageBatchSize | int Min: 0 | 要在一个批次中处理的最大消息数 | |
queueManager | string | 要连接至的队列管理器的名称 | |
subscriptionDurability |
| 是使用持久预订还是非持久预订来将消息传递至预订该主题的 MDB Durable Durable NonDurable NonDurable | |
subscriptionName | string | 持久预订的名称 | |
messageRetention | 布尔型 | 连接使用者是否保留输入队列中不想要的消息。 | |
messageSelector | string | 确定消息选择是由 WebSphere MQ JMS 类还是代理程序完成。如果 brokerVersion 值为 1,那么不支持使用代理程序来选择消息 | |
sslCertStores | string | 用于保存要在 SSL 连接上使用的证书撤销列表 (CRL) 的轻量级目录访问协议 (LDAP) 服务器 | |
sslCipherSuite | string | 要用于 SSL 连接的密码套件 | |
sslFipsRequired | 布尔型 | SSL 连接是否必须使用 IBM Java JSSE FIPS 提供程序 (IBMJSSEFIPS) 支持的密码套件。 | |
sslPeerName | string | 对于 SSL 连接,这是用于在队列管理器提供的数字证书中检查专有名称的模板 | |
brokerCCDurSubQueue | string | 一个队列的名称,将从此队列中检索连接使用者的非持久预订消息 | |
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 | 调用通道发送出口程序时传递至这些出口程序的用户数据。 |