CEMT SET CONNECTION

更改基于 SNA 的 MRO 或 ISC 连接的属性。

在 CICS Explorer®中， ISC/MRO 连接视图 提供与此命令等效的功能。

描述

您可以使用 CEMT SET CONNECTION 命令来更改一些属性，这些属性用于定义 基于 SNA 的 MRO 或 ISC 连接。

注: 另请参阅 CEMT SET IPCONN。 CEMT SET IPCONN 命令用于更改 IPIC 连接 (也称为 IPCONN) 的属性。

有关不同类型的相互通信连接的信息，请参阅 相互通信方法。

当连接已定义为间接时，除非安装了它所引用的直接连接，否则不会提供任何信息。

要在已安装新连接定义时安装新连接定义，必须设置连接 OUTSERVICE ，如果它是 z/OS® Communications Server连接的连接，请在对新定义使用 CEDA INSTALL 命令之前将其释放。

语法

按 "清除" 键以清除屏幕。 您可以通过两种方式启动此事务:
  • 输入 CEMT SET CONNECTION (或关键字的适当缩写) ，后跟一个或多个连接标识或 ALL。 生成的屏幕将列出当前状态，类似于使用 CEMT INQUIRE CONNECTION 命令获取的状态。 您可以按 Tab 键切换到突出显示的字段或空白字段，并使用必需的值覆盖这些字段。
  • 输入 CEMT SET CONNECTION (或关键字的适当缩写) ，后跟一个或多个连接标识或 ALL ，然后依次输入一个或多个要更改的属性设置。 例如， cemt s c al i 会重置所有连接的值，以使其可供使用 (inservice)。

在第一行或第二行的开头输入 ? 将给出语法提示。 重置值将立即生效。

CEMT SET CONNECTION

读取语法图跳过可视语法图CEMT SET CONNECTION ( 值)ALLNOTPENDINGINSERVICEOUTSERVICEACQUIREDRELEASEDPURGEFORCEPURGEKILLCANCELFCANCELCOMMITBACKOUTFORCEUOWRESYNCENDAFFINITYNORECOVDATA

选项

(value)
为区域间通信 (IRC) 或系统间通信 (ISC) 连接定义的一个或多个名称 (1-4 字符)。

此参数还接受本地系统的名称。 对于本地系统条目，唯一有效的选项是 CANCEL 和 FORCECANCEL。

已获取 (仅限 APPC)
指定 CICS® 是否获取与 CONNECTION 名称表示的逻辑单元的会话。 要获取有关连接元素的可用性状态的更多详细信息，请使用 CEMT INQUIRE MODENAME 命令。 连接不能同时为既得和 OUTSERVICE。
ALL
您请求的任何更改都将对您有权访问的指定类型的所有资源进行。
BACKOUT (APPC PARALLEL-SESSION ， CICS-TO-CICS MRO 和 LU61 ONLY)
由于此连接失败而搁置的所有 UOW 都将回退。 将部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何工作单元进行决策，但将记录决策并在下次获取连接时报告任何数据不一致情况。
CANCEL
将取消为指定连接排队的自动启动描述符 (AID)。

表示在本地 CICS 系统中等待指定连接的已调度和已分配请求的 AID 将被取消。 但是，不会取消具有已启动的关联触发任务的 TD AID。 此外，除非指定 FCANCEL ，否则不会清除以下 CICS 系统 AID。

表 1. 需要 FCANCEL 以将其移除的系统 AID
描述 Tranid
远程删除 AID  
远程调度程序 AID CRSR
LU6.2 服务管理器 1 AID CLS1
LU6.2 服务管理器 3 AID CLS3
远程调度程序 PURGE AID CRSQ
资源管理器再同步 AID CRSY
自动安装的终端删除 AID CATD
自动安装的终端重新启动 AID CATR

当发现已取消的 SCHEDULE 请求在远程 CICS 系统中具有前体时; 即，最初在远程系统中调度 AID 时，将异步取消远程 AID。

将消息 DFHTF0100 写入 CSMT 以指示为连接删除了多少个 AID 以及保留了多少个 AID。

:NONE.AIDS CANCELED只要使用 CEMT SET CONNECTION 命令的 CANCEL 选项删除 AID ，就会在 CEMT 面板上显示消息。

COMMIT (仅 APPC 并行会话， CICS-to-CICS MRO 和 LU61 )
将落实由于此连接失败而搁置的所有 UOW。 将部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何工作单元进行决策，但将记录决策并在下次获取连接时报告任何数据不一致情况。
ENDAFFINITY (仅限 APPC 和 LU6.1 )
指定 z/OS Communications Server 要结束 CICS拥有的亲缘关系，其中 CICS 是 z/OS Communications Server 通用资源组的成员。 此选项仅对 APPC 和 LU6.1 连接有效。 该连接必须已经停用，并且处于 NORECOVDATA 状态（对于 APPC）。
注：
  1. z/OS Communications Server 中没有用于查询亲缘关系的工具，因此 CICS 不知道存在给定连接的亲缘关系。 只要有可能创建了必须显式结束的亲缘关系， CICS 就会发出消息 DFHZC0177。 此消息提供可疑连接的 NETNAME。
  2. 如果 z/OS Communications Server 拒绝了终止亲缘关系的请求，因为不存在此类亲缘关系，那么 CICS 会发出消息 DFHZC0181。
  3. 响应 "NETID 0 USE PRFRM" 表示不能使用 SET CONNECTION 来结束亲缘关系，因为已安装连接中 NETID 的值为 0。 (NETID 是包含已连接 LU 的网络对于 z/OS Communications Server已知的名称。) 要结束亲缘关系，必须使用 PERFORM ENDAFFINITY 命令，在该命令上必须指定正确的 NETID。

    此响应还可能是在亲缘关系结束后反复命中 ENTER 键所导致的。

  4. 相互通信入门中描述了通用资源和亲缘关系。
取消
将取消针对指定连接排队的所有 AID (包括系统 AID)。 请参阅 表 1 ，以获取需要 FCANCEL 将其除去的系统艾滋病列表。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。
注: FCANCEL 不会除去具有关联触发任务的瞬时数据 AID。 可以通过清除关联的任务来除去这些辅助。

每当使用 CEMT SET CONNECTION 命令的 FCANCEL 选项删除 AID 时， CEMT 面板上都会显示 "AIDS CANCELED" 消息。

FORCEPURGE (仅限z/OS Communications Server )
立即异常终止所有正在所连接系统上的会话中运行的事务。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。

在某些极端的情况下（例如，如果在回退处理时出现错误），CICS 可能会异常终止。

FORCEPURGE 替换仅出于兼容性目的保留的 PURGE FORCE。 您应该在新应用程序中使用 FORCEPURGE。

FORCEUOW (APPC PARALLEL-SESSION ， CICS-TO-仅限CICS MRO 和 LU61 )
由于此连接失败而搁置的所有 UOW 都将强制回退或落实，如 TRANSACTION 定义的 ACTION 选项中所指定。 将部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何工作单元进行决策，但将记录决策并在下次获取连接时报告任何数据不一致情况。
INSERVICE
系统处于服务状态; 即，可供使用。
对于 MRO 连接，所有会话都处于服务状态，并且发生以下情况:
  • 如果发出系统和系统 sysid 都已打开 IRC ，并且发出系统在系统 sysid 中具有状态 INSERVICE ，那么将在两个系统之间建立连接并使其可用。
  • 否则，系统的状态 (以及底层会话的状态) 将设置为 INSERVICE ，以便当两个系统都打开了 IRC 并且相对于彼此为 INSERVICE 时，将建立连接。 请注意， INQUIRE 指示系统 (及其底层会话) 是 INSERVICE ，即使不能使用任何连接也是如此。
  • 系统的底层会话的状态始终与系统本身的状态相同。
对于 ISC 系统，发生以下情况:
  • LU6.1 系统 (即，指向 sysid 的链接是通过系统间通信): 所有底层会话都置于服务中。
  • APPC 系统: 使 SNASVCMG 会话处于服务状态，从而允许随后建立连接。
KILL
终止任务。 不保证系统和数据完整性。 KILL 选项可扩展 PURGE 和 FORCEPURGE 选项的功能。 仅在首次尝试清除或强制清除后才使用此选项。 KILL 选项不保证任何种类的完整性，但在某些情况下，您可以使用它来释放停滞的区域，从而使该区域能够继续处理。 在某些情况下，例如，如果在回退处理过程中终止了任务，CICS 会异常终止。
NORECOVDATA (仅限 APPC)
指定要覆盖正常再同步过程。 NORECOVDATA 强制不确定工作单元 (根据事务定义) ，将针对连接未完成的任何再同步作为目标，并擦除先前从伙伴系统接收到的日志名。 连接的状态已重置。
注: 仅应在特殊情况下使用 SET CONNECTION NORECOVDATA。 它会擦除恢复信息，有可能会影响到在远程系统上更新了资源的工作单元的数据完整性。
您可能需要使用它的情况示例如下:
  • 您需要废弃连接或发出 SET CONNECTION ENDAFFINITY 命令，并且无法完成与伙伴系统的停顿协议。 （如果未完成恢复数据，那么对于 APPC 连接不可能执行任何操作。）
  • 操作或逻辑错误会导致连接的 logname 不匹配。 必须复位连接状态，从而完成交换日志名的过程。
注: 如果指定 NORECOVDATA ，那么不能指定 COMMIT ， BACKOUT ， FORCEUOW ， RESYNC 或 NOTPENDING。
NOTPENDING (仅 APPC 和 CICS-to-CICS MRO)
对于以下任一类型的连接，指定要覆盖正常再同步过程:
  • 与已执行初始启动的 z/OS 的 CICS TS, 版本 5。6 合作伙伴的连接
  • 与已执行冷启动的 z/OS 的 CICS TS, 版本 5。6 前合作伙伴的连接。

NOTPENDING 强制在合作伙伴初始 (或冷) 启动之前由连接创建的所有不确定工作单元 (根据事务定义)。 它还会忘记针对连接未完成的任何再同步 (等待忘记 UOW-links) ，并在合作伙伴初始 (或冷) 启动之前创建这些再同步。

PENDING 条件指示在经历了与合作伙伴不匹配的日志名称的连接上是否存在恢复信息 (已搁置的 UOW 或为合作伙伴记住的决策)。 对于 z/OS 的 CICS TS, 版本 5。6 合作伙伴，日志名称不匹配指示合作伙伴已执行初始启动。 对于z/OS 的 CICS TS, 版本 5。6 之前的合作伙伴，日志名称不匹配指示合作伙伴已执行冷启动。 无论哪种情况，由于合作伙伴丢失了日志数据，恢复协议遭到了损坏。

无法将连接设置为 NOTPENDING 状态 (强制 INDOUBT 和擦除 NOFORGET UOW) ，直到此系统与合作伙伴取得联系并从中接收到新的日志名为止。

可以忘记整个连接的决策，但这不会影响 UOW 中涉及的任何其他连接的决策内存。
注：
  1. 如果指定 NOTPENDING ，那么不能指定 COMMIT ， BACKOUT ， FORCEUOW ， RESYNC 或 NORECOVDATA。 有关要使用的选项的建议，请参阅 CEMT SET CONNECTION-notes on RES ync。
  2. NOTPENDING 对与z/OS 的 CICS TS, 版本 5。6 前系统的 MRO 连接没有影响。 但是，z/OS 的 CICS TS, 版本 5。6 前 MRO 伙伴的冷启动会导致按会话自动执行 SET CONNECTION NOTPENDING 函数。

定义多区域操作的链接中描述了 Exchange lognames 函数和再同步函数。

OUTSERVICE
系统已不服务; 即，它不可用。
对于 MRO 连接，所有会话都将停用 (如果指定了 PURGE ，那么将立即停用; 如果未指定 PURGE ，那么将在任务已终止时停用) ，并且将发生以下情况:
  • 如果当前已获取连接，那么会话将中断 (已停顿)。 在再次放置 INSERVICE 之前，无法使用该连接。
  • 如果该连接当前处于 "已释放" 状态，那么该连接的状态将设置为 OUTSERVICE ，并且直到该连接再次处于 "已释放" 状态时才能使用该连接。
  • 连接的底层会话的状态始终与连接本身的状态相同。
对于 ISC 系统，发生以下情况:
  • LU6.1 系统-将释放系统拥有的所有底层会话并将其置于服务之外: 如果指定了 PURGE 或 FORCEPURGE ，那么将立即释放这些会话; 如果既未指定 PURGE 也未指定 FORCEPURGE ，那么当任务已终止时，将立即释放这些会话。

    如果对 INQUIRE CONNECTION 命令的响应显示 OUTSERVICE ，那么这并不意味着该连接已显式设置为 SET OUTSERVICE; 在特定情况下，您无法重新安装此连接。

  • APPC 系统-仅当释放系统时，此选项才有效。 然后， ISC 系统拥有的所有会话都将退出服务并发布。
PURGE (仅z/OS Communications Server 和仅 IRC)
异常终止正在所连接的系统上运行的事务。 只有在可以保持系统和数据完整性的前提下，事务才会终止。 如果事务的定义指定 SPURGE=NO ，那么不会清除该事务。
已释放 (仅限 APPC)
指定 CICS 是否释放与 CONNECTION 名称表示的逻辑单元的会话。 要获取有关连接元素的可用性状态的更多详细信息，请使用 CEMT INQUIRE MODENAME 命令。
RESYNC (MRO TO CICS TS for z/OS， Version 5.6 AND LATER SYSTEMS AND APPC ONLY) (APPC PARALLEL-SESSION ， CICS-TO-CICS MRO ， AND LU61 ONLY)
将重试由于此连接失败而搁置的任何 UOW (即，将尝试此连接的交换日志名称再同步)。 当获取连接或 UOW 没有被搁置时，正常情况下，这个过程应该自动启动。 将部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何工作单元进行决策，但将记录决策并在下次获取连接时报告任何数据不一致情况。
注：
  1. COMMIT ， BACKOUT ， FORCEUOW 和 RESYNC 操作与设置 UOW 的状态同步; 即，在 SET CONNECTION BACKOUT ， COMMIT ， FORCEUOW 或 RESYNC 之后的 INQUIRE UOW 返回新的 UOW 状态。
  2. 指定其中一个选项将取消由于连接失败而失败的所有工作单元。 在发出 SET CONNECTION FORCEUOW 之前，您可能希望使用 SET UOW 命令为每个不确定的工作单元显式指定落实或回退，而不是让它成为缺省值，本地过程确定数据的重要性以及使用 INQUIRE UOW ， INQUIRE UOWENQ 和 INQUIRE UOWLINK 命令来建立正确操作的方法。
  3. 只能指定 BACKOUT ， COMMIT ， FORCEUOW ， RESYNC ， NOTPENDING 和 NORECOVDATA 选项之一。 SET CONNECTION NORECOVDATA 仅应在特殊情况下使用。
  4. 要强制所有由同一方向的连接失败导致的不确定工作单元，请使用 SET CONNECTION COMMIT 或 SET CONNECTION BACKUP OUT。
  5. SET CONNECTION 和 SET UOW 的 BACKOUT ， COMMIT ， FORCEUOW 或 RESYNC 选项不会清除再同步信息。 如果要执行此操作，必须使用 SET CONNECTION NOTPENDING 或 SET CONNECTION NORECOVDATA。
  6. 可以发出 BACKOUT ， COMMIT ， FORCEUOW 或 RESYNC 命令 前 ，发出 SET CONNECTION NOTPENDING 或 SET CONNECTION NORECOVDATA。