您可以通过配置具有终端处理程序 DFHPIJT的提供程序管道来设置用于处理 JSON 请求的非 Java 环境。 要为非 Java JSON 服务提供程序创建 CICS® 基础结构,必须创建管道配置文件并创建大量 CICS 资源。
限制: 如果使用此非 Java JSON 管道来处理 JSON 请求,那么以下限制适用:
- 不支持 RESTful JSON Web Service。
- 不支持管道中的上下文切换。
- 无法在 JSON 管道中使用 SOAP 和 JSON Web Service。 DFHPIJT 仅处理 JSON 消息。 接收 SOAP 消息会导致错误响应。
过程
- 定义传输基础结构。
- 定义要包含在管道配置文件中的消息处理程序,以处理入站 Web Service 请求及其响应。
如果要在管道中执行自己的处理,那么必须创建消息处理程序。 请参阅 消息处理程序 以获取详细信息。 如果您决定创建定制消息处理程序,那么要优化性能,必须使它们成为线程安全程序。
- 创建包含消息处理程序的 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> 元素。 如果指定了应用程序处理程序,那么不会调用该处理程序。
有关管道配置文件中可用的选项的更多信息,请参阅 服务提供者和服务请求者管道中使用的元素。
- 将管道配置文件复制到 z/OS® UNIX 中的合适目录。
- 更改管道配置文件许可权以允许 CICS 区域读取该文件。
- 创建 PIPELINE 资源。
PIPELINE 资源定义管道配置文件的位置。 它还指定 检取目录,这是包含 Web Service 绑定文件的 z/OS UNIX 目录。 对每个不同的管道配置重复此步骤。
安装 PIPELINE 资源或执行 PIPELINE SCAN 时, CICS 会读取指定拾取目录中的
.wsbind 文件,并动态创建相应的
WEBSERVICE 和
URIMAP 资源。
- 除非使用自动安装的 PROGRAM 定义,否则请为管道中运行的每个程序创建 PROGRAM 资源。 其中包括通常在事务 CPIH 下运行的目标应用程序。 事务是使用属性 TASKDATALOC (ANY)定义的。 因此,在链接编辑程序时,必须指定 AMODE (31) 选项。
结果
您已创建每个服务提供者所需的基础结构,现在可以在 CICS 系统上安装这些资源。
下一步操作
安装资源。 您可以在需要时扩展配置,以定义其他传输基础结构或创建其他管道。