SET PIPELINE
更改已安装的 PIPELINE 的状态。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。
条件: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
- 找不到管道。
