第 8 章管理受管理物件

使用受管理物件可允許對移植到其他 JMS 提供者的用戶端應用程式進行開發。受管理物件可封裝提供者特定的配置和命名資訊。

Message Queue 管理員通常會為用戶端應用程式建立受管理物件，使其能夠與代理程式建立連線。用戶端應用程式會使用連線來向實體目標傳送訊息並從實體目標接收訊息。

本章介紹如何使用物件管理員公用程式 (imqobjmgr) 以執行這些工作。因為這些工作涉及您使用的物件儲存與您建立的受管理物件之屬性理解，在描述如何使用 imqobjmgr 管理受管理物件前，本章會先提供這兩個主題的背景。

關於物件儲存

關於受管理物件屬性

使用物件管理員公用程式 (imqobjmgr)

關於物件儲存

受管理物件放在即時可用的物件儲存中，用戶端應用程式可透過 JNDI 查找來存取此處的受管理物件。您可以使用兩種類型的物件儲存︰標準的 LDAP 目錄伺服器或檔案系統物件儲存。

LDAP 伺服器物件儲存

LDAP 伺服器是用於生產訊息傳送系統的建議物件儲存。LDAP 實作可從一些供應商處獲得，並設計為在分散式系統中使用。LDAP 伺服器也在生產環境中提供有利的安全性功能。

Message Queue 管理工具可管理 LDAP 伺服器上的物件儲存。然而，依 LDAP 伺服器文件規定，您可能必須先配置 LDAP 伺服器，以便儲存 Java 物件與執行 JNDI 查找。

使用 LDAP 伺服器作為物件儲存時，您必須指定表 8-1 中顯示的屬性。這些屬性分為以下幾個種類：

初始環境：此屬性的值針對 LDAP 伺服器物件儲存進行修正。

位置：指定 LDAP 伺服器中，設定用來儲存您受管理物件的 URL 與目錄路徑。要特別注意的是，您必須檢查指定的路徑是否存在。

安全性資訊：根據 LDAP 提供者而異。您應查閱 LDAP 實作隨附的文件，以確定是否在所有作業上還是僅在變更已儲存資料的作業上需要安全性資訊。

表 8-1 LDAP 物件儲存屬性
屬性	說明
java.naming.factory.initial	LDAP 伺服器上 JNDI 查找的初始環境 com.sun.jndi.ldap.LdapCtxFactory
java.naming.provider.url	LDAP 伺服器 URL 與目錄路徑資訊。例如： ldap://mydomain.com:389/ou=mqobjs,o=myapp 受管理物件儲存於 /myapp/mqobjs 目錄中。
java.naming.security. principal	認證 LDAP 伺服器之呼叫者的負責人的身份。此項目的格式取決於認證方案。例如： uid=fooUser, ou=People, o=mq 如果沒有指定此特性，則運作方式將由 LDAP 服務提供者決定。
java.naming.security. credentials	認證 LDAP 伺服器之呼叫者的負責人的憑證。此特性的值取決於認證方案：它可以是雜湊密碼、清除文字密碼、密鑰以及憑證等。例如： fooPasswd 如果沒有指定此特性，則運作方式將由 LDAP 服務提供者決定。
java.naming.security. authentication	要使用的安全性級別。它的值為以下其中一各關鍵字：none、simple 和 strong。舉例來說，如果您指定 simple，則會提示您任何遺漏的負責人或憑證值。這可讓您以更安全的方式提供識別資訊。如果沒有指定此特性，則運作方式將由 LDAP 服務提供者決定。

檔案系統物件儲存

Message Queue 還支援檔案系統物件儲存實作。當檔案系統物件儲存未經過完全測試並因此不建議用於生產系統時，它的優點是易於在開發環境中使用。您所要做的是在您的本機檔案系統上建立目錄，而不是設定 LDAP 伺服器。

但是，檔案系統儲存不可作為部署在多重電腦節點之用戶端的集中物件儲存，除非這些用戶端可以存取物件儲存所在的目錄。除此之外，任何對此目錄擁有存取權的使用者均可使用 Message Queue 管理工具，以建立並管理受管理物件。

使用檔案系統物件儲存時，您必須指定表 8-2 中顯示的屬性。這些屬性分為以下幾個種類：

初始環境：此屬性的值針對檔案系統物件儲存進行修正。

位置：此屬性的值指定儲存您受管理物件的目錄路徑。該目錄必須存在，且 Message Queue 管理工具的使用者與用戶端應用程式的使用者皆擁有適當的存取許可權，以便存取儲存。

表 8-2 檔案系統物件儲存屬性
屬性	說明
java.naming.factory. initial	檔案系統物件儲存上 JNDI 查找的初始環境： com.sun.jndi.fscontext.RefFSContextFactory
java.naming.provider.url	目錄路徑資訊例如： file:///C:/myapp/mqobjs

關於受管理物件屬性

連線工廠受管理物件可由用戶端應用程式使用，以建立與代理程式的連線。

目標受管理物件可由用戶端應用程式使用，以識別生產者傳送訊息或用戶擷取訊息的目標。

Message Queue 提供兩種管理工具，用於建立和管理受管理物件：指令行物件管理員公用程式 (imqobjmgr) 和 GUI管理主控台。本章只描述如何使用指令行。

連線工廠屬性

連線工廠的配置會傳送至所有由連線工廠建立作為用戶端應用程式的連線。連線已配置成定義傳送或接收訊息的一方，可指定用戶端執行階段如何處理訊息流量，並為經由連線傳送的全部訊息自動設定某些資訊。

ConnectionFactory 支援一般訊息傳送和非分散式作業事件。

XAConnectionFactory 支援分散式作業事件。

連線工廠物件可由管理員或應用程式建立和配置 (以建立原型或測試為目的)。您可以使用 imqobjmgr 工具或管理主控台來設定連線工廠屬性。

本節描述以下各章節中的連線工廠屬性，這些章節是由屬性影響的運作方式所架構的。

與您有主要關係的屬性為 imqAddressList，它可用於指定用戶端將與其建立連線的代理程式。新增連線工廠一節介紹當您將連線工廠受管理物件新增至您的物件儲存時，如何指定屬性。

如需連線工廠屬性的參照資訊，請參閱第 16 章「受管理物件屬性參照」和 Message Queue 類別 com.sun.messaging.ConnectionConfiguration 的 JavaDoc API 文件。

連線處理

您可使用連線處理的屬性來指定要連線的訊息伺服器位址，如果需要重新連線，則要指定嘗試重新連線的次數，以及連線嘗試之間的間隔時間。

用戶端所連線的訊息伺服器位址，是您指定為 imqAddressList 屬性的數值。訊息伺服器位址包含代理程式主機名稱、連接埠號和連線服務類型。

連接埠的編號可以是代理程式的連接埠對映器常駐的連接埠，或是特定連線服務常駐的連接埠。如果您指定了連接埠對映器的連接埠，連接埠對映器會動態指定連線用的連接埠。如需指定訊息伺服器位址的完整資訊，請參閱 imqAddressList 屬性值的語法。

自動重新連線

在單一代理程式環境或多重代理程式叢集環境中，您可以設定當連線失敗時，讓用戶端能夠自動重新連線至代理程式的連線處理屬性。您也可以配置重新連線的程序。

重新連線功能可提供連線防故障備用，但不提供資料防故障備用：當用戶端自動重新連線至不同的代理程式實例時，失敗或斷線代理程式所保留的永久性訊息和其他狀態資訊將會遺失。

如果自動重新連線啟用的話，Message Queue 會在連線失敗時保留暫存目標，以防用戶端可能會重新連線和再次存取。在讓用戶端有時間進行重新連線並使用這些目標之後，代理程式將刪除這些目標。

處理重新連線的方法取決於用戶端連線至單一代理程式，或是連線至叢集一部分的代理程式。以下各節描述了各種可能性。

重新連線至單一代理程式若要讓用戶端能在連線失敗時自動重新連線至代理程式，您必須設定以下的連線工廠屬性：

imqReconnectEnabled。啟用自動重新連線運作方式。

imqReconnectAttempts。指定用戶端執行階段嘗試重新連線至用戶端的次數。

imqReconnectInterval。指定嘗試重新連線至用戶端的間隔時間。

重新連線至叢集中的代理程式在多重代理程式叢集的環境中，如果您指定 imqAddressList 屬性的多重位址，將重複自動重新連線清單中的代理程式。清單中的所有代理程式都必須以 Message Queue Enterprise Edition 安裝。

如果用戶端連線至清單中的第一個位址時失敗，用戶端執行階段會嘗試重新連線至清單中的另一個代理程式。如果嘗試連線失敗，用戶端執行階段會繼續在清單中逐一連線，直到能夠重新連線至用戶端為止。

如果嘗試連線不成功，用戶端執行階段會以指定的次數在清單中循環連線，直到找到可用的代理程式或無法找到任何的代理程式為止。imqAddressListBehavior 屬性的設定會決定，是要依照位址清單中的順序選擇重新連線的代理程式，還是在清單中隨機選擇。

若要讓用戶端能重新連線至叢集中的代理程式，請使用以下的屬性：

imqReconnectEnabled。啟用自動重新連線運作方式。

imqReconnectAttempts。指定在跳至下一個代理程式的位址之前，嘗試連線每個位址的次數。

imqReconnectInterval。指定嘗試重新連線的間隔時間。

imqAddressListIterations。指定在清單中重複連線的次數。

imqAddressListBehavior。指定嘗試連線的次序為依據位址清單中的位址次序或是隨機次序。

連線偵測

imqPingInterval 屬性可指定從用戶端執行階段到代理程式的偵測作業頻率。用戶端執行階段會不定期測試連線，以預先偵測到失敗的連線。如果偵測作業失敗，用戶端執行階段會拋出異常至用戶端應用程式的異常偵聽程式物件中。如果應用程式中沒有異常偵聽程式，則下一個使用連線的嘗試會失敗。

偵測功能對於那些等待接收訊息而無法傳送訊息的使用者用戶端應用程式來說，特別的重要。否則這些應用程式將無法得知連線何時會失敗。不定期產生訊息的用戶端也可因此功能而受惠，因為它可以在需要傳送訊息之前處理失敗的連線。

對於連線中斷的回應會根據特定的作業系統而有所差異。例如，在一些作業系統上，偵測會立即報告失敗的情況。其他的作業系統可能會繼續嘗試建立與代理程式的連線，緩衝連續的偵測，直到偵測成功或緩衝區溢位。

用戶端標識

Message Queue 會定義一組連線工廠屬性，以支援用戶端認證和唯一的用戶端 ID 設定，這是長期用戶所必需的。

嘗試連線至代理程式的用戶端必須經過認證。如果用戶端在建立連線時並未指定使用者名稱或密碼，會發生以下其中一種情況：

如果您未設定連線工廠屬性 imqDefaultUsername 和 imqDefaultPassword，用戶端執行階段會將數值 guest/guest 傳送至代理程式，而代理程式會使用這些數值來認證用戶端。

此使用者儲存庫出廠時隨附了 guest/guest 項目，所以用戶端將可取得連線。

如果您已設定連線工廠屬性 imqDefaultUsername 和 imqDefaultPassword，用戶端執行階段會將這些數值傳送至代理程式，而代理程式會使用這些數值來認證用戶端。

如果這對使用者/密碼位於使用者儲存庫中，則用戶端可取得連線。

此方案可允許任何使用者取得連線，這對於開發與測試來說非常的方便。在生產系統中，僅限於已新增至使用者儲存庫的使用者才能存取連線。

除了請求連線的用戶端之代理程式認證以外，JMS 規格會需要在維護用戶端狀態時，該連線能提供唯一的用戶端識別碼。Message Queue 使用用戶端 ID 來記錄長期用戶。如果長期用戶成為非使用中的用戶，代理程式會保留該用戶的訊息，等到用戶恢復作用時再傳送這些訊息。代理程式會藉由用戶端 ID 來識別用戶。

您可以使用管理級別設定 ClientID，或者用戶端可有計劃地設定 ClientID。如果多重用戶端從相同的連線工廠取得連線，請為連線工廠設定 ClientID。Message Queue 將能為每個從該工廠取得的連線提供唯一的 ClientID。

若要確保 ClientID 為唯一的值，請使用以下的格式來設定 imqConfiguredClientID屬性：

${u} 必須為屬性值的前四個字元。如果不是出現 "u" 的字元，在建立連線時會發生 JMS 異常。

string 數值是您要與連線工廠所生產的連線發生關聯的數值，例如 Xconn。在使用者認證階段，Message Queue 會以 u:userName 替代 u。例如，如果與連線有關聯的使用者為 Athena 而指定給連線的字串為 ${u}Xconn，則 ClientID 將為 u:AthenaXconn。

此方案將可確保每個由連線工廠所產生的連線都將包含 ClientID。

有一種方案無法運作的情況：如果兩個用戶端使用如 guest 的預設使用者名稱來取得連線，則都會有相同 ${u} 元件的 ClientID。在執行階段中，第一個要求連線的用戶端可取得連線，第二個則不行，因為 MQ 無法以非唯一的 ClientID 來建立連線。

您可以設定 imqDisableSetClientID 屬性，以防止使用連線工廠的用戶端有計劃地變更已配置用戶端 ID。

您必須設定長期訂閱的 imqConfiguredClientID 屬性，除非應用程式使用的是 setClientId() 方法。

imqDefaultUsername。當用戶端未指定建立連線的使用者名稱時，可指定由代理程式認證的預設使用者名稱。

imqDefaultPassword.當用戶端未指定建立連線的密碼時，可指定由代理程式認證的預設密碼。

imqConfiguredClientID。指定以管理級別配置的用戶端 ID 值。

imqDisableSetClientID。指定使用連線工廠的用戶端是否可以有計劃地變更用戶端 ID。

可靠性和流量控制

用戶端傳送和接收的訊息與 Message Queue 所使用的控制訊息，皆會忽略相同用戶端與代理程式間的連線。如果 JMS 訊息傳送阻擋控制訊息，則會造成控制訊息 (例如代理程式確認) 傳送的延遲。

您可以設定連線工廠屬性，讓您管理與用戶端訊息流量相關的控制訊息流量。控制這兩種訊息的流量涉及流量與可靠性之間的洩漏。如需如何使用這些屬性以管理流量控制與可靠性的說明，請參閱用戶端執行階段訊息流量調整。

imqAckTimeout。指定 (以毫秒為單位) 用戶端執行階段等待任何代理程式回應的最長時間。

imqConnectionFlowCount。指定計數批次中的最大 JMS 訊息數。

imqConnectionFlowLimitEnabled。限制連線層級的訊息流量。

imqConnectionFlowLimit。指定可透過連線傳送的，以及可以在用戶端執行階段緩衝待用的訊息數量限制。

imqConsumerFlowLimit。指定每個用戶可透過連線傳送的，以及可以在用戶端執行階段緩衝待用的訊息數量限制。

imqConsumerFlowThreshold。指定 imqConsumerFlowLimit 的百分比，此為用戶端執行階段緩衝的每位用戶之訊息數，低於該值時，便會繼續傳送訊息給用戶。

佇列瀏覽器運作方式和伺服器階段作業

imqQueueBrowserMaxMessagesPerRetrieve。指定瀏覽佇列目標內容時，用戶端一次將擷取的最大訊息數量。

imqQueueBrowserRetrieveTimeout。指定瀏覽佇列目標內容時，用戶端擷取訊息所需等待的時間。

imqLoadMaxToServerSession. JMS 應用程式伺服器設備，指定 Message Queue ConnectionConsumer 是否應該將 maxMessages 上載到 ServerSession 階段作業，或一次載入一個訊息。

JMS 定義的特性支援

您可以使用連線工廠屬性，在連線所產生的訊息上自動設定 JMS 定義的特性。JMS 特性是在 JMS 規格中所定義，位於 http://java.sun.com/products/jms/docs.html。

imqSetJMSXUserID。對已產生的訊息，指定 Message Queue 是否要設定 JMS 定義的特性 JMSXUserID (傳送訊息的使用者識別)。

imqSetJMSXAppID。對已產生的訊息，指定 Message Queue 是否要設定 JMS 定義的特性 JMSXAppID (傳送訊息的應用程式識別)。

imqSetJMSXProducerTXID。對已產生的訊息，指定 Message Queue 是否要設定 JMS 定義的特性 JMSXProducerTXID (產生了此訊息的作業事件處理識別碼)。

imqSetJMSXConsumerTXID。對已使用的訊息，指定 Message Queue 是否要設定 JMS 定義的特性 JMSXConsumerTXID (使用了此訊息的作業事件處理識別碼)。

imqSetJMSXRcvTimestamp。對已使用的訊息，指定 Message Queue 是否要設定 JMS 定義的特性 JMSXRcvTimestamp (訊息傳送至用戶的時間)。

JMS 訊息標頭覆寫

您可以設定連線工廠的屬性，以覆寫指定訊息的永久性、使用期限和優先權的 JMS 訊息標頭欄位。此設定是用於從連線工廠取得的連線所生產之訊息。

JMSDeliveryMode (訊息永久性/非永久性)

JMSExpiration (訊息使用期限)

JMSPriority (訊息優先順序 - 整數 0 到 9)

由於覆寫這些訊息標頭可能會干擾應用程式需求，請先諮詢應用程式使用者或設計者再使用此功能。

下表包含了處理訊息覆寫的連線工廠屬性。大部分的屬性都是成對的。每對的第一個屬性可指定是否能覆寫已指定的標頭欄位，第二個屬性則指定覆寫值。

imqOverrideJMSDeliveryMode 和 imqJMSDeliveryMode。第一個屬性指定是否可覆寫用戶端設定的 JMSDeliveryMode 欄位，第二個屬性則指定其覆寫值。

imqOverrideJMSExpiration 和 imqJMSExpiration。第一個屬性指定是否可覆寫用戶端設定的 JMSExpiration 欄位，第二個屬性則指定其覆寫值。

imqOverrideJMSPriority 和 imqJMSPriority。第一個屬性指定是否可覆寫用戶端設定的 JMSPriority 欄位，第二個屬性則指定其覆寫值。

imqOverrideJMSHeadersToTemporaryDestinations。指定臨時目標是否套用覆寫。

目標受管理物件屬性

目標受管理物件識別實體主題或佇列目標，其具有表 16-1 中列出的屬性。新增主題佇列一節介紹當您將目標受管理物件新增至您的物件儲存時，如何指定這些屬性。

與您有主要關係的屬性為 imqDestinationName。這是您指定給符合主題或佇列受管理物件的實體目標的名稱。您還可以提供目標描述，這會幫助您將此目標與您可能建立以支援許多應用程式的其他目標區分開來。

如需更多資訊，請參閱用於 Message Queue 類別 com.sun.messaging.DestinationConfiguration 的 JavaDoc API 文件。

使用物件管理員公用程式 (imqobjmgr)

物件管理員公用程式可讓您建立並管理 Message Queue 受管理物件。使用此公用程式，您可以執行以下工作：

新增或刪除物件儲存中的受管理物件。

列出現有受管理物件。

查詢並顯示有關受管理物件的資訊。

修改物件儲存中的現有受管理物件。

如需 imqobjmgr 指令的語法、子指令和選項的詳細資訊，請參閱第 13 章「指令參照」。下節描述使用任何 imqobjmgr 子指令時需要提供的資訊。

需要的資訊

當執行與受管理物件相關的大部分工作時，您必須將以下資訊指定為 imqobjmgr 子指令的選項：

受管理物件類型

受管理物件的 JNDI 查找名稱 ：

受管理物件屬性 (add 與 update 子指令特別需要)：

對於目標：代理程式上實體目標的名稱。這是使用 imqcmd create dst 子指令的 -n 選項指定的名稱。如果您沒有指定此名稱，則將使用 Untitled_Destination_Object 的預設名稱。

對於連線工廠：大部分的通用屬性為位址清單 (imqAddressList)，它可指定用戶端嘗試連線的訊息伺服器位址 (一個或多個)。如果您沒有指定此資訊，則會使用本地主機與預設連接埠號 (7676)，這表示用戶端將會連線到本地主機連接埠 7676 上的代理程式。新增連線工廠一節介紹如何指定物件屬性。

如需其他屬性，請參閱連線工廠屬性。

物件儲存屬性

此資訊取決於您要使用檔案系統儲存還是 LDAP 伺服器，但必須包括以下屬性：

JNDI 實作的類型 (初始環境屬性)。例如，檔案系統或 LDAP。

物件儲存中受管理物件的位置 (提供者 URL 屬性)，即它所在的「資料夾」。

存取物件儲存所需的使用者名稱、密碼和授權類型 (如果有)。

使用指令檔

imqobjmgr 指令可讓您指定使用 Java 特性檔案語法的指令檔的名稱，以表示所有或部分 imqobjmgr 子指令子句。

將指令檔與物件管理員公用程式 (imqobjmgr) 配合使用，對指定物件儲存屬性極為有用，這可能與跨 imqobjmgr 的多重呼叫一樣，並且一般需要大量的鍵入。使用指令檔還可讓您避免鍵入可能超出指令行所允許的最大字元數的情況。

imqobjmgr 指令檔的一般語法如下 (版本特性會反映指令檔版本，但不會反映 Message Queue 產品的版本 - 不是指令行選項 - 它的值必須設定成 2.0)：


version=2.0
cmdtype=[ add \| delete \| list \| query \| update ]
obj.type=[ q \| t \| qf \| tf \| cf \| xqf \| xtf \| xcf \| e ]
obj.lookupName=lookup name
obj.attrs.objAttrName1=value1
obj.attrs.objAttrName2=value2
obj.attrs.objAttrNameN=valueN
…
objstore.attrs.objStoreAttrName1=value1
objstore.attrs.objStoreAttrName2=value2
objstore.attrs.objStoreAttrNameN=valueN
…


imqobjmgr add
-t qf
-l "cn=myQCF"
-o "imqAddressList=mq://foo:777/jms"
-j "java.naming.factory.initial=
com.sun.jndi.ldap.LdapCtxFactory"
-j "java.naming.provider.url=
ldap://mydomain.com:389/o=imq"
-j "java.naming.security.principal=
uid=fooUser, ou=People, o=imq"
-j "java.naming.security.credentials=fooPasswd"
-j "java.naming.security.authentication=simple"

此指令可封裝在檔案 (如 MyCmdFile) 中，此檔案具有以下內容：


version=2.0
cmdtype=add
obj.type=qf
obj.lookupName=cn=myQCF
obj.attrs.imqAddressList=mq://foo:777/jms
objstore.attrs.java.naming.factory.initial=\
com.sun.jndi.ldap.LdapCtxFactory
objstore.attrs.java.naming.provider.url=\
ldap://mydomain.com:389/o=imq
objstore.attrs.java.naming.security.principal=\
uid=fooUser, ou=People, o=imq
objstore.attrs.java.naming.security.credentials=fooPasswd
objstore.attrs.java.naming.security.authentication=simple

然後，您可以使用 -i 選項將此檔案傳送至物件管理員公用程式 (imqobjmgr)：

您還可以使用指令檔指定某些選項，同時使用指令行指定其他選項。這可讓您使用指令檔指定部分子指令子句，這與跨公用程式的許多呼叫一樣。例如，以下指令指定新增連線工廠受管理物件所需的所有選項 (指定要在何處儲存受管理物件的那些選項除外)。


version=2.0
objstore.attrs.java.naming.factory.initial=\
com.sun.jndi.ldap.LdapCtxFactory
objstore.attrs.java.naming.provider.url=\
ldap://mydomain.com:389/o=imq
objstore.attrs.java.naming.security.principal=\
uid=fooUser, ou=People, o=imq
objstore.attrs.java.naming.security.credentials=fooPasswd
objstore.attrs.java.naming.security.authentication=simple

新增和刪除受管理物件

本節介紹如何將連線工廠和主題或佇列目標的受管理物件新增至物件儲存。

新增連線工廠

若要啟用用戶端應用程式以便與代理程式建立連線，您需要新增表示用戶端應用程式所需連線類型的受管理物件：主題連線工廠或佇列連線工廠


備註	物件管理員公用程式 (imqobjmgr) 僅列出並顯示 Message Queue 受管理物件。如果物件儲存應包含的非 Message Queue 物件與您想新增的受管理物件具有相同的查找名稱，那麼當您嘗試新增作業時會出現錯誤。


imqobjmgr add
-t qf
-l "cn=myQCF"
-o "imqAddressList=mq://myHost:7272/jms"
-j "java.naming.factoryinitial=
com.sun.jndi.ldap.LdapCtxFactory"
-j "java.naming.provider.url=ldap://mydomain.com:389/o=imq"
-j "java.naming.security.principal=
uid=fooUser, ou=People, o=imq"
-j "java.naming.security.credentials=fooPasswd"
-j "java.naming.security.authentication=simple"

上述指令建立查找名稱為 cn=myQCF 的受管理物件，此物件將連線至在 myHost 上執行的代理程式，並偵聽連接埠 7272。受管理物件儲存在 LDAP 伺服器中。您可以透過將指令檔指定為 imqobjmgr 指令的引數來完成相同的作業。如需更多資訊，請參閱使用指令檔。


備註	命名慣例：如果您要使用 LDAP 伺服器儲存受管理物件，則指定字首為「cn=」的查找名稱很重要 (如上述範例所示：cn=myQCF)。您可以使用 -l 選項指定查找名稱。如果您正在使用檔案系統物件儲存，那麼您不需使用 cn 字首，但請勿使用包含「/」的查找名稱。請參閱表 8-3。

表 8-3 命名慣例範例
物件儲存類型	正確名稱	錯誤名稱
LDAP 伺服器	cn=myQCF	myQCF
檔案系統	myTopic	myObjects/myTopic

新增主題佇列

若要啟用用戶端應用程式以存取代理程式上的實體目標，您需要將可識別這些目標的受管理物件新增至物件儲存。

在將相應的受管理物件新增至物件儲存前，最好先建立實體目標。使用指令公用程式 (imqcmd) 以在代理程式上建立實體目標，這些實體目標可由物件儲存中的目標受管理物件識別。如需有關建立實體目標的資訊，請參閱取得有關連線的資訊。

以下指令新增可識別主題目標的受管理物件，此主題目標的查找名稱為 myTopic，實體目標名稱為 TestTopic。受管理物件儲存在 LDAP 伺服器中。


imqobjmgr add
-t t
-l "cn=myTopic"
-o "imqDestinationName=TestTopic"
-j "java.naming.factory.initial=
com.sun.jndi.ldap.LdapCtxFactory"
-j "java.naming.provider.url=
ldap://mydomain.com:389/o=imq"
-j "java.naming.security.principal=
uid=fooUser, ou=People, o=imq"
-j "java.naming.security.credentials=fooPasswd"
-j "java.naming.security.authentication=simple"

這是相同的指令，只是受管理物件儲存在 Solaris 檔案系統中：


imqobjmgr add
-t t
-l "cn=myTopic"
-o "imqDestinationName=TestTopic"
-j "java.naming.factory.initial=
com.sun.jndi.fscontext.RefFSContextFactory"
-j "java.naming.provider.url=
file:///home/foo/imq_admin_objects"

例如，在 LDAP 伺服器一例中，您可以使用指令檔 MyCmdFile 以指定子指令子句。此檔案將包含以下文字：


version=2.0
cmdtype=add
obj.type=t
obj.lookupName=cn=myTopic
obj.attrs.imqDestinationName=TestTopic
objstore.attrs.java.naming.factory.initial=
com.sun.jndi.fscontext.RefFSContextFactory
objstore.attrs.java.naming.provider.url=
file:///home/foo/imq_admin_objects
objstore.attrs.java.naming.security.principal=
uid=fooUser, ou=People, o=imq
objstore.attrs.java.naming.security.credentials=fooPasswd
objstore.attrs.java.naming.security.authentication=simple

刪除受管理物件


備註	如果您要使用 LDAP 伺服器儲存受管理物件，則指定字首為「cn=」的查找名稱很重要 (如上述範例所示)。您可以使用 -l 選項指定查找名稱。如果您要使用檔案系統物件儲存，則無需使用此字首。

使用 delete 子指令以刪除受管理物件。您必須指定物件的查找名稱、類型和位置。

以下指令刪除某主題的受管理物件，此主題的查找名稱為 cn=myTopic，並儲存在 LDAP 伺服器上。


imqobjmgr delete
-t t
-l "cn=myTopic"
-j "java.naming.factory.initial=
com.sun.jndi.ldap.LdapCtxFactory"
-j "java.naming.provider.url=
ldap://mydomain.com:389/o=imq"
-j "java.naming.security.principal=
uid=fooUser, ou=People, o=imq"
-j "java.naming.security.credentials=fooPasswd"
-j "java.naming.security.authentication=simple"

列出受管理物件

使用 list 子指令以取得所有受管理物件的清單，或取得特定類型的所有受管理物件的清單。以下範例程式碼假設受管理物件儲存在 LDAP 伺服器中。


imqobjmgr list
-j "java.naming.factory.initial=
com.sun.jndi.ldap.LdapCtxFactory"
-j "java.naming.provider.url=
ldap://mydomain.com:389/o=imq"
-j "java.naming.security.principal=
uid=fooUser, ou=People, o=imq"
-j "java.naming.security.credentials=fooPasswd"
-j "java.naming.security.authentication=simple"


imqobjmgr list
-t q
-j "java.naming.factory.initial=
com.sun.jndi.ldap.LdapCtxFactory"
-j "java.naming.provider.url=
ldap://mydomain.com:389/o=imq"
-j "java.naming.security.principal=
uid=fooUser, ou=People, o=imq"
-j "java.naming.security.credentials=fooPasswd"
-j "java.naming.security.authentication=simple"

取得有關單一物件的資訊

使用 query 子指令，以取得有關受管理物件的資訊。您必須指定物件的查找名稱和包含受管理物件的物件儲存的屬性 (如初始環境和位置)。

在以下範例中，query 子指令用來顯示有關查找名稱為 cn=myTopic 之物件的資訊。


imqobjmgr query
-l "cn=myTopic"
-j "java.naming.factory.initial=
com.sun.jndi.ldap.LdapCtxFactory"
-j "java.naming.provider.url=
ldap://mydomain.com:389/o=imq"
-j "java.naming.security.principal=
uid=fooUser, ou=People, o=imq"
-j "java.naming.security.credentials=fooPasswd"
-j "java.naming.security.authentication=simple"

更新受管理物件

您可以使用 update 指令修改受管理物件的屬性。您必須指定物件的查找名稱和位置。您可以使用 -o 選項修改屬性值。


imqobjmgr update
-t tf
-l "cn=MyTCF"
-o imqReconnectAttempts=3
-j "java.naming.factory.initial=
com.sun.jndi.ldap.LdapCtxFactory"
-j "java.naming.provider.url=
ldap://mydomain.com:389/o=imq"
-j "java.naming.security.principal=
uid=fooUser, ou=People, o=imq"
-j "java.naming.security.credentials=fooPasswd"
-j "java.naming.security.authentication=simple"

上一頁目錄索引下一頁
Sun Java System Message Queue 3 2005Q1 管理指南