通过 JSON 模式生成映射

要从 JavaScript 对象表示法 (JSON) 或从应用程序数据创建应用程序数据，请创建映射以描述 CICS® 应如何在运行时变换数据和 JSON。 您可以从 JSON 模式开始。 生成语言结构和映射后，可以使用该语言结构开发 CICS 应用程序，并将 JSON 转换为应用程序数据，反之亦然。

开始之前

在创建映射之前，必须确保满足以下前置条件:
  • 您必须具有描述 JSON 记录的 JSON 模式。
  • 必须配置用于运行 DFHJS2LS 的用户标识以使用 z/OS® UNIX。
  • 用户标识必须具有读许可权才能访问 JSON 模式，并具有写许可权才能将输出放在 z/OS UNIX 上的相应目录中。
  • 您必须为用户标识分配足够的存储空间，该标识才能运行 Java™ 。 您可以使用任何受支持的 Java 版本。

关于此任务

使用 CICS JSON 助手为应用程序记录创建数据映射。 CICS JSON 助手会创建 CICS 束，并发出有关其在语言结构中标识的任何不受支持项的错误消息。 CICS JSON 助手的参考信息列出了适用于每种高级语言的限制。 有关更多信息，请参阅 DFHJS2LS: JSON 模式到可链接接口的高级语言转换。

过程

运行 DFHJS2LS 批处理作业。 DFHJS2LS 具有您为满足需求而选择的可选参数，例如，选择特定代码页。 请至少使用以下参数:

  • 在 BUNDLE 参数中指定捆绑软件资源的名称和位置。
  • 在 JSON-SCHEMA 参数中指定 JSON 模式文件的名称和位置。
  • 在 MAPPING-LEVEL 参数中指定映射级别。 虽然您可以使用任何映射级别，但要获取最高级的映射选项，请使用最新的映射级别。
  • 在 LANG 参数中指定生成的语言结构的高级语言。
  • 指定在 PDSMEM 和 PDSCP 参数中描述应用程序记录的语言结构的位置和代码页。 DFHJS2LS 创建语言结构，但不创建目录结构。
  • 指定用于 CICS 中的 JSONTRANSFRM 束资源的名称。 应用程序使用此名称来标识 JSON 映射。

    批处理作业在 z/OS UNIX 上创建捆绑软件目录结构。 捆绑软件目录具有包含捆绑软件清单的 META-INF 子目录。 批处理作业还会创建 JSON 绑定，并使用您为 JSONTRANSFRM 和 JSON-SCHEMA 参数指定的文件名将 JSON 模式复制到捆绑软件目录中。 批处理作业还会在 PDSMEM 和 PDSLIB 参数中指定的位置创建语言结构。

    安装指定此 JSON 绑定的 BUNDLE 资源。 JSONTRANSFRM 捆绑软件资源动态创建 JSONTRANSFRM 资源，该资源定义 JSON 模式和绑定文件的位置。 当您使用 CICS Explorer® 查看已安装的束的内容时，此束资源在 CICS 中可视。 它不是正常的 CICS 资源，并且在使用 CEMT 或 CICSPlex SM WUI 时不可见。

结果

将生成包含一个 JSON 变换的 CICS 束。 生成语言结构。
以下示例显示了指定了最小参数集的 DFHJS2LS 。
//JS2LS JOB 'accounting information',name,MSGCLASS=A
// SET QT=''''
//JCLLIB JCLLIB ORDER=FPHLQ.SDFHMOBI
//JAVAPROG EXEC DFHJS2LS,
//INPUT.SYSUT1 DD *
LANG=COBOL
BUNDLE=/u/exampleapp/bundle/test2
LOGFILE=/u/exampleapp/jsbind/example.log
MAPPING-LEVEL=3.0
PDSLIB=/u/exampleapp
PDSMEM=CPYBK2
JSONTRANSFRM=example.jsbind
JSON-SCHEMA=/u/exampleapp/example.json
/*

下一步操作

编写应用程序以将应用程序数据转换为 JSON ，反之亦然。 您可以对这两个变换使用相同的映射。