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

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

例 1: オブジェクトのリストを定義する

以下の制御ステートメントでは、次のオブジェクトを含むリストを定義しています。

  • 表スペース DBLT0301.TLLT031A
  • 索引スペース DBLT0301.IXlT031A
  • 表スペース DBLT0301.IPLT031C
  • ADMF001.TBLT032A_1 を含む表スペース

リストの名前は NAME1 です。 このリストは、後続のいずれのユーティリティー・ステートメントでも参照できます。

LISTDEF NAME1 INCLUDE TABLESPACE DBLT0301.TLLT031A            
              INCLUDE INDEXSPACE DBLT0301.IXLT031A            
              INCLUDE TABLESPACE DBLT0301.TPLT031C            
              INCLUDE TABLESPACES TABLE  ADMF001.TBLT032A_1 

例 2: 1 つのデータベース内のすべてのオブジェクトのリストを定義する

次の制御ステートメントは、PAYROLL データベースにあるすべての表スペースとすべての索引スペース を組み込んだリスト (EXAMPLE2) を定義します。

LISTDEF EXAMPLE2 INCLUDE TABLESPACES DATABASE PAYROLL
                 INCLUDE INDEXSPACES DATABASE PAYROLL

例 3: パターン・マッチング文字を使用してリストを定義する

以下の制御ステートメントは、次のオブジェクトを組み込んだリスト (PAYROLL) を定義します。

  • PAYROLL データベースにあるすべての表スペース。ただし、TEMP で始まる名前の表スペースを除く。
  • PAYROLL データベースにある IX で終わるすべての索引スペース。ただし、TMPIX で始まる索引スペース は除く。

後続の COPY ユーティリティー制御ステートメントがこのリストを処理します。

LISTDEF PAYROLL INCLUDE TABLESPACE PAYROLL.*
                EXCLUDE TABLESPACE PAYROLL.TEMP*
                INCLUDE INDEXSPACE PAYROLL.*IX
                EXCLUDE INDEXSPACE PAYROLL.TMPIX*
COPY LIST PAYROLL …

例 4: パーティションおよび非パーティション化表スペースのリストを 定義する

次の LISTDEF ステートメントでは、複数の対象とするパーティション表スペースの各パーティション ごとに 1 つのエントリー、および対象とする各非パーティション表スペースごとに 1 つの エントリーを含んでいるリストを定義しています。 このリストには EXAMPLE4 という名前が付けられます。これらの表スペースは、PAY*.* の名前パターンを満足している必要があります。

LISTDEF EXAMPLE4 INCLUDE TABLESPACE PAY*.* PARTLEVEL

3 つの表スペースが対象であると想定します。 これらの表スペースの中には、それぞれ 3 つのパーティションを持つ表スペースが 2 つ (PAY2.DEPTA およ び PAY2.DEPTF) あり、非パーティション表スペースが 1 つ (PAY1.COMP) あります。 この場合、EXAMPLE4 リストには以下の項目が組み込まれます。

  • PAY2.DEPTA パーティション 1
  • PAY2.DEPTA パーティション 2
  • PAY2.DEPTA パーティション 3
  • PAY2.DEPTF パーティション 1
  • PAY2.DEPTF パーティション 2
  • PAY2.DEPTF パーティション 3
  • PAY1.COMP

PARTLEVEL の代わりに PARTLEVEL(2) を指定した場合は、EXAMPLE4 リストには以下の項目が 組み込まれます。

  • PAY2.DEPTA パーティション 2
  • PAY2.DEPTF パーティション 2
  • PAY1.COMP

PARTLEVEL の代わりに PARTLEVEL(0) を指定した場合は、EXAMPLE4 リストには PAY1.COMP のみ が組み込まれます。

例 5: COPY YES 索引のリストを定義する

次の制御ステートメントは、定義済みまたは COPY YES に変更されている参照リスト (EXAMPLE4) から の関連する索引スペースを組み込んだリスト (EXAMPLE5) を定義しています。

LISTDEF EXAMPLE5 INCLUDE LIST EXAMPLE4 INDEXSPACES COPY YES

例 6: 1 つを除くすべての表スペース・パーティションを組み込んだ リストを定義する

次の制御ステートメントでは、表スペース X のパーティション 12 を除く すべてのパーティションを組み込んだリスト (EXAMPLE6) を定義してい ます。INCLUDE 文節は、それぞれのパーティションごとに 1 つのエントリーを追加し ます。EXCLUDE 文節はパーティション 12 のエントリーを除去します。

LISTDEF EXAMPLE6 INCLUDE TABLESPACE X PARTLEVEL
                 EXCLUDE TABLESPACE X PARTLEVEL(12)

次の 2 つのサンプル・ステートメントのように、PARTLEVEL キーワードが両方の文節で 指定されていない場合は、INCLUDE と EXCLUDE の各項目の間では AND 演算されません。 例えば、次のステートメントで、表スペース X は、パーティション・レベルではなく、全体としてリストに組み込まれます。したがって、パーティション 12 は除外することはできません。

LISTDEF EXAMPLE6 INCLUDE TABLESPACE X
                 EXCLUDE TABLESPACE X PARTLEVEL(12)

次のサンプル・ステートメントでは、リストには表スペース X のパーティション 12 のみが 組み込まれます。したがって、表スペース X を全体として除外することはできません。

LISTDEF EXAMPLE6 INCLUDE TABLESPACE X PARTLEVEL(12)
                 EXCLUDE TABLESPACE X

例 7: LISTDEF ライブラリーを定義し、QUIESCE ジョブでリストを参照する

この例では、 最初の 2 つの LISTDEF 制御ステートメントが NAME1 リストと NAME2 リストを定義しています。NAME1 リストは順次データ・セット (JULTU103.TCASE.DATA2) に保管されます。NAME2 リストは区分データ・セットの 1 つのメンバー (JULTU103.TCASE.DATA3(MEM1)) に保管されます。これらの出力データ・セットは、SYSUT2 DD ステートメント (CREATE1 および CREATE2 ジョブ の JCL の中) によって示されています。

LISTLIB DD ステートメント (QUIESCE ジョブの JCL の中) は、LISTDEF ライブラリーを 定義しています。LISTDEF ライブラリーを定義する際に、LISTDEF ステートメントを含んでいる データ・セットの名前を与えます。 この場合、ライブラリーには、以下のデータ・セットが組み込まれることになります。

  • 順次データ・セット JULTU103.TCASE.DATA2 (NAME1 リストが組み込まれている)
  • 区分データ・セット JULTU103.TCASE.DATA3 のメンバー MEM1 (NAME2 リストが組み込まれている)

そのようなライブラリーを定義すると、1 回の参照で、LISTDEF ステートメントのグループを後で参照することができます。

この例では、LISTLIB DD ステートメントが示すライブラリーをデフォルトの LISTDEF 定義ライブラリー として使用することを、OPTIONS ユーティリティー・ステートメントで指定しています。この宣言は、どのリスト参照でも、 リスト定義を検索する際には最初に Db2® が SYSIN を 検索することを意味します。Db2 は、SYSIN で リスト定義が見つからなかった場合、LISTLIB LISTDEF ライブラリーに入っているデータ・セットを 検索します。

最後の LISTDEF ステートメントは、NAME3 リストを定義しています。 このリストは、3 つの表スペース (TSLT032B、TSLT031B、TSLT032C) を除く、NAME1 および NAME2 の リストのすべてのオブジェクトを組み込んでいます。NAME1 リストと NAME2 リストは SYSIN に組み込まれていない ため、Db2 はデフォルトの LISTDEF ライブラリー (LISTLIB) を探して、 これらを見つけます。

最後に、QUIESCE ユーティリティー制御ステートメントは、 Db2 がこのオブジェクト・リスト (NAME3) に 対して静止ポイントを確立することを指定しています。

図 1. LISTDEF ライブラリーを構築してから QUIESCE ユーティリティーを実行する例
//CREATE1  JOB 'USER=NAME',CLASS=A,...                       
//*------------------------------------------------------    
//* Create an input data set.                                
//*------------------------------------------------------    
//LOAD1    EXEC PGM=IEBGENER                                 
//SYSPRINT DD DUMMY                                          
//SYSIN    DD DUMMY                                          
//SYSUT2   DD DSN=JULTU103.TCASE.DATA2,                      
//         DISP=(NEW,CATLG,CATLG),                           
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND),          
//         DCB=(RECFM=FB,LRECL=80,BLKSIZE=2400)              
//SYSUT1   DD *                                              
  LISTDEF NAME1 INCLUDE TABLESPACE DBLT0301.TLLT031A         
                INCLUDE TABLESPACE DBLT0301.TSLT031B         
/*
//CREATE2  JOB 'USER=NAME',CLASS=A,...                       
//*------------------------------------------------------    
//* Create an input data set.                                
//*------------------------------------------------------    
//CRECNTL  EXEC PGM=IEFBR14                                  
//CNTL     DD  DSN=JULTU103.TCASE.DATA3,UNIT=SYSDA,          
//             VOL=SER=SCR03,                                
//             SPACE=(TRK,(2,2,2)),DCB=(DSORG=PO,            
//             LRECL=80,RECFM=FB,BLKSIZE=4560),              
//             DISP=(NEW,CATLG,CATLG)                        
/*                                                           
//*------------------------------------------------------    
//* Create member of input data set.                         
//*------------------------------------------------------    
//FILLCNTL EXEC PGM=IEBUPDTE                                 
//SYSPRINT DD  SYSOUT=*                                      
//SYSUT1   DD  DSN=JULTU103.TCASE.DATA3,DISP=OLD
//SYSUT2   DD  DSN=JULTU103.TCASE.DATA3,DISP=OLD
//SYSIN  DD  DATA                                        
./ ADD NAME=MEM1                                         
  LISTDEF NAME2 INCLUDE TABLESPACE DBLT0302.TLLT032A     
                INCLUDE TABLESPACE DBLT0302.TSLT032B     
                INCLUDE TABLESPACE DBLT0302.TPLT032C     
./ ENDUP                                                 
/* 
                                                           
                                                      
//QUIESCE  JOB 'USER=NAME',CLASS=A,...                   
//*******************************************************
//* QUIESCE LISTDEF DD LILSTDEF data sets                 
//*******************************************************
//STEP1    EXEC DSNUPROC,UID='JULTU103.QUIESC2',         
//            UTPROC='',SYSTEM='SSTR'                    
//LISTLIB  DD DSN=JULTU103.TCASE.DATA2,DISP=SHR          
//         DD DSN=JULTU103.TCASE.DATA3(MEM1),DISP=SHR    
//SYSIN    DD *                                          
    OPTIONS LISTDEFDD LISTLIB                            
    LISTDEF NAME3 INCLUDE LIST NAME1                     
                  INCLUDE LIST NAME2                     
                  EXCLUDE TABLESPACE DBLT0302.TSLT032B   
                  EXCLUDE TABLESPACE DBLT0301.TSLT031B   
                  EXCLUDE TABLESPACE DBLT0302.TPLT032C      
    QUIESCE LIST NAME3                                   
/*    

例 8: 関連するオブジェクトを組み込んだリストを定義する

次の LISTDEF 制御ステートメントは、表スペース DBLT0101.TPLT011C、および参照でこれに関連する すべてのオブジェクトを組み込んだリスト (EXAMPLE8) を定義しています。このリストには基本表スペースのみが組み込まれます。 後続の RECOVER ユーティリティー制御ステートメントで、EXAMPLE8 リストのすべてのオブジェクトを リカバリーするように指定しています。

//STEP2    EXEC DSNUPROC,UID='JULTU101.RECOVE5',          
//            UTPROC='',SYSTEM='SSTR'                     
//SYSIN    DD *                                           
    LISTDEF EXAMPLE8 INCLUDE TABLESPACE DBLT0101.TPLT011C RI BASE         
    RECOVER LIST EXAMPLE8                       
/*   

例 9: クローン・データのリストを定義する

次の制御ステートメントは、INCLUDE 式が以下のオブジェクトの名前のみを戻すことを指定しています。
  • クローン表
  • クローン表を含む表スペース
  • クローン表の索引
  • クローン表の索引を含む索引スペース
LISTDEF REORG_TBSP INCLUDE TABLESPACE DB42240*.T*       
                             CLONED YES                   
                     EXCLUDE TABLESPACE DB42240*.TL4224L* 
                     EXCLUDE TABLESPACE DB42240*.TL4224B* 
                     EXCLUDE TABLESPACE DB42240*.TL4224C* 
                     EXCLUDE TABLESPACE DB42240*.TL4224D* 
                     EXCLUDE TABLESPACE DB42240*.TL4224E* 
                     EXCLUDE TABLESPACE DB42240*.TL4224F* 
                     EXCLUDE TABLESPACE DB422401.TSHR5702 
変更の始まり

例 10: アーカイブ・オブジェクトを含むリストを定義する

以下の LISTDEF ステートメントは、関連する表スペースをすべて含む (関連するアーカイブ表スペースを含む)、LISTALL という名前のリストを定義します。

LISTDEF  LISTALL                                                  
   INCLUDE TABLESPACES TABLESPACE DB516A01.TU516A01 RI ALL        
   INCLUDE TABLESPACES TABLESPACE DB516A01.TU516A01 RI ALL ARCHIVE

1 つ目の INCLUDE 節は、表スペース DB516A01.TU516A01 に参照関係を持つすべての基本表スペース、LOB 表スペース、および XML 表スペースがリストに含まれるように指定しています。2 つ目の INCLUDE 節は、表スペース DB516A01.TU516A01 に関連したすべてのアーカイブ表スペースをリストに含まれるように指定しています。

変更の終わり