在其他 Eclipse 環境中收集 IBM MQ Explorer 追踪

透過使用 runwithtrace 指令的變式,您可以從安裝到您自己的 Eclipse 環境或 Eclipse型產品中的 IBM® MQ Explorer 實例收集追蹤。

開始之前

這項作業假設您已將 IBM MQ Explorer 安裝到您自己的 Eclipse 環境或 Eclipse型產品中,因此無法依照 收集 IBM MQ 探險家追蹤中的說明來使用標準 runwithtrace 指令。

關於此作業

IBM MQ Explorer 可以安裝到您自己的 Eclipse 環境或 Eclipse 型產品中,以協助開發 Java 應用程式,或開發您自己的延伸規格。

若要收集追蹤,您可以使用 runwithtrace 指令來啟動 IBM MQ Explorer。 您無法使用產品隨附的 runwithtrace 指令。 相反地,您可以使用指令的變式,如下列程序所述。

附註: 通常只有在 IBM 客戶服務代表要求啟用追蹤時,才會啟用追蹤。 追蹤會減緩 IBM MQ Explorer 的速度,而且追蹤檔可能會快速變得很大。

程序

  1. IBM MQ Explorer 追蹤機制依賴於所安裝的 AspectJ 及 Equinox Weaving 外掛程式。 若要確認是否安裝這些外掛程式:
    1. 按一下 說明
    2. 按一下 關於 ...
    3. 按一下 安裝詳細資料
    4. 按一下 外掛程式 標籤。
    org.eclipse.equinox.weaving.caching.j9 外掛程式不再存在,但如果您使用 IBM MQ 9.0.4 之前的 IBM MQ 9.0 Long Term SupportIBM MQ 9.0 Continuous Delivery 版本,則需要此外掛程式。
    驗證是否安裝下列外掛程式:
    
    	org.aspectj.runtime
    	org.aspectj.weaver
    
    	org.eclipse.equinox.weaving.aspectj
    	org.eclipse.equinox.weaving.caching
    	org.eclipse.equinox.weaving.caching.j9
    	org.eclipse.equinox.weaving.hook
    
  2. 如果尚未安裝,請安裝 AspectJ 及 Equinox Weaving 外掛程式。 這些外掛程式必須符合您所使用的 Eclipse 版本,且可從「Eclipse AspectJ 開發工具」下載網站進行下載。 若要判斷您的 Eclipse版本要使用的下載網站,請參閱 https://projects.eclipse.org/projects/tools.ajdt

    如需建置 IBM MQ Explorer 之 Eclipse 層次的相關資訊,請參閱 IBM MQ 探險家中的新增功能及變更內容

    目前,這些建置僅以開發建置形式提供,您應選取可用的最新建置。

    若要安裝 AspectJ 和 Equinox Weaving 外掛程式,請完成下列子步驟:
    1. 按一下 說明 ,然後按一下 安裝新軟體 ...
    2. 按一下 新增 ... 然後輸入適用於 Eclipse 版本的下載網站位置。
      例如,對於 Eclipse 4.4,輸入 https://download.eclipse.org/tools/ajdt/44/dev/update
    3. 按一下 確定
      即會顯示可用軟體清單。
    4. 展開 其他 AJDT 工具 (選用) 種類,然後選取 AspectJ 編譯器及 Equinox Weaving SDK
    5. 下一步 ,並遵循精靈指示。
  3. 追蹤 IBM MQ Explorer

    使用 runwithtrace Script 關閉並重新啟動 IBM MQ Explorer 。 如需適用於 Windows 作業系統的 Script ,請參閱 適用於 Windows 的 runwithtrace 指令 Script。 如需適用於 Linux® 作業系統的 Script ,請參閱 適用於 Linux

    必須從包含 Eclipse 執行檔的目錄執行此 Script。

    當您使用 runwithtrace 指令來啟動 IBM MQ Explorer 時,會納入可啟用 IBM MQ Explorer追蹤的額外參數。 請注意,runwithtrace 指令本身不採用任何參數。

    執行指令時,追踪檔的輸出位置會列印到指令行,因為實際位置相依於
    • IBM MQ 安裝的狀態。
    • 使用者許可權。

    IBM MQ Explorer 追蹤檔的名稱格式為 AMQYYYYMMDDHHmmssmmm.TRC.n,指出追蹤階段作業的開始時間。 當追蹤檔達到其大小上限時,追蹤機能會將檔案字尾 .n 加 1,以重新命名階段作業中的所有追蹤檔。 然後,追蹤機能會建立字尾為 .0 的新檔案,其中包含最新追蹤。

  4. 解除安裝 AspectJ 及 Equinox Weaving 外掛程式。 當您完成 IBM MQ Explorer 追蹤時,可以從「 Eclipse 」環境中移除「 AspectJ 」及 Equinox Weaving 外掛程式。 若要解除安裝 AspectJ 及 Equinox Weaving 外掛程式:
    1. 按一下 說明 ,然後按一下 關於 ...
    2. 按一下 安裝詳細資料 ,然後按一下 已安裝軟體 標籤。
    3. 選取項目 AspectJ ComplierEquinox Weaving SDK
    4. 按一下 解除安裝 ... 並遵循精靈指示。