创建绑定文件和模式文件以与 z/OS Connect 配合使用

z/OS Connect 能够选择对用于调用 z/OS 操作系统上的业务资产的请求和响应有效内容进行变换。z/OS Connect 提供了称为 BBGLS2JS 和 BBGJS2LS 的两个新的实用程序。

开始之前

在创建绑定文件和模式文件之前,请确保设置符合下列先决条件:
  • 您的高级语言数据结构必须满足以下条件:
    • 必须单独从源程序定义数据结构;例如,在 COBOL 副本中。
    • 如果 PL/I 或 COBOL 应用程序使用不同的数据结构进行输入和输出,那么必须在分区数据集的两个不同成员中定义这些数据结构。如果将相同结构用于进行输入和输出,那么必须在单个成员中定义该结构。
    • 对于 C 和 C++,您的数据结构可以位于分区数据集的同一成员中。
  • 分区数据集中必须提供了语言结构。
  • 您必须向开放式多重虚拟存储器 (OMVS) 定义 BBGLS2JS 或 BBGJS2LS 用来运行的用户标识。
  • 该用户标识必须对 z/OS® UNIX 和 PDS 库具有读许可权,对于在 LOGFILE、WSBIND 以及 JSON-SCHEMA-REQUEST 和 JSON-SCHEMA-RESPONSE 输出参数中指定的目录具有写许可权。
  • 必须为该用户标识分配足够大的存储空间来运行 Java™。您可以使用任何受支持的 Java 版本。缺省情况下,BBGLS2JS/BBGJS2LS 实用程序在 USS 环境中使用由 JAVA_HOME 指定的 Java 版本。否则,该标识使用 PATH 语句中指定的 Java 版本。

关于此任务

BBGLS2JS 实用程序读取 COBOL 副本、PLI 或者 C 结构文件,并生成绑定文件和 JSON 模式文件。BBGJS2LS 实用程序读取 JSON 模式,并生成相应的绑定文件和语言结构文件(COBOL 副本、PL/I 或者 C 结构头文件)。这些实用程序类似于现有 DFHLS2JS 和 DFHJS2LS 工具(它们是 CICS Transaction Server Mobile 扩展功能部件包的一部分)。当输入参数相同时,符号参数不同。

过程

  1. 获取 BBGLS2JS JCL 过程。 GitHub 中提供了 JCL 过程 BBGLS2JS 和 BBGJS2LS。有关如何使用 JCL 的信息,请参阅 GitHub 中的自述文件。您需要将 JCL 过程从此位置复制到 z/OS 系统上的 JCL 过程库中名为 BBGLS2JS 的成员。
  2. 使用 BBGLS2JS 过程根据语言结构来生成 z/OS Connect 服务绑定文件。 您将需要提供 JCL 以使用输入参数来调用 BBGLS2JS 过程。请参阅 BBGLS2JS 参考文档以了解有关输入参数的信息以及帮助您使用该过程的示例作业。当您提交 BBGLS2JS 过程时,该实用程序将在您使用 WSBIND 参数指定的位置生成服务绑定文件。所生成的 JSON 模式放置在您通过 JSON-SCHEMA-REQUEST 和 JSON-SCHEMA-RESPONSE 参数指定的位置。
  3. 查看所生成的 JSON 模式。 这些模式用来定义输入和输出数据格式以与 z/OS Connect 服务交互。应用程序开发者在创建应用程序以调用服务和传递 JSON 请求有效内容时,必须使用这些模式。
    注: 更改所生成的模式会使 WSBIND 中所生成的绑定文件失效。如果您想要更改该模式(例如,将该模式中的字段重命名),您必须使用 BBGJS2LS 来生成新的绑定文件以及新的一组语言结构。必须将应用程序重新编译才能使用新的语言结构。

用于指示主题类型的图标 任务主题

文件名:twlp_zconnect_binding_and_schema.html