jms.html

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

</p>
<a name="wp83785"> </a><p class="pTableText">
示例：<br /><code class="cCode">mqssl:localhost:7676/ssljms</code>
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp83795"> </a><p class="pTableText">
<code class="cCode">http</code>
</p>
</td>
    <td><a name="wp83797"> </a><p class="pTableText">
<code class="cCode">httpjms</code>
</p>
</td>
    <td><a name="wp83799"> </a><p class="pTableText">
MQ 客户机运行时将与指定 URL 处的 MQ 隧道 Servlet 建立 HTTP 连接。（必须配置代理，以访问 MQ 的 Administrators Guide 中所述的 HTTP 隧道 Servlet。） 
</p>
</td>
    <td><a name="wp83801"> </a><p class="pTableText">
<em class="cEmphasis">hostName</em><code class="cCode">:</code><em class="cEmphasis">port</em><code class="cCode">/<br /></code><em class="cEmphasis">contextRoot</em><code class="cCode">/tunnel</code>
</p>
<a name="wp83803"> </a><p class="pTableText">
如果多个代理实例使用同一个隧道 Servlet，则连接特定代理实例（而不是随机选择的实例）的语法为：<code class="cCode">http://</code><em class="cEmphasis">hostName</em><code class="cCode">:</code><em class="cEmphasis">port</em><code class="cCode">/<br /></code><em class="cEmphasis">contextRoot</em><code class="cCode">/tunnel?</code><em class="cEmphasis">serverName</em><code class="cCode">=</code><em class="cEmphasis">hostName</em><code class="cCode">:</code><em class="cEmphasis">instanceName</em>
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp83813"> </a><p class="pTableText">
<code class="cCode">https</code>
</p>
</td>
    <td><a name="wp83815"> </a><p class="pTableText">
<code class="cCode">httpsjms</code>
</p>
</td>
    <td><a name="wp83817"> </a><p class="pTableText">
MQ 客户机运行时将与指定的 MQ 隧道 Servlet URL 建立安全 HTTPS 连接。（必须配置代理，以访问 MQ 的 Administrators Guide 中所述的 HTTPS 隧道 Servlet。）
</p>
</td>
    <td><a name="wp83819"> </a><p class="pTableText">
<em class="cEmphasis">hostName</em><code class="cCode">:</code><em class="cEmphasis">port</em><code class="cCode">/<br /></code><em class="cEmphasis">contextRoot</em><code class="cCode">/tunnel</code>
</p>
<a name="wp83821"> </a><p class="pTableText">
如果多个代理实例使用同一个隧道 Servlet，则连接特定代理实例（而不是随机选择的实例）的语法为：<code class="cCode">http://</code><em class="cEmphasis">hostName</em><code class="cCode">:</code><em class="cEmphasis">port</em><code class="cCode">/<br /></code><em class="cEmphasis">contextRoot</em><code class="cCode">/tunnel?</code><em class="cEmphasis">serverName</em><code class="cCode">=</code><em class="cEmphasis">hostName</em><code class="cCode">:</code><em class="cEmphasis">instanceName</em>
</p>
</td>
</tr>
</table>
</div>

</p>
<a name="wp84894"> </a><div class="pSmartList1"><li>在“其他属性”区域中，单击“添加属性”以添加属性。下表列出了可用的 Message Queue 代理配置属性。<div align="left">
<table border="1" cellpadding="5" cellspacing="0" summary="JMS 提供者的其他属性" id="wp83591">
  <caption><a name="wp83591"> </a><p class="pCaption">
表 8-5 JMS 提供者的其他属性
</p>
</caption>
  <tr bgcolor="#cdccee" align="left" valign="top">    <th scope="col"><a name="wp83597"> </a><p class="pTableHead">
属性名称
</p>
</th>
    <th scope="col"><a name="wp83599"> </a><p class="pTableHead">
说明
</p>
</th>
</tr>
  <tr align="left" valign="top">    <td><a name="wp83607"> </a><p class="pTableText">
<code class="cCode">instance-name</code>
</p>
</td>
    <td><a name="wp83609"> </a><p class="pTableText">
指定完整的 Sun Java System Message Queue 代理实例名称。默认值为 <code class="cCode">imqbroker</code>。
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp83617"> </a><p class="pTableText">
<code class="cCode">instance-name-suffix</code>
</p>
</td>
    <td><a name="wp83619"> </a><p class="pTableText">
指定要添加到完整的 Sun Java System Message Queue 代理实例名称中的后缀。该后缀与实例名之间以下划线字符 (<code class="cCode">_</code>) 分隔。例如，如果实例名为 <code class="cCode">imqbroker</code>，则在附加后缀 <code class="cCode">xyz</code> 之后，实例名将更改为 <code class="cCode">imqbroker_xyz</code>。
</p>
</td>
</tr>
  <tr align="left" valign="top">    <td><a name="wp83627"> </a><p class="pTableText">
<code class="cCode">append-version</code>
</p>
</td>
    <td><a name="wp83629"> </a><p class="pTableText">
如果为 <code class="cCode">true</code>，则应在完整的 Sun Java System Message Queue 代理实例名称后附加主要和次要版本号，这两个版本号之前都有一个下划线字符 (<code class="cCode">_</code>)。例如，如果实例名为 <code class="cCode">imqbroker</code>，则在附加版本号之后，实例名将更改为 <code class="cCode">imqbroker_8_0</code>。默认值为 <code class="cCode">False</code>。
</p>
</td>
</tr>
</table>
</div>
</li></div>
<a name="wp84896"> </a><div class="pSmartList1"><li>单击“保存”以保存更改，或者单击“装入默认值”以恢复服务的默认值。 </li></div>
<a name="wp84898"> </a><p class="pStepParaI1">
单击“Ping”以查看 JMS 服务是否已启动并正在运行。如果 JMS 服务已启动并正在运行，则将显示“Ping 成功：JMS 服务正在运行”的消息。
</p>
</ol></div>
<a name="wp84900"> </a><p class="pParagraph">
将提供者和主机改为远程系统会使所有 JMS 应用程序都在远程服务器上运行。要在使用本地服务器的同时使用一个或多个远程服务器，请使用 <code class="cCode">AddressList</code> 属性创建连接工厂资源从而创建访问远程服务器的连接。
</p>
<a name="wp84902"> </a><p class="pParagraph">
有关配置 JMS 服务的更多信息，请参见《Sun Java System Application Server Developer&#39;s Guide》。
</p>
<a name="wp84906"> </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/jms-ping.1.html  \n\n该文件无法用 Teleport Ultra 下载, 因为 它是一个域或路径外部被设置为它的启始地址的地址。  \n\n你想在服务器上打开它?'))window.location='http://docs.sun.com/source/817-6092/hman1/jms-ping.1.html'" tppabs="http://docs.sun.com/source/817-6092/hman1/jms-ping.1.html">jms-ping</code>
</p>
<a name="wp84946"> </a><h3 class="pHeading2">
创建 JMS 主机
</h3>
<a name="wp84950"> </a><p class="pParagraph">
要创建 JMS 主机，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp84952"> </a><div class="pSmartList1"><li>在树组件中，展开“配置”节点。</li></div>
<a name="wp84954"> </a><div class="pSmartList1"><li>选择要配置的实例：</li></div>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp84956"> </a><div class="pSmartList2"><li>要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 <code class="cCode">server</code>，请选择 <code class="cCode">server-config</code> 节点。</li></div>
<a name="wp84958"> </a><div class="pSmartList2"><li>要为将来的实例（使用 <code class="cCode">default-config</code> 的副本）配置默认设置，请选择 <code class="cCode">default-config</code> 节点。</li></div>
</ol></div>
<a name="wp84960"> </a><div class="pSmartList1"><li>展开“Java 消息服务”节点。</li></div>
<a name="wp84962"> </a><div class="pSmartList1"><li>选择“JMS 主机”节点。</li></div>
<a name="wp84964"> </a><div class="pSmartList1"><li>在“JMS 主机”页面中，单击“新建”。将显示“创建 JMS 主机”页面。</li></div>
<a name="wp84966"> </a><div class="pSmartList1"><li>在“名称”字段中，键入主机的名称。例如：</li></div>
<a name="wp84968"> </a><code class="pCodelineIndent">
NewJmsHost
</code>
<a name="wp84970"> </a><div class="pSmartList1"><li>在“主机”字段中，键入运行 JMS 主机的系统的名称或 Internet 协议 (IP) 地址（<code class="cCode">localhost</code> 或者本地或远程系统的名称）。</li></div>
<a name="wp84972"> </a><div class="pSmartList1"><li>在“端口”字段中，键入 JMS 服务的端口号。仅当要使用的 JMS 服务在非默认端口上运行时，才需要更改此字段。（默认端口为 7676。）</li></div>
<a name="wp84974"> </a><div class="pSmartList1"><li>在“管理用户名”和“管理密码”字段中，键入 MQ 代理用户名和密码。该用户名和密码与 Application Server 的用户名和密码不同。仅当已使用 <em class="cEmphasis">install_dir</em><code class="cCode">/imq/bin/imqusermgr</code> 命令更改了 MQ 代理值时，才需要编辑这些字段。默认值为 <code class="cCode">admin</code> 和 <code class="cCode">admin</code>。</li></div>
<a name="wp84976"> </a><div class="pSmartList1"><li>单击“确定”。</li></div>
</ol></div>
<a name="wp84980"> </a><p class="pParagraph">
等效的 <code class="cCode">asadmin</code> 命令为：<code class="cCode"><a href="javascript:if(confirm('http://docs.sun.com/source/819-0220/hman1/create-jms-host.1.html  \n\n该文件无法用 Teleport Ultra 下载, 因为 它是一个域或路径外部被设置为它的启始地址的地址。  \n\n你想在服务器上打开它?'))window.location='http://docs.sun.com/source/819-0220/hman1/create-jms-host.1.html'" tppabs="http://docs.sun.com/source/819-0220/hman1/create-jms-host.1.html">create-jms-host</code>
</p>
<a name="wp85008"> </a><h3 class="pHeading2">
编辑 JMS 主机
</h3>
<a name="wp85010"> </a><p class="pParagraph">
要编辑 JMS 主机，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp85012"> </a><div class="pSmartList1"><li>在树组件中，展开“配置”节点。</li></div>
<a name="wp85014"> </a><div class="pSmartList1"><li>选择要配置的实例：</li></div>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp85016"> </a><div class="pSmartList2"><li>要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 <code class="cCode">server</code>，请选择 <code class="cCode">server-config</code> 节点。</li></div>
<a name="wp85018"> </a><div class="pSmartList2"><li>要为将来的实例（使用 <code class="cCode">default-config</code> 的副本）配置默认设置，请选择 <code class="cCode">default-config</code> 节点。</li></div>
</ol></div>
<a name="wp85020"> </a><div class="pSmartList1"><li>展开“Java 消息服务”节点。</li></div>
<a name="wp85022"> </a><div class="pSmartList1"><li>选择“JMS 主机”节点。</li></div>
<a name="wp85024"> </a><div class="pSmartList1"><li>在“JMS 主机”页面中，选择要编辑的主机。</li></div>
<a name="wp85026"> </a><div class="pSmartList1"><li>在“编辑 JMS 主机”页面中，可以执行以下任务：</li></div>
<div class="pSmartList2"><ul class="pSmartList2">
<a name="wp85028"> </a><div class="pSmartList2"><li>在“主机”字段中，更改主机名或 Internet 协议 (IP) 地址。</li></div>
<a name="wp85030"> </a><div class="pSmartList2"><li>在“端口”字段中，更改 JMS 服务的端口号。</li></div>
<a name="wp85032"> </a><div class="pSmartList2"><li>更改“管理用户名”和“管理密码”字段中的值。</li></div>
</ul></div>
<a name="wp85034"> </a><div class="pSmartList1"><li>单击“保存”以保存更改，或者单击“装入默认值”以恢复主机的默认值。</li></div>
</ol></div>
<a name="wp85068"> </a><h3 class="pHeading2">
删除 JMS 主机
</h3>
<a name="wp85072"> </a><p class="pParagraph">
要删除 JMS 主机，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp85074"> </a><div class="pSmartList1"><li>在树组件中，展开“配置”节点。</li></div>
<a name="wp85076"> </a><div class="pSmartList1"><li>选择要配置的实例：</li></div>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp85078"> </a><div class="pSmartList2"><li>要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 <code class="cCode">server</code>，请选择 <code class="cCode">server-config</code> 节点。</li></div>
<a name="wp85080"> </a><div class="pSmartList2"><li>要为将来的实例（使用 <code class="cCode">default-config</code> 的副本）配置默认设置，请选择 <code class="cCode">default-config</code> 节点。</li></div>
</ol></div>
<a name="wp85082"> </a><div class="pSmartList1"><li>展开“Java 消息服务”节点。</li></div>
<a name="wp85084"> </a><div class="pSmartList1"><li>选择“JMS 主机”节点。</li></div>
<a name="wp85086"> </a><div class="pSmartList1"><li>在“JMS 主机”页面中，选中要删除的主机名称旁边的复选框。 </li></div>
<a name="wp85088"> </a><div class="pSmartList1"><li>单击“删除”。</li></div>
</ol></div>
<a name="wp85092"> </a><p class="pParagraph">
等效的 <code class="cCode">asadmin</code> 命令为：<code class="cCode"><a href="javascript:if(confirm('http://docs.sun.com/source/819-0220/hman1/delete-jms-host.1.html  \n\n该文件无法用 Teleport Ultra 下载, 因为 它是一个域或路径外部被设置为它的启始地址的地址。  \n\n你想在服务器上打开它?'))window.location='http://docs.sun.com/source/819-0220/hman1/delete-jms-host.1.html'" tppabs="http://docs.sun.com/sou