为非 Java JSON 服务提供者创建 CICS 基础结构

您可以通过配置具有终端处理程序 DFHPIJT的提供程序管道来设置用于处理 JSON 请求的非 Java 环境。 要为非 Java JSON 服务提供程序创建 CICS® 基础结构,必须创建管道配置文件并创建大量 CICS 资源。

限制: 如果使用此非 Java JSON 管道来处理 JSON 请求,那么以下限制适用:
  • 不支持 RESTful JSON Web Service。
  • 不支持管道中的上下文切换。
  • 无法在 JSON 管道中使用 SOAP 和 JSON Web Service。 DFHPIJT 仅处理 JSON 消息。 接收 SOAP 消息会导致错误响应。

过程

  1. 定义传输基础结构。

    定义用于定义接收入站请求的端口的 TCPIPSERVICE 资源。 请参阅 Web Service 的CICS 资源 以获取详细信息。

  2. 定义要包含在管道配置文件中的消息处理程序,以处理入站 Web Service 请求及其响应。

    如果要在管道中执行自己的处理,那么必须创建消息处理程序。 请参阅 消息处理程序 以获取详细信息。 如果您决定创建定制消息处理程序,那么要优化性能,必须使它们成为线程安全程序。

  3. 创建包含消息处理程序的 XML 管道配置文件。

    在配置文件中,必须在 <terminal_handler> 元素中指定终端处理程序 DFHPIJT ,如 图 1 中所示DFHPIJT 是 CICS提供的 JSON 处理程序,用于启用 JSON 消息的非 Java 处理。

    图 1。 为 JSON 消息的非 Java 处理指定终端处理程序 DFHPIJT
      <service>
        <terminal_handler>
          <handler>
              <program>DFHPIJT</program><handler_parameter_list/>
          </handler>
        </terminal_handler>
      </service>
    
    注:DFHPIJT 用作终端处理程序时,请勿在管道配置文件中定义应用程序处理程序,即管道配置文件不应包含 <apphandler> 元素。 如果指定了应用程序处理程序,那么不会调用该处理程序。

    有关管道配置文件中可用的选项的更多信息,请参阅 服务提供者和服务请求者管道中使用的元素

  4. 将管道配置文件复制到 z/OS® UNIX 中的合适目录。
  5. 更改管道配置文件许可权以允许 CICS 区域读取该文件。
  6. 创建 PIPELINE 资源。
    PIPELINE 资源定义管道配置文件的位置。 它还指定 检取目录,这是包含 Web Service 绑定文件的 z/OS UNIX 目录。 对每个不同的管道配置重复此步骤。
    安装 PIPELINE 资源或执行 PIPELINE SCAN 时, CICS 会读取指定拾取目录中的 .wsbind 文件,并动态创建相应的 WEBSERVICEURIMAP 资源。
  7. 除非使用自动安装的 PROGRAM 定义,否则请为管道中运行的每个程序创建 PROGRAM 资源。 其中包括通常在事务 CPIH 下运行的目标应用程序。 事务是使用属性 TASKDATALOC (ANY)定义的。 因此,在链接编辑程序时,必须指定 AMODE (31) 选项。

结果

您已创建每个服务提供者所需的基础结构,现在可以在 CICS 系统上安装这些资源。

下一步操作

安装资源。 您可以在需要时扩展配置,以定义其他传输基础结构或创建其他管道。