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 属性のある表スペースは静止されません。