WEBSERVICE 资源定义

WEBSERVICE 资源定义了在 Web Service 设置中部署的 CICS 应用程序的运行时环境的各个方面，在该设置中已经使用 CICS Web Service 助手生成了应用程序数据结构与 SOAP 消息之间的映射。虽然 CICS 为 WEBSERVICE 资源提供常用资源定义机制，但通常使用助手生成的输出动态安装这些资源。

由 WEBSERVICE 资源定义的运行时环境的各个方面包括:

一种管道: 定义一组对 Web Service 请求和响应执行操作的消息处理程序。 WEBSERVICE 资源指定单独的 PIPELINE 资源，而该资源又指定管道配置文件。
Web Service 绑定文件: 包含在运行时用于执行应用程序数据结构与 SOAP 消息之间的映射的信息。 Web Service 绑定文件由 CICS提供的工具生成。
Web Service 描述: 仅当需要对 SOAP 消息进行运行时验证时，才会使用 Web Service 描述。将针对其模式 (嵌入在 Web Service 描述中) 对每条消息执行验证。

入站 Web Service 请求 (即客户机通过其在 CICS中调用 Web Service 的请求) 由 URIMAP 资源与 WEBSERVICE 资源相关联。 URIMAP 标识适用于入站消息中 URI 的 WEBSERVICE 资源 ;WEBSERVICE 指定要对消息执行的处理。

虽然 CICS 提供了通常的资源定义机制，用于创建 WEBSERVICE 资源并将其安装在 CICS 区域中，但您可以改为使用扫描机制在正在运行的 CICS 系统中动态安装 WEBSERVICE 资源。此方法的优点是减少了所需的资源定义量，并且 CICS 可以直接使用开发时提供的信息。

要调用扫描机制，请使用 PERFORM PIPELINE 命令。

动态安装的 WEBSERVICE 的名称派生自从中生成 WEBSERVICE 定义的 Web Service 绑定文件的名称，最大长度为 32 个字符; 从 CSD 安装或使用 EXEC CICS CREATE WEBSERVICE 安装的 WEBSERVICE 定义的名称限制为 8 个字符。例如，其 zFS 名称为 /samples/Webservices/WSDir/InquireSingle.wsbind 的 Web Service 绑定文件将生成名为 InquireSingle 的 WEBSERVICE 定义

有关使用 CEMT 和 CEDA 安装 Web Service 资源定义的信息，请参阅安装 WEBSERVICE 资源定义。有关使用 BAS 的信息，请参阅使用 BAS Web Service 资源定义。

CICS 束中的 WEBSERVICE 资源

您可以使用 CICS 束来创建，编辑和安装 WEBSERVICE 资源定义。如果以此方式创建 WEBSERVICE 资源，那么必须使用 CICS 束来管理该资源的生命周期，并且不能单独管理该资源。

您可以使用 EXEC CICS INQUIRE WEBSERVICE 或 CEMT INQUIRE WEBSERVICE 命令来查询由 CICS 束动态生成的 WEBSERVICE 资源。但是，不能对动态生成的 WEBSERVICE 资源发出 DISCARD 命令。必须对 BUNDLE 资源发出该命令，并且 CICS 会将其应用于 WEBSERVICE 资源。有关在 CICS 束中定义资源的更多信息，请参阅定义 CICS 束。

语法

属性

WEBSERVICE(名称)

指定 WEBSERVICE 资源的 1-8 字符名称。

可接受的字符：

A-Z a-z 0-9 $ @ #./ - _ % &?!:| " = ¬,; < >

有效字符在代码页 IBM® -037 显示时列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。

最好不要使用以 DFH 开头的名称，因为这些字符保留供 CICS使用。当您升级或提供新功能或修订时， CICS 可以将其删除或废弃，并将其替换为 CICS 资源。

ARCHIVEFILE( hfsfile )

指定包含一个或多个 WSDL 文件的归档的 1-255 个字符的标准名称或相对名称。归档的受支持格式为 .zip。

对于由联机资源定义定义的 WEBSERVICE 资源的归档，文件路径是标准路径 (如果以正斜杠 (/) 作为前缀) ，或者相对于 CICS 区域用户标识的 HOME 目录。
对于 CICS 束中定义的 WEBSERVICE 资源的归档，文件路径相对于 CICS 束的根目录。 zFS 文件必须与 WEBSERVICE 资源一起打包在 CICS 束中。有关更多信息，请参阅引用捆绑软件中的 zFS 工件。

指定的值必须是 UNIX 文件的有效名称：

它不得包含嵌入的空格字符。
它不得包含 / 字符的连续实例。
它区分大小写。

可接受的字符：

A-Z a-z 0-9。 /_ # @-

当代码页为 IBM-037时，有效字符将按其呈现方式列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。

GROUP（组名）

每个资源定义都必须具有 GROUP 名称。资源定义成为组的成员，并在安装组时安装在 CICS 系统中。

可接受的字符：

A-Z 0-9 $ @ #

当代码页为 IBM-037时，有效字符将按其呈现方式列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。

输入的任何小写字符都将转换为大写。

GROUP 名称的长度最多可以为 8 个字符。小写字符被视为大写字符。

DESCRIPTION(文本)

您可以提供在此字段中定义的资源的描述。描述文本的长度最多可以为 58 个字符。您可以使用的字符没有任何限制。但是，如果使用括号，请确保对于每个左括号都有一个匹配的右括号。如果使用 CREATE 命令，那么对于文本中的每个单撇号，将编码两个撇号。

PIPELINE（管道名称）

指定与此 WEBSERVICE 资源相关联的 PIPELINE 资源的 1-8 字符名称。

可接受的字符：

A-Z 0-9 $ @ #

当代码页为 IBM-037时，有效字符将按其呈现方式列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。

除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

VALIDATION（否 |YES )

指定是否应在运行时针对 Web Service 描述中的相应模式执行 SOAP 消息的完整验证。根据 SOAP 消息的模式验证该消息会产生相当大的处理开销，您通常应该指定 VALIDATION (NO)。

完全验证可确保发送和接收的所有 SOAP 消息都是与 XML 模式相关的有效 XML。如果指定了 VALIDATION (NO) ，那么将执行检查以确保消息包含格式正确的 XML ，但不保证 XML 有效。

WSBIND( hfsfile )

指定 z/OS UNIX 上网络服务绑定文件的 1-255 个字符的全称或相对名称。

对于由联机资源定义定义的 WEBSERVICE 资源的 Web Service 绑定文件，文件路径是标准路径 (如果以正斜杠 (/) 作为前缀) ，或者相对于 CICS 区域用户标识的 HOME 目录。
对于在 CICS 束中定义的 WEBSERVICE 的 Web Service 绑定文件，文件路径相对于 CICS 束的根目录。 zFS 文件必须与 WEBSERVICE 资源一起打包在 CICS 束中。有关更多信息，请参阅引用捆绑软件中的 zFS 工件。

指定的值必须是 UNIX 文件的有效名称：

它不得包含嵌入的空格字符。
它不得包含 / 字符的连续实例。
它区分大小写。

可接受的字符：

A-Z a-z 0-9。 /_ # @-

当代码页为 IBM-037时，有效字符将按其呈现方式列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。

WSDLFILE( hfsfile )

指定 z/OS UNIX 上网络服务描述 (WSDL) 文件的 1-255 个字符全称或相对名称。当完整运行时验证处于活动状态时，将使用此文件。

对于由联机资源定义定义的 WEBSERVICE 资源的 Web Service 描述文件，文件路径是标准路径 (如果以正斜杠 (/) 作为前缀) ，或者相对于 CICS 区域用户标识的 HOME 目录。
对于 CICS 束中定义的 WEBSERVICE 资源的 Web Service 描述文件，文件路径相对于 CICS 束的根目录。 zFS 文件必须与 WEBSERVICE 资源一起打包在 CICS 束中。有关更多信息，请参阅引用捆绑软件中的 zFS 工件。

指定的值必须是 UNIX 文件的有效名称：

它不得包含嵌入的空格字符。
它不得包含 / 字符的连续实例。
它区分大小写。

可接受的字符：

A-Z a-z 0-9。 /_ # @-

当代码页为 IBM-037时，有效字符将按其呈现方式列出。如果使用不同的 EBCDIC 代码页，请注意变体角色中记录的变体字符。