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