RESYNC ENTRYNAME
确定 不确定
工作单元的处置。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。
条件: NOTAUTH
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
此命令是线程安全的。
描述
RESYNC 命令允许非CICS® 资源管理器确定其 处于不确定状态
的工作单元是否已落实或回退。
如果已针对同步点的第一阶段调用了工作单元,但未针对第二阶段调用了该工作单元,那么资源管理器可能会对该工作单元产生疑问。 资源管理器或 CICS 在阶段 1 和阶段 2 之间发生故障会使资源管理器对该工作单元产生疑问。
CICS 保存或重构任何此类工作单元的处置,直到 RESYNC 命令或初始启动。 CICS 还会保存资源管理器回复 记住
第二阶段同步点调用的任何工作单元的处置,以便如果资源管理器无法按指示落实或回滚,那么它可以请求稍后的处置以进行恢复。
要使用已保存的处置信息,资源管理器必须具有哪些工作单元存在疑问或 已记住
的记录。 然后,它可以在其任务相关的用户出口程序或关联的管理事务中发出带有这些工作单元列表的 RESYNC 命令。
作为响应, CICS 将为列表中的每个不确定工作单元创建一个任务 CRSY。 CRSY 任务代表其特定工作单元调用一次与任务相关的用户出口程序。 此调用将作为阶段 2 同步点请求标识到出口,并因此指示工作单元是已落实还是已回滚。 然后,出口程序可以按照资源管理器所需的格式来中继此信息。
资源管理器由其任务相关用户出口的名称以及 (可选) 此名称的限定符标识。 使用限定符允许同一资源管理器的多个实例独立再同步。
一旦调度了 CRSY 任务,就会将控制权返回给发出 RESYNC 命令的程序。 根据正常的 CICS 分派规则,它们以并行方式异步运行。 因此,应该在 RESYNC 命令之前启用,启动和初始化出口,使其能够处理这些调用。
如果出口不可用,那么 CRSY 任务将保存其工作单元的处置,但由于稍后会发生此情况,因此 RESYNC 上不会出现异常情况。 有关与任务相关的用户出口的再同步调用的完整详细信息,请参阅 编写与任务相关的用户出口程序 。
如果 CICS 由于某种原因而失败,或者执行了立即关闭,那么为响应从外部资源管理器返回的已落实流而写入的 忘记流
日志记录将丢失。 这是因为除了受控的CICS关闭外,任何其他操作都不会调用 MVS 日志记录器将日志记录强制添加到日志流中。 这可能会导致在 CICS的后续紧急重新启动时重建工作单元 (如果在重新启动时未看到这些工作单元与外部资源管理器的链接为 forgettable
)。 为了允许 CICS 放弃这些工作单元,外部资源管理器可以在 CICS 系统重启后重新连接时向 CICS 发送EXEC CICS RESYNC命令。 未在命令上传递的任何工作单元都将被视为 CICS不再需要。
选项
- ENTRYNAME (data-value)
- 指定资源管理器的任务相关用户出口的 8 字符名称。 这是用于建立出口的 ENABLE 命令的 ENTRYNAME 值,如果省略了 ENTRYNAME ,那么为 PROGRAM 值。
- IDLIST (data-value)
- 指定要再同步的工作单元的列表。 列表中的每个条目都是不确定工作单元的 8 字节标识的 地址 。 列表的结尾可以由开启的高阶位指示,也可以使用 IDLISTLENGTH。
工作单元由传递到任务相关用户出口的 UEPURID 值标识。
注: IDLIST 是可选的,但如果省略 IDLIST ,那么除非指定 PARTIAL ,否则 CICS 将废弃资源管理器的所有已保存的处置信息。 不指定列表和指定 PARTIAL 是不合逻辑的组合,并导致 NO-OP。 - IDLISTLENGTH (data-value)
- 指定一个半字二进制值,指示地址列表的长度 (以字节计,每个不确定工作单元计数 4 字节)。
- PARTIAL
- 指定 CICS 将保留未在不确定列表中传递的 UOW (对于此资源管理器) 的不确定解析数据。 PARTIAL 指示此时,资源管理器希望仅再同步其不确定的一部分 UOW。如果未指定 PARTIAL ,那么 CICS 将废弃未在不确定列表中传递但属于此资源管理器再同步集的任何 UOW 的解析数据。注: 首次启用与任务相关的用户出口时,将初始化资源管理器的再同步集。 当发出第一个非部分 RESYNC 命令时使用。 非部分 RESYNC 完成后,将初始化新的再同步集,以便与下一个非部分 RESYNC 配合使用。这包括 CICS 本身存在疑问的 UOW 的数据。
与任务相关的用户出口程序可以在与其外部资源管理器的连接的生存期内发出多个部分再同步。 但是,在连接的生存期内,它应该只发出 一个 完全 (即,非部分) 再同步。 这通常在首次建立连接时完成。 完全再同步意味着删除 IDLIST 中未提及的 UOW。 仅当外部资源管理器未连接到 CICS 时,才能确保它具有要传递到 CICS的 UOW 的完整列表。
- QUALIFIER (data-value)
- 指定 ENTRYNAME 值的 8 字符限定符,该限定符标识 RESYNC 命令应用于的资源管理器的特定实例。 该限定符是可选的; 它适用于可以使用资源管理器的多个副本的系统。
使用时,此值由任务相关的用户出口在工作单元发生时通过用户出口参数列表中的 UEPRMQUA 值分配给工作单元。 如果 RESYNC 命令指定了限定符,那么 CICS 将仅使用使用相同的 QUALIFIER 和 ENTRYNAME 值保存的处置信息。 同样,仅当已保存的处置具有相同的两个值,未包含在 IDLIST 中,并且未指定 PARTIAL 时,它才会废弃这些处置。
条件
- NOTAUTH
- RESP2 值:
- 100
- 未授权与发出任务关联的用户使用此命令。
