从数据结构创建服务提供程序

使用 CICS® Web Service 助手从高级语言数据结构创建服务提供者应用程序。

按照以下步骤，从高级数据结构创建服务提供程序：

1. 如果服务提供程序接口使用通道和许多容器，请创建一个描述 JSON 中接口的通道描述文档。 必须将通道描述文档保存在 z/OS UNIX 上的合适目录中。
   CICS 使用此文档来构造和解构来自通道上的容器的 JSON 消息。 或者，您可以使用通道中的一个容器，而不是创建通道描述文档。

   有关如何创建通道描述文档的更多信息，请参阅 创建通道描述文档。

2. 使用 DFHLS2JS 批处理程序从语言结构生成 Web Service 绑定文件和 Web Service 描述。
   可以在 HLQ .XDFHINST 中找到 DFHLS2JS 批处理程序，其中 HLQ 是 CICS的安装位置。 DFHLS2JS 包含大量可选参数，这些参数为您提供灵活性，以便创建您应用程序所需的绑定文件和语言结构。 当启用现有应用程序的 Web Service 时，考虑以下选项：

   • 您希望 CICS 使用哪种机制将数据传递到服务提供者应用程序? 您可以使用通道并传递容器中的数据或使用 COMMAREA。 通过使用 PGMINT 参数指定机制。 如果应用程序接口使用通道和许多容器，请指定 REQUEST-CHANNEL 参数和 (可选) RESPONSE-CHANNEL 。 仅当映射级别为 3.0 或更高级别时可以使用这些参数。
   • 您要使用哪种映射级别？ 映射级别越高，可供运行时处理字符和二进制数据使用的控制和支持就越多。 某些可选参数只能在更高映射级别可用。 您必须在 MAPPING-LEVEL 参数中指定最高级别的可用映射。
   • 您想要 Web Service 使用哪种 URI？ 使用 URI 参数指定绝对 URI; 例如， URI = http://www.example.org:80/my/test/webservice。 创建 URIMAP 资源时，将使用此地址的相对部分 /my/test/webservice 。
   提交 DFHLS2JS时， CICS 会生成 Web Service 绑定文件，并将其放在使用 WSBIND 参数指定的位置。 生成的 JSON 模式将放置在您使用 JSON-SCHEMA-REQUEST 和 JSON-SCHEMA-RESPONSE 参数指定的位置。
3. 查看生成的 JSON 模式。
   这些模式用于定义 JSON Web Service 的输入和输出数据格式。 当创建应用程序以与 JSON Web Service 进行交互时，应用程序开发人员必须使用这些模式。

   注: 更改生成的模式会使生成的 Web Service 绑定文件 WSBind失效。

   如果您要更改模式（例如，重命名模式内的字段），您必须使用 DFHJS2LS 生成新的 Web Service 绑定文件和一组新的语言结构。 必须更改 CICS 中的应用程序以使用新的语言结构。

4. 将 Web Service 绑定文件复制到您要用于 Web Service 应用程序的提供程序方式流水线的 pickup 目录。
   必须以二进制方式复制 Web Service 绑定文件。
5. 使用 PIPELINE SCAN 命令可动态创建 WEBSERVICE 资源和 URIMAP 资源。
   • WEBSERVICE 资源包含 CICS 中的 Web Service 绑定文件，并在运行时使用。
   • URIMAP 资源为 CICS 提供用于将 WEBSERVICE 资源与特定 URI 相关联的信息。

   或者，您可以自己定义资源。