[z/OS]

复制页集并在 z/OS® 上重置日志 (RESETPAGE)

RESETPAGE 函数类似于 COPYPAGE 函数，只是它还会重置新页集中的日志信息。

RESETPAGE 允许您从已知的一组有效页集重新启动队列管理器，即使相应的日志数据集已损坏也是如此。

RESETPAGE 的源页集必须处于一致状态。 它们必须是:
  • 已通过使用 IBM® MQ 命令 STOP QMGR 成功关闭队列管理器的页集。
  • 已成功停止的页集的副本。
不得对使用模糊备份 (请参阅 方法 2: 模糊备份 ) 生成的页集副本运行 RESETPAGE 函数，也不得对来自异常终止的队列管理器的页集运行 RESETPAGE 函数。
RESETPAGE:
  • 将 DDnames CSQS0000 通过 CSQS0099 引用的所有数据集上的页集复制到 DDnames CSQT0000 通过 CSQT0099引用的新数据集。 如果使用此功能，请修改启动式任务过程中的页集定义，以反映新页集所在数据集的名称更改。
  • 重置 DDnames CSQP0000 到 CSQP0099所引用的页集中的日志信息。

有关更多信息，请参阅 管理页集。

使用 RESETPAGE 函数

您可以使用 RESETPAGE 函数来更新一组一致的页集，以便这些页集可以与一组新的 (干净的) BSDS 和日志数据集配合使用，以启动队列管理器。 仅当日志的两个副本都已丢失或损坏时，才必须使用 RESETPAGE 功能; 您可以从页集的备份副本 (并接受从创建副本时产生的数据丢失) 或从现有页集重新启动。

在此情况下，请在受影响队列管理器的 所有 页集上使用 RESETPAGE 函数。 您还必须创建新的 BSDS 和日志数据集。

注: 请勿在 IBM MQ已知的页集子集上使用 RESETPAGE 函数。
如果对任何页集运行 RESETPAGE 功能，但没有为队列管理器提供干净的 BSDS 和日志数据集，那么 IBM MQ 会尝试从 RBA 零恢复日志，并将页集视为空。 例如，如果您尝试使用 RESETPAGE 函数来生成零页集， 1 ， 2 和 3 而不提供一组干净的 BSDS 和日志数据集，那么将生成以下消息:
CSQI021I +CSQ1 CSQIECUR PAGE SET 0 IS EMPTY. MEDIA RECOVERY STARTED
CSQI021I +CSQ1 CSQIECUR PAGE SET 1 IS EMPTY. MEDIA RECOVERY STARTED
CSQI021I +CSQ1 CSQIECUR PAGE SET 2 IS EMPTY. MEDIA RECOVERY STARTED
CSQI021I +CSQ1 CSQIECUR PAGE SET 3 IS EMPTY. MEDIA RECOVERY STARTED

页集管理 (RESETPAGE)

读取语法图跳过可视语法图 RESETPAGE FORCE

关键字和参数

FORCE
指定将由 DDnames CSQP0000 到 CSQP00nn 指定的页集重置到位。

如果未指定 FORCE ，那么 DDnames CSQS0000 到 CSQS00nn 指定的页集将复制到 DDnames CSQT0000 到 CSQT00nn指定的新页集。 这是缺省值。

您应该先获取页集的副本。 请参阅 备份页集 以获取用于执行此操作的样本 JCL。

示例

DDname CSQS0007所引用的现有页集将复制到 DDname CSQT0007所引用的新数据集。 在调用 RESETPAGE 函数之前，已将 DDname CSQP0007引用的新数据集格式化为页集。
图 1。 显示 RESETPAGE 函数用法的样本 JCL
//RESTPAGE EXEC PGM=CSQUTIL
//STEPLIB  DD   DISP=SHR,DSN=thlqual.SCSQANLE
//         DD   DISP=SHR,DSN=thlqual.SCSQAUTH
//CSQP0007 DD   DISP=OLD,DSN=pageset.newname7
//CSQS0007 DD   DISP=OLD,DSN=pageset.oldname7
//CSQT0007 DD   DISP=OLD,DSN=pageset.newname7
//SYSPRINT DD   SYSOUT=*
//SYSIN    DD   *
* Format new data set, CSQP0007, as page set
 FORMAT
* Copy page set CSQS0007 to CSQT0007 and reset it
 RESETPAGE
/*

使用说明

  1. 在队列管理器异常终止后，请勿对页集使用 RESETPAGE 函数。 来自异常终止的队列管理器的页集可能包含不一致的数据; 在处于此状态的页集上使用 RESETPAGE 会导致数据完整性问题。
  2. 不能在属于正在运行的队列管理器的页集上使用 RESETPAGE。
  3. 在使用 RESETPAGE 之前，必须将新数据集预先格式化为页集。 为此，请使用 FORMAT 函数，如 图 1中所示。
  4. 确保新 (目标) 数据集大于旧 (源) 数据集。
  5. 不能更改与页集相关联的页集标识 (PSID)。 例如，不能 "使" 页集 03 成为页集 05。
  6. 此函数的故障不会阻止尝试其他 CSQUTIL 函数。