根据 Web Service 描述创建服务提供者应用程序

通过使用 CICS Web Service 助手，可以根据符合 WSDL 1.1 或 WSDL 2.0的 Web Service 描述来创建服务提供者应用程序。

稳定功能：CICS®中的 Web 服务描述语言 (WSDL) 2.0 已稳定。 使用 WSDL 1.1 作为基于 SOAP 的 Web Service 的实际标准。 另请参阅 稳定通知和终止功能。

开始之前

必须先满足以下条件，然后才能创建服务提供者应用程序:
  • 您的 Web Service 描述必须位于 z/OS 中的 UNIX 文件中，并且必须在 CICS 区域中创建合适的提供程序方式管道。
  • 必须向 OMVS 定义用于运行 DFHWS2LS 的用户标识。
  • 用户 ID 必须具有 z/OS UNIX 和 PDS 库的读取权限，以及 LOGFILE、 WSBIND 和 WSDL 参数指定目录的写入权限。
  • 您必须为用户标识分配足够的存储空间，该标识才能运行 Java™ 。 您可以使用任何受支持的 Java 版本。 缺省情况下， DFHWS2LS 使用 JAVADIR 参数中指定的 Java 版本。

关于此任务

您可以使用 Web Service 助手从 WSDL 为服务提供者应用程序创建语言结构。 您也可以使用存储在 IBM WebSphere® Service Registry and Repository (WSRR) 服务器中的 WSDL 文档。

过程

  1. 使用 DFHWS2LS 批处理程序来生成 Web Service 绑定文件以及一个或多个语言数据结构。
    DFHWS2LS 包含大量可选参数，这些参数使您能够灵活地创建应用程序所需的绑定文件和语言结构。 为 Web Service 启用现有应用程序时，请考虑以下选项:
    1. CICS 将使用哪种机制将数据传递到服务提供者应用程序?

      您可以使用通道并在容器中传递数据，也可以使用 COMMAREA。 建议使用通道和容器。 请使用 PGMINT 参数来予以指定。

    2. 要生成哪种语言?

      DFHWS2LS 可生成、C®/C++ 或 语言的数据结构。 COBOL PL/I 使用 LANG 参数指定语言。

    3. 要使用哪个映射级别?

      映射级别越高，可供运行时处理字符和二进制数据使用的控制和支持就越多。 某些可选参数只能在更高映射级别可用。 建议您使用可用的最高级别的映射。 使用 MAPPING-LEVEL 参数指定映射级别。

    4. 您希望 Web Service 请求者使用哪个 URI?

      使用 URI 参数指定相对 URI; 例如， URI=/my/test/webservice 。 该值由 CICS 在创建 URIMAP 资源时使用。

    5. 您将在哪个事务和用户标识下运行 Web Service 请求和响应?

      您可以使用别名事务来运行应用程序，以编写对服务请求者的响应。 别名事务是在用户标识下附加的。

      请使用 TRANSACTION 和 USERID 参数对其进行指定。 这些值在创建 URIMAP 资源时使用。 如果您不想使用特定事务，请不要使用这些参数。

    6. WSDL 文档存储在何处?

      如果要从 WSRR 服务器 (而不是从本地文件系统) 检索 WSDL 文档，那么必须在 DFHWS2LS中指定特定参数。

      至少，您必须将 WSRR-SERVER 参数与 WSRR 服务器的位置一起指定，并将 WSRR-NAME 参数与要从 WSRR 中检索的 WSDL 文档的名称一起指定。

      有关使用 WSRR 时可能需要指定的其他参数的信息，请参阅 DFHWS2LS: WSDL 到高级语言的转换。

    7. 如果要从 WSRR 服务器检索 WSDL 文档，是否要使用安全连接来执行此操作?

      您可以通过设置相应参数以安全地与 WSRR 进行互操作，从而使用安全套接字层 (SSL) 加密。 有关示例，请参阅 如何将 SSL 用于 Web Service 助手和 WSRR 的示例。

    提交 DFHWS2LS时， CICS 会生成 Web Service 绑定文件，并将其放置在使用 WSBIND 参数指定的位置。 语言结构放置在使用 PDSLIB 参数指定的分区数据集中。

  2. 将生成的 Web Service 绑定文件复制到要用于 Web Service 应用程序的提供程序方式 PIPELINE 资源的 pickup 目录。
    必须以二进制方式复制绑定文件。
  3. 可选: 将包含一个或多个 Web Service 描述的 Web Service 描述或归档文件复制到与 Web Service 绑定文件相同的目录中。
    归档文件必须是 .zip 文件，并且文件名必须与 WSDL 文件名匹配。 通过此副本，您可以发现 WSDL。
  4. 编写服务提供者应用程序以与生成的语言结构进行交互，并实现所需的业务逻辑。
  5. 创建 WEBSERVICE 资源和两个 URIMAP 资源。
    • WEBSERVICE 资源将 Web Service 绑定文件封装在 CICS 中，并在运行时使用。
    • 第一个 URIMAP 资源为 CICS 提供用于使 WEBSERVICE 资源与特定 URI 相关联的信息。
    • 第二个 URIMAP 资源为 CICS 提供用于使 WSDL 归档文件或 WSDL 文档与特定 URI 相关联的信息。
      • 此 URI 与与 WEBSERVICE 关联的 URI 具有相同的路径，并附加后缀 ?wsdl 。
      • 创建此 URIMAP 资源是为了使外部请求者可以使用 URI 来发现 WSDL 归档文件或 WSDL 文档。
      • 仅当已将包含一个或多个 Web Service 描述的 Web Service 描述或归档文件复制到与 Web Service 绑定文件相同的目录时，才会创建此 URIMAP 资源。
      • 如果提货目录包含 WSDL 归档文件和 WSDL 文档，那么 URI 仅返回归档文件中的 WSDL。
      • 此功能仅适用于使用管道扫描操作安装的 Web Service。

    您可以通过以下方式创建资源:

    1. 使用 PIPELINE SCAN 命令动态创建 WEBSERVICE 资源和 URIMAP 资源。
    2. 自行定义资源。 如果使用 CICS Explorer 在 CICS 束中定义 WEBSERVICE 资源，那么可以选择导入 Web Service 绑定文件和 WSDL 文档或 WSDL 归档文件，并将这些文件包括在束中。 然后，可以生成 URIMAP 定义以支持 Web Service 并将这些定义打包到捆绑软件中。 有关使用 CICS Explorer 在 CICS 捆绑包中创建和编辑资源的更多帮助，请参阅 在 CICS Explorer 产品文档中使用捆绑包。

结果

如果在提交 DFHWS2LS时迂到任何问题，或者资源未正确安装，请参阅 诊断部署错误。