SET IPCONN
更改 IPIC 连接（又称IPCONN）的属性或取消未执行的 AID。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: INVREQ ， IOERR ， NORMAL ， NOTAUTH 和 SYSIDERR
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
此命令是线程安全的。
描述
可以使用 SET IPCONN 命令来更改定义 IPCONN 的某些属性。 当已调度所需操作时，控制权将返回到发出程序。 要开始操作，必须将控制权交给 CICS®。
选项
- CONNSTATUS (cvda)
- 指定是获取还是释放与由 IPCONN 名称表示的系统的会话。 IPCONN 不能同时是既已获取又已 OUTSERVICE。CVDA 值如下：
- ACQUIRED
- 将获取会话。
- RELEASED
- 将发布会话。
有关管理 IPCONN 的更多信息，请参阅 Intercommunication methods。
- IPCONN (data-value)
- 以 8 字符字段的形式指定要修改的 IPCONN 的名称。 这是在 IPCONN 定义的 IPCONN 选项上指定的远程系统或区域的名称。
- PENDSTATUS (cvda)
- 对于已执行初始启动的 CICS Transaction Server for z/OS® 合作伙伴的 IPCONN ，指定要覆盖正常再同步过程。CVDA 值为:
- 未暂挂
- 强制所有不确定工作单元 (由 IPCONN 在合作伙伴初始启动之前创建) 落实或回退，如 TRANSACTION 定义的 ACTION 选项所指定。 它还会忘记对连接未完成的任何再同步 (等待忘记 UOW-links) ，并在合作伙伴初始启动之前创建这些再同步。
PENDING 条件指示在经历了与合作伙伴不匹配的日志名称的连接上是否存在恢复信息 (已搁置的 UOW 或为合作伙伴记住的决策)。 这指示合作伙伴已执行初始启动，并且恢复协议已因合作伙伴丢失日志数据而损坏。
无法将连接设置为 NOTPENDING 状态 (强制不确定和擦除 NOFORGET UOW) ，直到 CICS 与合作伙伴取得联系并从中接收到新的 logname 为止。
可以忘记整个连接的决策，但这不会影响 UOW 中涉及的任何其他连接的决策内存。
注: SET IPCONN NOTPENDING ， SET IPCONN NORECOVDATA 和 SET IPCONN UOWACTION 互斥。 有关要使用的命令的建议，请参阅 UOWACTION 选项描述后面的注释。对系统间问题进行故障诊断中描述了交换日志名称函数和再同步函数。
- PURGETYPE (cvda)
- 指定要清除关联事务的方式。 CVDA 值如下：
- CANCEL
- 指定将取消事务使用此 IPCONN 的排队请求。
除非指定了 FORCECANCEL ，否则不会清除由 CICS 系统事务使用此 IPCONN (管理此 IPCONN 之间的通信) 的排队请求。
将消息 DFHISnnnn 写入 CSMT 以指示已删除多少个使用此 IPCONN 的排队请求以及多少个剩余请求。
每当使用 CEMT SET IPCONN 命令的 CANCEL 选项删除使用此 IPCONN 的排队请求时， CEMT 面板上都会显示
QUEUED REQUESTS CANCEL
消息。 - FORCECANCEL
- 指定将取消事务使用此 IPCONN 的所有排队请求，包括管理此 IPCONN 之间的通信的 CICS 系统事务的请求。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。
每当使用 CEMT SET IPCONN 命令的 FORCECANCEL 选项删除使用此 IPCONN 的排队请求时， CEMT 面板上都会显示
QUEUED REQUESTS CANCEL
消息。 - FORCEPURGE
- 指定将立即异常终止在与所连接系统的会话上运行的所有事务。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。
在某些极端的情况下（例如，如果在回退处理时出现错误），CICS 可能会异常终止。
- KILL
- 指定将终止该任务。 不保证系统和数据完整性。 KILL 选项可扩展 PURGE 和 FORCEPURGE 选项的功能。 仅当尝试执行 PURGE 或 FORCEPURGE 任务后，才应使用此命令。 KILL 选项不保证任何完整性，但是在某些情况下，它允许您释放已停止的区域，使其能继续处理。 在某些情况下，例如，如果在回退处理期间终止任务，那么 CICS 将异常终止。
- PURGE
- 指定将异常终止在已连接系统上运行的事务。 只有在可以保持系统和数据完整性的前提下，事务才会终止。 如果事务的定义指定 SPURGE=NO ，那么不会清除该事务。
- RECOVSTATUS (cvda)
- 指定要覆盖正常再同步过程。 CVDA 值为:
- NORECOVDATA
- 强制所有不确定工作单元 (根据事务定义) ，以 IPCONN 未完成的任何再同步为目标，并擦除先前从伙伴系统接收到的日志名。 连接的状态已重置。注意: 仅在特殊情况下才应使用 SET IPCONN NORECOVDATA。 它会擦除恢复信息，有可能会影响到在远程系统上更新了资源的工作单元的数据完整性。您可能需要使用它的情况示例如下所示:
- 您需要废弃 IPCONN ，并且无法完成与伙伴系统的停顿协议。
- 操作或逻辑错误会导致连接的 logname 不匹配。 必须复位连接状态，从而完成交换日志名的过程。
注: SET IPCONN NORECOVDATA ， SET IPCONN NOTPENDING 和 SET IPCONN UOWACTION 互斥。
- 服务器状态 (cvda)
- 指定是将 IPCONN 置于服务中还是置于服务外。 CVDA 值如下：
- INSERVICE
- IPCONN 将投入服务。 这允许它被获取。
- OUTSERVICE
- IPCONN 将不可用; 即不可用。发生以下情况:
- 如果当前已获取连接并且您指定了 OUTSERVICE ，那么该命令将失败，并返回 INVREQ 和 2 的 RESP2 。 必须先释放连接，然后再设置 OUTSERVICE。
- 如果该连接当前处于 "已释放" 状态，那么该连接的状态将设置为 OUTSERVICE ，并且直到该连接再次处于 "已释放" 状态时才能使用该连接。
- UOWACTION (cvda)
- 指定要部分覆盖正常再同步过程: 将对由于 IPCONN 故障而不确定的任何工作单元进行决策; 但将记录决策并在下次获取连接时报告任何数据不一致情况。该操作与设置 UOW 的状态同步; 即， SET IPCONN UOWACTION 之后的 INQUIRE UOW 返回新的 UOW 状态。 CVDA 值如下：
- 回退
- 由于此 IPCONN 失败而搁置的所有 UOW 都将回退。
- 落实
- 将落实由于此 IPCONN 失败而搁置的所有 UOW。
- FORCE
- 由于此 IPCONN 的故障而搁置的所有 UOW 都将强制进行 BACKUP 或 COMMIT ，如在 TRANSACTION 定义的 ACTION 选项上指定的那样。
- RESYNC
- 将重试由于此 IPCONN 失败而搁置的任何 UOW (即，将尝试此连接的交换日志名称再同步)。 当获取连接或 UOW 没有被搁置时，正常情况下，这个过程应该自动启动。
备注信息：- SET IPCONN UOWACTION 将由于 IPCONN 的故障而失败的所有工作单元取消舍入。 在发出 SET IPCONN FORCE 之前，您可能希望使用 SET UOW 命令为每个不确定的工作单元显式指定落实或回退，而不是将其设置为缺省值。 本地过程将确定数据的重要性以及使用 INQUIRE UOW ， INQUIRE UOWENQ 和 INQUIRE UOWLINK 命令建立正确操作的方法。
- 就搁置的工作单元而言，您只能使用 SET IPCONN UOWACTION ， SET IPCONN NOTPENDING 和 SET IPCONN NORECOVDATA 中的一个。 仅应在特殊情况下使用 SET IPCONN NORECOVDATA。
- 要强制使用由同一方向的 IPCONN 故障导致的所有不确定工作单元，请使用 SET IPCONN COMMIT 或 SET IPCONN BACKOUT。
- SET IPCONN UOWACTION 和 SET UOW UOWACTION 命令都不会清除再同步信息。 如果要执行此操作，必须使用 SET IPCONN NOTPENDING 或 SET IPCONN NORECOVDATA。
- 可以发出 SET UOW UOWACTION 命令 前 ，发出 SET IPCONN NOTPENDING 或 SET IPCONN NORECOVDATA。
条件
- INVREQ
- RESP2 值：
- 2
- 在下列任何一种方法中，都未一致地指定既得和 OUTSERVICE:
- 已使用 OUTSERVICE 指定既已获取
- 为 OUTSERVICE IPCONN 资源指定了既得
- 在同一命令中为既获取的 IPCONN 资源指定了已释放和 OUTSERVICE。
- 为未释放的 IPCONN 资源指定了 OUTSERVICE
- 3
- CONNSTATUS 具有无效的 CVDA 值。
- 4
- SERVSTATUS 具有无效的 CVDA 值。
- 7
- PURGETYPE 具有无效的 CVDA 值。
- 8
- PENDSTATUS 具有无效的 CVDA 值。
- 18
- 无法为已成功完成交换日志名处理的 IPCONN 设置 NOTPENDING。
- 19
- 当处于 FREE 状态时，无法将 CONNECT 状态设置为既已获取。
- 20
- 试图获取单向 IPCONN。
- 21
- 指定了 BACKOUT 或 FORCE ，但未成功。 对于此 IPCONN ，某些 UOW 仍处于搁置状态。
- 22
- CANCEL 或 FORCECANCEL 选项随附了其他 SET 参数。
- 25
- IPCONN 仍在使用中。
- 26 日
- RECOVSTATUS 的值不为 NORECOVDATA。
- 27
- 在 UOWACTION 选项上指定的 CVDA 值无效。
- 45
- 不能为正在服务的 IPCONN 设置 NORECOVDATA。
- IOERR
- RESP2 值：
- 10
- 意外的错误。
- 正常
- RESP2 值：
- 58
- AID 已成功取消。
- 59
- 未取消任何 AID。
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。
- SYSIDERR
- RESP2 值：
- 9
- 找不到指定的 IPCONN。