SET PIPELINE

更改已安装的 PIPELINE 的状态。

语法

警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。

SET PIPELINE

读取语法图跳过可视语法图SET PIPELINE( data-value)ENABLESTATUS( CVDA)ENABLEDDISABLEDRESPWAIT( data-area)

条件:INVREQ、NOTAUTH 和 NOTFND

NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项,用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息,请参阅 CICS-值数据区 (CVDA)

此命令是线程安全的。

描述

使用 SET PIPELINE 命令可更改已安装的 PIPELINE 的状态。

不能使用 SET PIPELINE 命令来更改已定义并安装在 $TAG1 CICS ® $TAG2 束中的 PIPELINE 资源的 ENABLESTATUS。 如果尝试执行此操作,那么将发出 RESP2 值为 300 的 INVREQ 响应。 您可以修改动态生成的 PIPELINE 资源的所有其他属性,但不会对这些更改进行编目,并且不会在 CICS的热重新启动过程中恢复这些更改。 如果要更改由束安装的资源的属性,那么应禁用并废弃 CICS 束,并安装具有所需更改的束的新版本。

您可以通过启用或禁用安装了动态生成的 PIPELINE 资源的 BUNDLE 资源来控制这些资源的状态。

您可以使用 CICS Explorer® 中的资源编辑器修改动态生成的 PIPELINE 资源的定义。要更新定义,请按照.NET Framework 2.0 中的说明,用新版本替换 CICS bundle 中的旧版本。 CICS 可单独更新单独部署或与平台一起部署的捆绑包。 如果 CICS bundle 是作为应用程序的一部分或与应用程序绑定一起部署的,则更新整个应用程序。

选项

PIPELINE 数据值
指定要查询的 PIPELINE 的 8 字符名称。
ENABLESTATUS( cvda )
指定 PIPELINE 的状态:
ENABLED
将正常处理此 PIPELINE 的入站服务请求。
DISABLED
此 PIPELINE 的入站服务请求被拒绝。
RESPWAIT(数据区)
指定应用程序应该等待来自远程 Web Service 的可选响应消息的秒数。 该值的范围可以从 0 到 9999 秒。 如果未指定值,那么将使用传输协议的缺省超时值。
  • HTTP默认超时值为10秒。
  • IBM® MQ 的缺省超时值为 60 秒。

条件

INVREQ
RESP2 值:
5
尝试为 RESPWAIT 设置无效值。
11
尝试启用或禁用处于无效状态的 PIPELINE。 要解决此情况,请尝试废弃并重新安装 PIPELINE。
300
指定了对 BUNDLE 资源安装的资源无效的操作。
NOTAUTH
RESP2 值:
100
未授权与发出任务关联的用户使用此命令。
NOTFND
RESP2 值:
3
找不到管道。