启动与 IBM Z Open Debug 的交互式调试会话

您可以使用 启动 类型的配置来启动和调试应用程序,或者将 Z Open Debug 用户界面连接到暂停的调试会话。

  1. 通过命令面板 > 调试:添加配置来打开文件 launch.json变革的开端您可以在配置列表中选择“Z Open Debug:启动并调试 z/OS 应用程序 ”来创建默认模板。 您可以通过点击 “添加配置 ”来获取该列表。变更结束
  2. 创建启动配置条目 (如果不存在)。 请参阅此类配置中可用的属性列表。变革的开端
     {
            "type": "zOpenDebug",
            "request": "launch",
            "name": "Z Open Debug: Launch and debug a z/OS application",
            "connection": { 
                "type": "zowe", "name": "zOpenDebug"
            },
            "profile": "YOUR_PROFILE_NAME",
            "applicationLaunch": {
                "commandLine": "ssh yourUserid@yourZOShost.com /path/to/yourApplicationLaunchScript.sh"
            },
            "terminateAndAbend": true,
            "trace": true
        },
    变更结束
    • 要指定可构建和部署应用程序的任务,请使用 VS Code 中提供的 属性 "preLaunchTask"
    • 要在应用程序启动前自动激活调试配置文件,并在会话建立后将其停用,请使用 "profile" 属性指定您在 z/OS 调试器配置文件视图中创建的调试配置文件名称。
    • 要启动 z/OS 应用程序或事务,请使用 "applicationLaunch" `attribute`属性指定客户端命令行,例如通过Zowe CLI或`curl""`命令。 例如:
      • "applicationLaunch": {
            "commandLine": "zowe rse submit data-set \"YOURUSR.SAMPLE.JCL(DBG)\""
        }
        使用RSE API Zowe后端提交位于远程 z/OSYOURUSR.SAMPLE.JCL(DBG) 系统上的JCL。
      • "curl -X GET https://yourZOShost.com:443/yourApplication/uri/2/1"
        触发用于公开 REST API 的应用程序。 此命令行调用 curl 命令,以使用 REST 服务端点 /yourApplication/uri/2/1对在 yourZOSHost.com上公开 REST API 的应用程序调用 HTTP GET 请求。
    • 当存在多个已停放的调试会话时,使用 "sessionId" 来选择特定程序进行调试,而非默认选择第一个可用的程序。 例如,当两个暂停的调试会话都可用时,指定 "sessionId": "31" 以调试 31 而不是 30:
      30 Parked USER123 TBND009 
      31 Parked USER123 TSCODEL.RDBG.NHK.SRC(TQND01)
  3. 在 "运行" 视图中,启动条目:
    • 若您已指定 "applicationLaunch" 启动应用程序或事务,请选择命令面板 > 调试:选择并开始调试 > Z 打开调试:启动并调试 z/OS 应用程序。 或者,在 "运行" 视图顶部栏中,从下拉列表中选择 Z Open Debug: Launch and debug a z/OS application ,然后单击 启动调试 图标或按 F5。
    • 若您有可用的已停放调试会话并希望直接连接,请选择命令面板 > 调试:选择并开始调试 > 连接到已停放的 IBM Z 打开调试会话。 或者,在 "运行" 视图顶部栏中,从下拉列表中选择 连接到停放的 IBM Z 打开调试会话 ,然后单击 启动调试 图标或按 F5。
现在,您可以在 Z Open Debug 用户界面中启动交互式调试。
此配置类型支持以下属性:
连接
引用 zOpenDebug 的Zowe连接配置文件。
sessionId
连接到特定的 "已停止" 调试会话标识。 缺省值为 "*",用于连接到第一个可用的暂停调试会话。
概要文件
指定在 z/OS 调试器配置文件视图中创建的调试配置文件名称。 在启动应用程序之前自动激活调试概要文件,并在建立调试会话之后自动取消激活。
applicationLaunch: {commandLine}
指定可用于启动 z/OS 应用程序或事务的客户机端命令行,例如通过 "ssh" 或 "curl" 命令。 如何启动应用程序的详细信息由您如何准备应用程序环境来确定。
terminateAndAbend
指定在从 UI 终止调试会话时应发出 ABEND。 如果指定了 "terminateAndAbend": true ,那么当按下 "终止" 按钮时,程序会异常终止,并且操作系统会将程序视为崩溃,这可能会导致系统回滚事务或数据库调用。
轨迹
启用诊断跟踪。 指定 "trace": true 将在 IDE 与 远程调试服务之间生成调试通信的跟踪。
以下属性已弃用。 变革的开端指定这些属性将覆盖Zowe连接配置文件中的设置。变更结束
主机
直接指定 z/OS® 主机名。
port
指定远程调试服务的端口。
安全
指定应使用安全连接。
ignoreCertificateErrors
忽略远程调试服务使用的 TLS 证书相关问题,例如自签名证书或过期证书。
警告: 使用此属性可能会导致客户机忽略来自所有服务器的所有证书错误。
用户
指定在连接到暂停的调试会话时要用于认证的用户标识。 用户标识必须与在 z/OS 主机上拥有调试会话的用户标识匹配。
密码
指定在连接到暂停的调试会话时要用于认证的密码。 缺省情况下,每次调用启动配置时都会显示密码提示。