使用受管理物件

只要物件存放區連線至管理主控台，就可以繼續將受管理物件 (連線工廠及目標) 增加至此物件存放區。本節會描述作業方法。

管理主控台僅會顯示 Message Queue 受管理物件。如果物件存放區含有非 Message Queue 物件，而該物件與所需增加的受管理物件具有相同的查找名稱，則嘗試執行增加作業時，會出現錯誤。

新增連線工廠

連線工廠由用戶端應用程式使用，以建立與代理程式的連線。只要配置連線工廠，即可控制其所建連線的特性。

將連線工廠新增至物件存放區

1. 確認物件存放區已連線至管理主控台 (請參閱連線至物件存放區)。

2. 在 [管理主控台] 視窗的瀏覽窗格中，按一下該物件存放區名稱下的 [連線工廠] 項目，然後選擇 [動作] 功能表的 [增加連線工廠物件]。

   您也可以在 [連線工廠] 上按一下滑鼠右鍵，然後從快顯功能表中選擇 [增加連線工廠物件]。不論何種方式，都會出現 [增加連線工廠物件] 對話方塊 (圖 2–13)。

   圖 2–13 [增加連線工廠物件] 對話方塊

   
   

3. 在 [查找名稱] 欄位中輸入該連線工廠的名稱。

   這是用戶端應用程式透過 JNDI 查找連線工廠時所使用的名稱。

   在此練習中，請鍵入名稱 MyQueueConnectionFactory。

4. 請從 [Factory 類型] 下拉式功能表中，選擇您希望建立的連線工廠類型。

   在此練習中，請選擇 [QueueConnectionFactory]。

5. 按一下 [連線處理] 標籤。

   即會出現 [連線處理] 窗格，如圖 2–13 中所示。

6. 在 [Message Server 位址清單] 欄位中，填入將要與此連線工廠建立連線的代理程式位址。

   此位址清單可能包含一個代理程式；或在代理程式叢集的狀況下，包含多個代理程式。它會針對每個代理程式，指定代理程式連線服務、主機名稱及連接埠號等資訊。實際指定的資訊性質和語法會各有不同，需視所要使用的連線服務而定；如需詳細資訊，請參閱連線處理。

   在此練習中，不需要在 [Message Server 位址清單] 欄位中鍵入任何位址，這是因為範例應用程式 HelloWorldMessageJNDI 會讓連線工廠使用預設自動配置的標準位址清單屬性 (連線服務為 jms，主機名稱為 localhost，連接埠號為 7676 )。

7. 請視需要配置連線工廠的其他屬性。

   [增加連線工廠物件] 對話方塊除了有 [連線處理] 窗格之外，另有其他多個面板，可用以配置連線工廠的各種屬性。

   在此練習中，請勿變更其他任何屬性設定。但是，您還是可以按其他標籤，瞭解可指定的配置資訊種類，增進對此項作業的認識。請使用 [說明] 按鈕，瞭解有關這些其他配置面板的內容。

8. 在適當情況下，按一下 [唯讀] 核取方塊。

   這會鎖定連線工廠物件的配置屬性，以保持建立時所指定的值。不論是用戶端程式碼的程式設計方式或指令行的管理方式，都無法置換唯讀的受管理物件屬性。

   在此練習中，請勿核取 [唯讀]。

9. 按一下 [確定] 以建立連線工廠、將其增加至物件存放區，並結束對話方塊。

   新的連線工廠會出現在結果窗格中。

新增目標

目標受管理物件代表代理程式上的實體目標，可讓用戶端將訊息傳送至該實體目標，而不受提供者專用配置及命名語法的影響。當用戶端傳送經由受管理物件定址的訊息時，代理程式會將該訊息傳送至對應的實體目標 (如果存在)。如果上述實體目標不存在，代理程式會自動建立一個實體目標 (如果已啟用自動建立功能，如建立實體目標中所述)，並將訊息傳送至此；否則，就會產生一個錯誤，指出訊息無法傳送。

下列程序描述如何將目標受管理物件，增加至與現有實體目標相對應的物件存放區。

將目標新增至物件存放區

1. 確認物件存放區已連線至管理主控台 (請參閱連線至物件存放區)。

2. 在 [管理主控台] 視窗的瀏覽窗格中，按一下物件存放區名稱下的 [目標] 項目，然後選擇 [動作] 功能表的 [增加目標物件]。

   您也可以在 [目標] 上按一下滑鼠右鍵，然後從快顯功能表中選擇 [增加目標物件]。不論何種方式，都會出現 [增加目標物件] 對話方塊 (圖 2–14)。

   圖 2–14 [增加目標物件] 對話方塊

   
   

3. 在 [查找名稱] 欄位中，輸入該目標受管理物件的名稱。

   這是用戶端應用程式透過 JNDI 查找目標時所使用的名稱。

   在此練習中，請鍵入名稱 MyQueue。

4. 選擇 [佇列] 或 [主題] 單選按鈕，指定要建立的目標物件類型。

   在此練習中，請選擇 [佇列] (如果尚未選取)。

5. 在 [目標名稱] 欄位中，輸入對應實體目標的名稱。

   這是您將實體目標增加至代理程式時，所指定的名稱 (請參閱使用實體目標)。

   在此練習中，請鍵入名稱 MyQueueDest。

6. 在 [目標描述] 欄位中，輸入該目標的簡短說明；此為選擇性項目。

   此欄位的內容僅供使用者參考，對用戶端作業沒有任何影響。

   在此練習中，您可以刪除 [目標描述] 欄位的內容，或鍵入一些說明性文字，例如

   Example destination for MQ Admin Guide tutorial

7. 在適當情況下，按一下 [唯讀] 核取方塊。

   這會鎖定目標物件的配置屬性，以保持建立時所指定的值。不論是用戶端程式碼的程式設計方式或指令行的管理方式，都無法置換唯讀的受管理物件屬性。

   在此練習中，請勿核取 [唯讀]。

8. 按一下 [確定] 以建立目標物件、將其增加至物件存放區，並結束對話方塊。

   新的目標物件會隨即出現在結果窗格中，如圖 2–15 所示。

   圖 2–15 管理主控台視窗中顯示的目標物件

   
   

檢視受管理物件特性

您可以在 [管理主控台] 上，使用 [動作] 功能表的 [特性] 指令，檢視或修改受管理物件的特性。

檢視或修改受管理物件的特性

1. 在 [管理主控台] 視窗的瀏覽窗格中，選擇物件存放區名稱下的 [連線工廠] 或 [目標]。

   結果窗格會出現可用連線工廠或目標受管理物件的清單，其中顯示各項目的查找名稱和類型 (目標受管理物件清單另包括目標名稱)。

2. 在結果窗格中按一下受管理物件的名稱，以選擇該受管理物件。

3. 從 [動作] 功能表中選擇 [特性]。

   此時會出現 [連線工廠物件特性] 或 [目標物件特性] 對話方塊，與 [增加連線工廠物件] (圖 2–13) 或 [增加目標物件] (圖 2–14) 對話方塊類似。您可使用此對話方塊，變更所選取物件的配置屬性。但請注意，您無法變更物件的查找名稱；唯一的方法是刪除該物件，然後再以所需的查找名稱增加新的受管理物件。

4. 按一下 [確定] 以接受新的屬性值，並結束對話方塊。

刪除受管理物件

刪除受管理物件會將其從所屬物件存放區中永久移除。

刪除受管理物件

1. 在 [管理主控台] 視窗的瀏覽窗格中，選擇物件存放區名稱下的 [連線工廠] 或 [目標]。

   結果窗格會出現可用連線工廠或目標受管理物件的清單，其中顯示各項目的查找名稱和類型 (目標受管理物件清單另包括目標名稱)。

2. 請在結果窗格中按一下受管理物件的名稱，以選擇該受管理物件。

3. 從 [編輯] 功能表中選擇 [刪除]。

   此時會出現確認對話方塊，要求您確認是否繼續該作業。

4. 按一下 [是] 以確認作業，並結束確認對話方塊。

   在此練習中，請勿刪除先前建立的受管理物件 MyQueue 或 MyQueueConnectionFactory；請按一下 [否] 結束確認對話方塊，以免執行刪除作業。