MODIFY RECOVERY 制御ステートメントの構文とオプション
MODIFY RECOVERY ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。
制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。
構文図
>>-MODIFY--RECOVERY---------------------------------------------> >--+-LIST--listdef-name------------------------------+----------> '-TABLESPACE--+----------------+-table-space-name-' '-database-name.-' .-DSNUM--ALL-----. >--+----------------+--+-------+--------------------------------> '-DSNUM--integer-' '-CLONE-' >--+-DELETE-+------------------+----------------------+---------> | +-AGE-+-integer-+--+ | | | '-(*)-----' | | | '-DATE-+-integer-+-' | | '-(*)-----' | '-RETAIN----+-LAST--(--integer--)--------------+---' +-LOGLIMIT-------------------------+ '-GDGLIMIT-+---------------------+-' +-LAST--(--integer--)-+ '-LOGLIMIT------------' >--+------------+---------------------------------------------->< '-NOCOPYPEND-'
オプションの説明
- LIST listdef-name
- 前に定義された、表スペースのみを含む LISTDEF リスト名の名前を指定し
ます。MODIFY RECOVERY 制御ステートメントごとに 1 つの LIST キーワードを指定することができ
ます。LIST は、TABLESPACE キーワードと一緒には指定しないでくだ
さい。MODIFY は、リストにあるそれぞれの表スペースごとに 1 回、呼び出され
ます。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。
LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。
パーティションまたは パーティション範囲をリストに指定できます。
- TABLESPACE database-name.table-space-name
- レコードの削除を行うデータベースおよび表スペースを指定します。
- database-name
- 表スペースが属しているデータベースの名前を指定します。
database-name はオプション
です。
デフォルト値は、DSNDB04 です。
- table-space-name
- 表スペースの名前を指定します。
- DSNUM integer
- レコードの削除を行う表スペースの、単一のパーティションまたはデータ・セットを示し
ます。ALL は、データ・セットおよび表スペース全体のレコードを削除します。
integer はパーティションまたはデータ・セットの番号です。
デフォルト値は ALL です。
パーティション化表スペースの場合の integer は、その物理パーティション番号です。最大は 4096 です。
非パーティション化表スペースの場合、VSAM カタログにカタログされている データ・セット名の終わりのデータ・セット整数を使用してください。イメージ・コピーがパーティション別またはデータ・セット別に作成されている場合に DSNUM ALL を 指定すると、表スペース全体のフル・イメージ・コピーが存在しない場合は、表スペース は COPY ペンディング状況になります。データ・セット名の形式は次のとおりです。ここで、 y は I または J、 z は 1 または 2、nnn はデータ・セット 整数です。catname.DSNDBx.dbname.tsname.y000z.AnnnDSNUM n が指定 されている場合、MODIFY RECOVERY は、表スペース全体をリカバリー可能な最も早いポイント の RBA より大きな RBA を持つパーティションの SYSCOPY レコードを 削除しません。このポイントは、フル・イメージ・コピー、LOG YES を用いた LOAD 操作、 あるいは LOG YES を用いた REORG 操作を示していることがあります。
パーティション化 表スペースに対して DSNUM n が指定されている場合、MODIFY RECOVERY は、 そのパーティションと同様に、すべてのパーティション化索引スペースについても、SYSCOPY レコードを 削除し、SYSIBM.SYSINDEXES カタログ表内のバージョン番号を更新します。ただし、非パーティション化索引 については、Db2® はこの 機能を実行しません。
PRO 制限状況にあるパーティションを持つ表スペースに、DSNUM ALL が暗黙的または明示的に指定されている場合、MODIFY RECOVERY は失敗します。 指定するパーティションが PRO 制限状況にある場合、RETAIN 値は LAST(2) に設定されます。
- CLONE
- MODIFY RECOVERY がクローン・オブジェクトについてのみ SYSCOPY レコード と SYSLGRNX レコードを削除することを指示します。CLONE が指定されていない場合、 レコードは基本オブジェクトについてのみ削除されます。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。 LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。
- DELETE
- レコードを削除することを示します。
パーティション統計の削除に関する制約事項については、上記の DSNUM の説明を参照してください。
- AGE integer
- 指定された日数より古いすべての SYSCOPY レコードと SYSLGRNX レコードを
削除します。指定された経過日数による削除基準を満たす SYSLGRNX レコードは、
削除される SYSCOPY レコードがなくても、削除されます。
integer は日数で、可能な範囲は 0 から 32767 です。 当日に作成されたレコードの経過日数は 0 であるため、このオプションでは削除できません。
(*) は、経過日数に関係なく、すべてのレコードを削除します。
- DATE integer
- 指定された日付より前に書き込まれたすべての SYSCOPY レコードと SYSLGRNX レコード
を削除します。指定された日付による削除基準を満たす SYSLGRNX レコードは、
削除される SYSCOPY レコードがなくても、削除されます。
integer は、8 文字または 6 文字の形式が可能です。 年 (yyyy または yy)、月 (mm)、 および日 (dd) を、yyyymmdd ま たは yymmdd の形式で指定する必要があり ます。Db2 は、システム・クロックを検査し、6 文字の日付を最新の日付 (前の 8 文字に相当する日付) に変換します。
(*) は、書き込みが行われた日付に関係なく、すべてのレコードを削除します。
- RETAIN
- レコードを保存することを指示します。より古いレコード
は削除されます。
RETAIN は、 クリーンアップ日付を判別するために、DSNUM で指定された表スペースについて、SYSIBM.SYSCOPY 内の ICTYPE=F (フル・コピー)、 ICBACKUP=ブランク (LOCALSITE 1 次コピー) のレコードのみを検査します。
RETAIN は、 内部的に、完全なタイム・スタンプではなく、日付を使用します。その結果として、RETAIN で指定されるよりも多くのコピーが保存される ことがあります。例えば、同じ日に作成された最新のコピーが 5 個 ある場合、RETAIN LAST (2) が指定されていると、それら 5 個のすべてのコピーが SYSCOPY に残ります。
- LAST (integer)
- SYSIBM.SYSCOPY 内に保存する最新レコードの数を指定します。
- LOGLIMIT
- BSDS を照会して最も古いアーカイブ・ログのタイム・スタンプを判別し、このタイム・スタンプより古いレコードを削除します。データ共用の場合、Db2 は、すべてのデータ共用メンバーの BSDS を 照会して、全体で最も古いログ・タイム・スタンプを判別します。BSDS をメンバーのいずれかが使用できず、対応するメンバーが静止している場合、この BSDS は無視されます。
- GDGLIMIT
- SYSIBM.SYSCOPY 内の最新レコードが世代別データ・セット (GDS) を参照している場合は、世代別データ・グループ (GDG) の限界値を取得します。Db2 は、同じ GDG を参照するレコードを、この GDG 限界値を超えない範囲で、可能な限り多く保持できます。このシチュエーションでは、Db2 は、SYSIBM.SYSCOPY レコードが参照する他の GDG を考慮しません。
他の GDG を参照するこれらのレコードは、削除日に従い削除されます。
- LAST (integer)
- SYSIBM.SYSCOPY 内の最新レコードが非 GDS を参照している場合に SYSIBM.SYSCOPY 内に保存する 最新レコードの数を指定します。
- LOGLIMIT
- SYSIBM.SYSCOPY 内の最新レコードが非 GDS を参照している場合は、BSDS を照会して、最も古いアーカイブ・ログのタイム・スタンプ を判別します。データ共用の場合、Db2 は、 すべてのデータ共用メンバーの BSDS を照会して、全体で最も古いログ・タイム・スタンプを 判別し、そのタイム・スタンプより古いレコードを削除します。BSDS をメンバーのいずれかが使用できず、対応するメンバーが静止している場合、この BSDS は無視されます。
NOCOPYPEND
すべてのイメージ・コピーが SYSIBM.SYSCOPY から削除されたときに、表スペースが COPY ペンディング状況に置かれないことを示します。NOCOPYPEND の指定は、索引に通知 COPY ペンディング (ICOPY) 状況を設定しません。NOCOPYPEND の指定は、MODIFY RECOVERY ユーティリティーが実行される前に設定された COPY ペンディング状況を除去しません。MODIFY ジョブの正常終了は、他にエラーや警告が存在しなければ、コード 0 を返します。注: NOCOPYPEND は、表スペース内のデータが、失われても容易に再作成できる場合にだけ指定してください。MODIFY RECOVERY ユーティリティーの直後にイメージ・コピーを作成しなかった場合は、RECOVER ユーティリティーを使用して表スペースをリカバリーすることができず、データが失われるおそれがあります。
