启动与 IBM Z Open Debug 的交互式调试会话
您可以使用 启动 类型的配置来启动和调试应用程序,或者将 Z Open Debug 用户界面连接到暂停的调试会话。
- 通过来打开文件 launch.json 。
您可以在配置列表中选择“Z Open Debug:启动并调试 z/OS 应用程序 ”来创建默认模板。 您可以通过点击 “添加配置 ”来获取该列表。
- 创建启动配置条目 (如果不存在)。 请参阅此类配置中可用的属性列表。

{ "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""`命令。 例如:
使用RSE API Zowe后端提交位于远程 z/OS"applicationLaunch": { "commandLine": "zowe rse submit data-set \"YOURUSR.SAMPLE.JCL(DBG)\"" }YOURUSR.SAMPLE.JCL(DBG)系统上的JCL。
触发用于公开 REST API 的应用程序。 此命令行调用"curl -X GET https://yourZOShost.com:443/yourApplication/uri/2/1"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)
- 在 "运行" 视图中,启动条目:
- 若您已指定 "applicationLaunch" 启动应用程序或事务,请选择。 或者,在 "运行" 视图顶部栏中,从下拉列表中选择 Z Open Debug: Launch and debug a z/OS application ,然后单击 启动调试 图标或按 F5。
- 若您有可用的已停放调试会话并希望直接连接,请选择。 或者,在 "运行" 视图顶部栏中,从下拉列表中选择 连接到停放的 IBM Z 打开调试会话 ,然后单击 启动调试 图标或按 F5。
此配置类型支持以下属性:
- 连接
- 引用 zOpenDebug 的Zowe连接配置文件。
- sessionId
- 连接到特定的 "已停止" 调试会话标识。 缺省值为
"*",用于连接到第一个可用的暂停调试会话。 - 概要文件
- 指定在 z/OS 调试器配置文件视图中创建的调试配置文件名称。 在启动应用程序之前自动激活调试概要文件,并在建立调试会话之后自动取消激活。
- applicationLaunch: {commandLine}
- 指定可用于启动 z/OS 应用程序或事务的客户机端命令行,例如通过 "
ssh" 或 "curl" 命令。 如何启动应用程序的详细信息由您如何准备应用程序环境来确定。 - terminateAndAbend
- 指定在从 UI 终止调试会话时应发出 ABEND。 如果指定了
"terminateAndAbend": true,那么当按下 "终止" 按钮时,程序会异常终止,并且操作系统会将程序视为崩溃,这可能会导致系统回滚事务或数据库调用。 - 轨迹
- 启用诊断跟踪。 指定
"trace": true将在 IDE 与 远程调试服务之间生成调试通信的跟踪。
以下属性已弃用。
指定这些属性将覆盖Zowe连接配置文件中的设置。
指定这些属性将覆盖Zowe连接配置文件中的设置。
- 主机
- 直接指定 z/OS® 主机名。
- port
- 指定远程调试服务的端口。
- 安全
- 指定应使用安全连接。
- ignoreCertificateErrors
- 忽略远程调试服务使用的 TLS 证书相关问题,例如自签名证书或过期证书。警告: 使用此属性可能会导致客户机忽略来自所有服务器的所有证书错误。
- 用户
- 指定在连接到暂停的调试会话时要用于认证的用户标识。 用户标识必须与在 z/OS 主机上拥有调试会话的用户标识匹配。
- 密码
- 指定在连接到暂停的调试会话时要用于认证的密码。 缺省情况下,每次调用启动配置时都会显示密码提示。