Resource Adapter for JMS with WebSphere Application Server 的配置属性
部署 Resource Adapter for JMS with WebSphere® Application Server 时,必须配置已部署资源适配器实例支持的一组 JMS 资源。
下列各表列示 JMS 属性及其值。
注: 并非对
WebSphere Application Server 环境中运行的应用程序可用的所有属性在第三方环境中都可用。某些属性在
WebSphere Application Server 环境外部无任何意义,某些属性对远程连接的客户机无任何意义。
| 属性名 | 描述 | 允许的值 | 缺省 |
|---|---|---|---|
| BusName | 要连接的服务集成总线的名称。 | ||
| ClientID | 使用此连接工厂创建的所有连接上持久主题预订所需的 JMS 客户机标识。 | ||
| UserName | |||
| Password | |||
| NonPersistentMapping | 可靠性适用于使用此连接工厂发送的非持久 JMS 消息。 | BestEffortNonPersistent、ExpressNonPersistent 和 ReliableNonPersistent | ExpressNonPersistent |
| PersistentMapping | 对使用此连接工厂发送的持久 JMS 消息应用的可靠性。 | ReliablePersistent 和 AssuredPersistent | ReliablePersistent |
| DurableSubscriptionHome | 一个消息传递引擎的名称,该消息传递引擎用于存储传递到根据此 JMS 连接工厂创建的对象的持久预订的消息。 | ||
| ReadAhead | 预读是一种优化措施,即抢先将消息指定给使用者。此优化措施能够缩短满足使用者请求所耗用的时间。 | AlwaysOn、AlwaysOff 和 Default | 缺省 |
| 目标 | 标识了一组消息传递引擎的目标的名称。请使用 Target type 属性来指定目标类型。 | ||
| TargetType | Target 属性中指定的目标的类型。 | BusMember、Custom 和 ME | BusMember |
| TargetSignificance | 目标组的重要性。 | 必需和首选 | 必需 |
| TargetTransportChain | 解析到一组消息传递引擎的协议的名称。 | ||
| ProviderEndpoints | 用于连接到引导服务器的以逗号分隔的端点列表。 | ||
| ConnectionProximity | 可接受连接请求的消息传递引擎与引导消息传递引擎的邻近度。 | Server、Cluster、Host 和 Bus | 总线 |
| TemporaryQueueNamePrefix | 使用此连接工厂的应用程序创建的临时队列的名称前缀,限长 12 个字符。 | ||
| TemporaryTopicNamePrefix | 使用此连接工厂的应用程序所创建的临时主题的前缀。 | ||
| ShareDurableSubscriptions | 控制是否在服务器集群成员的连接之间共享持久预订。 | InCluster、AlwaysShared 和 NeverShared | InCluster(始终解析为 AlwaysOff,因为客户机始终在 WebSphere Application Server 集群服务器外部) |
ProducerDoesNotModify |
启用后,连接至总线的消息产生应用程序使用此连接工厂发送的对象或字节数消息在设置时不会复制它们的数据,并且系统仅在绝对必要时才会序列化消息数据。一旦数据设置到消息中,发送这类消息的应用程序就不能修改数据。 | true 和 false | False |
| 属性名 | 描述 | 允许的值 | 缺省 |
|---|---|---|---|
| BusName | 要连接的服务集成总线的名称。 | ||
| UserName | |||
| Password | |||
| NonPersistentMapping | 对使用此连接工厂发送的非持久 JMS 消息应用的可靠性。 | BestEffortNonPersistent、ExpressNonPersistent 和 ReliableNonPersistent | ExpressNonPersistent |
| PersistentMapping | 对使用此连接工厂发送的持久 JMS 消息应用的可靠性。 | ReliablePersistent 和 AssuredPersistent | ReliablePersistent |
| ReadAhead | 预读是一种优化措施,即抢先将消息指定给使用者。此优化措施能够缩短满足使用者请求所耗用的时间。 | AlwaysOn、AlwaysOff 和 Default | 缺省 |
| Target | 标识了一组消息传递引擎的目标的名称。请使用 Target type 属性来指定目标类型。 | ||
| TargetType | Target 属性中指定的目标的类型。 | BusMember、Custom 和 ME | BusMember |
| TargetSignificance | 目标组的重要性。 | 必需和首选 | 必需 |
| TargetTransportChain | 解析到一组消息传递引擎的协议的名称。 | ||
| ProviderEndpoints | 用于连接到引导服务器的以逗号分隔的端点列表。 | ||
| ConnectionProximity | 可接受连接请求的消息传递引擎与引导消息传递引擎的邻近度。 | Server、Cluster、Host 和 Bus | 总线 |
| TemporaryQueueNamePrefix | 使用此连接工厂的应用程序创建的临时队列的名称前缀,限长 12 个字符。 | ||
ProducerDoesNotModify |
启用后,连接至总线的消息产生应用程序使用此连接工厂发送的对象或字节数消息在设置时不会复制它们的数据,并且系统仅在绝对必要时才会序列化消息数据。一旦数据设置到消息中,发送这类消息的应用程序就不能修改数据。 | true 和 false | False |
| 属性名 | 描述 | 允许的值 | 缺省 |
|---|---|---|---|
| BusName | 要连接的服务集成总线的名称。 | ||
| ClientID | 使用此连接工厂创建的所有连接上持久主题预订所需的 JMS 客户机标识。 | ||
| UserName | |||
| Password | |||
| NonPersistentMapping | 对使用此连接工厂发送的非持久 JMS 消息应用的可靠性。 | BestEffortNonPersistent、ExpressNonPersistent 和 ReliableNonPersistent | ExpressNonPersistent |
| PersistentMapping | 对使用此连接工厂发送的持久 JMS 消息应用的可靠性。 | ReliablePersistent 和 AssuredPersistent | ReliablePersistent |
| DurableSubscriptionHome | 一个消息传递引擎的名称,该消息传递引擎用于存储传递到根据此 JMS 连接工厂创建的对象的持久预订的消息。 | ||
| ReadAhead | 预读是一种优化措施,即抢先将消息指定给使用者。此优化措施能够缩短满足使用者请求所耗用的时间。 | AlwaysOn、AlwaysOff 和 Default | 缺省 |
| Target | 标识了一组消息传递引擎的目标的名称。请使用 Target type 属性来指定目标类型。 | ||
| TargetType | Target 属性中指定的目标的类型。 | BusMember、Custom 和 ME | BusMember |
| TargetSignificance | 目标组的重要性。 | 必需和首选 | 必需 |
| TargetTransportChain | 解析到一组消息传递引擎的协议的名称。 | ||
| ProviderEndpoints | 用于连接到引导服务器的以逗号分隔的端点列表。 | ||
| ConnectionProximity | 可接受连接请求的消息传递引擎与引导消息传递引擎的邻近度。 | Server、Cluster、Host 和 Bus | 总线 |
| TemporaryTopicNamePrefix | 使用此连接工厂的应用程序所创建的临时主题的前缀。 | ||
| ShareDurableSubscriptions | 控制是否在服务器集群成员的连接之间共享持久预订。 | InCluster、AlwaysShared 和 NeverShared | InCluster(始终解析为 AlwaysOff,因为客户机始终在 WebSphere Application Server 集群服务器外部) |
ProducerDoesNotModify |
启用后,连接至总线的消息产生应用程序使用此连接工厂发送的对象或字节数消息在设置时不会复制它们的数据,并且系统仅在绝对必要时才会序列化消息数据。一旦数据设置到消息中,发送这类消息的应用程序就不能修改数据。 | true 和 false | False |
| 属性名 | 描述 | 允许的值 | 缺省 |
|---|---|---|---|
| QueueName | 服务集成总线上关联队列的名称。 | ||
| DeliveryMode | 发送至此目标的消息的传递方式。此选项控制此目标上的消息持久性。 | Application、Persistent 或 NonPersistent | |
| TimeToLive | 发送至此目标的消息应该由系统保留的缺省时间长度,从分派时间起计,以毫秒为单位。 | ||
| 优先级 | 发送至此目标的消息的相对优先级,范围是 0(最低)到 9(最高)。 | ||
| ReadAhead | 预读是一种优化措施,即抢先将消息指定给使用者。此优化措施能够缩短满足使用者请求所耗用的时间。 | AlwaysOn、AlwaysOff、AsConnection 或 Default | AsConnection |
| BusName | 要连接的服务集成总线的名称。 | ||
| ScopeToLocalQP | 设置应用程序连接至的消息传递引擎上存在单个队列点时,是否将此队列所标识的服务集成总线队列目标的范围动态限定为此队列点。 | On 和 Off | Off |
| ProducerPreferLocal | 设置此队列的消息生产者是否应选择服务集成总线队列目标的本地连接队列点而不是任何其他队列点。 | On 和 Off | On |
| ProducerBind | 设置单个消息生产者发送至此队列的消息是进入同一服务集成总线队列点,还是不存在这样的限制并且不同消息将发送至不同队列点。 | On 和 Off | Off |
| GatherMessages | 设置是所有服务集成总线队列点上的消息还是只有单个队列点上的消息对使用此队列的消息使用者和队列浏览器可视。 | On 和 Off | Off |
| 属性名 | 描述 | 允许的值 | 缺省 |
|---|---|---|---|
| TopicSpace | 包含主题的主题空间的名称,此主题在 BusName 属性定义的服务集成总线上。 | Default.Topic.Space | |
| TopicName | 在 TopicSpace 属性定义的主题空间中对此 JMS 主题指定的主题的名称。 | ||
| DeliveryMode | 发送至此目标的消息的传递方式。此选项控制此目标上的消息持久性。 | Application、Persistent 或 NonPersistent | |
| TimeToLive | 发送至此目标的消息应该由系统保留的缺省时间长度,从分派时间起计,以毫秒为单位。 | ||
| 优先级 | 发送至此目标的消息的相对优先级,范围是 0(最低)到 9(最高)。 | ||
| ReadAhead | 预读是一种优化措施,即抢先将消息指定给使用者。此优化措施能够缩短满足使用者请求所耗用的时间。 | AlwaysOn、AlwaysOff、AsConnection 或 Default | AsConnection |
| BusName | 要连接的服务集成总线的名称。 |
| 属性名 | 描述 | 允许的值 | 缺省 | 必需/可选 |
|---|---|---|---|---|
| 目标 | 服务集成总线上的目标的名称。 | 必需 | ||
| ProviderEndpoints | 用于连接到引导服务器的以逗号分隔的端点列表。 | 必需 | ||
| DestinationType | 消息驱动的 Bean 使用队列还是主题目标。 | javax.jms.Queue 和 javax.jms.Topic | 必需 | |
| BusName | 要连接的服务集成总线的名称。 | 必需 | ||
| MessageSelector | 用于确定消息驱动的 Bean 所接收消息的 JMS 消息选择器。值是用于选择一小部分可用消息的字符串。语法基于由 JMS 规范描述的 SQL 92 条件表达式语法的子集。 | 可选 | ||
| AcknowledgeMode | 会话如何确认其接收的任何消息。 | Auto-acknowledge 和 Dups-ok-acknowledge | Auto-acknowledge | 可选 |
| SubscriptionDurability | JMS 主题预订是持久的还是非持久的。 | 持久和非持久 | 非持久 | 可选 |
| SubscriptionName | 持久主题预订所需的预订名。在使用持久主题预订时,这是必填字段。 | 可选 | ||
| MaxBatchSize | 在一个消息批次中能够从消息传递引擎接收的最大消息数。 | 1 到 2147483647 | 1 | 可选 |
| MaxConcurrency | 以并发方式将消息传递至的端点的最大数目。 | 1 到 2147483647 | 10 | 可选 |
| RetryInterval | 尝试连接至消息传递引擎操作之间的延迟(以秒计)。 | 1 到 2147483647 | 30 | 可选 |
| UserName | 可选 | |||
| Password | 可选 | |||
| DurableSubscriptionHome | 一个消息传递引擎的名称,该消息传递引擎用于存储传递到根据此 JMS 连接工厂创建的对象的持久预订的消息。 | 可选 | ||
| ShareDurableSubscriptions | 控制是否在服务器集群成员的连接之间共享持久预订。 | InCluster、AlwaysShared 和 NeverShared | InCluster(始终解析为 AlwaysOff,因为客户机始终在 WebSphere Application Server 集群服务器外部) | 可选 |
| ClientID | 使用此连接工厂创建的所有连接上持久主题预订所需的 JMS 客户机标识。 | 可选 | ||
| TargetTransportChain | 解析到一组消息传递引擎的协议的名称。 | 可选 | ||
| ReadAhead | 预读是一种优化措施,即抢先将消息指定给使用者。此优化措施能够缩短满足使用者请求所耗用的时间。 | AlwaysOn、AlwaysOff 和 Default | 缺省值 | 可选 |
| Target | 标识了一组消息传递引擎的目标的名称。请使用 Target type 属性来指定目标类型。 | 可选 | ||
| TargetType | Target 属性中指定的目标的类型。 | BusMember、Custom 和 ME | BusMember | 可选 |
| TargetSignificance | 此属性指定目标组的重要性。 | 必需和首选 | 必需 | 可选 |
| TopicSpace | 包含主题的主题空间的名称,此主题在 BusName 属性定义的服务集成总线上。 | Default.Topic.Space | 可选 | |
ForwarderDoesNotModify |
启用后,通过此激活规范转发的并且其有效内容已修改的对象/字节消息的数据在设置到消息中时不会被复制,并且系统仅在绝对必要时才会序列化消息数据。一旦数据设置到消息中,发送这类消息的应用程序就不能修改数据。 | true 和 false | false | 可选 |
参考主题