REXX 编辑教程

关于本教程

对于该教程，您将承担 REXX 开发者的角色，收到增强 RSAM1 输出的要求，以显示输出文件的内容，该输出文件是两个输入文件的组合。当前版本仅读取两个文件，并将记录写入输出文件。 RSAM 应用程序位于 https://github.com/IBM/zopeneditor-sample。

先决条件

安装 IBM Z® Open Editor 及其必备软件，例如 Java™，如入门中所述。

过程

要增强报告，首先需要导入样本应用程序的源代码。
- 在 VS Code 中，单击终端 > 新建终端以打开终端。
- 在“终端”窗口中，通过输入来浏览至源代码的期望目录，例如：
```
cd /c/Users/Public
```
- 要从 Git 存储库克隆源代码，请输入提供的样本文件的 git 存储库：
```
git clone https://github.com/IBM/zopeneditor-sample.git
```
- 克隆完成后，单击文件 > 打开文件夹。然后，在“打开文件夹”窗口中，选择克隆的 C:/Users/Public/zopeneditor-sample 目录，然后单击选择文件夹。现在，该文件夹在 VS Code 左侧的"资源管理器"视图中打开。
  
  当前样本应用程序由 REXX 程序、RSAM1 和 JCL 组成，用于设置应用程序文件 (REXALLOC) 和数据源文件（FILEIN1 和 FILEIN2）。
  
  RSAM1 读取 FILEIN1 数据文件并将记录写入 FILEOUT 数据文件。然后，它读取 FILEIN2，并将记录写入 FILEOUT。
（可选）在您查看 VS Code 中的源代码时，可以使用“大纲”视图高效地浏览和导航程序代码。请注意，仅当您在 VS Code 中打开了一个文件或程序之后，才能使用“大纲”视图。

如果“大纲”视图尚未展开，那么可以通过单击视图 > 打开视图 > 大纲来打开该视图。通过查看此视图中的项，您可以粗略了解该程序执行的操作。

注意：REXX“大纲”视图仅显示内部例程。 RSAM1.rexx 是在编辑教程中使用的简单程序，因此只有两个内部例程在“大纲”视图中显示。
（可选）在 RSAM1.rexx 文件中，您将在打开的文件中看到代码语法突出显示，这有助于您快速区分注释、字符串、常量、变量、关键字、标签、例程、比较和算术。

无法识别的语句和表达式以红色突出显示，这样您可以相应地进行快速更正，并减少编译错误。要查看打开的文件中的所有语法错误，请单击视图 > 问题，或单击状态栏底部的错误和警告图标。单击列表项以直接转至问题。
修改 RSAM1.rexx 文件中的代码以添加新的内部例程 fileout，该例程将通过 FILEOUT 读取，并显示该文件中的每个记录。

例如，将光标放在第 42 行上并按 Enter 键以在第 43 行上开始新行。开始输入命令 CALL fileout，在输入时，您可以从显示的代码补全建议列表中进行选择。您还将看到一个弹出窗口，其中显示命令的名称和命令的格式。
（可选）悬停功能作用于 REXX 关键字指示信息。您可以将鼠标悬停在关键字上以查看其定义和格式。
（可选）编辑器可以显示代码中对某个变量或内部例程的所有引用。双击变量或内部例程名称以突出显示整个名称，然后右键单击它，您可以看到以下可用操作：
- 单击查找所有引用：Alt+Shift+F12 (Windows) 或 Option+Shift+F12 (Mac)
  
  变量或段落的“结果引用”视图显示在屏幕左侧。单击任何结果以转至文件中的该位置。
- 单击快速查看引用：Shift+F12（Windows 和 Mac）
  
  “结果引用”视图显示在变量或段落下方的 CodeLens 框中。单击任何结果以转至文件中的该位置。
打开 VS Code 中的集成 Git，并创建名为 display-fileout-content 的隔离分支，其中在您将更改推送到源存储库之前，只有您自己可以访问源代码。

要创建分支：
1. 在左下角的 VS Code 中，单击。
2. 然后，从显示在 VS Code 顶部的下拉菜单中，单击创建新分支。
3. 指定分支名称 display-fileout-content，然后按 Enter 键确认。工作空间现在切换到隔离的 display-fileout-content 分支。
将更改落实到 display-fileout-content 分支中。

既然您已执行各种代码更改和优化，现在可以将应用程序的此文件版本落实到 SCM 以保留并共享。

要落实更改，请单击 VS Code 左侧的“源代码控制”图标。在打开的“源代码控制”面板中，更改的程序列示在 CHANGES 部分中。在 CHANGES 部分中，将鼠标悬停在 RSAM1.rexx 程序名上，然后单击阶段更改 (+) 图标以将更改移至登台区域。在“消息”文本框中，输入更改的注释（如显示文件输出内容），然后单击落实图标以落实更改。

祝贺您完成本教程。有关代码编辑的可用功能的更全面列表，请参阅进行 REXX 代码更改。