SET CONNECTION

更改通过 SNA 连接的 MRO 或 ISC 的属性，或取消未完成的 AID。

语法

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

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

SET CONNECTION

读取语法图跳过可视语法图SET CONNECTION( data-value)ACQSTATUS(CVDA)CONNSTATUS(CVDA)ACQUIREDRELEASEDAFFINITY(CVDA)ENDAFFINITYEXITTRACING(CVDA)EXITTRACENOEXITTRACEPENDSTATUS(CVDA)NOTPENDINGPURGETYPE(CVDA)CANCELFORCECANCELFORCEPURGEKILLPURGERECOVSTATUS(CVDA)NORECOVDATASERVSTATUS(CVDA)INSERVICEOUTSERVICEUOWACTION(CVDA)BACKOUTCOMMITFORCEUOWRESYNCZCPTRACING(CVDA)NOZCPTRACEZCPTRACE

条件: INVREQ ， IOERR ， NORMAL ， NOTAUTH 和 SYSIDERR

NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。

描述

您可以使用 "SET CONNECTION命令更改定义 SNA 上 MRO 或 ISC 连接的某些属性。 当已调度所需操作时，控制权将返回到发出程序。 要开始运行，必须将控制权交给CICS®。

注："SET CONNECTION用于通过 SNA 连接更改 MRO 和 ISC 的属性。 另请参阅 SET IPCONN。 SET IPCONN命令用于更改 IPIC 连接（也称为IPCONN）的属性。

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

获取和释放与 ISC 通过 SNA 连接相关联的 APPC 会话的过程涉及启动 LU 服务管理器事务CLS1。 为了向CLS1事务传递数据，CICS使用了默认前缀为 DF 的临时存储队列。 如果在安装中将前缀为 DF 的临时存储队列定义为可恢复，则必须在 "SET CONNECTION命令后执行 "SYNCPOINT命令，以结束逻辑工作单元，并允许 "SET CONNECTION命令完成。

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

选项

ACQSTATUS (cvda) (仅限 APPC)
仅出于兼容性目的保留此选项。 在新应用程序中使用 CONNSTATUS。
AFFINITY (cvda) (仅限 APPC 和 LU61 )
指定 z/OS Communications Server 要结束 CICS拥有的亲缘关系，其中 CICS 是 z/OS® Communications Server 通用资源组的成员。 此选项仅对 APPC 和 LU6.1 连接有效。 该连接必须已经停用，并且处于 NORECOVDATA 状态（对于 APPC）。
CVDA 值为:
结束亲缘关系
结束亲缘关系。
备注信息：
  1. z/OS Communications Server 中没有用于查询亲缘关系的工具，因此 CICS 不知道存在给定连接的亲缘关系。 只要有可能创建了必须显式结束的亲缘关系， CICS 就会发出消息 DFHZC0177。 此消息提供可疑连接的 NETNAME 和 NETID。
  2. 如果 z/OS Communications Server 拒绝了结束亲缘关系的请求，因为不存在此类亲缘关系，那么 CICS 会发出消息 DFHZC0181。
  3. 综合系统中的工作负载均衡中描述了通用资源和亲缘关系。
连接 (data-value)
以 4 字符字段的形式指定 APPC ， IRC 或 LUTYPE6.1 连接。 这是在 CEDA DEFINE CONNECTION 命令的 CONNECTION 选项中指定的远程系统或区域的名称。

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

CONNSTATUS (cvda) (仅限 APPC)
指定是获取还是释放具有由 CONNECTION 名称表示的逻辑单元的会话。 要获取有关连接元素的可用性状态的更详细信息，请使用 INQUIRE MODENAME START ， NEXT 和 END 命令。 连接不能同时为既得和 OUTSERVICE。
CVDA 值包括：
ACQUIRED
将获取会话。
RELEASED
将发布会话。

有关管理 APPC 连接的更多信息，请参阅 管理 APPC 连接。

注: CONNSTATUS 适用于 INQUIRE CONNECTION 命令的 IRC 连接，但不适用于 SET CONNECTION 命令。 通过使用 SERVSTATUS CVDA 设置连接 INSERVICE 或 OUTSERVICE 来控制 MRO 连接的 CONNSTATUS。
EXIT跟踪 (cvda) (仅限z/OS Communications Server )
指定是否跟踪与此连接关联的会话的与终端出口程序关联的活动。 CVDA 值包括：
出口跟踪
要跟踪活动。
NOEXITTRACE
活动不溯源。
PENDSTATUS (cvda) (仅 APPC 和 CICS-to-CICS MRO)
对于以下任一类型的连接，指定要覆盖正常再同步过程:
  • 与已执行初始启动的 CICS Transaction Server for z/OS 合作伙伴的连接
  • 与执行冷启动的CICS Transaction Server for z/OS 前合作伙伴的连接。
CVDA 值为:
未暂挂
强制所有在伙伴初始 (或冷) 启动之前由连接创建的不确定工作单元 (根据事务定义)。 它还会忘记针对连接未完成的任何再同步 (等待忘记 UOW-links) ，并在合作伙伴初始 (或冷) 启动之前创建这些再同步。

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

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

可以忘记整个连接的决策，但这不会影响 UOW 中涉及的任何其他连接的决策内存。

注: SET CONNECTION NOTPENDING ， SET CONNECTION NORECOVDATA 和 SET CONNECTION UOWACTION 是互斥的。 有关要使用的命令的建议，请参阅 UOWACTION 选项描述后面的注释。

对系统间问题进行故障诊断中描述了交换日志名称函数和再同步函数。

PURGETYPE (cvda)
指定要清除关联事务的方式。 CVDA 值包括：
CANCEL
将取消排队等待指定连接的 AID。

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

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

将消息 DFHTF0101 写入 CSMT ，以指示已删除连接的 AID 数以及剩余的 AID 数。

如果发现已取消的 SCHEDULE 请求在远程 CICS 系统中具有前兆; 即， AID 最初是在远程系统中调度的，那么将异步取消此远程 AID。

FORCECANCEL
将取消针对指定连接排队的所有 AID (包括系统 AID)。 请参阅 表 1 以获取需要 FORCECANCEL 将其除去的系统艾滋病列表。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。
注： FORCECANCEL 不会除去具有相关触发任务的瞬时数据 AID。 可通过清除相关任务除去这些 AID。
FORCEPURGE
立即异常终止所有正在所连接系统上的会话中运行的事务。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。

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

对于不确定和搁置的 UOW ， FORCEPURGE 没有任何作用。

注: 要强制搁置的 UOW ，操作员必须在 FORCEPURGE 之后发出 SET CONNECTION COMMIT ， BACKOUT 或 FORCE。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。
KILL
将终止该任务。 不保证系统和数据完整性。 KILL 选项可扩展 PURGE 和 FORCEPURGE 选项的功能。 只有在已经尝试对任务执行 PURGE 或 FORCEPURGE 操作之后，才使用此命令。 KILL 选项不保证任何完整性，但是在某些情况下，它允许您释放已停止的区域，使其能继续处理。 在某些情况下，例如，如果在回退处理过程中终止了任务，CICS 会异常终止。
PURGE
异常终止正在所连接的系统上运行的事务。 只有在可以保持系统和数据完整性的前提下，事务才会终止。 如果事务的定义指定 SPURGE=NO，或者 UOW 被搁置，那么不会清除该事务。
RECOVSTATUS (cvda) (仅限 APPC)
指定要覆盖正常再同步过程。 CVDA 值为:
NORECOVDATA
强制所有不确定的工作单元 (根据事务定义) ，以连接未完成的任何再同步为目标，并擦除先前从合作系统接收的日志名。 连接的状态已重置。
注意: 应仅在特殊情况下使用 SET CONNECTION NORECOVDATA。 它会擦除恢复信息，并可能损害远程系统上已更新资源的单元或工作的数据完整性。
您可能需要使用它的情况示例如下:
  • 您需要废弃连接或发出 SET CONNECTION ENDAFFINITY 命令，并且无法完成与伙伴系统的停顿协议。 （如果未完成恢复数据，那么对于 APPC 连接不可能执行任何操作。）
  • 操作或逻辑错误会导致连接的 logname 不匹配。 必须复位连接状态，从而完成交换日志名的过程。
注: SET CONNECTION NORECOVDATA ， SET CONNECTION NOTPENDING 和 SET CONNECTION UOWACTION 是互斥的。
服务器状态 (cvda)
指定是将系统置于服务中还是将系统置于服务中。 CVDA 值包括：
INSERVICE
系统将投入服务; 即可供使用。
对于 MRO 连接，所有会话都处于服务状态，并且发生以下情况:
  • 如果发出系统和远程系统都打开了 IRC ，并且远程系统具有发出系统的 INSERVICE 连接定义，那么将进行既得连接 (请参阅 CONNSTATUS 选项描述后面的注释)。
  • 否则，将设置连接的状态为 INSERVICE ，以便在满足上述条件时获取连接。
  • 连接的底层会话的状态始终与连接本身的状态相同。

对于 EXCI 连接，所有接收会话 (或 管道) 都已投入服务，可供客户机程序使用。

对于 ISC APPC 连接，将 LU 服务管理器会话置于服务中，从而允许随后获取该连接。

对于 ISC LU6.1 连接，所有会话都置于服务中。

OUTSERVICE
连接将被置于服务外; 即不可用。
对于连接，所有会话都将停用 (如果指定了 PURGE ，那么将立即停用; 如果未指定 PURGE ，那么将在任务已终止时停用) ，并且将发生以下情况:
  • 如果当前已获取 APPC 连接并且您指定了 OUTSERVICE ，那么该命令将失败，并返回 INVREQ 和 2 的 RESP2 。 必须先释放连接，然后再设置 OUTSERVICE。
  • 如果当前已获取 任何其他 连接，那么会话将中断 (已停顿)。 在再次放置 INSERVICE 之前，无法使用该连接。
  • 如果该连接当前处于 "已释放" 状态，那么该连接的状态将设置为 OUTSERVICE ，并且直到该连接再次处于 "已释放" 状态时才能使用该连接。
  • 连接的底层会话的状态始终与连接本身的状态相同。

对于 EXCI 连接，所有接收会话 (或 管道) 都将被置于服务之外，并且不可供客户机程序使用。

对于 ISC APPC 系统，仅当已释放连接时，此选项才有效。 将 LU 服务管理器会话置于服务之外，并且直到再次将其置于 INSERVICE 之后，才能获取连接。

对于 ISC LU6.1 连接，将释放所有会话并将其置于服务之外: 如果指定了 PURGE 或 FORCEPURGE ，那么将立即释放这些会话; 如果既未指定 PURGE 也未指定 FORCEPURGE ，那么将在任务终止时释放这些会话。 如果对 INQUIRE CONNECTION 命令的响应显示 OUTSERVICE ，那么这并不意味着该连接已显式设置为 SET OUTSERVICE; 在特定情况下，您无法重新安装此连接。

UOWACTION (cvda) (仅 APPC 并行会话， CICS-to-CICS MRO 和 LU61 )
指定要部分覆盖正常再同步过程: 将对由于连接失败而不确定的任何工作单元进行决策; 但将记录决策并在下次获取连接时报告任何数据不一致情况。
该操作与设置 UOW 的状态同步; 即， SET CONNECTION UOWACTION 之后的 INQUIRE UOW 返回新的 UOW 状态。 CVDA 值包括：
回退
由于此连接失败而搁置的所有 UOW 都将回退。
落实
将落实由于此连接失败而搁置的所有 UOW。
FORCEUOW
将强制所有因此连接失败而搁置的 UOW 进行 BACKOUT 或 COMMIT ，如 TRANSACTION 定义的 ACTION 选项中所指定。
RESYNC (仅限 MRO-to-CICS Transaction Server for z/OS 和更高版本的系统以及 APPC)
将重试由于此连接失败而搁置的任何 UOW (即，将尝试此连接的交换日志名称再同步)。 当获取连接或 UOW 没有被搁置时，正常情况下，这个过程应该自动启动。
备注信息：
  1. SET CONNECTION UOWACTION 取消舍入由于连接失败而导致不确定失败的所有工作单元。 在发出 SET CONNECTION FORCE 之前，您可能希望使用 SET UOW 命令为每个不确定的工作单元显式指定落实或回退，而不是让其为缺省值。 本地过程将确定数据的重要性以及使用 INQUIRE UOW ， INQUIRE UOWENQ 和 INQUIRE UOWLINK 命令建立正确操作的方法。
  2. 就搁置的工作单元而言，只能使用 SET CONNECTION UOWACTION ， SET CONNECTION NOTPENDING 和 SET CONNECTION NORECOVDATA 之一。 SET CONNECTION NORECOVDATA 仅应在特殊情况下使用。
  3. 要强制所有由同一方向的连接失败导致的不确定工作单元，请使用 SET CONNECTION COMMIT 或 SET CONNECTION BACKUP OUT。
  4. SET CONNECTION UOWACTION 和 SET UOW UOWACTION 命令都不会清除再同步信息。 如果要执行此操作，必须使用 SET CONNECTION NOTPENDING 或 SET CONNECTION NORECOVDATA。
  5. 可以发出 SET CONNECTION NOTPENDING 或 SET CONNECTION NORECOVDATA 命令 前 。
ZCP跟踪 (cvda) (仅限z/OS Communications Server )
指定 CICS 的 z/OS Communications Server 控制组件是否跟踪与此连接关联的会话上的活动。 CVDA 值包括：
NOZCPTRACE
将不执行 z/OS Communications Server ZCP 跟踪。
ZCPTRACE
将执行 z/OS Communications Server ZCP 跟踪。

条件

INVREQ
RESP2 值：
1
ACQSTATUS | 为非 APPC 连接指定了 CONNSTATUS。
2
在下列任何一种方法中，都未一致地指定既得和 OUTSERVICE:
  1. 已使用 OUTSERVICE 指定既已获取
  2. 为 OUTSERVICE 连接指定了既得
  3. 为获取的 APPC 连接指定了 OUTSERVICE。
  4. 在同一命令中为既已获取的连接指定了已释放和 OUTSERVICE。
3
ACQSTATUS | CONNSTATUS 具有无效的 CVDA 值。
4
SERVSTATUS 具有无效的 CVDA 值。
5
对不是 APPC 或 IRC 的连接指定了 PENDSTATUS 或 NOTPENDING。
6
为非 z/OS Communications Server的连接指定了 PURGE。
7
PURGETYPE 具有无效的 CVDA 值。
8
PENDSTATUS 具有无效的 CVDA 值。
11
SET 命令指定了远程连接。
12
EXIT跟踪具有无效的 CVDA 值。
13
ZCP跟踪具有无效的 CVDA 值。
14
未初始化对非z/OS Communications Server 连接或 z/OS Communications Server 指定的EXIT跟踪 | ZCPTRACXX_ENCODE_CASE_CAPS_LOCK_OFF。
16
由 CONNECTION (data-value) 指定其名称的资源是间接链接。
17 日
ACQSTATUS | 当系统使用 ISC=NO 初始化时，无法设置 CONNSTATUS。
18
无法为已成功完成 Exchange Lognames 处理的连接设置 NOTPENDING。
19
当处于 FREE 状态时，无法将 CONNECT 状态设置为既已获取。
20
COMMIT ， BACKOUT ， FORCE 或 RESYNC 对此类型的连接无效。
21
指定了 BACKOUT 或 FORCE ，但未成功。 对于此连接，某些 UOW 仍处于搁置状态。
22
CANCEL 或 FORCECANCEL 选项随附了其他 SET 参数。
23
名称由 CONNECTION (name) 指定的资源是本地 TCT 系统条目 (TCTSE)。
25
连接仍在服务中。
26 日
RECOVSTATUS 的值不为 NORECOVDATA。
30
ENDAFFINITY 的连接类型错误。 亲缘关系只能存在于 LU6.1 和 LU6.2 连接上。
31 日
无法从已安装的连接获取 NETID。 因此，要结束亲缘关系，必须使用 PERFORM ENDAFFINITY 命令。
32
请参阅消息 DFHZC0178。 z/OS Communications Server 无法结束亲缘关系，原因不是 35 (NOTFOUND) 或 36 (SESSIONS ACTIVE)。
35
z/OS Communications Server 找不到此连接的亲缘关系。
36
z/OS Communications Server 无法结束亲缘关系，因为连接具有一些活动会话。
37
请参阅消息 DFHZC0176。 z/OS Communications Server 错误导致无法执行 CHANGE ENDAFFIN 宏。
44
GRSTATUS 未设置为 REGISTERED 或 DEREGISTERED。 (无通用资源名称。)
45
不能为正在服务的连接设置 NORECOVDATA。
46
为非 APPC 连接指定了 NORECOVDATA。
47
命名本地系统项的 SET 命令指定 CANCEL 或 FORCECANCEL 以外的选项。
IOERR
RESP2 值：
10
意外的错误。
正常
RESP2 值：
58
AID 已成功取消。
59
未取消任何 AID。
NOTAUTH
RESP2 值：
100
未授权与发出任务关联的用户使用此命令。
SYSIDERR
RESP2 值：
9
找不到指定的连接。