DSN1LOGP
DSN1LOGP スタンドアロン・ユーティリティーは、リカバリー・ログの内容を表示用にフォーマット設定します。
リカバリー・ログ報告書には、以下の 2 つの形式があります。
- 個々のログ・レコードの詳細報告書。この情報は、IBM® ソフトウェア・サポート 担当者がログを詳細に分析するときに役立ちます (ここでは、詳細報告書の詳しい説明 は行いません)。
- 要約報告書。これは、次のような場合に役立ちます。
- 条件付き再始動を実行する。
- リモート・サイトとの未確定スレッドを解決する。
- データ伝搬に伴う問題を検出する。
処理するログの範囲 およびその範囲内での選択基準を指定して、詳細報告書内のレコードを限定することができます。例えば、次のような指定を行うことができます。
- URID によって示される 1 つ以上のリカバリー単位
- 単一データベース
URID およびデータベースを指定することにより、1 つのデータベースの使用に 対応するリカバリー・ログ・レコードを 1 つのリカバリー単位で表示することができます。
DSN1LOGP は、 基本表オブジェクトとクローン表オブジェクトの両方について、ログ・レコードを印刷できます。
DSN1LOGP は、DFSMS により圧縮されたログを読み取ることはできません。(この圧縮には、拡張フォーマットのデータ・セットを必要とします。)
環境
DSN1LOGP はバッチ z/OS® ジョブとして実行します。
Db2® が 稼働している間は、DSN1LOGP をアーカイブ・データ・セットに対して実行することはできますが、 アクティブ・データ・セットに対しては実行できません。
出力
すべてのマイグレーション・モードで、フォーマット設定された RBA 値および LRSN 値が 10 バイト・フォーマットで表示されます。
この 10 バイトの定様式表示は、カタログまたはディレクトリーのマイグレーション、個々のオブジェクトの EXTENDED フォーマットへの変換、あるいは BSDS 変換には関連していません。
RBA 値または LRSN 値を含んでいる可能性があるダンプ・フォーマット・データは、値が保存されたときのフォーマットで表示される場合には、RBA または LRSN を 6 バイト・フォーマットで表示することがあります。
表示のフォーマットは、ユーティリティー実行時の実際のデータを表し、変換なしで表示されます。
この 10 バイト・フォーマットは、リカバリーを目的とする場合、Db2 で推奨される入力フォーマットです。
10 バイトの RBA 値または LRSN 値が Db2 への入力値として指定される場合、必要に応じて 6 バイト・フォーマットへの変換が内部的に実行されます。
すべてのデータ共有メンバーで BSDS が Db2 11 フォーマットに変換される前、またはカタログおよびディレクトリーがマイグレーションされる前であっても、下位 3 バイトが非ゼロ数字の 10 バイトの LRSN 値が表示される可能性があります。
BSDS の変換前にキャプチャーされた LRSN 値は、表示不可になるまで (例えば、MODIFY RECOVERY によって削除されるまで) 引き続き保存された状態のままで表示されます。
この動作は、LRSN 値が Db2 で生成され、保管され、処理される多数の方法を前提とすると、正常であり予期されたとおりです。
これらの LRSN 値が Db2 への入力値として指定される場合、それらを示されているとおりに指定します。
LRSN 値の下位 3 バイトに非ゼロ数字が含まれている場合、それらを削除しないでください。
必要と見なされるすべての変換は、Db2 内部で実行されます。
必要な許可
DSN1LOGP は許可を 必要としません。ただし、RACF 保護されているデータ・セットがある場合は、 ジョブの許可 ID は RACF® 権限を持っている必要があります。
必要なデータ・セット
DSN1LOGP を実行するときには、以下のデータ定義 (DD) ステートメントを指定してください。
- SYSPRINT
- DSN1LOGP は、すべてのエラー・メッセージ、例外条件、および 詳細報告書を SYSPRINT ファイルに書き込みます。論理レコード長 (LRECL) は 131 です。
- SYSIN
- DSN1LOGP はこのファイルの中にキーワードを指定します。LRECL は 80 でなければなりません。 キーワードと値は、文字 1 ~ 72 までに存在している必要があります。DSN1LOGP では 、1 つのジョブに対して制御ステートメントを 50 まで指定できます。DSN1LOGP はすべてのレコードを単一のストリングに連結します。
- SYSSUMRY
- DSN1LOGP は、フォーマットされた要約報告書の出力を SYSSUMRY ファイルに書き込み ます。LRECL は 131 です。
DSN1LOGP は、スタンドアロン・ログ・サービスで説明されている DD ステートメントによって、 リカバリー・ログを識別します。
ログ・データ・セットの識別
以下の DD ステートメントの少なくとも 1 つを組み込むことによって、DSN1LOGP に対して、 処理すべきログ・データ・セットを示す必要があります。
- BSDS
- BSDS は、Db2 サブシステムに存在する、すべてのアクティブ・ログ・データ・セットおよびアーカイブ・ログ・データ・セットに関する情報を識別して提供します。 DSN1LOGP に対して BSDS を示す場合は、表示するリカバリー・ログの範囲の開始と終了の RBA を 与える必要があります。そうすると、DSN1LOGP は、開始 RBA 仕様と終了 RBA 仕様を、該当するデータ・セット名に関連付けます。
- ACTIVEn
- BSDS が使用不可であり、関与するアクティブ・ログ・データ・セットがコピーされてユーザーに送信された場合は、ACTIVE DD ステートメントを使用します。
1 つ以上の ACTIVE DD ステートメントを使用して、DSN1LOGP が処理するアクティブ・ログ・データ・セットの集合を指定します。
アクティブ・ログをコピーするのにアクセス方式サービスの REPRO コマンドを使用した場合
は、ARCHIVE DD ステートメントにこのデータ・セットを指定する必要があります。
組み込む各 DD ステートメントが、それぞれ別のアクティブ・ログ・データ・セットを指定します。複数の アクティブ・ログ・データ・セットを指定する場合は、 ログ RBA の昇順に、ACTIVEn DD ステートメントをリストする必要があります。例えば、ACTIVE1 は ACTIVE2 より 小さいログの部分を指定し、ACTIVE2 は ACTIVE3 より小さいログの部分を指定していなければなりません。 これらの DD ステートメントを正しく指定しないと、DSN1LOGP が検出できないエラーが起こることがあります。 これらのアクティブ・ログ・データ・セットは、16 個まで指定できます。
アクティブ・ログ・データ・セットを指定するときには、(BSDS を指定する場合のように) RBASTART および RBAEND キーワードを使用する必要はありません。DSN1LOGP は、データ・セットが正しいログ RBA 順に並んでいる場合に限り、ジョブが示す アクティブ・ログ・データ・セットをすべてスキャンします。
- ARCHIVE
- BSDS が使用できない場合は (前記の ACTIVEn で説明しているよう
に)、1 つの ARCHIVE DD ステートメントに 1 つ以上の DD ステートメントを連結して、
処理対象にするアーカイブ・ログ・データ・セットを指定することができます。
組み込む各 DD ステートメントが、それぞれ別のアーカイブ・ログ・データ・セットを指定します。複数の アーカイブ・ログ・データ・セットを指定する場合は、複数のアーカイブ・ログ・データ・セットに 対応する DD ステートメントを、ログ RBA の昇順にリストする必要があります。 この指定が正しくない場合は、DSN1LOGP が検出できないエラーが起こることがあります。
アーカイブ・ログ・データ・セットを指定するときには、RBASTART および RBAEND キーワード を使用する必要はありません。DSN1LOGP は、データ・セットが正しいログ RBA 順に並んでいる場合に限り、ジョブが示す アーカイブ・ログ・データ・セットをすべてスキャンします。
データ共用の要件
複数の Db2 サブシステム からログ・レコードを選択する場合、ログ・データ・セットを指定するために、以下の DD ステートメントのうちの 1 つまたは すべてを使用する必要があります。
- GROUP
- MxxBSDS
- MxxARCHV
- MxxACTn
ログ・データ・セットを指定するのに GROUP または MxxBSDS を使用する 場合は、LRSNSTART を使用して選択範囲を定義する必要があります。