Rational Developer for System z V8.0.1 版

使用除錯器除錯 z/OS 應用程式入門

這些指示協助您快速開始使用除錯器除錯 z/OS 應用程式。這些指示說明如何為本作業選擇 z/OS 應用程式,將常駐程式設定為正確的 IP 位址和埠號,驗證常駐程式是否正在接聽、修改 TEST 執行時期參數的正確選項,然後完成一些簡單的除錯步驟。完成這些步驟之後,您可以進一步瞭解您需要對這些步驟進行的修改,以除錯其他 z/OS 應用程式。

關於這項作業

本主題中的指示可協助您開始除錯您的其中一個 z/OS 應用程式。

程序

執行下列步驟,以開始在 z/OS 系統上除錯應用程式:

  1. 選擇符合以下條件的應用程式:您目前可以使用「除錯工具」進行除錯,並且您瞭解如何修改與此應用程式相關聯的 TEST 執行時期參數。 除了少數幾個例外情況之外,您可以除錯在 IMS™、CICS® 或 DB2® 中執行的大部分 COBOL、PL/I、C/C++ 和組譯器程式。《除錯工具使用手冊》中的『除錯工具:概觀』主題提供了可以使用除錯器(在《除錯工具使用手冊》中稱為遠端除錯器遠端除錯模式)進行除錯的程式類型以及除錯器支援的子系統完整清單。
  2. 取得工作站的 IP 位址。 您可以執行下列步驟來取得 IP 位址:
    1. 開啟命令提示字元視窗並輸入指令 ipconfig 該視窗會顯示 IP 位址清單。正確的 IP 位址標有 IP 位址且格式如下:www.xxx.yyy.zzz。如果您看到多個 IP 位址,則一個 IP 位址是網路裝置(如路由器或無線集線器)的 IP 位址,另一個 IP 位址是工作站的 IP 位址。請使用工作站的 IP 位址。記下此 IP 位址。
    2. 輸入 exit 指令以關閉視窗。
  3. 在除錯器中,執行下列步驟來驗證常駐程式正在接聽
    1. 按一下視窗 > 開啟視景
    2. 按一下除錯
    3. 按一下確定
    4. 在「除錯」視圖中,找到「除錯」視圖右側的接聽器圖示。如果接聽器常駐程式已開啟,則接聽器圖示是綠色的 (指出接聽已開啟的圖示),如果接聽器常駐程式已關閉,則接聽器圖示是紅色的 (指出接聽已關閉的圖示)。
    5. 如果該圖示是紅色的,請按一下該圖示以開啟接聽器常駐程式。此時該圖示會變成綠色。
  4. 修改應用程式的 TEST 執行時期選項,以用 TCPIP& 選項取代現有的 MFIVTAM% 選項,或者更新現有的 TCPIP& 選項。

    如果要取代現有的 MFIVTAM% 選項,請記住 TCPIP& 選項的格式是 TCPIP&tcpip_workstation_id%port_id,其中您使用從步驟 2 取得的 TCP/IP 位址取代 tcpip_workstation_id。預設埠 ID 是 8001;如果常駐程式顯示不同的埠號,請將 port_id 取代為該埠號。

    如果要更新現有的 TCPIP& 選項,請驗證您指定的是從步驟 2 取得的 IP 位址。預設埠 ID 是 8001;如果常駐程式顯示不同的埠號,請將 port_id 取代為該埠號。

    如果要將 CADP 用於 CICS 程式,請記住要正確設定顯示裝置;具體地說,將階段作業類型設定為 TCP

    如果要將 DTCN 用於 CICS 程式,請記住要將階段作業類型設定為 TCP

    如果要指定 DB2 儲存程序的 IP 位址,請記住要遵守《除錯工具使用手冊》之主題『準備 DB2 儲存程序程式』中的指示。

    您可以在「下一步」中檢視 TEST 執行時期選項會如何變更的範例。

  5. 啟動應用程式,啟動方法與通常用於啟動它以進行除錯的方法相同。 與應用程式相關的資訊會出現在「除錯」視圖中。如果您在「除錯」視圖中看不到應用程式的相關資訊,請檢查下列項目:
    • 您已取得工作站的正確 IP 位址和埠號。
    • 您已指定正確的 TEST 執行時期選項,包括正確的 IP 位址和埠號。
    • 驗證常駐程式正在接聽。
  6. 逐步執行程式,設定岔斷點,執行程式至岔斷點,並監視應用程式中的變數。 下列指示顯示如何執行這些作業中的每一個作業:
    • 若要逐步執行程式,請按一下進入副程序按鈕 (「進入副程序」動作的圖示)。
    • 若要設定岔斷點,請跳至「除錯器」編輯器,並用滑鼠右鍵按一下要設定岔斷點的陳述式,然後選取新增岔斷點
    • 若要執行程式至所設定的岔斷點,請按一下回復 「回復」動作的圖示
    • 若要監視變數,請跳至「除錯器」編輯器並用滑鼠右鍵按一下要監視的變數。從蹦現功能表中選取監視表示式
  7. 若要結束除錯階段作業,請在「除錯」視圖中按一下「終止」按鈕 (「終止」動作的圖示)。此圖示位於「除錯」視圖右側。

下一步

若要瞭解除錯器的特性,請執行下列步驟閱讀線上說明:
  1. 按一下說明 > 說明內容
  2. 展開開發 > 除錯 COBOL、PL/I、組譯器和 C++ 程式 > 編譯語言除錯器

若要進一步瞭解 TEST 執行時期選項,請閱讀 Debug Tool Reference and Messages GC27-3624 中的主題 "Syntax of the TEST run-time option"。下列表格強調顯示您針對不同狀況變更 TEST 執行時期選項的內容:

表 1. 變更 TEST 執行時期選項以在遠端除錯模式下工作的範例。
之前 之後
TEST(ALL,,,MFI:)

指出您要讓「除錯工具」以全螢幕模式啟動除錯階段作業。

TEST(,,,TCPIP&127.0.0.1%8001:*)

指出您要以遠端除錯模式啟動除錯階段作業,工作站上遠端除錯器的 TCP/IP 位址是 127.0.0.1,其除錯常駐程式接聽埠 ID 8001。

TEST(,,,TCPIP&abc.example.com%8000:*)

指出您要以遠端除錯模式啟動除錯階段作業,工作站上遠端除錯器的 TCP/IP 名稱是 abc.example.com,其除錯常駐程式接聽埠 ID 8000

TEST(,,,TCPIP&abc.example.com%8001:*)

指出您要以遠端除錯模式啟動除錯階段作業,工作站上遠端除錯器的 TCP/IP 名稱是 abc.example.com,其除錯常駐程式接聽埠 ID 8001

TEST(,,,TCPIP&127.0.0.1%8001:*)

指出您要以遠端除錯模式啟動除錯階段作業,工作站上遠端除錯器的 TCP/IP 位址是 127.0.0.1,其除錯常駐程式接聽埠 ID 8001。

TEST(,,,TCPIP&192.0.2.09%8001:*)

指出您要以遠端除錯模式啟動除錯階段作業,工作站上遠端除錯器的 TCP/IP 位址是 192.0.2.09,其除錯常駐程式接聽埠 ID 8001。

意見