CEMT SET IPCONN
更改 IPCONN 资源的属性或取消未完成的自动启动描述符 (AID)。
在 CICS Explorer®中， "IPIC 连接" 视图 提供与此命令等效的功能。
描述
您可以使用 SET IPCONN 命令来更改 IPCONN 资源的某些属性。
要在已安装新的 IPCONN 定义时安装该定义，必须先设置与 OUTSERVICE 的连接，然后再对新定义使用 CEDA INSTALL 命令。
有关不同类型的相互通信连接的信息，请参阅 相互通信方法。
语法
- 输入
CEMT SET IPCONN(或关键字的适当缩写) ，后跟一个或多个连接标识或 ALL。 生成的屏幕将列出当前状态，类似于使用 CEMT INQUIRE IPCONN 命令获取的状态。 您可以按 Tab 键切换到突出显示的字段或空白字段，并使用必需的值覆盖这些字段。 - 输入
CEMT SET IPCONN(或关键字的适当缩写) ，后跟一个或多个连接标识或 ALL ，然后后跟一个或多个要更改的属性设置。 例如，cemt s ip al i会重置所有连接的值，以使其可供使用 (inservice)。
在第一行或第二行的开头输入 ? 将给出语法提示。 重置值将立即生效。
选项
- (value)
- 指定要修改的连接的名称 (1-8 个字符)。 这是在 IPCONN 定义的 IPCONN 选项上指定的远程系统或区域的名称。 可以指定多个名称。
- ACQUIRED
- 指定 CICS® 获取与由 IPCONN 名称表示的系统的会话。 连接不能同时为既得和 OUTSERVICE。
- ALL
- 指定对您有权访问的指定类型的所有资源进行您请求的任何更改。
- 回退
- 指定回退由于此连接失败而搁置的所有工作单元 (UOW)。 将部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何 UOW 进行决策，但将记录决策并在下次获取连接时报告任何数据不一致情况。
- CANCEL
指定取消事务使用此 IPCONN 的排队请求。
除非指定了 FCANCEL ，否则不会清除由 CICS 系统事务使用此 IPCONN 的排队请求，这些事务用于管理 IPCONN 之间的通信。
将消息 DFHISnnnn 写入 CSMT ，以指示已为 IPCONN 删除多少个使用此 IPCONN 的排队请求以及多少个剩余请求。
每当使用 CEMT SET IPCONN 命令的 CANCEL 选项删除使用此 IPCONN 的排队请求时， CEMT 面板上都会显示
QUEUED REQUESTS CANCEL
消息。- 落实
- 指定由于此连接失败而搁置的所有 UOW 都已落实。 将部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何工作单元进行决策，但将记录决策并在下次获取连接时报告任何数据不一致情况。
- 取消
- 指定取消事务使用此 IPCONN 的所有排队请求，包括管理此 IPCONN 之间通信的 CICS 系统事务的请求。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。
每当使用 CEMT SET IPCONN 命令的 FCANCEL 选项删除使用此 IPCONN 的排队请求时， CEMT 面板上都会显示
QUEUED REQUESTS CANCEL
消息。 - FORCEPURGE
- 指定在与已连接系统的会话上运行的所有事务都将立即异常终止。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。
在某些极端的情况下（例如，如果在回退处理时出现错误），CICS 可能会异常终止。
- FORCEUOW
- 指定强制回退或落实由于此连接失败而搁置的所有 UOW ，如 TRANSACTION 定义的 ACTION 选项中所指定。 将部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何工作单元进行决策，但将记录决策并在下次获取连接时报告任何数据不一致情况。
- INSERVICE
- 指定系统处于服务状态; 即，可供使用。
- KILL
- 指定任务已终止。 不保证系统和数据完整性。 KILL 选项可扩展 PURGE 和 FORCEPURGE 选项的功能。 仅在首次尝试清除或强制清除后才使用此选项。 KILL 选项不保证任何种类的完整性，但在某些情况下，您可以使用它来释放停滞的区域，从而使该区域能够继续处理。 在某些情况下，例如，如果在回退处理过程中终止了任务，CICS 会异常终止。
- NORECOVDATA
- 指定将覆盖正常再同步过程。 NORECOVDATA 强制不确定工作单元 (根据事务定义) ，将针对连接未完成的任何再同步任务作为目标，并擦除先前从伙伴系统接收的日志名。 连接的状态已重置。注: 仅在特殊情况下使用 SET IPCONN NORECOVDATA。 此选项会擦除恢复信息，并可能损害远程系统上已更新资源的工作单元的数据完整性。以下是您可能需要使用此选项的情况示例:
- 您需要废弃连接，并且无法使用已完成的伙伴系统的停顿协议。
- 操作或逻辑错误会导致连接的 logname 不匹配。 必须复位连接状态，从而完成交换日志名的过程。
注: 如果指定 NORECOVDATA ，那么不能指定 COMMIT ， BACKOUT ， FORCEUOW ， RESYNC 或 NOTPENDING。 - 未暂挂
- 对于已执行初始启动的 CICS Transaction Server for z/OS® 合作伙伴的连接，指定将覆盖正常再同步过程。
NOTPENDING 强制所有在合作伙伴初始启动之前由连接创建的不确定工作单元 (根据事务定义)。 它还会忘记对连接未完成的任何再同步任务 (等待忘记 UOW-links) ，并在合作伙伴初始启动之前创建这些任务。
PENDING 条件指示在经历了与合作伙伴不匹配的日志名称的连接上是否存在恢复信息 (已搁置的 UOW 或为合作伙伴记住的决策)。 这指示合作伙伴已执行初始启动，并且恢复协议已因合作伙伴丢失日志数据而损坏。
无法将连接设置为 NOTPENDING 状态 (强制不确定和擦除 NOFORGET UOW) ，直到 CICS 与合作伙伴取得联系并从中接收到新的 logname 为止。
可以忘记整个连接的决策，但这不会影响 UOW 中涉及的任何其他连接的决策内存。注: 如果指定 NOTPENDING ，那么不能指定 COMMIT ， BACKOUT ， FORCEUOW ， RESYNC 或 NORECOVDATA。 有关要使用的选项的建议，请参阅 RESYNC 选项描述后面的注释。对系统间问题进行故障诊断中描述了交换日志名称函数和再同步函数。
- OUTSERVICE
- 使系统停止服务; 即，不可用。
- PURGE
- 指定在已连接系统上运行的事务异常终止。 只有在可以保持系统和数据完整性的前提下，事务才会终止。 如果事务的定义指定 SPURGE=NO ，那么不会清除该事务。
- RELEASED
- 指定 CICS 释放与由 IPCONN 名称表示的系统的会话。
- RESYNC
- 指定重试因此连接失败而搁置的任何 UOW。 即，尝试此连接的交换日志名称再同步。 此过程通常应该在获取连接或取消搁置 UOW 时自动启动。 将部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何工作单元进行决策，但将记录决策并在下次获取连接时报告任何数据不一致情况。注：
- COMMIT ， BACKOUT ， FORCEUOW 和 RESYNC 操作与设置 UOW 的状态同步; 即， SET IPCONN BACKOUT ， COMMIT ， FORCEUOW 或 RESYNC 之后的 INQUIRE UOW 返回新的 UOW 状态。
- 指定其中一个选项将取消由于连接失败而失败的所有工作单元。 在发出 SET IPCONN FORCEUOW 命令之前，可以使用 SET UOW 命令为每个不确定工作单元显式指定落实或回退，而不是允许缺省操作。 本地过程确定数据的重要性以及使用 INQUIRE UOW， INQUIRE UOWENQ和 INQUIRE UOWLINK 命令来建立正确操作的方法。
- 只能指定 BACKOUT ， COMMIT ， FORCEUOW ， RESYNC ， NOTPENDING 和 NORECOVDATA 选项之一。 仅在特殊情况下使用 SET IPCONN NORECOVDATA 命令。
- 要强制所有由同一方向的连接失败导致的不确定工作单元，请使用 SET IPCONN COMMIT 或 SET IPCONN BACKOUT。
- SET IPCONN 和 SET UOW 的 BACKOUT ， COMMIT ， FORCEUOW 或 RESYNC 选项不会清除再同步信息。 如果要执行此操作，必须使用 SET IPCONN NOTPENDING 或 SET IPCONN NORECOVDATA。
- 在 发出 SET IPCONN NOTPENDING 或 SET IPCONN NORECOVDATA 命令之前，可以发出 BACKOUT ， COMMIT ， FORCEUOW 或 RESYNC 命令。