管道 资源定义
PIPELINE 资源会在 CICS 应用程序充当 Web Service 提供者或请求者的角色时使用。 它提供了有关用作服务请求和响应的消息处理程序的相关信息。 通常，一个 PIPELINE 定义可定义多个应用程序所用的基础结构。
有关处理节点的信息是间接提供的：PIPELINE 指定一个 z/OS UNIX 文件的名称，该文件包含节点及其配置的 XML 描述。
入站 Web Service 请求 (即客户机通过其在 CICS中调用 Web Service 的请求) 由 URIMAP 资源与 PIPELINE 资源相关联。 URIMAP 标识应用于与请求关联的 URI 的 PIPELINE 资源 ;PIPELINE 指定要对消息执行的处理。
对于使用 CICS Web Service 助手部署的服务提供者，将在扫描拾取目录时自动创建 URIMAP 资源。 在安装了 PIPELINE 资源或者发出了 PERFORM PIPELINE SCAN 命令之后，会执行此扫描操作。 为 CICS 提供信息以将 WEBSERVICE 资源与特定 URI 相关联的 URIMAP 资源是必需资源。 此资源的属性由 pickup 目录中的 Web Service 绑定文件指定。 为 CICS 提供用于将 WSDL 归档文件或 WSDL 文档与特定 URI 相关联的信息的 URIMAP 资源是可选资源，并且是在选取目录中存在 WSDL 文件或 WSDL 归档文件时创建的。
对于服务请求者， CICS 不会在安装 PIPELINE 资源时或由于 PERFORM PIPELINE SCAN 命令而自动创建任何 URIMAP 资源。
有关使用 BAS 的信息，请参阅 使用 BAS 管道资源定义。
CICS 束中的 PIPELINE 资源
您可以使用 CICS 束来创建，编辑和安装 PIPELINE 资源定义。 如果以此方式创建 PIPELINE 资源，那么必须使用 CICS 束来管理该资源的生命周期，并且不能单独管理该资源。
您可以使用 EXEC CICS INQUIRE PIPELINE 或 CEMT INQUIRE PIPELINE 命令来查询由 CICS 束动态生成的 PIPELINE 资源。 但是，不能对动态生成的 PIPELINE 资源发出 DISCARD 命令，也不能使用 SET 命令来更改资源的状态。 必须对 BUNDLE 资源发出命令，并且 CICS 会将这些命令应用于 PIPELINE 资源。
您可以修改动态生成的 PIPELINE 资源的属性，但不会对这些更改进行编目，并且不会在 CICS的热重新启动过程中恢复这些更改。 如果要更改由束安装的 PIPELINE 资源的属性，请禁用并废弃 CICS 束，并安装具有所需更改的束的新版本。
有关在 CICS 束中定义资源的更多信息，请参阅 定义 CICS 束。
语法
属性
- CONFIGFILE(名称)
- 指定 z/OS UNIX 文件的全称或相对名称，该文件包含将对服务请求和响应采取行动的处理节点信息。
- 对于由联机资源定义定义的 PIPELINE 资源的配置文件，文件路径是标准路径 (如果以正斜杠 (/) 作为前缀) ，或者相对于 CICS 区域用户标识的 HOME 目录。
- 对于在 CICS 束中定义的 PIPELINE 资源的配置文件，文件路径相对于 CICS 束的根目录。 zFS 文件必须与 PIPELINE 资源一起打包在 CICS 束中。 有关更多信息，请参阅 引用捆绑软件中的 zFS 工件。
指定的值必须是 UNIX 文件的有效名称：- 它不得包含嵌入的空格字符。
- 它不得包含
/字符的连续实例。 - 它区分大小写。
- DESCRIPTION(文本)
- 您可以提供在此字段中定义的资源的描述。 描述文本的长度最多可以为 58 个字符。 您可以使用的字符没有任何限制。 但是，如果使用括号，请确保对于每个左括号都有一个匹配的右括号。 如果使用 CREATE 命令，那么对于文本中的每个单撇号，将编码两个撇号。
- GROUP（ 组名 ）
- 每个资源定义都必须具有 GROUP 名称。 资源定义成为组的成员，并在安装组时安装在 CICS 系统中。可接受的字符：
A-Z 0-9 $ @ #
当代码页为 IBM-037时，有效字符将按其呈现方式列出。 如果使用不同的 EBCDIC 代码页，请注意 变体角色 中记录的变体字符。
输入的任何小写字符都将转换为大写。
GROUP 名称的长度最多可以为 8 个字符。 小写字符被视为大写字符。
- PIPELINE(名称)
- 指定该 PIPELINE 的名称。 该名称的最大长度为 8 个字符。可接受的字符：
A-Z 0-9 $ @ #
当代码页为 IBM-037时，有效字符将按其呈现方式列出。 如果使用不同的 EBCDIC 代码页，请注意 变体角色 中记录的变体字符。
除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。
- RESPWAIT(值)
- 指定应用程序应该等待来自远程 Web Service 的响应消息的时间（单位：秒）。 该值的范围可以从 0 到 9999 秒。要使用传输协议的缺省超时值，请指定 DEFT。 如果未对 RESPWAIT 指定任何值，那么也将使用缺省超时值。
- HTTP默认超时值为10秒。
- 的默认超时值为 60 秒。 IBM MQ 的默认超时值为 60 秒。
- SHELF（ { /var/cicsts/ | 目录 } ）
- 指定 z/OS UNIX 上一个目录（主要用于存放网络服务绑定文件的架子 ）的 1-255 个字符的全称。指定的值必须是 UNIX 文件的有效名称：
- 它不得包含嵌入的空格字符。
- 它不得包含
/字符的连续实例。 - 它区分大小写。
安装了 PIPELINE 定义的 CICS 区域必须具有对存储架目录的完整许可权-读，写和创建子目录的能力。
单个存储架目录可以由多个 CICS 区域和多个 PIPELINE 定义共享。 在存储架目录中，每个 CICS 区域都使用单独的子目录来使其文件与其他 CICS 区域的文件保持独立。 在每个区域的目录中，每个 PIPELINE 都使用单独的子目录。
您不应尝试修改已安装的 PIPELINE 定义所引用的存储架的内容。 如果这样做，那么影响是不可预测的。
使用 CICS Explorer 在 CICS 束中定义的 PIPELINE 资源不使用存储架目录。
- STATUS（ { 已启用 |DISABLED } ）
- 指定 PIPELINE 在安装时的初始状态:
- 已启用
- 将正常处理此 PIPELINE 的 Web Service 请求。
- DISABLED
- 无法处理此 PIPELINE 的 Web Service 请求。
- WSDIR(目录)
- 指定 z/OS UNIX 上网络服务绑定目录 （也称为拾取目录 ）的 1-255 个字符的全称。 安装在 CICS 区域中的每个 PIPELINE 都必须指定不同的 Web Service 绑定目录。指定的值必须是 UNIX 文件的有效名称：
- 它不得包含嵌入的空格字符。
- 它不得包含
/字符的连续实例。 - 它区分大小写。
Web Service 绑定目录包含与 PIPELINE 关联的 Web Service 绑定文件，这些文件将由 CICS 扫描机制自动安装。 安装 PIPELINE 定义时， CICS 会扫描目录并自动安装它在其中找到的任何 Web Service 绑定文件。 请注意，无论 PIPELINE 安装处于已启用还是已禁用状态，都将发生此情况。
如果为 WSDIR 属性指定一个值，该值必须指向 CICS 区域至少具有读取访问权限的有效 z/OS UNIX 目录。 如果情况并非如此，那么安装 PIPELINE 资源的任何尝试都将失败。
如果未指定 WSDIR 的值，那么安装 PIPELINE 时不会进行自动扫描。