Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南

Procedure创建 JMS 连接工厂资源

  1. 在树组件中,展开“资源”节点,然后展开“JMS 资源”节点。

  2. 选择“连接工厂”节点。

  3. 在“JMS 连接工厂”页面中,单击“新建”。

    将出现“创建 JMS 连接工厂”页面。

  4. 在“JNDI 名称”字段中,键入连接工厂的名称。

    建议使用 JMS 资源的命名子上下文前缀 jms/。例如:jms/ConnectionFactory1

  5. 从“类型”下拉式列表中,选择 javax.jms.ConnectionFactoryjavax.jms.QueueConnectionFactoryjavax.jms.TopicConnectionFactory

  6. 选中“已启用”复选框以在运行时启用该资源。

  7. 在“高级”区域中,更改连接工厂属性所需的值。

    有关这些属性的详细信息,请参见编辑 JMS 连接工厂资源。Application Server 会将这些属性应用到为连接工厂创建的连接器连接池。

  8. 对于 JMS 连接工厂资源,请按照如下所示指定事务支持的值:

    • 对于可用于事务的资源,指定 XATransaction(默认值),这些事务使用事务范围内多个资源。

      例如,此资源和 JDBC 资源、连接器资源或其他 JMS 连接工厂资源。此值提供最大的灵活性。配置为 XATransaction 的资源将参与分为两个阶段的提交操作。

    • 对于事务(仅使用事务范围内的唯一一种资源)可以使用的资源或在使用多个 XA 资源的分布式事务中用作最后一个代理的资源,指定 LocalTransaction

      此值提供更好的性能。配置为 LocalTransaction 的资源将不被用于分为两个阶段的提交操作。

    • 对于永远无法参与事务的资源,指定 NoTransaction

      JMS 应用程序中限用此设置。

  9. 在“其他属性”区域中,为应用程序所需的属性提供值。下表列出了可用的属性。

    属性名称 

    说明 

    ClientId

    为长期订户将要使用的连接工厂指定客户机 ID。 

    AddressList

    指定应用程序将与其进行通信的消息代理实例的名称(和端口号 [可选] )。列表中的每个地址都指定了要连接的主机名(和端口号和连接服务 [可选])。例如,该值可能为 earthearth:7677。当消息代理在默认端口 (7676) 以外的端口上运行时,请指定端口号。如果属性设置指定了群集环境中的多个主机和端口,则将使用该列表中的第一个可用主机(除非将 AddressListBehavior 属性设置为 RANDOM)。

    有关详细信息,请参见 Message Queue Developer’s Guide for Java Clients

    默认值:本地主机和默认端口号 (7676)。客户机将尝试连接至位于本地主机端口 7676 上的代理。 

    Message Service AddressList

    AddressList 相同。此属性名已过时。请使用 AddressList 代替。

    UserName

    进入连接工厂的用户名。 

    默认值:guest

    Password

    进入连接工厂的密码。 

    默认值:guest

    Reconnect Enabled

    如果启用该属性(值 = true),则指定客户机运行时在丢失连接时尝试重新连接至消息服务器(或 AddressList 中的地址列表)。

    默认值:TRUE 

    Reconnect Attempts

    指定客户机运行时在尝试连接 AddressList 列表中的下一个地址之前尝试连接(或重新连接)列表中每个地址的次数。值 -1 表示重新连接尝试次数没有限制(客户机运行时将尝试连接至第一个地址,直到连接成功)。

    默认值:3 

    Reconnect Interval

    指定重新连接尝试之间的时间间隔(毫秒)。此属性适用于对 AddressList 中每个地址的尝试,及对该列表中连续地址的尝试。如果该时间间隔太短,则代理将没有时间恢复。如果该时间间隔太长,则重新连接可能会指明这是不可接受的延迟。

    默认值:30000 

    AddressList Behavior

    指定是按 AddressList 属性中的地址顺序 (PRIORITY) 还是按随机顺序 (RANDOM) 进行连接尝试。

    RANDOM 表示重新连接将从 AddressList 中随机选择一个地址。如果许多客户机尝试使用同一个连接工厂来进行连接,则该值将阻止它们全部连接至同一个地址。

    PRIORITY 表示重新连接始终尝试连接 AddressList 中的第一个服务器地址,并且仅在第一个代理不可用时才使用其他地址。

    默认值:RANDOM

    AddressList Iterations

    指定客户机运行时建立(或重新建立)连接时,在 AddressList 中重复的次数。值 -1 表示尝试次数没有限制。

    默认值:3 

  10. 在“目标”区域中,执行以下操作:

    1. 从“可用”列中选择将要部署使用了资源的应用程序的一个或多个目标。

      可用目标包括可用群集和可用服务器实例,以及默认服务器实例 server

    2. 单击“添加”以将目标移动到“选定”列中。

  11. 单击“确定”以保存连接工厂。

等效的 asadmin 命令

create-jms-resource