Rational Developer for System z V8.0.1

使用“远程编译应用程序”配置

调试配置用于保存当调试会话启动时使用的设置。“远程编译应用程序”配置会保存当入局应用程序通过调试守护程序连接至调试器用户界面时使用的启动设置。无法将“远程编译应用程序”配置用于从调试器用户界面直接启动调试会话。

关于此任务

注: “远程编译应用程序”配置仅在 IBM® Rational® Developer for System z® 中可用。

在终止调试会话时,会保存诸如断点之类的设置,但是,这些设置不由启动配置保存。因此,如果为同一应用程序创建多个启动配置,那么对于每个启动配置,诸如断点之类的设置将相同。为同一应用程序创建多个启动配置的优点如下:可以在启动配置中设置不同自变量作为程序参数,并且当启动调试会话时,可以具有不同的“调试控制台”命令集。

当通过启动连接至用户界面调试守护程序的 JCL 连接至调试器用户界面时,会为您正在调试的程序自动创建“远程编译应用程序”调试配置。同一程序的后续启动将复用此配置。可以为同一程序创建多个配置,例如,可以复制某个配置,然后对该副本进行修改。如果对于同一程序具有多个配置,并且启动了该程序以进行调试,那么对话框将提示您选择要用于启动调试会话的配置。

要创建“远程编译应用程序”配置,请完成下列步骤:

过程

  1. 在提供与调试相关的操作集的工作台透视图(例如,“调试”透视图)中,执行下列其中一项任务:
    • 从工作台菜单栏中选择运行 > 调试,以打开调试启动配置对话框。
    • 单击工作台工具栏调试按钮旁边的向下箭头并从列表中选择调试。这将打开调试启动配置对话框。
  2. 调试启动配置对话框中,执行下列其中一个任务:
    • 右键单击远程编译应用程序节点并从弹出菜单中选择新建
    • 双击编译应用程序节点。
  3. 这将使启动配置选项卡和输入字段显示在该对话框的右边。
  4. 名称字段中,为正在创建的配置输入您选择的名称。
  5. 选择程序选项卡以使它出现在前台。
  6. 程序名字段中,输入要调试的程序的名称。必须完成此字段。
  7. 选中调试初始化复选框,以调试在调用主程序入口点之前就执行的代码。如果正在调试 C++ 代码并且需要调试全局声明的 C++ 类对象的构造函数时,可能要执行此操作,因为在输入主程序入口点之前会构造此类对象。如果该复选框处于未选中状态,那么该程序将运行至主入口点。
  8. 要设置“源文件查找路径”,请选择源文件选项卡并执行下列任何任务:
    • 要添加源文件位置,单击添加。这将调用添加源文件对话框,可以在其中选择要添加的源文件位置的类型。从添加源文件对话框中的选择列表中:
      • 选择工作空间将使工作空间中的所有项目添加至源文件位置列表。
      • 选择文件系统目录会将本地文件系统目录添加至源文件位置列表。需要时,如果选中搜索子文件夹复选框,那么将递归地搜索此目录的子目录。
      • 选择项目会打开一个对话框,它允许您选择工作空间中的某个项目。从项目的列表中,可以选择一个或多个项目以添加至源文件位置列表。
      • 选择调试引擎将使调试引擎添加至源文件位置列表。
      • 选择调试引擎路径将使调试引擎上指定的路径添加至源文件位置列表。当指定多个路径时,路径分隔符随平台的不同而有所变化(在 System z 上,请使用分号 (;) 作为路径分隔符)。
        注:调试引擎路径设置的更改将在后续调试会话中生效。
      取决于您正在使用的产品,其他源文件容器类型可能可用。
    • 要除去现有条目,选择源文件位置并单击除去
    • 要设置现有条目的顺序,选择源文件位置并单击向上向下来更改该位置的布局。
      注: 在一些情况下,对位置布局的更改可能下次程序启动时才生效。

    如果要在源文件搜索路径中搜索源文件名称的所有实例,那么选中在路径上搜索重复的源文件复选框。如果选中此复选框并且调试器找到该文件名的多个实例,那么对话框将提示您选择正确的源文件。

  9. 选择调试控制台命令选项卡以使它出现在前台。此选项卡用于添加在调试会话启动时要对调试引擎发出的命令。可以使用页面中的按钮来添加、除去和修改这些命令,也可以从命令列表文本文件中导入命令。命令列表文件包含的命令列表由新行(回车/换行)分隔。命令列表文件可包含注释,这些注释将不会导入到命令列表中。注释行以 # 字符开头。
  10. 选择公共选项卡以使它出现在前台。可以在公共页面中执行下列任何任务:
    • 如果要以本地方式存储启动配置并且使它对于单用户可用,那么确保已选择本地单选按钮。如果启动配置要作为文件存储在工作空间中并在存储库中供团队共享使用,请选择共享文件单选按钮,并在共享文件旁的文本字段中输入要存储启动配置的项目位置。或者,可以进行浏览以选择该项目。
    • 如果要使启动配置作为首选调试配置显示在调试按钮的收藏夹菜单或调试菜单的调试历史记录列表中,那么选中调试复选框。
  11. 如果已提供启动配置的所有必需信息,那么将启用调试应用按钮。单击应用将保存启动配置,此时,可选择关闭该对话框而不启动调试会话,也可单击调试以使用新的启动配置来启动调试会话。如果单击调试,那么将保存对启动配置的任何更改并且将启动调试会话。

    在保存调试启动配置之后,可以对它进行编辑。有关对调试启动配置进行编辑的进一步信息,请参阅相关任务。

    提示: 如果尚未保存启动配置设置,并且已在要除去或更改的启动配置设置中生成条目,那么单击恢复将除去已进行的所有更改。
  12. 如果尚未提供启动配置的必需信息,或已提供的信息中存在错误,那么该对话框顶部的消息将指示遗漏哪些内容。
  13. 如果未使用该对话框来启动调试会话(例如转而使用它来创建并保存启动配置),那么当在其中完成工作时,单击关闭以退出该对话框。

结果

反馈