DSN1LOGP 出力

このユーティリティーの用途の 1 つは、システム問題の判別と修正の手助けをすることです。 Db2® 問題を診断する際、このユーティリティーの出力を解釈するために ライセンス資料を参照しなければならない場合があります。

DSN1LOGP 出力の検討

SUMMARY オプションを用いると、要約報告書、または詳細報告書、あるいはその両方を作成することができます。 また、CHECK(DATA) オプションを使用して、ページ・レグレッション・エラーの要約報告書 および詳細報告書を作成することもできます。

データ共用の場合、 1 つの Db2 データ共用メンバー について、LRSN 値が同じ複数のログ・レコードが存在する場合があります。

要約報告書の説明

下の図に示す要約報告書には、 完了したイベントの要約が含まれています。この報告書は、 完了したそれぞれの作業単位ごとに 1 つずつの項目から構成されています。各項目では、とりわけ、開始時刻、ユーザー、ならびに変更されたすべてのページ・セットが示されています。 可能な場合、報告書には、 オブジェクトが LOGGED なのか NOT LOGGED なのかが示されます。

要約報告書は、2 つの別の部分に分かれています。

  • 最初のセクションでは、先頭に次のメッセージがあります。
    DSN1150I SUMMARY OF COMPLETED EVENTS
  • 2 番目の部分の始めのメッセージは次のとおりです。
    DSN1157I RESTART SUMMARY

最初の部分には、スキャンされたログの範囲内で完了したすべての リカバリー単位 (UR) とチェックポイントのリストが示されています。 各イベントは時刻順にリストされており、UR は完了した順に、チェックポイントはそのチェックポイント の終わりが処理された順にリストされています。 完了した各 UR により変更されたページ・セットがリストされ ます。UR に関連したログ・レコードが利用不能の場合は、その UR については属性 INFO=PARTIAL が 表示されます。 そうでない場合は、UR に INFO=COMPLETE のマークが付けられます。 スキャンされたログの範囲が、与えられた UR のすべてのレコードを入れるほど大きくない 場合は、UR に関連したログ・レコードは利用不能となります。

DISP 属性は、COMMITTED、ABORTED、INFLIGHT、IN-COMMIT、IN-ABORT、 POSTPONED ABORT、または INDOUBT の いずれかです。DISP 属性の COMMITTED および ABORTED は最初の部分で使用されます。 残りの属性は、2 番目の部分で使用されます。

2 番目の部分のリストでは、再始動時に Db2 に必要な作業を、指定したログに 記録されたとおりに示しています。 ログが使用可能な場合は、使用されるチェックポイントが示されています。 同様に、それぞれの未解決の UR が、それが変更したページ・セットと一緒に示されています。 書き込みペンディングのそれぞれのページ・セットも、書き込みの完了に必要な初期のログ・レコードの場合と同様に、 示されています。UR に関連したログ・レコードが利用不能の場合は、属性 INFO=PARTIAL が表示され、その UR については 変更されたページ・セットの識別は未完了となります。

図 1. DSN1LOGP 要約報告書のサンプル
変更の始まり
DSN1212I DSN1LGRD FIRST LOG LRSN ENCOUNTERED 00CA21F57927B1D48000                     
                                                                                      
================================================================================      
DSN1150I SUMMARY OF COMPLETED EVENTS                                                  
                                                                                      
DSN1151I DSN1LPRT MEMBER=DB2A     UR  CONNID=DB2A      CORRID=021.OPNLGR00  AUTHID=SYSOPR    PLAN=SYSTEM
             START DATE=00.161 TIME=11:27:30  DISP=COMMITTED           INFO=COMPLETE  
             STARTRBA=0000000000002BB36475   ENDRBA=0000000000002BB37024              
             STARTLRSN=00CA21F57945B9AE2000  ENDLRSN=00CA21F57953A83EC000             
             NID=* LUWID=DSNCAT.SYEC1DB2.CA21F5792E8A.0001                            
             COORDINATOR=* PARTICIPANTS=*                                             
             DATA MODIFIED:                                                           
                  DATABASE=0001=DSNDB01   PAGE SET=00CF=SYSLGRNX                      
                  DATABASE=0001=DSNDB01   PAGE SET=0087=DSNLLX01                      
                  DATABASE=0001=DSNDB01   PAGE SET=0086=DSNLLX02  

DSN1151I DSN1LPRT MEMBER=DB2A     UR  CONNID=DB2A      CORRID=021.OPNLGR00  AUTHID=SYSOPR    PLAN=SYSTEM
             START DATE=00.161 TIME=11:27:30  DISP=COMMITTED           INFO=COMPLETE  
             STARTRBA=0000000000002BB374EF   ENDRBA=0000000000002BB37C81              
             STARTLRSN=00CA21F57956411DE000  ENDLRSN=00CA21F5795841E68000             
             NID=* LUWID=DSNCAT.SYEC1DB2.CA21F5795571.0001                            
             COORDINATOR=* PARTICIPANTS=*                                             
             DATA MODIFIED:                                                           
                  DATABASE=0001=DSNDB01   PAGE SET=00CF=SYSLGRNX                      
                  DATABASE=0001=DSNDB01   PAGE SET=0087=DSNLLX01                      
                  DATABASE=0001=DSNDB01   PAGE SET=0086=DSNLLX02                      

....
DSN1213I DSN1LGRD LAST LOG  RBA ENCOUNTERED 0000000000002BBC97A6

DSN1213I DSN1LGRD LAST LOG LRSN ENCOUNTERED 00CA21F5849F250A8000

DSN1224I SPECIFIED LOG LRSNEND 00CA21F586A6D2000000 COULD NOT BE LOCATED FOR MEMBER DB2A  

DSN1214I NUMBER OF LOG RECORDS READ 0000000000002571 

================================================================================
DSN1157I RESTART SUMMARY
 
DSN1153I DSN1LSIT CHECKPOINT  MEMBER=DB2A                                    
               STARTRBA=0000000000002BBB8CAC  ENDRBA=0000000000002BBC59E8    
               STARTLRSN=00CA21F58479D042C000  ENDLRSN=00CA21F58480E67E4000  
               DATE=12.250  TIME=14:20:29                                    
                                                                             
DSN1162I DSN1LPRT  MEMBER=DB2A     UR  CONNID=BATCH     CORRID=ARCHIVE       AUTHID=SYSADM    PLAN=ARCHIVE
             START DATE=00.161 TIME=11:27:30  DISP=INFLIGHT            INFO=COMPLETE 
             STARTRBA=0000000000002BBC888E  STARTLRSN=00CA21F5849D6B88E000  NID=*    
              LUWID=DSNCAT.SYEC1DB2.CA21F58084CF.0003  COORDINATOR=*                 
              PARTICIPANTS=*                                                         
             DATA MODIFIED:                                                          
                  DATABASE=0119=JACKDB    PAGE SET=0002=JACKTS                       
                  DATABASE=0119=JACKDB    PAGE SET=0005=TESTIX                       

DSN1160I DATABASE WRITES PENDING:                                                    
                  DATABASE=0001=DSNDB01    PAGE SET=0008=DSNDB01X   START=0000000000002BB8BC60
                  DATABASE=0001=DSNDB01    PAGE SET=001F=DBD01      START=0000000000002BB8BED8
                  DATABASE=0006=DSNDB06    PAGE SET=006C=DSNADX01   START=0000000000002BB8EE55
                  DATABASE=0006=DSNDB06    PAGE SET=0787=DSNADH02   START=0000000000002BB8E858
                  DATABASE=0006=DSNDB06    PAGE SET=0076=DSNUCX01   
....
変更の終わり

詳細報告書の説明

下の図に示す詳細報告書には、 以下のレコードが含まれています。

  • 再実行と取り消しのログ・レコード
  • システム・イベント・ログ・レコード。 開始および終了チェックポイント・レコード、開始現行状況再ビルド・レコード、開始順方向 および逆方向リカバリー・レコードが含まれます。
  • ページ・セット制御ログ・レコード。 ページ・セットのオープンおよびクローズのログ・レコード、 データ・セットのオープンおよびクローズのログ・レコード、 セット書き込み、リセット書き込み、およびページ・セット書き込みログ・レコードが含まれます。
  • 完了または未完了のリカバリー単位の UR 制御ログ・レコード。

DSN1LOGP ユーティリティー制御ステートメントに オプションのキーワードを 1 つ以上指定することによって、明細ログ・レコードの量を削減することができます。

図 2. DSN1LOGP 詳細報告書の例
変更の始まり
00000000000023C9EAF6  MEMBER(DB2A    )  TYPE( DBE TABLE CHECKPOINT - DBGC READ)
              LRSN(00C9C1231139FA000000)  DBID(002B)  OBID(0000)     
              SUBTYPE(DBE TABLE WITH EXCEPTION DATA) 

     *LRH* 007A007A 4100001D 0E800000 00000000 000023C9 EA7C0826 000023C9 EA7CC9C1 
           231139FA 0001 
      0000 00000054 03100000 00000000 00000000 00000000 00000000 00000000 0EC7C4C2 
      0020 C5E3002B 00000000 00000000 00000000 C7000000 00C9B6DE A8263200 00000000 
      0040 00000000 00000000 00000000 002B0000 00C80000 

     HASH RECORD - CHAIN:   43,        LRSN: 00C9B6DEA82632000000 

00000000000023C9EB70 MEMBER(DB2A     ) TYPE( DBE TABLE CHECKPOINT - DBGC READ) 
              LRSN(00C9C1231139FB000000) DBID(002C) OBID(0000)       
              SUBTYPE(DBE TABLE WITH EXCEPTION DATA) 
     *LRH* 007A007A 4100001D 0E800000 00000000 000023C9 EAF60826 000023C9 EAF6C9C1 
           231139FB 0001 
      0000 00000054 03100000 00000000 00000000 00000000 00000000 00000000 0EC7C4C2 
      0020 C5E3002C 00000000 00000000 00000000 C7000000 00C9B6DE A8268A00 00000000 
      0040 00000000 00000000 00000000 002C0000 00C80000 

     HASH RECORD - CHAIN: 44,          LRSN: 00C9B6DEA8268A000000 
0000000000023C9EBEA MEMBER(DB2A      ) TYPE( DBE TABLE CHECKPOINT - DBGC READ) 
              LRSN(00C9C1231139FC000000) DBID(002D) OBID(0000)       
              SUBTYPE(DBE TABLE WITH EXCEPTION DATA) 
     *LRH* 007A007A 4100001D 0E800000 00000000 000023C9 EB700826 000023C9 EB70C9C1 
           231139FC 0001 
      0000 00000054 03100000 00000000 00000000 00000000 00000000 00000000 0EC7C4C2 
      0020 C5E3002D 00000000 00000000 00000000 C7000000 00C9B6DE A826BC00 00000000 
      
      0040 00000000 00000000 00000000 002D0000 00C80000
変更の終わり

要約報告書のデータ伝搬情報の説明

下の図の出力例は、 DSN1LOGP 要約報告書に含まれる情報のうち、DATA CAPTURE CHANGES で定義された Db2 表に 対する変更のログ・レコードに関する情報を示しています。

各フィールドには、以下のことが示されています。

  • START RBA および END RBA は、取り出されなかったリカバリー単位について収集された、 最初と最後の RBA を示しています。 開始 RBA および終了 RBA がカバーする範囲には、リカバリー単位の有効範囲内の 1 つまたは全部 の SQL ステートメントを含めることができます。
  • TABLE LIST OVERFLOW は、10 を超える別々のデータ収集表 ID がこのリカバリー単位によって 更新されたかどうかを示しています。 この例では、オーバーフローは起こらなかったことが示されています。
  • LR WRITTEN は、書き込まれたログ・レコード数を示しています。 これらのレコードは、データ収集のために定義され、かつ DB2CDCEX ルーチンで使用可能であった 表に対する変更を表していたものです。DB2CDCEX からの再帰的 SQL 変更および DB2CDCEX に関連しない 他の接続からの変更は含まれません。受け取った値が 2147483647 であった場合は、 オーバーフローが発生したためにカウントが 無効になっています。
  • LR RETRIEVED は、DB2CDCEX によって取り出された、収集された RBA の数です。 受け取った値が 2147483647 であった場合は、 オーバーフローが発生したためにカウントが 無効になっています。
  • LR NOT RETRIEVED は、書き込まれたログ・レコード数 (LR WRITTEN) と 取り出されたログ・レコード数 (LR RETRIEVED) との差です。 次の出力例では、4 つのログ・レコードが書き込まれたこと、および取り出されたログ・レコードは なかったことが示されています。
図 3. 要約報告書のデータ伝搬情報の例
DATA PROPAGATION INFORMATION:
     START RBA=000004A107F4       END RBA=000004A10A5C           TABLE LIST OVERFLOW=NO
     LR WRITTEN=0000000000000004  LR RETRIEVED=0000000000000000  LR NOT RETRIEVED=0000000000000004
     DATABASE=0112=DBCS1701       PAGESET=0002=TSCS1701          TABLE OBID=0005

ページ・レグレッション・エラーについての報告書の説明

CHECK(DATA) オプションを指定した場合、DSN1LOGP は、ページ・レグレッション・エラーを報告し ます。SUMMARY オプションの値によって、ユーティリティーが詳細報告書または要約報告書、あるいは その両方を作成するかどうかが決まります。

詳細報告書には、それぞれのページ・レグレッション・エラーごとに、以下の情報が含まれています。

  • DBID
  • OBID
  • ページ番号
  • 現行 RBA または LRSN
  • メンバー名
  • 前のレベル
  • 前の更新
  • 日付
  • 時刻

要約報告書には、ページ・レグレッション・エラーが検出されたそれぞれの表スペースごとに、以下の情報のほか、 ユーティリティーが検出したページ・レグレッションの総数が含まれています。

  • データベース名
  • 表スペース名
  • DBID
  • OBID

ページ・レグレッション・エラーが検出されなかった場合は、DSN1LOGP は、ページ・レグレッション・エラーは検出されなかった という単一のメッセージを出力します。

下の図の出力例は、ページ・レグレッション・エラーが検出された場合の詳細報告書を示しています。

Page regression detected:                                        
DBID(0001) OBID(001F) PAGE(00000003)                             
Current LRSN                           = C93AA29FC3D1            
Previous level from current log record = C93AA290845E            
Previous update to data page found on log = C93AA29FC3D0         
                                                                 
Page regression detected:                                        
DBID(0001) OBID(001F) PAGE(00000002)                             
Current LRSN                           = C93AA2E1EDEA            
Previous level from current log record = C93AA2D380F7            
Previous update to data page found on log = C93AA2E1EDE9         
                                                                 
Page regression detected:                                        
DBID(0001) OBID(001F) PAGE(00000002)                             
Current LRSN                           = C93BBD7CD15E            
Previous level from current log record = C93BBD7CCA7C            
Previous update to data page found on log = C93BBD7CD15B    

DSN1LOGP 出力の中のコマンド・テキスト

コマンド・テキストは自動的にログに記録されます。 TYPE(0010) を使って DSN1LOGP を実行すると、コマンドについてのレコードが出力に含まれます。 コマンド・レコード出力のタイプは TYPE(SYSTEM EVENT) および SUBTYPE(TRACE RECORD) です。 データは IFCID 0090 トレース・レコード形式になります。 例えば、DSN1LOGP からの以下の出力には -STOP DB2 コマンドが示されています。

00006BFBE999  LRSN(C6CD403EB3AF)  TYPE(SYSTEM EVENT)                     
              SUBTYPE(TRACE RECORD)                                      
                                                                         
*LRH* 01400034 00100041 10800000 00000000 00000000 00000726 00000000 00000000 0000C6CD  *                              F
      403EB3AF 0000                                                                     *                    
0000  011A0000 00000028 00F20001 00000014 00130001 000B60E2 E3D6D740 E3D6D740 C4C2F216  *         2            -STOP DB2
0020  81AB2000 00000040 00560117 005A02A1 16180930 C4E2D5C1 C6CD403E C6CD403E B392DDEE  *a            !      DSNAF    k
0040  00000006 00000006 00000000 E2E3D3C5 C3F14040 40404040 40404040 40404040 C4E2D5C1  *            STLEC1          DSNA
0060  40404040 E2E8C5C3 F1C4C2F2 C6CD403E B3770001 00000000 0000F3F0 0000F3F0 F9F0009C  *    SYEC1DB2F             3090
0080  0200E2E8 E2D6D7D9 4040F0F2 F34BC7C3 E2C3D5F6 F0F2E5C1 F1C14040 F1C14040 40404040  *  SYSOPR  023.GCSCN602VA1A
00A0  40404040 4040E2E8 E2D6D7D9 40400000 00000000 00000000 00000000 00000000 00000000  *      SYSOPR        
00C0  00000000 00000000 00004040 40404040 40404040 40404040 40404040 40404040 40404040  *                    
00E0  40404040 40404040 40404040 40404040 40404040 40404040 40404040 40404040 40404040  *                    
0100  40404040 40404040 40404040 00000000 00000000 00000000 0000

エラー・コードの解釈

エラーが発生すると、DSN1LOGP は SYSPRINT 出力に Db2 スタンドアロン・ログ・サービスからの 理由コードをフォーマット設定します。

DSN1LOGP は、 ユーザー異常終了コード X'099' で異常終了する場合があります。 DSN1LOGP は、対応する異常終了理由コードを、レジスター 15 で見つけます (エラー時)。 指定された RBA または LRSN 範囲が入力データ・セット内に 見つからなかった場合、DSN1LOGP は戻りコード 4 で終了します。