QUIESCE 制御ステートメントの構文とオプション

QUIESCE ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。

制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。

構文図

>>-QUIESCE------------------------------------------------------>

>--+-LIST--listdef-name-------------------------------------------------------+-->
   | .----------------------------------------------------------------------. |   
   | V                                                                      | |   
   '---+-TABLESPACE-+----------------+-table-space-name-+---------------+-+-+-'   
       |            '-database-name.-'                  '-PART--integer-' |       
       '-TABLESPACESET-+------------+-+----------------+-table-space-name-'       
                       '-TABLESPACE-' '-database-name.-'                          

              .-WRITE--YES-.   
>--+-------+--+------------+-----------------------------------><
   '-CLONE-'  '-WRITE--NO--'   

オプションの説明

QUIESCE 制御ステートメントの大部分のオプションの目的は、静止するオブジェクトを指定することです。バッチ・アドレス・スペースおよび Db2® DBM1 アドレス・スペース での使用可能メモリーによって許容されるだけの数のオブジェクトを QUIESCE ジョブに指定できます。1 つの表スペースを複数回指定すると、ユーティリティー処理は続行し、その表スペースは一度だけ静止されます。QUIESCE は、戻りコード 4 および 警告メッセージ DSNU533I を出して、その重複について警告します。

以下のオプションを使用して、静止するオブジェクトを指定します。

LIST listdef-name
前に定義された、表スペースのみを含む LISTDEF リスト名の名前を指定し ます。このユーティリティーでは、それぞれの QUIESCE 制御ステートメントごとに LIST キーワード を 1 つ使用することができます。LIST は、TABLESPACE または TABLESPACESET キーワードとは一緒に指定しないでください。QUIESCE は、リスト全体に対して、一度呼び出され ます。QUIESCE ユーティリティーでは、関連する索引スペースは、OPTIONS ITEMERROR 処理の ためのリスト項目であると見なされます。OPTIONS ITEMERROR ステートメントを使用して、関連する索引処理時 に、このユーティリティーの動きを変更できます。このユーティリティーは、CLONE キーワードが指定されている場合のみクローン・データを処理します。LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。

パーティションまたは パーティション範囲をリストに指定できます。

TABLESPACE database-name.table-space-name
QUIESCE TABLESPACE の場合は、静止する表スペースを指定します。
QUIESCE TABLESPACESET の場合は、静止する表スペース・セット内の表スペースを 指定します。QUIESCE TABLESPACESET の場合、TABLESPACE キーワードはオプションです。
database-name
オプションで、表スペースが属しているデータベースの名前を指定します。

デフォルト値は、DSNDB04 です。

table-space-name

変更の始まり静止する表スペースの名前を指定し ます。DSNDB01.SYSUTILX を指定することはできますが、静止する他の表スペースを持つ リストにその名前を組み込まないでください。 ポイント・イン・タイム・リカバリーがカタログおよびディレクトリーで予定されている場合 は、他のすべてのカタログおよびディレクトリー表スペースの後で、DSNDB06.SYSTSCPY を単独で 静止させる必要があります。変更の終わり

システム期間テンポラル表または履歴表スペースのいずれかに対する QUIESCE が実行されると、バージョン管理関係に関係するすべての表スペースが静止されます。システム期間テンポラル表スペースおよび履歴表スペースの両方の補助 LOB 表スペースおよび XML 表スペースが含まれます。

PART integer
静止するパーティションを示します。

変更の始まりinteger は物理パーティション番号です。1 から、表スペースに定義されたパーティション数までの範囲でなければなりません。 最大は 4096 です。変更の終わり

1 つのリスト中に同じ表スペースを 2 回指定し、一方の指定では PART n を使用し、もう一方の指定では PART m を使用すると、各パーティションがそれぞれ一度ずつ静止します。

TABLESPACESET
表スペース・セット内の参照関連のあるすべての表スペースを 静止することを指定します。QUIESCE ユーティリティーの目的に合った表スペース・セットには、次のオブジェクトのセットが含まれます。
  • 参照制約によって関連している表スペースのグループ
  • 1 つの基本表スペースとそのすべての LOB 表スペース
  • 1 つの基本表スペースとそのすべての XML 表スペース
  • システム期間テンポラル表を含む表スペースと、関連する履歴表を含む表スペース
  • 変更の始まりアーカイブ対応表を含む表スペースと、関連するアーカイブ表を含む表スペース変更の終わり

指定した各表スペース・セットは、関連したこれらの表スペースのリストに展開されます。

CLONE
指定されたクローン表スペースについてのみ QUIESCE が静止ポイントを作成することを 指定します。このユーティリティーは、CLONE キーワードが指定されている場合のみクローン・データを処理します。LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。

次のオプションを使用して、QUIESCE の動作を制御します。

WRITE
表スペースまたは索引スペースから変更ページをディスクに 書き込むかどうかを指定します。
YES
静止ポイントを設定し、表スペースまたは索引スペースから変更ページを ディスクに書き込みます。
NO
静止ポイントを設定しますが、表スペースまたは索引スペースから変更ページを ディスクに書き込みません。

NOT LOGGED 属性のある表スペースは静止されません。