DSN1LOGP 制御ステートメントのサンプル

以下の制御ステートメントのサンプルを、独自の DSN1LOGP 制御ステートメントを作成するためのモデルとして使用できます。

例 1: 使用可能な BSDS がある場合に、リカバリー・ログから情報を 抽出する

変更の始まり次の例では、使用可能な BSDS がある場合に、情報をリカバリー・ログから取り出す方法が示されています。抽出はログ RBA の X'00000FC000000000A000' から始まり、ログ RBA の X'00000FC000000000B000' で終わり ます。DSN1LOGP ユーティリティーは、 X'10A' (10 進 266) の DBID と X'1F' (10 進 31) の OBID によって、表または索引スペースを識別します。変更の終わり

変更の始まり
//STEP1 EXEC PGM=DSN1LOGP
//STEPLIB  DD DSN=PDS containing DSN1LOGP
//SYSPRINT DD SYSOUT=A
//SYSABEND DD SYSOUT=A
//BSDS     DD DSN=DSNCAT.BSDS01,DISP=SHR
//SYSIN    DD *
  RBASTART (00000FC000000000A000) 
  RBAEND   (00000FC000000000B000)
  DBID (10A) OBID(1F)
/*
変更の終わり

Db2® リカバリー・ログは、大きい順次ファイルと見なすことができます。 リカバリー・ログ・レコードが書き込まれるときは、常にログの終わりまで書き込まれます。 ログ RBA は、ログ上のバイトのアドレスです。リカバリー・ログは、単一のデータ・セットよりも大きい ため、物理的には多数のデータ・セットの中に保管されています。Db2 は、RBA 範囲と それに対応するデータ・セットを BSDS に記録します。ある特定の RBA がどのデータ・セットに 含まれているのかを判別する方法については、DSNJU004 ユーティリティーの説明を参照してください。通常の Db2 の操作中に、ログ RBA に関する情報を含んだメッセージが出されます。

例 2: BSDS が使用不可の場合に、アクティブ・ログから 情報を抽出する

この例は、BSDS が使用できないときのアクティブ・ログからの情報を取り出す方法を示しています。 この抽出には、X'10A' の DBID と X'1F' の OBID によって識別される表スペースまたは索引スペース に適用されるログ・レコードが含まれます。抽出される情報は、PAGE オプションで指定されたページ番号 X'3B' と X'8C' に関連する情報 だけです。DSN1LOGP の検索には指定された ACTIVEn DD ステートメントが すべて含まれるため、ACTIVEn または ARCHIVE DD ステートメント の開始と終了の RBA 値は省略することができ ます。ACTIVE1、ACTIVE2、および ACTIVE3 DD ステートメントは、ログ RBA 範囲の 昇順でログ・データ・セットを指定します。DSNJU004 ユーティリティーを使用して 、アクティブ・ログ・データ・セットごとのログ RBA 範囲 を判別します。BSDS を使用できず、データ・セットの昇順ログ RBA 順序を判別できない場合には、それぞれのログ・データ・セットを個別に実行する必要があります。

//STEP1 EXEC PGM=DSN1LOGP
//STEPLIB  DD DSN=PDS containing DSN1LOGP
//SYSPRINT DD SYSOUT=A
//SYSABEND DD SYSOUT=A
//ACTIVE1  DD DSN=DSNCAT.LOGCOPY1.DS02,DISP=SHR      RBA X'A000' - X'BFFF'
//ACTIVE2  DD DSN=DSNCAT.LOGCOPY1.DS03,DISP=SHR      RBA X'C000' - X'EFFF'
//ACTIVE3  DD DSN=DSNCAT.LOGCOPY1.DS01,DISP=SHR      RBA X'F000' - X'12FFF'
//SYSIN    DD *
  DBID (10A) OBID(1F) PAGE(3B) PAGE(8C)
/*

例 3: BSDS が使用不可の場合に、アーカイブ・ログから 情報を抽出する

次の図の例は、BSDS が使用できないときにアーカイブ・ログから情報を取り出す方法を 示しています。この抽出には、1 つのリカバリー単位 (URID は X'61F321') に適用されるログ・レコードが含まれます。 BEGIN UR はこのリカバリー単位の最初のレコードであり、X'61F321' にあるため、 開始 RBA が指定されて、それがリカバリー・ログ・レコードの抽出元にする範囲内の開始 RBA で あることが指示されています。 また、終了 RBA 値は指定されていないため、該当するログ・レコードを求めて、 指定されたアーカイブ・ログがすべてスキャンされ ます。DBID(4) の指定によって、スキャンの対象は、 DBID が X'4' のデータベース内にあるすべての表スペースおよび索引スペースに、 指定されたリカバリー単位が加えた変更に限定されます。

図 1. RBASTART および URID オプションを用いた DSN1LOGP ステートメントの例
//STEP1 EXEC PGM=DSN1LOGP
//STEPLIB  DD DSN=PDS containing DSN1LOGP
//SYSPRINT DD SYSOUT=A
//SYSABEND DD SYSOUT=A
//ARCHIVE  DD DSN=DSNCAT.ARCHLOG1.A0000037,UNIT=TAPE,VOL=SER=T10067,
//            DISP=(OLD,KEEP),LABEL=(2,SL)
//         DD DSN=DSNCAT.ARCHLOG1.A0000039,UNIT=TAPE,VOL=SER=T30897,
//            DISP=(OLD,KEEP),LABEL=(2,SL)
//         DD DSN=DSNCAT.ARCHLOG1.A0000041,UNIT=TAPE,VOL=SER=T06573,
//            DISP=(OLD,KEEP),LABEL=(2,SL)
//SYSIN    DD *
  RBASTART (61F321)
  URID (61F321) DBID(4)
/*

例 4: SUMMARY オプションを指定して DSN1LOGP を使用する

DSN1LOGP SUMMARY オプションにより、リカバリー・ログをスキャンして、再始動時に未完了の作業を 判別することができます。 このオプションは、単独で、もしくは DSN1LOGP を使用してログ・データの詳細報告書を作成するときに、 指定することができます。 要約ログの結果は SYSSUMRY に現れます。したがって、DSN1LOGP の実行に使用する JCL の一部とし て SYSSUMRY DD ステートメントを組み込む必要があります。

次の例では、BSDS を使用してログ・データ・セットを識別して、要約報告書および詳細報告書の両方が生成されます。 要約報告書は、RBASTART と RBAEND 指定内のすべてのリカバリー・ログ情報を要約し ます。URID または LUWID を指定した FILTER オプションを使用する場合を除き、他のオプションを使って要約報告書の出力を制限することはできません。 RBASTART と RBAEND 指定の使用は、BSDS を使用するかどうかに依存します。

この例は、BSDS が使用可能な場合のリカバリー・ログからの情報の抽出方法を示しているという点で、 例 1 に似ています。 ただし、この例では、X'AF000' のログ RBA と X'B3000' のログ RBA との間のログに記録されたすべての 情報の要約報告書の指定方法も示しています。 この要約は、詳細報告書と一緒に生成されますが、SYSSUMRY への印刷は別個に行われます。

//STEP1 EXEC PGM=DSN1LOGP
//STEPLIB  DD DSN=PDS containing DSN1LOGP
//SYSPRINT DD SYSOUT=A
//SYSSUMRY DD SYSOUT=A
//SYSABEND DD SYSOUT=A
//BSDS     DD DSN=DSNCAT.BSDS01,DISP=SHR
//SYSIN    DD *
  RBASTART (AF000) RBAEND (B3000)
  DBID (10A) OBID(1F) SUMMARY(YES)
/*

例 5: 1 つのデータ共用グループのすべてのメンバーに対して DSN1LOGP を使用する

次の例は、 DBID X'112' と OBID X'1D' によって 識別される表スペースに関連するログ情報を、1 つのデータ共用グループのすべてのメンバーから抽出する 方法を示しています。

変更の始まり
//STEP1 EXEC PGM=DSN1LOGP
//STEPLIB DD  DSN=PDS containing DSN1LOGP
//SYSPRINT SYSOUT=A
//SYSABEND SYSOUT=A
//GROUP DD DSN=DSNDB0G.BSDS01,DISP=SHR
//SYSIN DD *
  DATAONLY (YES)
  LRSNSTART (00CA21F57927B1D48000) 
  LRSNEND   (00CA21F57927B2BBB000)  
  DBID (112) OBID(1D)
/*
変更の終わり

例 6: データ共用グループの単一メンバーに対して DSN1LOGP を 使用する

次の例は、 DBID X'112' と OBID X'1D' によって 識別される表スペースに関連するログ情報を、1 つのデータ共用グループの単一のメンバーから抽出する 方法を示しています。

//STEP1 EXEC PGM=DSN1LOGP
//STEPLIB DD  DSN=PDS containing DSN1LOGP
//SYSPRINT SYSOUT=A
//SYSABEND SYSOUT=A
//M01BSDS DD DSN=DSNDB0G.DB1G.BSDS01,DISP=SHR
//SYSIN DD *
  DATAONLY (YES)
  LRSNSTART (A7951A001AD5) LRSNEND (A7951A003B6A)
  DBID (112) OBID(1D)
/*
変更の始まり

例 5: 1 つのデータ共用グループのすべてのメンバーに対して DSN1LOGP を使用する

次の例は、LRSN X'00CAFFFFFFFFF1D48000' の後、データ共用グループから、DBID X'112' および OBID X'1D' に一致するすべてのログ・レコードに関するログ情報を取り出す方法を示しています。

//STEP1 EXEC PGM=DSN1LOGP
//STEPLIB DD  DSN=PDS containing DSN1LOGP
//SYSPRINT SYSOUT=A
//SYSABEND SYSOUT=A
//GROUP DD DSN=DSNDB0G.BSDS01,DISP=SHR
//SYSIN DD *
  DATAONLY (YES)
  LRSNSTART (00CAFFFFFFFFF1D48000) 
  LRSNEND   (FFFFFFFFFFFFFFFFFFFF)
  DBID (112) OBID(1D)
/*
変更の終わり