========================================================================
* IBM(R) IBM Debugger for AIX, Version 6.1
* (C) COPYRIGHT International Business Machines Corp. 2006, 2008
* All Rights Reserved
* Licensed Materials - Property of IBM
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
* AIX and IBM are trademarks of IBM Corp.
*
* Other company, product, and service names may be trademarks or service
* marks of others.
========================================================================

IBM Debugger for AIX 6.1 版對於在 AIX 第 5 版執行的 C/C++ 應用程式支援本端和遠端除錯。在 AIX 機器上執行的應用程式，可以從相同機器上執行的除錯器使用者介面中進行除錯，或從另一部 AIX 或 Windows 機器進行遠端除錯。

本文件包含下列幾節：

• 必備軟體
• 安裝 IBM Debugger for AIX
• 解除安裝 IBM Debugger for AIX
• IBM Debugger for AIX 6.1 版的最新功能
• 啟動除錯階段作業
• 存取 IBM Debugger for AIX 文件
• IBM Debugger for AIX 限制

必備軟體

AIX 用戶端安裝

AIX 用戶端需要 AIX 5.2 版（AIX 5200-07 或更新版本）或 AIX 5.3 版（AIX 5300-03 或更新版本）。

若要測試是否支援此安裝平台，請在系統提示鍵入 lscfg -p | fgrep Architecture。您應該會收到這樣的回覆：Model Architecture: chrp。唯一支援的是 Common Hardware Reference Platform (chrp) 系統。

唯有當硬體或作業系統中出現對應特性時，才支援下列特性的除錯：

• 執行緒本端儲存體 (TLS)
• 十進位浮點數 (DFP)
• 向量類型
• POWER5 和 POWER6 硬體特性

安裝 IBM Debugger for AIX

如果您在安裝 XL C/C++ 編譯器時安裝了所有檔案集，如同「IBM XL C/C++ Enterprise Edition for AIX, V9.0 Installation Guide」中的預設安裝程序所述，您已安裝了 AIX 的所有 IBM Debugger 元件（用戶端和引擎）。

如果您在安裝 XL C/C++ 編譯器時未安裝所有檔案集，或使用非預設安裝程序，則您需要個別安裝 AIX 的 IBM Debugger 元件。如需說明，請參閱以下的「安裝 AIX 除錯引擎 (irmtdbgc) 和使用者介面用戶端 (idebug)」。

如果您想要在 Windows 上使用 IBM Debugger 使用者介面用戶端，您需要遵循以下的「安裝 Windows 使用者介面用戶端 (idebug)」。

如果您要安裝完整的產品版本，而不是安裝臨時修正程式，建議您在安裝這一版的 IBM Debugger for AIX 之前，先將所有舊版的 IBM Debugger 解除安裝（請參閱解除安裝 IBM Debugger for AIX）。

安裝 AIX 除錯引擎 (irmtdbgc) 和使用者介面用戶端 (idebug)

IBM Debugger for AIX 包裝在下列檔案集內：

若要在 AIX 安裝 IBM Debugger 元件，以及您系統目前支援的適當訊息檔案集，請發出下列指令：

installp -aXgd . -e /tmp/ibmdebugger.install.log ibmdebugger*

安裝 Windows 使用者介面用戶端 (idebug)

若要安裝 Windows 使用者介面用戶端：

1. 開啟命令提示字元，瀏覽至產品光碟上的 IBMdebugger\windows\ 目錄。
2. 執行產品光碟上的 IBMdebugger\windows\setup.exe 程式，然後遵循螢幕上的提示來安裝使用者介面用戶端。

解除安裝 IBM Debugger for AIX

在 Windows 解除安裝

若要將 IBM Debugger for AIX Windows 用戶端解除安裝，請開啟 Windows 控制台，並選擇新增或移除程式。尋找並選取 IBM Debugger for AIX。按一下移除來啟動解除安裝程序。

如果解除安裝失敗，可遵循下列步驟，手動啟動解除安裝程式：

1. 開啟命令提示字元。
2. 切換目錄（使用 cd 指令）至 IBM Debugger for AIX 安裝目錄。預設安裝目錄是 C:\Program Files\IBM\IBM Debugger for AIX。
3. 切換目錄（使用 cd 指令）至 _jvm\bin。
4. 輸入下列指令：java -jar ..\..\_uninst\uninstall.jar
5. 解除安裝程式將啟動。

在 AIX 解除安裝

若要在 AIX 解除安裝 IBM Debugger for AIX 引擎/用戶端，當登入身分為 root 使用者時，請發出此指令：

installp -u ibmdebugger*

IBM Debugger for AIX 6.1 版的最新功能

• 支援：
  • POWER6 硬體
  • AltiVec 暫存器
  • 十進位浮點數 (DFP)
  • 執行緒本端儲存體
• 區域變數過濾
• show_self 函數，可讓您採取有意義的方式來顯示 C++ 物件的內容
• 在具有 C 鏈結的函數上進行 C/C++ 函數評估
• 在指派表示式上進行表示式評估
• 單行聚集顯示支援
• 支援 C/C++ 程式檔中使用國家語言字元
• 「轉型為範本」支援
• 改良的區域變數監視
• 新的除錯主控台視圖（僅限技術預覽）

啟動除錯階段作業

當程式進行除錯之前，請確定您已使用 -g 編譯器選項的除錯資訊來編譯該程式。

若要啟動除錯階段作業，首先您要在本端或遠端 AIX 機器或遠端 Windows 機器上啟動 IBM Debugger 用戶端。然後，您可以在本端或從遠端啟動除錯階段作業。

啟動 IBM Debugger 用戶端

若要在 Windows 啟動 IBM Debugger 用戶端，請跳至 Windows 開始功能表，並選取程式集 > IBM > IBM Debugger for AIX > IBM Debugger for AIX。

若要在 AIX 啟動 IBM Debugger 用戶端，請執行 idebug 指令。如果多使用者環境中（有多位使用者在相同 AIX 機器上執行使用者介面用戶端），則每一位使用者必須選取唯一的常駐程式埠號。 若要這麼做，請在使用者介面用戶端指定一個常駐程式埠範圍。

1. 啟動使用者介面用戶端。
2. 在「除錯」視圖中按一下常駐程式圖示旁邊的下移鍵。
3. 輸入使用者介面用戶端可嘗試使用的埠範圍（例如，輸入的範圍為 8001-8009）。
4. 使用者介面用戶端將使用範圍中第一個可用的連接埠。
5. 如果除錯引擎是從使用者介面用戶端啟動的，它將使用該使用者介面用戶端所發現可用的埠。
6. 如果您是直接啟動除錯引擎，則必須指定使用者介面用戶端所取得的埠。

啟動 IBM Debugger 引擎

若要在本端進行程式除錯，可從 AIX 用戶端啟動引擎，或從指令行啟動。若要從遠端進行程式除錯，則必須從 AIX 指令行啟動引擎。

若要從 AIX 用戶端啟動引擎（僅本端除錯）：

1. 從 AIX 用戶端，選取檔案 -> 新啟動 -> 載入程式。
2. 提供要尋找及啟動程式的必要資訊。至少，您必須指定執行檔的名稱。如果在現行 PATH 環境變數中找不到該程式，請併入該程式的完整路徑。

將載入您的應用程式，並在 main() 暫停執行。

若要從指令行啟動引擎（本端或遠端除錯），請執行下列指令：

irmtdbgc [-qhost=<hostname>:<uidaemonport>] <executable><executable parameters>

其中：

• <uidaemonport> 是在常駐程式喜好設定中指定的用戶端機器 TCP/IP 埠號。預設常駐程式埠號是 8001。對引擎指定的埠必須是使用者介面接聽的其中一個埠。
• -qhost=<hostname> 是執行用戶端的主機名稱。如果在相同機器上執行用戶端，或您已使用 DER_DBG_ADDR 環境變數指定用戶端機器和埠，則您可以省略本選項（請參閱IBM Debugger for AIX 限制的「除錯器引擎」一節）。
• <executable> 是您要除錯的程式完整路徑。
• <executable parameters> 是傳遞至您要除錯的程式參數。

然後引擎會連接到用戶端，載入您的程式，當它呼叫到 main() 時會暫停該程式。

存取 IBM Debugger for AIX 文件

從 IBM Debugger 用戶端啟動的線上資訊中心有提供 IBM Debugger for AIX 的完整文件。

若要檢視說明系統：從 Windows 或 AIX 用戶端，選取說明 > 說明內容。

IBM Debugger for AIX 限制

一般限制：

• 當透過 Windows 用戶端套用「臨時修正程式」，日誌檔會在您以另一個配置取代現行配置時，寫入一個未處理的 SWT 異常狀況。您可以忽略此異常狀況，放心地繼續使用包含已取代配置的工作台。
• 當使用 AIX 用戶端，並在「記憶體視圖」中新增呈現方式時，該呈現方式未必定位於記憶體區塊的基本位址。若要解決此問題，用滑鼠右鍵按一下該呈現方式，並選取重設為基本位址。這會使呈現方式進入記憶體區塊的基本位址。
• 使用 AIX 用戶端時，如果路徑上有不運作的 Web 瀏覽器，則可能無法啟動說明系統。為確保說明系統能夠運作，請從路徑中移除不運作的 Web 瀏覽器。
• IBM Debugger for AIX 不支援以參數形式傳遞程式名稱至 idebug 指令。

除錯器引擎：

• DER_DBG_PORT 除錯引擎環境變數已淘汰。主機位址和埠應該指定為 DER_DBG_ADDR=host:port。
• DER_DBG_DEEP_STEP_DEBUG 環境變數已淘汰。此環境變數已被 DER_DBG_STEP_DEBUG = [SHALLOW | DEEP] [INCLUDE | NOINCLUDE] 取代，其中：
  • SHALLOW 或 DEEP 控制逐步除錯功能是否只檢查直系子常式的除錯資訊 (SHALLOW)，或一直深入到發現除錯資訊的位置為止 (DEEP)。 預設值是 SHALLOW。如果您有大量程式碼都沒有除錯資訊，則深層逐步除錯會變慢。
  • INCLUDE 或 NO_INCLUDE 決定在執行逐步除錯時是否將併入檔中的程式碼視為具有除錯資訊。 預設值是 INCLUDE。
• 已新增下列環境變數：
  • DER_DBG_BACKGROUND_READ - 預設值是 YES。將此值設為 NO 會防止除錯器在閒置時讀取除錯資訊。對於擁有極大量除錯資料的應用程式，可能需要將此值設為 NO，以防止耗盡除錯器的資料堆空間。
  • DER_DBG_POWER_STEP - 如果設為 Y 或 YES，除錯器將會在逐步進行時忽略岔斷點。預設值是 NO。
  • DER_DBG_CICS_STEP - 這是在 CICS 下除錯時所用的特殊環境變數。它可讓除錯器正常地逐步執行會透過 CICS 來呼叫常式的程式碼。
• 不再支援 DER_DBG_ NO_LIBPTHDEBUG 環境變數。

說明文件 InfoCenter

• 「說明」搜尋結果中出現 HTTP 狀態 500 錯誤或可見的 HTML 程式碼：在「說明」視窗中搜尋線上文件時（說明 > 說明內容），如果發生下列其中一個問題：
  • HTTP 狀態 500 錯誤，出現的說明是 "The server encountered an internal error () that prevented it from fulfilling this request."
  • 搜尋結果清單的頂端或底端有可見的 HTML 標示，例如 <a class="link" id="a113" href="...
  請嘗試在「動態說明」視圖中執行相同的搜尋：按一下說明 > 動態說明，或選取鍵盤的 F1 鍵，然後按一下視圖底端的「搜尋」鏈結。「動態說明」搜尋會將結果顯示在「本端說明」種類下。
• 按一下「說明」搜尋結果會顯示 XML 程式碼：如果在「說明」視窗中搜尋線上文件（說明 > 說明內容），並按一下其中一個結果，但內容頁框卻顯示 XML 原始檔，而不是可閱讀的文字內容，請在嘗試在「動態說明」視圖中重新執行搜尋。請按一下說明 > 動態說明，再按一下視圖底端的「搜尋」鏈結。「動態說明」搜尋會將結果顯示在「本端說明」分類下。 如果已選取顯示結果種類按鈕，則您尋找的結果會顯示在一個種類下，例如「歡迎使用」（這些是只在「動態說明」視圖中才會正確顯示的一些種類）。

國家語言限制：

• 使用 irmtdbgc 指令時，您無法載入下列程式：其名稱或參數包含高於 255 的 UCS 內碼字元。您可以利用 AIX 用戶端的檔案 > 新啟動 > 載入程式動作，在本端載入這類程式。
• 雙向 (BIDI/BiDi) 語言限制：
  • 「除錯器」編輯器、「變數」視圖、「監視器」視圖及「記憶體」視圖可能無法正確顯示由 BIDI 字元和數字組成的字。字裡的數字和 BIDI 字元的位置可能不正確。
  • 使用 CP420 時，「記憶體」視圖中無法以 EBCDIC 呈現來正確顯示阿拉伯文 Lam Aleph（或 Lam Alef）字元。可以改用 CP420S 來代替。
  • 將字串變數編輯成有字尾的阿拉伯文字元時，如果字尾字元沒有緊接空格，則可能無法正確設定值。可能會遺失字尾字元。
  • 無法在「變數」、「監視器」及「記憶體」視圖的編輯欄位中輸入印度文數字。
• 「臨時修正程式」在產品中新增的使用者介面文字只有英文字。