在 VS 代码上安装 IBM Developer for z/OS

IBM Developer for z/OS VS Code 上的 IBM Z® Open Editor 是其关键组件之一。 IBM Z Open Editor 是 VS Code 的扩展。 安装前，请确保已安装和配置所有先决条件，最重要的是 Java 运行时，因为扩展的核心部分是用 Java 编程语言实现的。

先决条件

下载前，请仔细阅读《 IBM Z Open Editor 许可协议 》和《 第三方声明 》。

安装的先决条件：

  • VS Code 1.102.3 或更高版本（推荐版本： 1.105.1 ）： IBM Z Open Editor 作为 VS Code 的扩展而非独立编辑器提供。 因此，必须先安装和配置 VS Code。 建议使用最新版本的 VS Code。 如果尚未安装 VS Code，建议使用微软提供的 “ Visual Studio Code for Java”安装程序。 该安装程序会自动下载并安装 Java SDK 和 VS Code。 如果使用该选项，则可跳过下一个关于 Java 依赖性的小节。 有关 VS Code 的安装和配置信息，请参阅其文档。

  • Java SDK 或 JRE 21 或更高版本 - 64 位：该扩展中包含的语言服务器是用 Java 实现的。 要成功启动扩展，必须安装和配置 64 位 Java SDK 或 Runtime。 建议安装 VS Code for Java（如上一节所述），因为它会自动包含所需的 Java SDK。 不过，如果已经安装了 VS Code 或希望手动安装，则可使用以下选项安装 Java：

    • 请使用 IBM 公司发布的 Semeru Runtime 第21版，可在此处下载。 IBM® Semeru 运行时支持构建和部署启动速度快、性能强、内存消耗少的 Java 应用程序。 在开发过程中，内部也会使用这些运行时。

    • 此外，您还可以使用 Oracle Java 的LTS版本21或 OpenJDK。

    • 预计 21 版以后的 Java 新版本也能运行，但它们没有经过 Z Open Editor 测试。

    提供了各种设置来配置扩展如何使用 Java。 有关更多详细信息，请参阅下面的配置 Java 部分。

  • Zowe 客户端软件：若要利用 Zowe 直接从 z/OS® MVS™ 或 z/OS UNIX System Services 打开和编辑文件，您必须已配置好 Zowe 客户端软件和主机组件。 有关设置 Zowe 的更多信息，请访问设置与 z/OS 交互的集成。 安装完成后，您可以按照《 与 z/OS 交互 》中的说明访问 z/OS 资源。

    • Zowe Explorer VS Code 扩展 v3.2.2 或更高版本。 当您从VS Code Marketplace将 IBM Z Open Editor 安装到您的VS Code中时，最新版本的Zowe Explorer VS Code扩展程序也会被自动安装，因为它是运行 Z Open Editor 的必备前提条件。

    • (可选） Zowe CLI v8.11.0 或更高版本。 Z Open Editor 而 Zowe Explorer 则可以完全独立运行。

  • （可选） Git ：要使用涉及 Git 的功能，您必须安装 Git 并将其添加到系统路径中，以便VS Code可以显示它。 在 Macs 上，Git 开箱即用。 在 Linux 上，您可以使用您的分发版的软件包管理器安装 Git。 在 Windows 系统上，您可以从 https://git-scm.com 下载 Git。

在 VS 代码上下载 IBM Developer for z/OS

请按照《 从 Mainframe DEV 下载安装包的步骤》，在 VS Code 上下载 Mainframe DEV 提供的 IBM 客户端（ Developer for z/OS ）。 提取下载的 IBM_Developer_for_z/OS_on_VSCode.zip。

如果要检查下载的二进制文件的代码签署签名，请参阅以下过程。 如果尚未安装 OpenSSL，请进行安装。

  1. "(《世界人权宣言》) IBM_Developer_for_z/OS_on_VSCode上面提取的.zip 文件包含.sig 和.pem 文件，用于验证二进制文件。

  2. 检查证书有效性。

    1. 要查看证书详细信息，请发出以下命令：

      $ openssl x509 -text -in wazi-certificate.pem -noout

    2. 要查看公钥的详细信息，请执行以下命令：

      $ openssl rsa -noout -text -inform PEM -in wazi-public.pem -pubin

    3. 比较公用密钥和证书的指数，以查看公用密钥是否确实是证书内的密钥。 您还可以使用任何其他证书查看器，如 Mac OS Preview。

    4. 要检查 IBM 公用证书的有效性，请发出以下命令：

      $ openssl ocsp -no_nonce -issuer wazi-chain0.pem -cert wazi-certificate.pem -VAfile wazi-chain0.pem -text -url http://ocsp.digicert.com -respout ocsptest

      如果证书有效，那么输出为：

      Response verify OK

  3. 验证下载的二进制文件。

    要使用签名和公用密钥文件来验证文件，请发出以下命令：

    $ openssl dgst -sha256 -verify wazi-public.pem -signature ${binary-filename}.sig ${binary-filename}

    例如，要验证 zopeneditor-1.0.0.vsix ，请发出：

    $ openssl dgst -sha256 -verify wazi-public.pem -signature zopeneditor-1.0.0.vsix.sig zopeneditor-1.0.0.vsix

    如果二进制文件验证成功，那么输出为：

    Verified OK

安装 IBM Z Open Editor

下载和安装 IBM Z Open Editor 有几种方法。 如果您计划使用或评估该未经保修且不受支持的版本，可直接从 VS Code Marketplace 或 Open VSX Registry 进行安装。

如果您是 IBM Developer for z/OS Enterprise Edition 或 IBM Application Delivery Foundation for z/OS 的用户，或者以其他方式有权获得 Z Open Editor 的技术支持，建议您使用其中一个扩展包，该扩展包会自动安装多个 VS Code 扩展。 您还可以从 Mainframe DEV 下载站点下载一个方便的 ZIP 文件。

ZIP文件包含VS Code市场中所有可找到的扩展，以及下文详细列出的Open-VSX扩展包。 此外，它们还包含非 VS Code 扩展程序的组件，因此无法通过扩展程序包获取。 这些命令行界面工具能增强VS Code扩展的功能，让你能够从工作站向 z/OS 发出临时命令，甚至可用于脚本自动化。 我们提供了 Zowe CLI 以及适用于 IBM RSE API 和 IBM CICS 的 Zowe CLI 插件。 这些命令行工具并非 VS Code 扩展运行的必需组件，但能提供额外价值。 特别是，RSE API插件由 IBM 提供，不属于Zowe项目及文档的一部分，因此仅在本在线文档中提供完整说明。

最后，ZIP文件还包含代码签名文件，您可以使用这些文件来验证下载文件的完整性。 ZIP文件中包含的 README.txt 文件详细说明了如何逐个使用签名文件验证所有包含的二进制文件。

从 VSIX 文件安装 IBM Z Open Editor

如果您已下载 Mainframe DEV Center 的 VS Code 扩展 ，请按照以下步骤在 VS Code 中进行安装。

  1. 解压缩下载的压缩文件。

  2. 在文本编辑器中打开 README.txt 文件，并按照其中描述的（可选）步骤，使用提供的代码签名验证各个文件。

  3. 要在VS Code中安装zopeneditor-\<version\>.vsix文件，请点击VS Code活动栏中的扩展图标打开扩展视图。

  4. 单击 ... 图标，显示更多操作的下拉菜单。

  5. 在显示的下拉菜单中，单击从 VSIX 安装...。

  6. 使用弹出的文件选取器可浏览并选择您下载的 VSIX 文件，然后单击安装。

  7. 扩展应该从 VSIX 文件安装。

从Open VSX注册表中安装 IBM Z Open Editor

如果您已经配置或希望配置 VS Code 以使用替代的公共或私有本地 Open VSX Registry，或者您正在使用默认已集成该注册表的 VS Code 兼容编辑器（如 VSCodium 或 Eclipse Theia），那么您也可以通过 IBM Z Open Editor 查找并安装该扩展。 有关如何配置和使用此注册表，请参阅 Open VSX 文档。

从VS Code市场安装 IBM Z Open Editor

当正确的Java运行时安装和配置完成后，您可以使用以下任一方式获取VS Code Marketplace中可用的 IBM Z Open Editor 版本：

然后点击 “安装”按钮 ，等待安装完成。

从扩展包安装

有两个扩展包，其中包括 Z Open Editor 以及其他各种扩展，为客户提供了一种只需点击几下鼠标就能安装和管理 IBM 的 VS Code 工具系列的便捷方法。

要了解有关每个扩展的更多信息，请浏览每个扩展包说明中提供的链接。

要安装扩展包，请遵循从 VS Code Marketplace 或 Open-VSX 安装 Z Open Editor 的相同说明：

  • 在 VS 代码扩展视图或市场网页上搜索软件包。

  • 点击安装按钮。

安装扩展包及其包含的扩展后，可以在 VS 代码扩展视图中启用或禁用每个单独的扩展。 任何扩展的新版本发布后，都会自动安装更新。 无需重新安装扩展包。

验证安装 IBM Z Open Editor

要快速测试 IBM Z Open Editor 是否安装正确，您可以在计算机上打开 COBOL、 PL/I、HLASM、 REXX 或JCL程序文件。 如果您的计算机上没有此类文件，您可以按照 “探索示例文件 ”一节中的说明克隆示例代码库，并打开其中的 COBOL、 PL/I、HLASM、 REXX 或JCL程序文件。 如果您在 COBOL、 PL/I、HLASM、 REXX 或 JCL 代码中看到语法高亮显示，则说明该扩展功能运行正常。

配置Java

IBM Z Open Editor 欢迎页面会显示Java是否成功安装。 要打开欢迎页面，请按 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（ MacOS ），然后输入 IBM Z Open Editor ：欢迎。 查看页面上的先决条件表，并点击Java部分展开。

IBM Z Open Editor 所使用的 COBOL、 PL/I、HLASM、 REXX 以及 JCL 语言服务器均采用 Java 编程语言实现。 因此，Java运行时需要通过设置或程序路径在VS Code中启动。 IBM Z Open Editor 扩展使用 VS Code 设置属性（可添加到 VS Code 用户设置中），用于配置应使用哪些 Java 功能以及如何使用。 这些设置允许您选择特定 Java 安装（以防您有多个安装），以及设置参数，例如您希望扩展使用的内存量。

选择要使用的Java安装

在启动语言服务器之前， IBM Z Open Editor VS Code 扩展中的语言服务器客户端会在多个位置查找匹配的 Java 安装。 它们按以下顺序搜索，并选择第一个版本为 21 或更高且为 64 位的 Java。 如果 Java 安装不符合其中任一标准，则会继续搜索，直到找到合适的版本。

  1. zopeneditor.JAVA_HOME VS Code 用户设置。

  2. java.home VS Code 用户设置。

  3. JAVA_HOME 环境变量。

  4. 为 Z Open Editor 运行环境定义的路径，即默认的Windows或 MacOS 路径。

  5. 典型的特定于平台的位置。 例如，在 MacOS, 上执行 /usr/libexec/java_home -V ；在Windows上，运行 where java.exe 命令以找到有效的Java安装。

如您所见，用户设置始终优先于列出的其他选项，这样，如果您安装了多个版本的Java，就可以为 IBM Z Open Editor 指定一个与计算机上默认版本不同的Java版本。 如果您使用了推荐的 Visual Studio Code for Java安装程序 ，则该安装程序已为您设置了用户 java.home 配置。 另请注意，列表末尾的方法在系统上执行程序时需要大量时间。 要缩短启动时间，您应该考虑用户设置，因为它们提供最佳启动性能。

如果无法找到 Java，请检查 VS Code 输出视图的 Z Open Editor 选项卡是否有任何错误，并尝试通过设置 JAVA_HOME 环境变量或在 VS Code 用户设置中创建一个条目来解决该问题。

要定义用户设置，请使用 “首选项” > “设置” 菜单，然后在 IBM Z Open Editor 下的图形编辑器中找到该设置，或者直接通过使用 Java 安装目录的绝对路径名添加如下条目来编辑设置 JSON 文件。

在 MacOS:

"zopeneditor.JAVA_HOME": "/Library/Java/JavaVirtualMachines/jdk21/Contents/Home"

在 Windows 上：

"zopeneditor.JAVA_HOME": "C:\\Program Files\\Java\\jdk21"
配置Java内存分配

缺省情况下，为 COBOL、PL/I、HLASM 或 REXX 启动个别语言服务器的语言服务器客户机为每个服务器分配最多 512 MB 内存。 语言服务器在启动时消耗的内存更少，然后在您解析程序时分配和释放内存。 但是，当您解析非常大的程序文件并达到预定义的限制时，它们可能会耗尽内存。 为了分配更多的内存，请使用以下VS Code设置来指定新的最大值：

"zopeneditor.server.memoryAllocation": 640

请记住，此值适用于您使用的每种语言，因此在使用 COBOL 和 PL/I 时，您最终的使用量可能是指定数量的两倍。 如果您正在使用较小的程序，或者您的计算机可能不支持这样大量的内存，那么还可以尝试将小于 512 的值用于此设置。