示例: TEST 运行时选项

提供了以下使用 TEST 运行时选项的示例，以说明可用于程序的运行时选项。 这些命令未说明完整的命令。 可以在 TEST 运行时选项的语法中找到 TEST 运行时选项的完整语法。

远程调试
如果您正在 远程调试 方式下工作，即，您正在从工作站调试主机应用程序，那么以下示例适用:
表 1. TEST 用于远程调试的运行时选项示例
方案分析 TEST 运行时选项用法
使用 调试管理器 的 Eclipse IDE TEST(,,,DBMDT:*)

指示您要启动 Eclipse IDE的调试会话。 客户机的地址由当前用户标识的 调试管理器 自动确定。
使用工作站 IP 地址的 Eclipse IDE TEST(,,,TCPIP&abc.example.com%8001:*)

指示您要启动 Eclipse IDE的调试会话。 在此示例中，客户机的 TCP/IP 地址手动指定为 abc.example.com ，调试守护程序正在侦听端口 8001。
IBM Z® 打开调试 TEST(,,,RDS:*)

表示要使用 IBM Developer for z/OS VS Code 或 Wazi for Dev Spaces 的远程调试服务启动调试会话。 在此场景中，必须正在运行并配置 远程调试服务 。


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

表示要使用 IBM Developer for z/OS VS Code 或 Wazi for Dev Spaces 的远程调试服务启动调试会话。 在这种情况下， 远程调试服务在本地 z/OS 机器上运行，使用 TCP/IP 地址 127.0.0.1 ，并在端口 8001 上监听内部 z/OS® 调试器连接。

当 调试概要文件服务 处于活动状态时，可以选择在未指定子选项的情况下使用 TEST 以启用延迟调试方式。 有关更多信息，请参阅 简单 TEST 选项。

代码覆盖
如果要启动代码覆盖会话，那么以下示例适用:
表 2. TEST 代码覆盖的运行时选项示例
方案分析 TEST 运行时选项用法
使用 调试管理器 通过 Eclipse IDE 进行代码覆盖 TEST(,,,DBMDT:*)

指示您要启动 Eclipse IDE的代码覆盖会话。 客户机的地址由当前用户标识的 调试管理器 自动确定。
使用工作站 IP 地址的 Eclipse IDE 的代码覆盖 TEST(,,,TCPIP&abc.example.com%8001:*)

指示您要启动 Eclipse IDE的代码覆盖会话。 在此示例中，客户机的 TCP/IP 地址手动指定为 abc.example.com ，调试守护程序正在侦听端口 8001。
无头代码覆盖 使用 远程调试服务 TEST(,,,RDS:*)

指示您要运行代码覆盖会话并连接到 远程调试服务。 在此场景中， 远程调试服务 必须正在运行并配置为收集代码覆盖。
z/OS 上的 无头代码覆盖 TEST(,,,TCPIP&127.0.0.1%8001:*)

指示您要使用 无外设代码覆盖来运行代码覆盖会话。 在此场景中， 无外设代码覆盖 正在本地 z/OS 机器上使用 127.0.0.1 的 TCP/IP 地址运行，并且正在侦听端口 8001 for z/OS Debugger 连接。
使用 Windows 或 Linux 客户机的 无头代码覆盖 TEST(,,,TCPIP&cde.example.com%8001:*)

指示您要使用 无外设代码覆盖来启动代码覆盖会话。 在此场景中， 无头代码覆盖 守护程序正在 Windows 或 Linux 机器上使用 cde.example.com 的 TCP/IP 地址运行，并且正在侦听端口 8001 for z/OS Debugger 连接。
注：
  • 还需要 EQA_STARTUP_KEY 以指示代码覆盖。 有关更多信息，请参阅 EQA_STARTUP_KEY 和 在启动键中指定代码覆盖选项。
  • IBM Z and Cloud Modernization Stack （Wazi Code） 不支持代码覆盖。
  • IBM Debug for z/OS中不支持无外设代码覆盖。
全屏调试
如果要使用全屏幕调试，那么以下示例适用:
表 3。 TEST 用于全屏幕调试的运行时选项
方案分析 TEST 运行时选项用法
CICS 全屏方式 TEST(ALL,,,MFI%F000:)

在 CICS®下运行时， z/OS Debugger 会在终端标识 F000上显示其屏幕。
具有专用终端的全屏模式 TEST(ALL,,,MFI%TRMLU001:)

用于使用没有终端接口管理器的专用终端的全屏方式。 VTAM LU TRMLU001 用于显示。 当启动 z/OS Debugger 时，此终端必须是 VTAM 已知的终端，而不是会话中的终端。


TEST(ALL,,,MFI%SYSTEM01.TRMLU001:)
在以下情况下使用:
  • 您正在使用全屏方式，使用没有终端接口管理器的专用终端。
  • 必须指定网络标识。
网络节点 SYSTEM01 上的 VTAM LU TRMLU001 用于显示。 当启动 z/OS Debugger 时，此终端必须是 VTAM 已知的终端，而不是会话中的终端。
使用终端接口管理器的全屏方式 TEST(ALL,,,VTAM%USERABCD:)

用于使用终端接口管理器的全屏幕方式。 用户使用用户标识 USERABCD 访问了 z/OS Debugger 终端接口管理器。
TSO 全屏方式 TEST(,,,MFI:*)

指示您希望调试器以 TSO 全屏方式启动调试会话。
注: 仅在 IBM® Developer for z/OS Enterprise Edition 和 IBM Debug for z/OS中支持全屏幕调试。
NOTEST
z/OS Debugger 未在程序初始化时启动。 请注意，调用 CEETEST， PLITEST或 __ctest() 会导致在程序执行期间启动 z/OS Debugger 。
NOTEST(ALL,MYCMDS,*,*)
z/OS Debugger 未在程序初始化时启动。 请注意，调用 CEETEST， PLITEST或 __ctest() 会导致在程序执行期间启动 z/OS Debugger 。 启动 z/OS Debugger 后，指定的子选项将生效，并且将处理分配给 MYCMDS 的 DD 名称的文件中的命令。

如果指定 NOTEST 并且控制已从首次激活 z/OS Debugger 的程序返回，那么您无法再调试非Language Environment ® 程序或检测非Language Environment 事件。

TEST
指定不带子选项的 TEST 会导致检查子选项的其他可能定义。 例如， C 和 C++ 允许使用 #pragma runopts在编译时选择缺省子选项。 同样， PL/I 提供 PLIXOPT 字符串。 Language Environment 提供宏 CEEXOPT。 通过使用此宏，可以指定安装和特定于程序的缺省值。

如果不存在这些子选项的其他定义，那么 IBM提供的缺省子选项 (ALL,*,PROMPT,INSPPREF) 将生效。 在不是前台 TSO 任务的环境中，当 调试概要文件服务 API 处于活动状态时， z/OS Debugger 将以延迟调试方式运行。

TEST(ALL,*,*,*)
z/OS Debugger 最初未启动; 但是，程序中的任何条件或注意会导致 z/OS Debugger 启动，就像调用 CEETEST， PLITEST或 __ctest()一样。 既不使用主命令文件，也不使用首选项文件。
TEST(NONE,,*,*)
z/OS Debugger 最初未启动，而是以 "生产方式" (即，对程序处理的影响最小) 运行。 但是，可以使用 CEETEST， PLITEST或 __ctest()来启动 z/OS Debugger 。
TEST(ALL,test.scenario,PROMPT,prefer)
z/OS Debugger 在环境初始化结束时启动，但在主程序序言完成之前启动。 将 ddname prefer 作为首选项文件进行处理，并在数据集 test.scenario中找到后续命令。 如果处理了命令文件中的所有命令，并且您在提示时发出了 STEP 命令，或者在命令文件中运行了 STEP 命令，那么主块将完成初始化 (即，获取其 AUTOMATIC 存储器并设置初始值)。 如果由于任何原因稍后重新输入 z/OS Debugger ，那么它将继续从重复此过程的 test.scenario 获取命令，直到达到文件结束为止。 此时，将从终端获取命令。

请参阅以下主题，以获取与本主题中讨论的材料相关的更多信息。

  • 相关参考
  • z/OS Language Environment 编程指南