设置属性组

使用 ZAPP 属性组中 libraries 项的名称 syslib 来解析以下类型的语句:

• COPY <COPYBOOK_NAME> (COBOL 和 HLASM)

• %INCLUDE <INCLUDE_NAME> (PL/I)

• /*%INCLUDE <INCLUDE_NAME> */ (REXX)

对于 locations 的值，请提供一个目录路径名数组（用于本地属性组）或数据集名数组（用于 mvs 属性组），以便 IBM Z Open Editor 查找包含的内容。 您可以提供多个路径，以解析不同文件夹中的包含。 对于本地 libraries 项，可以指定相对于 ZAPP 文件所在工作空间的路径或开发机器上的绝对路径。

使用 libraries 项设置的定制名称来解析以下类型的语句 (将 <LIBRARY_NAME> 替换为您为 te 项指定的名称):

• COPY <COPYBOOK_NAME> IN <LIBRARY_NAME> (COBOL)

• %INCLUDE <LIBRARY_NAME> (<INCLUDE_NAME>) (PL/I)

• /*%INCLUDE <LIBRARY_NAME>(<INCLUDE_NAME>) */ (REXX)

您可以在属性组的 libraries 数组中提供多个库项。 libraries 数组中的每个库项都由以下属性组成:

• name 属性必须与程序中使用的库名匹配。 例如，要解析 COBOL 语句 COPY COPYFILE IN MYLIB 中的库引用，name 的值必须为 "MYLIB"。

• type 属性可以是 local 或 mvs ，指定提供的 locations 是本地搜索路径实体还是 MVS 数据集。

• locations 属性是关联库名的目录或数据集名称的数组。

Glob 模式可以有以下语法：

• ?，以匹配路径段中的一个字符

• *，以匹配路径段中的一个或多个字符

• **，以匹配任意数量的路径段。

请参阅 minimatch glob patterns 文档 以获取更多信息。

针对 Windows 和 Mac 使用基本 glob 模式的示例：

propertyGroups:
- name: cobol-copybooks
  language: cobol
  libraries:
    - name: syslib
      type: local
      locations:
        - "zopeneditor-sample/**",
        - "zopeneditor-sample/**/COPYFILES"
    - name: MYFILE
      type: local
      locations:
        - "zopeneditor-sample/**/COPY*",
        - "zopeneditor-sample/**/INCLUD?LIB"

需要注意的一些事项:

• Windows: 仅在 glob 表达式中使用正斜杠 (/)。 虽然 Windows 使用 / 或 \ 作为路径分隔符，但此 glob 实现仅使用 / 字符。 在 glob 表达式中只能使用正斜杠。 反斜杠将始终解释为转义字符，而不是路径分隔符。

• 性能警告: Using glob expressions can have an impact on the time it takes for Z Open Editor to find include files if it has to search through hundreds of local file directories. 修改搜索模式，尽可能匹配最少数量的文件夹，以提高查找副本和包含文件的性能。

IBM Z Open Editor 属性组位置可以是相对于工作区根的路径模式。 您希望避免指向工作空间外部的模式，因为对于要与之共享 ZAPP 文件的每个开发者，这些模式可能有所不同。 这对于多根工作空间也很重要: 您不想引用另一个工作空间中的文件。 相反，每个工作空间都可以有自己的 ZAPP 文件，并且所有工作空间的属性组都将按照在多根 .code-workspace file中列出工作空间的顺序进行并置。

IBM Z Open Editor 支持 locations 项目的绝对路径模式。

Windows：

propertyGroups:
- name: cobol-copybooks
  language: cobol
  libraries:
    - name: syslib
      type: local
      locations:
        - "C:\\Users\\<username>\\Desktop\\zopeneditor-sample\\COPYBOOK",
        - "C:/Users/<username>/Desktop/zopeneditor-sample/INCLUDES"
    - name: MYFILE
      type: local
      locations:
        - "C:/Users/<username>/Desktop/zopeneditor-sample/COPYLIB",
        - "C:\\Users\\<username>\\Deskto\\zopeneditor-sample\\INCLUDELIB"

Mac：

propertyGroups:
- name: cobol-copybooks
  language: cobol
  libraries:
    - name: syslib
      type: local
      locations:
        - "/Users/<username>/Desktop/zopeneditor-sample/COPYBOOK",
        - "/Users/<username>/Desktop/zopeneditor-sample/INCLUDES"
    - name: MYFILE
      type: local
      locations:
        - "/Users/<username>/Desktop/zopeneditor-sample/COPYLIB",
        - "/Users/<username>/Desktop/zopeneditor-sample/INCLUDELIB"

从 IBM Z Open Editor 1.2.0 开始，通过本地 libraries 项匹配的文件名默认不区分大小写。 例如，如果在由本地属性组指定的工作空间文件夹中有名为 book1.cpy 的本地副本文件，那么 COBOL 语句 COPY BOOK1. 仍将解析该文件，即使在使用区分大小写的磁盘格式的区分大小写的操作系统（例如 Linux 或 Mac）上。 在较早版本的 Z Open Editor 中，这在区分大小写的操作系统上严格区分大小写。

虽然用户可以利用此新行为更灵活地创建小写的副本和包含文件，但这可能会在其成员使用不同操作系统或从 VS Code 切换到 Eclipse Che 的团队中带来问题。 例如，在区分大小写的操作系统上，文件可以在除了大小写不同之外同名的文件夹（例如 Book1 和 BOOK1）中创建，但这会在不区分大小写的文件系统（如 Windows）上造成问题。 因此，要强制实施严格大小写匹配，您可以启用用户设置 "zopeneditor.enforceCaseSensitiveIncludeFileNames"，该设置缺省情况下为 false。 将其设置为 true 意味着即使在 Windows 上，也需要程序代码中所指定的文件名的严格相同大小写。 这适用于 COBOL、PL/I 和 HLASM。

注：此行为也适用于属性组中指定的路径名，它们在缺省情况下不区分大小写，但可以使用此设置使其区分大小写。 但是，这仅适用于 Windows 和 Mac。 在 Linux 上，因而在 Eclipse Che 上，属性组路径名始终区分大小写。 在 Linux 上按该方式配置时，仅文件系统上的文件名以不区分大小写的方式进行匹配。

可以编写 COBOL 或 PL/I 程序以使用 SQL 通信区 (SQLCA) 和 SQL 描述符区域 (SQLDA) 来检查嵌入式 SQL 语句的返回状态，或者程序可以使用 SQL 诊断区域来检查返回状态。

SQLCA 和 SQLDA 包含通常是内置的，不会添加到 zopeneditor 属性组中。 在 IBM Z Open Editor 中，SQLCA 和 SQLDA 副本将从搜索中排除，因为它们不存在，或者因为它们对于开发没有用处。 它不会在属性组中提及的 syslib 或 libraries 中查找这些副本。