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

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

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

構文図

>>-REPORT------------------------------------------------------->

                                                            .-INDEX NONE-.                             
>--+-RECOVERY--+-TABLESPACE--+-LIST--listdef-name--------+--+------------+-+--+------------------+-+-><
   |           |             '-| table-space-name-spec |-'  '-INDEX ALL--' |  '-| info options |-' |   
   |           '-| index-list-spec |---------------------------------------'                       |   
   '-TABLESPACESET--+------------+--| table-space-name-spec |--+----------+------------------------'   
                    '-TABLESPACE-'                             '-SHOWDSNS-'                            

構文図を読む
index-list-spec:

>>-+-INDEXSPACE--+-+----------------+-index-space-name-+-+-----><
   |             | '-database-name.-'                  | |   
   |             '-LIST--listdef-name------------------' |   
   '-INDEX--+-+-------------+-index-name-+---------------'   
            | '-creator-id.-'            |                   
            '-LIST--listdef-name---------'                   

info options:

   .-DSNUM--ALL-----.                             
>>-+----------------+--+---------+--+---------+----------------->
   '-DSNUM--integer-'  '-CURRENT-'  '-SUMMARY-'   

                                    .-ARCHLOG--1-------.   
>--+-----------+--+--------------+--+------------------+-------><
   '-LOCALSITE-'  '-RECOVERYSITE-'  '-ARCHLOG--+-2---+-'   
                                               '-ALL-'     

構文図を読む
table-space-name-spec:

>>-+----------------+--table-space-name------------------------><
   '-database-name.-'                     

オプションの説明

RECOVERY
指定された表スペースまたは索引に関するリカバリー情報を報告することを指示します。

LOCALSITE オプションおよび RECOVERSITE オプションを使用することによって、ローカル・サイトまたはリカバリー・サイトのいずれか、あるいはその両方のリカバリー情報を要求できます。 カタログおよびディレクトリーに関するリカバリー情報を要求する場合、アーカイブ・テープが不必要にマウントされないように、CURRENT オプションを指定してください。

推奨事項: DSNUM ALL オプションで作成されるパーティション化表スペースのイメージ・コピー に対しては、REPORT RECOVERY DSNUM ALL を実行してください。REPORT RECOVERY DSNUM ALL CURRENT を実行すると、Db2® は、表スペース全体に対して取られた最後のフル・イメージ・コピーまでさかのぼる履歴情報を追加で報告します。
REPORT RECOVERY が提供する情報については、REPORT 出力を参照してください。
TABLESPACE database-name.table-space-name
REPORT RECOVERY の場合は、報告対象の表スペース (およびオプションで、 それが属しているデータベース) を指定します。
REPORT TABLESPACESET の場合は、表スペース・セット内の表スペース (およびオプションで、 それが属しているデータベース) を指定します。
database-name
オプションで、表スペースが属しているデータベースを指定します。
table-space-name
表スペースを指定します。
LISTlistdef-name

前に定義された LISTDEF リスト名の名前を指定し ます。このユーティリティーでは、REPORT のそれぞれの制御ステートメントごとに、LIST キーワードを 1 つ 使用することができます。 リストに含まれるのは、表スペースのみ です。LIST を TABLESPACE…table-space-name 仕様と一緒に指定しないでください。 リストの内容の妥当性を検査するためには、TABLESPACE キーワードが必要です。 REPORT RECOVERY TABLESPACE は、リストの項目ごとに 1 回、呼び出されます。

SHOWDSNS
各表スペースまたは索引スペースの VSAM データ・セットの名前を TABLESPACESET 報告書に組み込むことを指示します。基本オブジェクトのデータ・セット名は、 TABLESPACE SET REPORT というタイトルのセクションに示されます。クローン・オブジェクト のデータ・セット名は、CLONE TABLESPACE SET REPORT というタイトルのセクションに示されます。 後者の報告は、基本オブジェクトのクローンが作成済みである場合のみ提供されます。
INDEXSPACE database-name.index-space-name
報告の対象にする索引スペースを指定します。
database-name
オプションで、索引スペースが属しているデータベースを指定します。
index-space-name
報告の対象にする索引の索引スペース名を指定します。
LIST listdef-name

前に定義された LISTDEF リスト名の名前を指定し ます。このユーティリティーでは、REPORT のそれぞれの制御ステートメントごとに、LIST キーワードを 1 つ 使用することができます。 リスに含まれているのは、索引スペースのみ です。LIST は、INDEXSPACEindex-space-name 指定とは一緒に指定しないでください。 リスト内容の妥当性を検査するためには、INDEXSPACE キーワードが必要 です。REPORT RECOVERY INDEXSPACE は、リストのそれぞれの項目ごとに 1 回、呼び出されます。

INDEX creator-id.index-name
報告の対象にする索引スペース内の索引を指定します。
creator-id
オプションで、索引の作成者を指定します。
index-name
報告する索引名を指定します。名前にブランクが含まれている場合は、索引名を引用符で囲みます。
LIST listdef-name

前に定義された LISTDEF リスト名の名前を指定し ます。このユーティリティーでは、REPORT のそれぞれの制御ステートメントごとに、LIST キーワードを 1 つ 使用することができます。 リスに含まれているのは、索引スペースのみ です。LIST を INDEX…index-name 仕様と一緒に指定しないでください。 リスト内容の妥当性を検査するためには、INDEX キーワードが必要です。リスト中の各項目ごとに 1 回 REPORT RECOVERY INDEX が 起動されます。

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

以下の REPORT のキーワードはオプションです。

INDEX NONE
指定された表スペースに関連する索引スペースのリカバリー情報を 報告しないことを指定します。
INDEX ALL
指定された表スペースに関連する索引スペースのリカバリー情報を 報告することを指定します。
DSNUM
情報を報告する対象のパーティションまたはデータ・セットを指定します。 あるいは、DSNUM は、表スペース全体または索引スペース全体について、情報を報告することを指定します。
ALL
表スペースまたは索引スペース全体について情報を 報告することを指定します。
整数
情報を報告する対象のパーティションまたはデータ・セットの番号です。最大は 4096 です。

変更の始まりパーティション化表スペースまたはパーティション化索引スペース の場合、整数はその物理パーティション番号です。変更の終わり

非パーティション化表スペースの場合、VSAM カタログにカタログされたデータ・セット名の終わりに ある整数です。データ・セット名の形式は以下のとおりです。

catname.DSNDBx.dbname.tsname.y0001.Annn

このフォーマットの意味は、以下のとおりです。

catname
VSAM カタログ名または別名
x
C または D
dbname
データベース名
tsname
表スペース名
y
I または J
nnn
データ・セット整数
CURRENT
表スペースの最後のリカバリー・ポイントの後に書き込まれた SYSCOPY 項目のみを 報告するように指定します。 最後のリカバリー・ポイントは、最後のフル・イメージ・コピー、LOAD REPLACE LOG YES イメージ・コピー、 または REORG LOG YES イメージ・コピー です。DSNUM ALL が指定されている場合、最後のリカバリー・ポイントは、表スペースまたは 索引スペース全体について作成されたフル・イメージ・コピーです。 CURRENT オプションを指定したのに、最後のリカバリー・ポイントがアクティブ・ログ上 に存在していない場合には、そのポイントが検出されるまで、Db2 はアーカイブ・テープのマウント を求めるプロンプトを出します。

また、CURRENT は、SYSLGRNX 行と最後の増分イメージ・コピー項目の後のアーカイブ・ログ・ボリュームに ついてのみ報告します。 増分イメージ・コピーが作成されなかった場合は、SYSLGRNX 行と最後のリカバリー・ポイント以降 に作成されたアーカイブ・ログ・ボリュームが報告されます。

CURRENT が指定されていない場合、または最後のリカバリー・ポイントが存在しない場合は、 その表スペースまたは索引スペースに関するすべての SYSCOPY 項目および SYSLGRNX 項目が報告され ます。レポートにはアーカイブ・ログに関する項目が含まれています。 CURRENT を指定しない場合、報告書では、最後のリカバリー・ポイント以降の項目にアスタリスク (*) が 付けられます。

SUMMARY
ボリューム通し番号の要約だけを報告するように指定します。 このオプションは以下のボリューム通し番号を報告します。
  • BSDS からのアーカイブ・ログ・データ・セットが存在する場所
  • SYSCOPY からのイメージ・コピー・データ・セットが存在する場所

SUMMARY を指定しない場合は、ボリューム通し番号の要約以外に、リカバリー情報も報告されます。

LOCALSITE
ローカル・サイトのシステムからコピーされたすべての SYSCOPY レコードを報告するように指定します。
RECOVERYSITE
リカバリー・サイトのシステムからコピーされたすべての SYSCOPY レコードを報告するように指定します。
ARCHLOG
報告するアーカイブ・ログ・データ・セットを指定します。
1
アーカイブ・ログ・データ・セット 1 についてのみ報告します。
2
アーカイブ・ログ・データ・セット 2 についてのみ報告します。
ALL
アーカイブ・ログ・データ・セット 1 および 2 の両方について報告します。
TABLESPACESET
表スペース・セット内のすべての表スペースの名前と、 それらの表のすべての索引の名前とを報告するように指定します。

表スペース・セットについて詳しくは、 QUIESCE ユーティリティーの TABLESPACESET オプションについての説明を参照してください。