test

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

有關 JMS 連線工廠的 管理主控台 作業

Procedure建立 JMS 連線工廠資源

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [JMS 資源] 節點。

  2. 選取 [連線工廠] 節點。

  3. 在 [JMS 連線工廠] 頁面中，按一下 [新建]。

    將顯示 [建立 JMS 連線工廠] 頁面。

  4. 在 [JNDI 名稱] 欄位中，鍵入連線工廠的名稱。

    建議的作業是使用 JMS 資源的命名子環境前綴 jms/。例如︰jms/ConnectionFactory1。

  5. 從 [類型] 下拉式清單中，選擇 javax.jms.ConnectionFactory、javax.jms.QueueConnectionFactory 或 javax.jms.TopicConnectionFactory。

  6. 選取 [啟用] 核取方塊以在執行階段啟用該資源。

  7. 在 [進階] 區域中，變更連線工廠屬性所需的值。

    如需有關這些屬性的詳細資訊，請參閱編輯 JMS 連線工廠資源。Application Server 會將這些屬性套用至為連線工廠建立的連接器連線池。

  8. 請為 JMS 連線工廠資源指定 [作業事件支援] 值，如下所示：

    • 為可用於作業事件 (此作業事件包含在作業事件範圍內使用的多個資源) 的資源指定 XATransaction (預設值)。

      例如，此資源加上 JDBC 資源、連接器資源或其他 JMS 連線工廠資源。此值提供了最大的靈活性。配置為 XATransaction 的資源將參與分為兩個階段的確定作業。

    • 為可用於作業事件 (此作業事件僅包含作業事件範圍內的一個資源) 的資源，或用做分散式作業事件 (此分散式作業事件包含多個 XA 資源) 中最後一個代理程式的資源指定 LocalTransaction。

      使用此值可以獲得更好的效能。配置為 LocalTransaction 的資源不會被用於分為兩個階段的確定作業。

    • 為永遠無法參與作業事件的資源指定 NoTransaction。

      此設定在 JMS 應用程式中的使用受限。

  9. 在 [附加特性] 區域中，為應用程式所需的特性提供值。下表列示了可用的特性。

    特性名稱 

    說明 

    ClientId

    為長期訂戶將要使用的連線工廠指定用戶端 ID。 

    AddressList

    指定訊息代理程式實例或應用程式要與其通訊的實例的名稱和連接埠號 (可選擇)。清單中的每個位址都指定了要連線的主機名稱 (和連接埠號與連線服務 [選擇性地])。例如，該值可能為 earth 或 earth:7677。當訊息代理程式在預設連接埠 (7676) 以外的連接埠上執行時，請指定連接埠號。如果特性設定在叢集環境中指定了多個主機和連接埠，則將使用該清單中的第一個可用主機 (除非將 AddressListBehavior 特性設定為 RANDOM)。

    如需詳細資訊，請參閱「Message Queue Developer’s Guide for Java Clients」。

    預設：本地主機和預設連接埠號 (7676)。用戶端將嘗試連線至位於本地主機連接埠 7676 上的代理程式。 

    MessageServiceAddressList

    與 AddressList 相同。此特性名稱已被拒絕。請改為使用 AddressList。

    UserName

    進入連線工廠的使用者名稱。 

    預設：guest

    Password

    進入連線工廠的密碼。 

    預設：guest

    ReconnectEnabled

    如果啟用此特性 ( 值 = true)，請指定用戶端執行階段在遺失連線時嘗試重新連線至訊息伺服器 (或 AddressList 中的位址清單)。

    預設：TRUE 

    ReconnectAttempts

    指定用戶端執行階段嘗試連線 (或重新連線) AddressList 清單中每個位址的次數。到達這個值後，用戶端執行階段將嘗試連線清單中的下一個位址。值 -1 表示重新連線嘗試次數沒有限制 (用戶端執行階段將嘗試連線至第一個位址直到連線成功)。

    預設：3 

    ReconnectInterval

    指定兩次連線嘗試之間的間隔 (以毫秒為單位)。此屬性適用於對 AddressList 中每個位址的嘗試，及對該清單中連續位址的嘗試。如果該間隔太短，則代理程式將沒有時間恢復。如果該間隔太長，則重新連線會變得遲緩，以至於讓人無法接受。

    預設：30000 

    AddressListBehavior

    指定是按 AddressList 屬性中的位址順序 (PRIORITY) 還是按隨機順序 (RANDOM) 嘗試連線。

    RANDOM 表示重新連線將從 AddressList 中隨機選擇位址。如果許多用戶端嘗試使用同一個連線工廠來進行連線，則使用該值可以阻止它們全部連線至同一個位址。

    PRIORITY 表示重新連線時始終嘗試連線 AddressList 中的第一個伺服器位址，而僅在第一個代理程式不可用時才使用其他位址。

    預設：RANDOM

    AddressListIterations

    指定用戶端執行階段建立 (或重新建立) 連線時，在 AddressList 中反覆運算的次數。值 -1 表示嘗試次數沒有限制。

    預設：3 

  10. 在 [目標] 區域中，執行以下操作：

    1. 從 [可用] 欄中選取一個或多個目標，在這些目標上將部署使用了資源的應用程式。

      可用目標包括可用叢集和可用伺服器實例，以及預設的伺服器實例 server。

    2. 按一下 [新增] 以將目標移至 [選取] 欄中。

  11. 按一下 [確定] 以儲存連線工廠。

等效的 asadmin 指令

create-jms-resource

Procedure編輯 JMS 連線工廠資源

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [JMS 資源] 節點。

  2. 展開 [連線工廠] 節點。

  3. 選取要編輯的連線工廠。

  4. 在 [編輯 JMS 連線工廠] 頁面中，可以執行以下作業：

    • 修改 [描述] 欄位中的文字。

    • 選取或取消選取 [啟用] 核取方塊以啟用或停用資源。

    • 變更 [進階] 區域中的屬性值。

    • 新增、移除或修改特性。

  5. 此外，按一下 [目標] 標籤以移至 [JMS 連線工廠資源目標] 頁面。在此頁面中，執行以下操作：

    1. 按一下 [管理目標] 以開啟 [管理資源目標] 頁面。

      在此頁面中，在 [可用] 欄與 [選取] 欄之間移動目標。確定將目標放入 [選取] 欄中。使用了資源的應用程序將部署在這樣的目標上。可用目標包括可用的叢集和伺服器實例，以及預設的伺服器實例 server。按一下 [確定] 以儲存變更。

    2. 選取目標的核取方塊，然後按一下 [啟用] 或 [停用]，以啟用或停用目標的資源。

  6. 按一下 [儲存] 以儲存變更。

Procedure刪除 JMS 連線工廠資源

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [JMS 資源] 節點。

  2. 選取 [連線工廠] 節點。

  3. 在 [JMS 連線工廠] 頁面中，選取要刪除的連線工廠的名稱旁邊的核取方塊。

  4. 按一下 [刪除]。

等效的 asadmin 指令

delete-jms-resource