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 地址。
    2. 输入 exit 命令以关闭此窗口。
  3. 在调试器中,通过执行以下步骤来验证守护程序是否正在侦听
    1. 单击窗口 > 打开透视图
    2. 单击调试
    3. 单击确定
    4. 在“调试”视图中,找到“调试”视图右侧的侦听器图标。如果侦听器守护程序已开启,那么侦听器图标为绿色(指示侦听已开启的图标),如果侦听器守护程序已关闭,那么侦听器图标为红色(指示侦听已关闭的图标)。
    5. 如果图标为红色,请单击该图标以开启侦听器守护程序。该图标将变为绿色。
  4. 修改应用程序的 TEST 运行时选项以将现有的 MFIVTAM% 选项替换为 TCPIP& 选项,或更新现有的 TCPIP& 选项。

    如果您要替换现有的 MFIVTAM% 选项,请记住 TCPIP& 选项的格式为 TCPIP&tcpip_workstation_id%port_id,其中,将使用从步骤 2获取的 TCP/IP 地址来替换 tcpip_workstation_id。缺省端口标识为 8001;如果守护程序显示其他的端口号,请将 port_id 替换为该端口号。

    如果您要更新现有的 TCPIP& 选项,验证您是否指定了从步骤 2 获取的 IP 地址。缺省端口标识为 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,调试守护程序在端口标识 8001 上侦听的工作站上。

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

指示您希望以远程调试方式启动调试会话,远程调试器在 TCP/IP 名称为 abc.example.com,调试守护程序在端口标识 8000 上侦听的工作站上。

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

指示您希望以远程调试方式启动调试会话,远程调试器在 TCP/IP 名称为 abc.example.com,调试守护程序在端口标识 8001 上侦听的工作站上。

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

指示您希望以远程调试方式启动调试会话,远程调试器在 TCP/IP 地址为 127.0.0.1,调试守护程序在端口标识 8001 上侦听的工作站上。

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

指示您希望以远程调试方式启动调试会话,远程调试器在 TCP/IP 地址为 192.0.2.09,调试守护程序在端口标识 8001 上侦听的工作站上。

反馈