jms.html

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

<a name="wp84353"> </a><p class="pStepParaI1">
对于 JMS 连接工厂资源，请指定事务支持值，如下所示：
</p>
<div class="pSmartList2"><ul class="pSmartList2">
<a name="wp84355"> </a><div class="pSmartList2"><li>为可用于事务（使用事务范围内多个资源的事务，例如，此资源加上 JDBC 资源、连接器资源或其他 JMS 连接工厂资源）的资源指定 <code class="cCode">XATransaction</code>（默认值）。此值提供最大的灵活性。配置为 <code class="cCode">XATransaction</code> 的资源将参与分为两个阶段的提交操作。</li></div>
<a name="wp84357"> </a><div class="pSmartList2"><li>对用于事务的资源（该事务仅使用事务范围内的唯一一种资源）或在使用多个 XA 资源的分布式事务中用作最后一个代理的资源指定 <code class="cCode">LocalTransaction</code>。此值提供更好的性能。配置为 <code class="cCode">LocalTransaction</code> 的资源将不被用于分为两个阶段的提交操作。</li></div>
<a name="wp84359"> </a><div class="pSmartList2"><li>对永远无法参与事务的资源指定 <code class="cCode">NoTransaction</code>；此设置在 JMS 应用程序中有一定的使用。</li></div>
</ul></div><br>
<a name="wp84362"> </a><div class="pSmartList1"><li>在“其他属性”区域中，为应用程序所需的属性提供值。下表列出可用的属性。<div align="left">
<table border="1" cellpadding="5" cellspacing="0" summary="JMS 连接工厂的其他属性" id="wp82659">
  <caption><a name="wp82659"> </a><p class="pCaption">
表 8-1 JMS 连接工厂的其他属性&#160;</span>
</p>
</caption>
  <tr bgcolor="#cdccee" align="left" valign="top">    <th scope="col"><a name="wp82665"> </a><p class="pTableHead">
属性名称
</p>
</th>
    <th scope="col"><a name="wp82667"> </a><p class="pTableHead">
说明
</p>
</th>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82675"> </a><p class="pTableText">
<code class="cCode">ClientId</code>
</p>
</td>
    <td><a name="wp82677"> </a><p class="pTableText">
为长期订户将要使用的连接工厂指定客户机 ID。
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82685"> </a><p class="pTableText">
<code class="cCode">AddressList</code>
</p>
</td>
    <td><a name="wp82687"> </a><p class="pTableText">
指定应用程序将与其进行通信的消息代理实例的名称（和端口号 [可选]）。列表中的每个地址都指定了要连接的主机名（和端口号和连接服务 [可选]）。例如，该值可能为 <code class="cCode">earth</code> 或 <code class="cCode">earth:7677</code>。当消息代理在默认端口 (7676) 以外的端口上运行时，请指定端口号。如果属性设置指定了群集环境中的多个主机和端口，则将使用该列表中的第一个可用主机（除非将 <code class="cCode">AddressListBehavior</code> 属性设置为 <code class="cCode">RANDOM</code>）。 
</p>
<a name="wp82689"> </a><p class="pTableText">
有关详细信息，请参见《Sun Java System Message Queue Developer&#39;s Guide for Java Clients》。
</p>
<a name="wp82691"> </a><p class="pTableText">
默认值：本地主机和默认端口号 (7676)。客户机将尝试连接至位于本地主机端口 7676 上的代理。
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82699"> </a><p class="pTableText">
<code class="cCode">MessageServiceAddressList</code>
</p>
</td>
    <td><a name="wp82701"> </a><p class="pTableText">
与 <code class="cCode">AddressList</code> 相同。此属性名已过时。请使用 <code class="cCode">AddressList</code> 代替。
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82709"> </a><p class="pTableText">
<code class="cCode">UserName</code>
</p>
</td>
    <td><a name="wp82711"> </a><p class="pTableText">
进入连接工厂的用户名。
</p>
<a name="wp82713"> </a><p class="pTableText">
默认值：<code class="cCode">guest</code>
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82721"> </a><p class="pTableText">
<code class="cCode">Password</code>
</p>
</td>
    <td><a name="wp82723"> </a><p class="pTableText">
进入连接工厂的密码。
</p>
<a name="wp82725"> </a><p class="pTableText">
默认值：<code class="cCode">guest</code>
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82733"> </a><p class="pTableText">
<code class="cCode">ReconnectEnabled</code>
</p>
</td>
    <td><a name="wp82735"> </a><p class="pTableText">
如果启用该属性（值 = true），则指定客户机运行时在丢失连接时尝试重新连接至消息服务器（或 <code class="cCode">AddressList</code> 中的地址列表）。
</p>
<a name="wp82737"> </a><p class="pTableText">
默认值：TRUE
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82745"> </a><p class="pTableText">
<code class="cCode">ReconnectAttempts</code>
</p>
</td>
    <td><a name="wp82747"> </a><p class="pTableText">
指定客户机运行时尝试连接（或重新连接）<code class="cCode">AddressList</code> 列表中每个地址的次数。到达这个值后，客户机运行时将尝试连接列表中的下一个地址。值 -1 表示重新连接尝试次数没有限制（客户机运行时将尝试连接至第一个地址，直到连接成功）。
</p>
<a name="wp82749"> </a><p class="pTableText">
默认值： 3
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82757"> </a><p class="pTableText">
<code class="cCode">ReconnectInterval</code>
</p>
</td>
    <td><a name="wp82759"> </a><p class="pTableText">
指定重新连接尝试之间的时间间隔（毫秒）。此属性适用于对 <code class="cCode">AddressList</code> 中每个地址的尝试，及对该列表中连续地址的尝试。如果该时间间隔太短，则代理将没有时间恢复。如果该时间间隔太长，则重新连接可能会指明这是不可接受的延迟。
</p>
<a name="wp82761"> </a><p class="pTableText">
默认值： 30000
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82769"> </a><p class="pTableText">
<code class="cCode">AddressListBehavior</code>
</p>
</td>
    <td><a name="wp82771"> </a><p class="pTableText">
指定按 <code class="cCode">AddressList</code> 属性中的地址的顺序 (<code class="cCode">PRIORITY</code>) 还是按随机顺序 (<code class="cCode">RANDOM</code>) 进行连接尝试。
</p>
<a name="wp82773"> </a><p class="pTableText">
<code class="cCode">RANDOM</code> 表示重新连接将从 <code class="cCode">AddressList</code> 中随机选择一个地址。如果许多客户机尝试使用同一个连接工厂来进行连接，则该值将阻止它们全部连接至同一个地址。
</p>
<a name="wp82775"> </a><p class="pTableText">
<code class="cCode">PRIORITY</code> 表示重新连接始终尝试连接 <code class="cCode">AddressList</code> 中的第一个服务器地址，而仅在第一个代理不可用时才使用其他的地址。 
</p>
<a name="wp82777"> </a><p class="pTableText">
默认值：<code class="cCode">RANDOM</code>
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp82785"> </a><p class="pTableText">
<code class="cCode">AddressListIterations</code>
</p>
</td>
    <td><a name="wp82787"> </a><p class="pTableText">
指定客户机运行时建立（或重新建立）连接时，在 <code class="cCode">AddressList</code> 中迭代的次数。值 -1 表示尝试次数没有限制。
</p>
<a name="wp82789"> </a><p class="pTableText">
默认值： 3
</p>
</td>
</tr>
</table>
</div>
</li></div><br>
<a name="wp84364"> </a><div class="pSmartList1"><li>在“目标”区域中，执行以下操作：</li></div>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp84366"> </a><div class="pSmartList2"><li>从“可用”列中选择将要部署使用了资源的应用程序的一个或多个目标。可用目标包括可用群集和可用服务器实例，以及默认的服务器实例 <code class="cCode">server</code>。</li></div>
<a name="wp84368"> </a><div class="pSmartList2"><li>单击“添加”以将目标移动到“选定”列中。</li></div>
</ol></div>
<a name="wp84370"> </a><div class="pSmartList1"><li>单击“确定”以保存连接工厂。</li></div>
</ol></div>
<a name="wp84374"> </a><p class="pParagraph">
等效的 <code class="cCode">asadmin</code> 命令为：<code class="cCode"><a href="javascript:if(confirm('http://docs.sun.com/source/817-6092/hman1/create-jms-resource.1.html  \n\n该文件无法用 Teleport Ultra 下载, 因为 它是一个域或路径外部被设置为它的启始地址的地址。  \n\n你想在服务器上打开它?'))window.location='http://docs.sun.com/source/817-6092/hman1/create-jms-resource.1.html'" tppabs="http://docs.sun.com/source/817-6092/hman1/create-jms-resource.1.html">create-jms-resource</code>
</p>
<a name="wp84402"> </a><h3 class="pHeading2">
编辑 JMS 连接工厂资源
</h3>
<a name="wp84404"> </a><p class="pParagraph">
要编辑 JMS 连接工厂资源，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp84406"> </a><div class="pSmartList1"><li>在树组件中，展开“资源”节点，然后展开“JMS 资源”节点。</li></div>
<a name="wp84408"> </a><div class="pSmartList1"><li>展开“连接工厂”节点。</li></div>
<a name="wp84410"> </a><div class="pSmartList1"><li>选择要编辑的连接工厂。</li></div>
<a name="wp84412"> </a><div class="pSmartList1"><li>在“编辑 JMS 连接工厂”页面中，可以执行以下任务：</li></div>
<div class="pSmartList2"><ul class="pSmartList2">
<a name="wp84414"> </a><div class="pSmartList2"><li>修改“说明”字段中的文本。</li></div>
<a name="wp84416"> </a><div class="pSmartList2"><li>选中或取消选中“已启用”复选框以启用或禁用资源。</li></div>
<a name="wp84418"> </a><div class="pSmartList2"><li>更改“高级”区域中的属性值。</li></div>
<a name="wp84420"> </a><div class="pSmartList2"><li>添加、删除或修改属性。</li></div>
</ul></div>
<a name="wp84422"> </a><div class="pSmartList1"><li>或者，单击“目标”选项卡以转至“JMS 连接工厂资源目标”页面。在此页面中，执行以下操作：</li></div>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp84424"> </a><div class="pSmartList2"><li>单击“管理目标”以打开“管理资源目标”页面。 </li></div>
<a name="wp84426"> </a><p class="pStepParaI2">
在此页面中，在“可用”列与“选定”列之间移动目标。确保将要部署使用了资源的应用程序的目标放入“选定”列中。可用目标包括可用群集和可用服务器实例，以及默认的服务器实例 <code class="cCode">server</code>。单击“确定”以保存更改。
</p>
<a name="wp84428"> </a><div class="pSmartList2"><li>选中目标的复选框，然后单击“启用”或“禁用”，以启用或禁用目标的资源。</li></div>
</ol></div>
<a name="wp84430"> </a><div class="pSmartList1"><li>单击“保存”以保存更改。</li></div>