DISCARD CONNECTION

除去 CONNECTION 定义。

语法

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

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

DISCARD CONNECTION

读取语法图跳过可视语法图DISCARD CONNECTION( data-value)

条件: INVREQ , NOTAUTH 和 SYSIDERR

NOHANDLERESPRESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.

描述

DISCARD CONNECTION 命令从本地 CICS® 系统中除去 CONNECTION 定义。 除去连接时,还会除去所有关联的会话。

要成功删除:
  • 如果连接是远程连接 (即,具有除本地区域名称以外的 REMOTESYSTEM 值) ,那么该连接不能具有活动会话,并且如果该连接不是远程连接,那么该连接必须处于 OUTSERVICE 状态。
  • 如果连接是 MRO 连接,那么必须关闭区域间通信设施。 (可以使用 SET IRC CLOSED 命令将其关闭。)
  • 如果连接是 APPC 连接,并且本地 CICS 系统是 z/OS® Communications Server 通用资源组的成员,那么不能有延迟工作暂挂。 当故障导致在 SYNCLEVEL 2 上使用了连接上的会话的工作单元被 搁置 时,会发生延迟工作 (由于需要执行恢复操作才能完成处置,因此暂挂该工作单元以进行后续处置)。

    可以 废弃其他类型的连接,即使存在未完成的恢复工作也是如此。 但是,如果存在,建议您不要将其废弃。 可以使用 INQUIRE CONNECTION RECOVSTATUS 命令进行检查。

  • 不能存在指向要废弃的连接的间接 CONNECTION 定义。
注: 在异常情况下,如果 LU6.1 连接的某些会话仍在服务中,那么废弃该连接可能会失败,即使该连接处于服务外状态也是如此。 如果发生此情况,请将连接状态设置为 INSERVICE ,然后设置为 OUTSERVICE ,然后重新发出 DISCARD 命令。

CICS 使用隐式同步点 (代表发出任务) 成功完成 DISCARD CONNECTION 处理,并落实对该任务中该点的可恢复资源所作的更改。 如果废弃处理失败,那么 CICS 会产生值为 27 的 INVREQ 异常条件,并改为执行 SYNCPOINT ROLLBACK ,以回滚对可恢复资源的更改。 但是,对于所有其他异常情况,不会尝试废弃处理,并且不会发出 SYNCPOINT 或 SYNCPOINT ROLLBACK。

请参阅 废弃资源定义 ,以获取有关 DISCARD 命令的常规信息。

选项

连接 (data-value)
指定要废弃的 CONNECTION 定义的 4 字符标识。

条件

INVREQ
RESP2 值:
24
连接是远程的,并且正在本地使用。
25
连接是本地的,并且未中断服务。
26 日
对于在允许废弃之前必须解析的连接,恢复信息未完成。
27
废弃处理失败。
28 日
间接连接指向连接。
29 日
该连接是 MRO 连接,并且 IRC 未关闭。
38
此连接的废弃已在进行中。
39
CONNECTION 定义当前正在使用中。
200
该命令是在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中执行的,或在没有 SYNCONRETURN 选项的分布式程序链接从远程系统调用的程序中执行的。
NOTAUTH
RESP2 值:
100
未授权与发出任务关联的用户使用此命令。
SYSIDERR
RESP2 值:
9
找不到连接。