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) に 対して静止ポイントを確立することを指定しています。
//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: クローン・データのリストを定義する
- クローン表
- クローン表を含む表スペース
- クローン表の索引
- クローン表の索引を含む索引スペース
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 に関連したすべてのアーカイブ表スペースをリストに含まれるように指定しています。
