UPDATE IMS 命令

要更改 IMSplex 中的全局 PLEXPARM 值，请使用 UPDATE IMS SET(PLEXPARM()) 命令。 要在 IMSplex 中的一个或多个 IMS 系统中更改本地 LCLPARM 值，请使用 UPDATE IMS SET(LCLPARM()) 命令。

子节:

• 环境
• 语法
• 关键字
• 使用说明
• 输出字段
• 返回码，原因码和完成代码
• 示例

环境

下表列出了可以从中发出 UPDATE IMS 命令和关键字的环境 (DB/DC ， DBCTL 和 DCCTL)。

语法

关键字

以下关键字对 UPDATE IMS 命令有效:

LCLPARM ()

指定要修改的局部参数的值。 LCLPARM () 关键字与 UPDATE IMS SET() 命令中的 PLEXPARM () 关键字互斥。

UPDATE IMS SET(LCLPARM()) 命令可用于修改每个 IMS 系统上的本地参数，例如 FPBP64STAT 。

对于 UPDATE IMS SET(LCLPARM()) 命令，从 OM 接收该命令的所有 IMS 系统都会处理该命令。

指定下列其中一个选项:

AUTOEXPORT (N)

指定应禁用系统检查点期间的自动导出处理。 AUTOEXPORT 关键字在具有或不具有 IMSRSC 存储库的 DRD 环境中有效。

对于启用了 RDDS 数据集的 DRD 用户，在成功迁移到存储库之后，可以使用 UPDATE IMS SET(LCLPARM(AUTOEXPORT(N))) 命令。 此命令可减少系统检查点自动导出的处理器使用率。

AUTOEXPORT (N) 如果同时启用了 IMSRSC 存储库 和 RDDS ，那么将关闭对这两个存储库的自动导出。 如果在 IMS 关闭期间自动导出到存储库期间发生错误，那么可以使用 UPDATE IMS SET(AUTOEXPORT(N)) 命令关闭自动导出到存储库，然后重试 IMS 关闭。

UPDATE IMS SET(AUTOEXPORT(N)) 命令所做的更改仅在 IMS 重新启动之前保持有效。 要永久更改 IMS中的 AUTOEXPORT 设置，请修改 DFSDFXXX PROCLIB 成员中的 AUTOEXPORT 设置。

发出带有 AUTOEXPORT (N) 关键字的 UPDATE IMS 命令后，可以在 EXPORT 和 IMPORT 命令上以及在自动导入期间继续使用系统 RDDS 数据集。 但是，在导入和自动导入期间，请确保 RDDS 包含当前数据，尤其是在关闭 AUTOEXPORT 时。

自动导出到 RDDS 和/或 IMSRSC 存储库可由 IMS 的冷启动启用，并且为 DFSDFxxx PROCLIB 成员指定了 AUTOEXPORT = RDDS | REPO | AUTO。

通过对 DFSDFxxx PROCLIB 成员指定 AUTOEXPORT = N ，然后启动 IMS，可以启用到 RDDS 的自动导出。

FPBP64STAT

指定是否将从属区域的每个工作单元 (UOW) 的快速路径 64 位缓冲区使用情况统计信息写入 OLDS。 快速路径 64 位缓冲区使用情况记录在 X'5945 ' 日志记录中。

N

不将 X'5945 ' 日志记录中从属区域的每个工作单元的快速路径 64 位缓冲区使用情况统计信息写入 OLDS。

Y

将 X'5945 ' 日志记录中从属区域的每个工作单元的快速路径 64 位缓冲区使用情况统计信息写入 OLDS。

锁定时间

指定 IMS LOCKTIME 值。 可以通过下列关键字和参数的任意组合来指定 LOCKTIME 值:

BMP (xx)

指定 IMS 在 BMP 区域的锁定请求超时之前等待的时间量。 BMP 区域包括 IMS BMP 和 JBP 区域。 该值表示时间 (以秒为单位) ，范围为 1-32767。

BMPOPT (ABEND | STATUS)

指定 IMS 是异常结束超时任务 (ABEND) 还是向应用程序返回状态码 (STATUS)。

MSG (yy)

指定 IMS 在对 MSG 区域的锁定请求超时之前等待的时间量。 MSG 区域包括 IMS MPP ， JMP 和 IFP 区域以及 DRA 线程。 该值表示时间 (以秒为单位) ，范围为 1-32767。

MSGOPT (ABEND | STATUS)

指定 IMS 是异常结束超时任务 (ABEND) 还是向应用程序返回状态码 (STATUS)。

更新 IMS LOCKTIME 值不会影响 IRLM中的锁定超时值。 要更改 IRLM中的锁定超时值，请使用现有 MODIFY IRLM 命令。

建议: 通常，对 IMS 和 IRLM使用相同的超时值。 在 IMS中使用两个值时，将 IRLM 超时值设置为两个 IMS 值中的较低值将允许 IMS 和 IRLM 一起操作。 向同一 IRLM标识多个 IMS 时，工作负载条件可能需要在整个 IMS 系统中使用不同的超时值。 在这种情况下，请注意以下事项:

• 在 IRLM 中使用较低的超时值会导致锁定请求等待，直到等待时间等于最低的 IMS LOCKTIME 值。
• 在 IRLM 中使用更高的超时值会导致锁定请求等待超过 IMS 时间，因为在超过 IRLM 超时值之前， IRLM 不会调用 IMS 。

REPO (Y)

使 IMS 能够使用存储库。

REPOTYPE (IMSRSC)

要启用的存储库类型。 REPO (Y) 需要 REPOTYPE。

在命令处理期间， IMS 将连接到存储库服务的 RM ，以使 IMS 能够使用该存储库。 如果未启用 RM 以使用存储库，那么 UPDATE IMS 命令将导致错误。 必须首先通过发出 UPDATE RM 命令来启用 RM 以使用存储库。

要禁用存储库，必须冷启动 IMS 。

初始化 IMS 时，仅当在 DFSDFxxx PROCLIB 成员的 REPOSITORY 部分中定义了 REPOSITORY = (TYPE = IMSRSC) 语句时，才会启用存储库使用。 因此，成功处理 UPDATE IMS SET(LCLPARM(REPO(Y) REPOTYPE(IMSRSC)) 命令时，必须在任何 IMS 重新启动之前添加 REPOSITORY = (TYPE = IMSRSC) 语句，因为我们只能在 IMS 冷启动期间禁用存储库的使用。

在 IMS 重新启动期间，如果 IMS 日志记录指示在重新启动之前已启用 IMSRSC 存储库 ，并且未定义 REPOSITORY = (TYPE = IMSRSC) 语句，那么 IMS 将终止并返回 U0168 异常终止代码和 X’1C’ 错误代码。

对于 XRF 复合体，在 IMS 活动系统上输入命令会导致在 IMS 备用系统上处理该命令。 成功完成该命令需要 IMS 活动系统和备用系统都在其各自 DFSDFxxx PROCLIB 成员的 REPOSITORY 部分中添加 REPOSITORY = (TYPE = IMSRSC) 语句。

在 IMS 连接到 IMSRSC 存储库之后，如果在 IMS 初始化期间使用的 DFSDFxxx 成员中显式指定了 AUTOEXPORT = AUTO 或 REPO ，那么还会启用到 IMSRSC 存储库 的自动导出。

自动导出是根据 DFSDFxxx 成员中指定的 AUTOEXPORT_IMSID= 值完成的。 如果未在 DFSDFxxx 成员中指定 AUTOEXPORT_IMSID= ，那么针对自动导出将 AUTOEXPORT_IMSID 设置为 THIS_IMS。

如果您希望 AUTOEXPORT_IMSID=ALL ，那么必须修改 DFSDFxxx 成员以添加存储库部分，并且必须重新启动 AUTOEXPORT_IMSID=ALL 和 IMS 。

如果未在 DFSDFxxx 成员中显式指定 AUTOEXPORT = AUTO 或 REPO ，那么 UPD IMS 命令不会启用自动导出到 IMSRSC 存储库 。 必须修改 DFSDFxxx 成员以添加 AUTOEXPORT = AUTO 或 REPO 和 AUTOEXPORT_IMSID= 关键字并重新启动 IMS。

ZHyperWrite

指定是否为 OLDS 或 WADS 启用 IBM zHyperWrite。

OLDS

指定是否为 OLDS 启用 IBM zHyperWrite。

Y

IBM zHyperWrite 将用于OLDS。

N

IBM zHyperWrite 不能用于OLDS。

WADS

指定是否为 WADS 启用 IBM zHyperWrite。

Y

IBM zHyperWrite 将用于WADS。

N

IBM zHyperWrite 不适用于 WADS。

如果你发布 UPDATE IMS SET(LCLPARM(ZHYPERWRITE()))命令为 OLDS 启用或禁用 zHyperWrite ，该命令只对 IMS 打开的后续 OLDS 有效，对已经打开的 OLDS 无效。 要迫使 IMS 打开新的OLDS，以便立即开始或停止使用 zHyperWrite ，请两次发送 /SWITCH OLDS 命令。

如果您发出 UPDATE IMS SET(LCLPARM(ZHYPERWRITE())) 命令来启用或禁用WADS zHyperWrite ，该命令IMS 下一次写入WADS时生效。

UPDATE IMS SET(LCLPARM(ZHYPERWRITE())) 命令可在不IMS 的情况下动态启用或禁用WADS和OLDS zHyperWrite。 但是，不会记录 UPDATE IMS SET(LCLPARM(ZHYPERWRITE())) 命令，这意味着如果 IMS 重新启动，那么您使用 UPDATE IMS SET(LCLPARM(ZHYPERWRITE())) 命令所做的任何更改都不可恢复。 如果希望更改在 IMS 重新启动之间持久存在，请更新 DFSDFxxx 成员的 LOGGER 部分中的 ZHYPERWRITE 参数。

建议 ：如果您想更改此参数的值，并希望更改后的值在重启后仍保持不变，请在 DFSDFxxx 成员的 LOGGER 部分更新 ZHYPERWRITE 参数，然后发出 UPDATE IMS SET(LCLPARM(ZHYPERWRITE())) 命令以动态更改 zHyperWrite。 这样，如果 IMS 失败并且必须重新启动，那么将使用更新后的值重新启动该 IMS。

PLEXPARM ()

指定要修改的全局参数的值。 LCLPARM 关键字与 UPDATE IMS SET() 命令中的 PLEXPARM 关键字互斥。

UPDATE IMS SET(PLEXPARM()) 命令可用于修改 IMSplex 中维护的区域，数据库和事务的全局状态。 如果该命令成功，那么将更新 RM 全局 PLEXPARM 条目中的值以及在每个 IMS 系统中维护的值。

对于 UPDATE IMS SET(PLEXPARM()) 命令， IMSplex 中的所有 IMS 系统都会接收该命令，但只有命令主 IMS 会处理该命令。 非主 IMS 系统不会处理从 OM 发送的命令。 相反，命令主 IMS 会在 IMSplex 中的所有 IMS 系统之间协调更改。

指定以下一个或多个资源:

GSTSAREA

指定如何在 IMSplex 中维护区域状态。

N

没有为 RM 中的区域资源维护全局状态。 将删除区域资源的 RM 中的所有全局状态。

Y

RM 中的区域资源保持全局状态。 全局状态在后续 UPD AREA SCOPE(ALL) 命令或包含 GLOBAL 关键字的 type-1 区域命令上保持。

GSTSDB

指定如何在 IMSplex 中维护数据库状态。

N

没有为 RM 中的数据库资源维护全局状态。 将删除 RM 中数据库资源的所有全局状态。

Y

为 RM 中的数据库资源维护全局状态。 全局状态在包含 GLOBAL 关键字的后续 UPD DB SCOPE(ALL) 命令或 type-1 数据库命令上保持。

GSTSTRAN

指定如何在 IMSplex 中维护事务状态。

N

没有为 RM 中的事务资源保留全局状态。 将删除 RM 中事务资源的所有全局状态。

Y

为 RM 中的事务资源维护全局状态。 全局状态在后续 UPD TRAN SCOPE(ALL) 命令上保持。

选项 ()

指定 UPDATE IMS SET 命令的选项。

CONTINUE

指示 IMS 应继续处理先前输入的 UPDATE IMS SET 命令，该命令在完成之前迂到错误。 该命令必须位于允许继续处理的位置，否则该命令将异常中止。

如果指定了 OPTION (CONTINUE) ，那么不能在 PLEXPARM 参数上传递任何参数。

FORCE

当 UPD IMS 命令由于备用数据库未完成重新启动处理而失败时，可在 DBCTL 热备用环境中使用 OPTION (FORCE)。 如果指定了 OPTION (FORCE) ，那么即使 IMS 处于重新启动方式，也可以完成 UPD IMS 命令。 当指定 OPTION (FORCE) 时，处于重新启动方式的 IMS 不会参与并更新 UPD IMS 值; 此选项仅允许 UPD IMS 命令在其他 IMS 系统上完成。 DBCTL 备用数据库在重新启动以变为活动状态时重新读取全局条目，以获取当前 PLEXPARM 值。 如果在非 DBCTL 备用系统未完成重新启动时使用 OPTION (FORCE) ，那么结果可能与预期不符，因为 IMS 未运行 UPD IMS 命令。 这可能导致错误，因为 PLEXPARM 值不匹配。

使用说明

UPDATE IMS SET 命令是必须通过 OM API 发出的 type-2 命令。 该命令对 OM 定义为 ROUTE=ALL。 OM 将该命令路由到 IMSplex 中的所有 IMS 系统。 此命令不是可恢复命令。

只有在XRF备用系统上，才会从日志记录中处理命令，该系统读取XRF主系统的 X'220E' ，以便与XRF主系统保持同步。 即使在 XRF 环境中，如果发生接管并且需要重新启动 IMS (/ERE 或 /NRE) ，那么不会恢复该命令。 它要求更改 DFSDFxxx PROCLIB 成员以在 REPOSITORY 部分中包含 REPOSITORY = (TYPE = IMSRSC) 语句。 否则， IMS 将以 U0168 异常终止代码和 X’1C’ 错误代码终止。

通常，当接收到 UPDATE IMS 命令的非零返回码时，必须输入 UPD IMS SET(PLEXPARM()) OPTION(CONTINUE) 命令，这将指示 IMS 完成该命令或取消该命令并根据需要进行清除。 UPD IMS SET(PLEXPARM()) OPTION(CONTINUE) 命令的原因码可能指示原始 UPD IMS 命令的状态。 如果命令无法确定原始 UPD IMS 命令的状态，那么原因码指示该事实。 用户可以使用 QUERY IMS 命令来查找全局 IMSplex 参数的状态。

如果在 UPD IMS 命令处理期间迂到错误，那么在发出 UPDATE IMS SET(PLEXPARM()) OPTION(CONTINUE) 命令并成功完成之前，无法处理另一个新的 UPD IMS 命令。

如果未解决导致接收到 UPDATE IMS 命令的非零返回码的错误情况，那么 UPDATE IMS SET(PLEXPARM()) OPTION(CONTINUE) 命令将继续迂到相同的错误情况。 必须先解决错误情况，然后才能清除该命令并输入另一个 UPDATE IMS 命令。

此命令在 FDBR 系统或 XRF 备用系统上无效。 但是， FDBR 系统和 XRF 备用系统在内部维护全局 PLEXPARM 值，并使用 QUERY IMS SHOW (PLEXPARM) 命令报告其值。 FDBR 系统返回完成代码 ICC_NA 或 1。 允许 UPD IMS 命令在其他 IMS 系统上完成。

如果 IMS 正在重新启动，那么不允许使用 UPD IMS SET 命令。 该命令失败，返回码为 "B0"。 必须在 IMS 完成重新启动处理后发出 UPD IMS 命令。

指定 REPO (Y) 时，某些错误条件会导致 DFS3308E， DFS4400E， DFS4457E或其他错误消息作为命令应答中的消息输出发送。 这些消息可用于帮助诊断错误原因。

输出字段

返回码，原因码和完成代码

可以作为 UPDATE IMS 命令的结果返回的返回码和原因码是通过 OM API 输入的所有命令的标准代码。

下表包含返回码和原因码以及代码的简要说明。 针对该命令返回的返回码或原因码还可能指示来自 CSL 请求的错误。

对于 UPDATE IMS 命令的处理唯一的错误将作为完成代码返回。 针对单个资源返回每个操作的完成代码。