JMS 队列连接工厂用于创建与 JMS 队列的关联 JMS 提供程序的连接,以便进行点到点消息传递。请使用队列连接工厂管理对象来管理缺省消息传递提供程序的 JMS 队列连接工厂。
要在控制台中查看此页面,请单击下列其中一个操作途径:
缺省情况下,在服务器容器中使用此 JMS 连接工厂创建的连接(例如,与企业 Bean 的连接)将通过 Java Platform Enterprise Edition (Java EE) 连接器体系结构 (JCA) 连接池来进行共用。通过在管理控制台面板的“其他属性”部分中选择连接池属性链接,可以修改此连接工厂的连接池设置。
“配置”选项卡显示此对象的配置属性。这些属性值将被保存下来,即使停止并重新启动运行时环境也是如此。请参阅信息中心任务描述以获取关于如何将配置更改应用于运行时环境的信息。
指定使应用程序服务器可使用此资源对象的最高拓扑级别。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 字符串 |
指定 JMS 提供程序,它将启用基于 Java 消息服务 (JMS) 的异步消息传递。它提供了 J2EE 连接工厂,用于为特定 JMS 队列或主题目标创建连接。JMS 提供程序管理对象用于为相关 JMS 提供程序管理 JMS 资源。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 字符串 |
资源的必需显示名称。
| 信息 | 值 |
|---|---|
| 必需 | 是 |
| 数据类型 | 字符串 |
资源的 JNDI 名称。
作为约定,请使用格式为 jms/Name 的 JNDI 名称,其中 Name 是资源的逻辑名。有关 JNDI 用途及其语法的更多信息,请参阅 WebSphere® Application Server 中的“JNDI 支持”主题。
| 信息 | 值 |
|---|---|
| 必需 | 是 |
| 数据类型 | 字符串 |
资源的可选描述。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 文本区域 |
对资源进行分类或分组时使用的可选类别字符串。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 字符串 |
要连接的服务集成总线的名称。
| 信息 | 值 |
|---|---|
| 必需 | 是 |
| 数据类型 | 定制 |
标识了一组消息传递引擎的目标的名称。请使用“目标类型”属性来指定目标类型。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 字符串 |
Target 属性中指定的目标的类型。
此属性指示用于确定一个或多个处理工作的消息传递引擎的目标名。目标类型由目标类型属性指示。
在满足选择标准的可用消息传递引擎之间对连接进行负载均衡。
如果希望应用程序能够连接到总线中的任何消息传递引擎,请不要设置此属性。
有关将此属性与连接工作负载管理的其他连接工厂属性配合使用的更多信息,请参阅“与总线的 JMS 连接的管理属性”主题。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |
| 范围 |
|
此属性指定目标组的重要性。
有关将此属性与连接工作负载管理的其他连接工厂属性配合使用的更多信息,请参阅“与总线的 JMS 连接的管理属性”主题。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |
| 范围 |
|
应用程序连接至不在该应用程序所在进程中的消息传递引擎时应使用的入站传输链的名称。如果选择另一个进程中的消息传递引擎,那么仅当该消息传递引擎在运行所指定入站传输链的服务器中时,才可以建立连接。有关更多信息,请参阅信息中心。
如果所选消息传递引擎与应用程序在同一服务器中,那么将建立直接进程内连接并忽略此传输链属性。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 字符串 |
用于连接至引导服务器的端点三元组(语法为“主机名:端口号:链名”)的列表,以逗号分隔各个端点三元组。例如,Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging。如果未指定主机名,那么缺省值为 localhost。如果未指定端口号,那么缺省值为 7276。如果未指定链名,那么缺省值为 BootstrapBasicMessaging。有关更多信息,请参阅信息中心。
仅当在应用程序服务器外部运行的客户机应用程序或者另一单元中服务器上的应用程序要使用此连接工厂来连接到对此连接工厂指定的目标服务集成总线时,才需要修改此属性。
为了使用缺省消息传递提供程序的 JMS 目标,应用程序将连接到目标服务集成总线上目标被指定给的消息传递引擎。例如,JMS 队列被指定给服务集成总线上的队列目标。
在应用程序服务器外部运行的客户机应用程序 - 例如,在客户机容器中或在 WebSphere Application Server 环境外部运行 - 不能直接在目标总线中找到合适的消息传递引擎来连接。同样,在一个单元中的服务器上运行以连接到另一单元中的目标总线的应用程序在目标总线中无法直接找到要连接的适当消息传递引擎。
在这些方案中,客户机(或者另一总线中的服务器)必须通过作为目标总线成员的引导服务器来完成引导过程。引导服务器是运行 SIB 服务的应用程序服务器,但它不需要运行任何消息传递引擎。引导服务器将选择正在应用程序服务器中运行并且支持必需的目标传输链的消息传递引擎。为了能够执行引导过程,必须在客户机使用的连接工厂中配置一个或多个提供程序端点。
引导服务器使用特定的端口和引导传输链。该端口是主管链路远程端的消息传递引擎的 SIB_ENDPOINT_ADDRESS(如果启用了安全性,那么为 SIB_ENDPOINT_SECURE_ADDRESS)。该端口与主机名一起构成引导服务器的端点地址。
注: 对于
IBM® i
平台,必须(至少)将缺省主机名从 localhost 更改为 your.server.name。如果要让应用程序使用具有另一个端点地址的引导服务器,那么需要对客户机应用程序使用的 JMS 连接工厂的提供程序端点属性指定所需的端点地址。您可以指定一个或多个引导服务器端点地址。
必须在每个由应用程序服务器外部的应用程序使用的 JMS 连接工厂中指定引导服务器端点地址。为了避免必须指定过多的引导服务器,您可以提供几台具有高可用性的服务器来作为专用引导服务器。然后,您只需要对每个连接工厂指定少量的引导服务器。
boothost1:7278:BootstrapBasicMessaging
或
boothost1:7278
而对于主机 boothost2 上分配了安全端口 7289 并使用预定义传输链
BootstrapTunneledSecureMessaging 的服务器:boothost2:7289:BootstrapTunneledSecureMessaging
[ [host_name] [ ":" [port_number] [ ":" chain_name] ] ]
其中:[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
.
如果未指定值,那么缺省值是 localhost。
注: 对于
IBM i
平台,必须(至少)将缺省主机名从 localhost 更改为 your.server.name。如果未指定 port_number,那么缺省值是 7276。
要使用管理控制台查找其中任一值,请单击。
提供了下列预定义引导传输链:
指定 host_name : chain_name 而不是 host_name : : chain_name(带有两个冒号)是不正确的。可以不输入任何内容,也可以输入以下任何内容:"a"、"a:"、":7276"、"::chain" 等等。如果未指定值,就会应用缺省值,但您必须用“:”将各个字段分隔开。
boothost1:7278:BootstrapBasicMessaging,
boothost2:7289:BootstrapTunneledSecureMessaging,
[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 文本区域 |
可接受连接请求的消息传递引擎与引导消息传递引擎的邻近度。
有关将此属性与连接工作负载管理的其他连接工厂属性配合使用的更多信息,请参阅“与总线的 JMS 连接的管理属性”主题。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |
| 范围 |
|
对使用此连接工厂发送的非持久 JMS 消息应用的可靠性。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |
| 范围 |
|
对使用此连接工厂发送的持久 JMS 消息应用的可靠性。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |
| 范围 |
|
预读是一种优化措施,即抢先将消息指定给使用者。此优化措施能够缩短满足使用者请求所耗用的时间。
指定给使用者的消息被锁定在服务器上,并且不能被此目标的任何其他使用者使用。指定给使用者但在该使用者关闭前未被使用的消息随后在服务器上被解锁,这样其他使用者就可以接收那些消息。
通过对 JMS 目标设置提前读取属性,可以对各个 JMS 目标覆盖此属性。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |
| 范围 |
|
使用此连接工厂的应用程序所创建的临时队列的前缀。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 字符串 |
发送大型对象消息或字节消息时,序列化、反序列化和复制消息有效内容的内存和处理器使用成本可能会很高。 如果对连接工厂或激活规范启用通过引用传递消息有效内容属性,请通知缺省消息传递提供程序覆盖 JMS 1.1 规范并可能要减少或绕过此数据复制。
启用后,连接至总线的消息产生应用程序使用此连接工厂发送的对象/字节数消息在设置时不会复制他们的数据,并且系统仅在绝对必要时才会序列化消息数据。一旦数据设置到消息中,发送这类消息的应用程序就不能修改数据。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 布尔值 |
启用后,连接至此连接工厂的消息使用应用程序所接收的对象消息仅在绝对必要时才会让系统序列化其消息数据。应用程序必须将从这些消息获取的数据视为只读。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 布尔值 |
获取连接时,容器是否记录缺少事务上下文。
如果选择此属性,那么将记录所创建的没有事务上下文的连接。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 布尔值 |
容器是否应该跟踪高速缓存的句柄(句柄保存在 Bean 的实例变量中)。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 布尔值 |
XA 恢复处理期间使用的认证别名。
此属性提供已对 WebSphere Application Server 定义的 JCA 认证数据条目别名的列表。您可以选择在 XA 恢复处理期间用来进行认证的数据条目别名。
如果已对相关联的服务集成总线启用了安全性,那么请选择指定了用于进行 XA 恢复的用户标识和密码的别名,该别名在 WebSphere Application Server 的用户注册中心中有效。如果启用了总线安全性并且将要使用 XA 事务,那么必须设置此属性。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |
指定此连接工厂使用的 Java 认证和授权服务 (JAAS) 映射配置的别名。
仅当组件资源引用上没有 loginConfiguration 时,才会使用此字段。登录配置的规范以及组件资源引用的关联属性确定当资源认证值为“容器”时容器管理的认证策略。如果指定了 DefaultPrincipalMapping 登录配置,那么相关联的属性将是一个 JAAS - J2C 认证数据条目别名。请参阅相关项 JAAS - J2C 认证数据条目以定义新的别名。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |
此别名指定用户标识和密码,他们将在进行容器管理的认证时用于认证与 JMS 提供程序的连接。仅在 res-auth 值是 container 并且部署应用程序时未设置认证别名的情况下才会使用此设置。
| 信息 | 值 |
|---|---|
| 必需 | 否 |
| 数据类型 | 下拉列表 |