TEMPLATE 制御ステートメントのサンプル
以下の制御ステートメントのサンプルを、独自の TEMPLATE 制御ステートメントを作成するためのモデルとして使用できます。
例 1: ディスク上のイメージ・コピー用の基本的なテンプレートを指定 する
次の TEMPLATE ユーティリティー制御ステートメントは、イメージ・コピー・データ・セットの 割り振りに使用できる基本テンプレートを定義します。 テンプレートの名前は COPYDS です。このテンプレートを動的に割り振られたデータ・セットに 対して指定する後続の COPY ジョブは、いずれも DSN オプションによって定義された データ・セット命名規則を使用します。
TEMPLATE COPYDS DSN &DB..&TS..COPY&IC.&LR.&PB..D&DATE..T&TIME.
例 2: 変数サブストリング表記を使用してデータ・セット名を指定 する
次の制御ステートメントは、テンプレート CP2 を定義しています。 データ・セット命名規則を定義するために DSN オプションで変数サブストリング表記が使用されています。
2003 年に表スペース DSN8S81D のパーティション 00004 のフル・イメージ・コピーをとるものと想定します。 ローカル 1 次コピーのデータ・セットに対して、テンプレート CP2 を指定すると想定し ます。この場合、Db2® は、イメージ・コピー・データ・セットに DH173001.DSN8S81D.Y03.COPYLP.P004 という名前を付けます。
DSN オプションのすべての変数は、アンパーサンド (&) で始まりピリオド (.) で終わること に注意してください。 これらのアンパーサンドとピリオドは、データ・セット名には組み込まれません。 変数の終わりの符号でないピリオドだけが、データ・セット名に組み込まれます。
TEMPLATE CP2 DSN 'DH173001.&SN..Y&YEAR(3)..COPY&LR.&PB..P&PART(3,3).'
UNIT(SYSDA)
例 3: 変数サブストリング表記を含む TEMPLATE を COPY で使用する
次の TEMPLATE ユーティリティー制御ステートメントは、テンプレート SYSCOPY を定義しています。 データ・セット命名規則を定義するために DSN オプションで変数サブストリング表記が使用されています。 後続の COPY ユーティリティー制御ステートメントは、Db2 が表スペース DSN8D81A.DSN8S81E の 先頭パーティションのローカル 1 次コピーを作成することを指定しています。COPY は、SYSCOPY テンプレートに従って動的に割り振られるデータ・セットに、このイメージ・コピー を書き込みます。 この場合、結果として、データ・セット名は DSN8D81A.DSN8S81E.P001 となります。
TEMPLATE SYSCOPY DSN '&DB..&TS..P&PA(3).'
COPY TABLESPACE DSN8D81A.DSN8S81E DSNUM 1 COPYDDN(SYSCOPY)
DSN オペランドのパート変数は、P&PA(3). から P&PA(3,3). に変更できることに 注意してください。 長さの値の 3 が最初の指定でも暗黙的に含まれているため、結果としてのデータ・セット名は同じです。
例 4: 有効期限のあるテープ・データ・セット用のテンプレートを指定する
次の制御ステートメントは、TAPEDS テンプレートを定義しています。 このテンプレートを用いて定義されたデータ・セットはいずれも、UNIT オプションで示しているように、 装置番号 3590-1 上に割り振られ、EXPDL オプションで示すように、2100 年 1 月 1 日で 有効期限が切れます。DSN オプションは、これらのデータ・セット名が、データベース名、表スペース名、および日付 という 3 つの部分を持っていることを示しています。
TEMPLATE TAPEDS DSN(&DB..&TS..D&DATE.)
UNIT 3590-1 EXPDL '2100001'
例 5: スペース割り振りパラメーターを与えるディスク・テンプレートを 指定する
次の制御ステートメントは、DISK テンプレートを定義しています。 このテンプレートを用いて定義されたデータ・セットはいずれも、SPACE および CYL オプションで 示しているように、100 シリンダーの 1 次ディスク・スペースと 10 シリンダーの 2 次ディスク・スペース を持っています。DSN オプションは、このデータ・セット名が、データベース名、表スペース名、および時刻 という 3 つの部分を持っていることを示しています。
TEMPLATE DISK DSN &DB..&TS..T&TIME.
SPACE(100,10) CYL
例 6: 制約付きでデフォルトのサイズを使用するディスク・テンプレートを 指定する
次の制御ステートメントは、DISK テンプレートを定義しています。 SPACE オプションに 1 次および 2 次スペース割り振り量が指定されていないので、Db2 が、最大の 1 次スペース割り振り量は 1000 シリンダーであるという 制約付きでこれらの値を計算します。 この制約は、MAXPRIME オプションで示されてい ます。DSN オプションは、このデータ・セット名が、データベース名、表スペース名、および時刻 という 3 つの部分を持っていることを示しています。
TEMPLATE DISK DSN(&DB..&TS..T&TIME.)
SPACE CYL MAXPRIME 1000
例 7: LISTDEF および COPY と共に TEMPLATE を使用する
次の例では、LISTDEF ユーティリティー制御ステートメントが CPY1 リストを定義しています。 次に、TEMPLATE 制御ステートメントが TMP1 テンプレートを定義しています。 その次に、COPY ユーティリティー制御ステートメントは、Db2 が CPY1 リスト中の オブジェクトのローカル・コピーを作成することを指定しています。Db2 は、TMP1 テンプレートに定義された特性に従って動的に割り振られるデータ・セットに、これらのコピーを書き込みます。
LISTDEF CPY1 INCLUDE TABLESPACES TABLESPACE DBA906*.T*A906*
INCLUDE INDEXSPACES COPY YES INDEXSPACE ADMF001.I?A906*
TEMPLATE TMP1 UNIT SYSDA
DSN (DH109006.&STEPNAME..&SN..T&TIME.)
DISP (MOD,CATLG,CATLG)
COPY LIST CPY1 COPYDDN (TMP1) PARALLEL (2) SHRLEVEL REFERENCE
DSN 名前式では、括弧はオプションです。
例 8: TEMPLATE を使用して GDG データ・セットを作成する
この例 では、TEMPLATE 制御ステートメントは COPYTEMP テンプレートを定義しています。 COPY ユーティリティー制御ステートメントは、Db2 が、 表スペース DBLT2501.TPLT2501 のローカル・イメージ・コピーを、COPYTEMP テンプレートに定義された特性に従って動的に 割り振られるデータ・セットに書き込むことを指定しています。 COPYTEMP テンプレートに従うと、このデータ・セットの名前は JULTU225.GDG(+1) (DSN オプション で示されている) であり、GDG ベースに 6 つの項目が作成されます (GDGLIMIT オプションで 示されている)。MODELDCB オプションで示されているように、制御ブロック情報は JULTU225.MODEL データ・セット のものと同じです。
//************************************************************
//* COMMENT: Define a model data set. *
//************************************************************
//STEP1 EXEC PGM=IEFBR14
//SYSCOPX DD DSN=JULTU225.MODEL,DISP=(NEW,CATLG,CATLG),
// UNIT=SYSDA,SPACE=(4000,(20,20)),VOL=SER=SCR03,
// DCB=(RECFM=FB,BLKSIZE=4000,LRECL=100)
//***********************************************************
//* COMMENT: GDGLIMIT(6)
//***********************************************************
//STEP2 EXEC DSNUPROC,UID='JULTU225.GDG',
// UTPROC='',
// SYSTEM='SSTR'
//SYSIN DD *
TEMPLATE COPYTEMP
UNIT SYSDA
DSN 'JULTU225.GDG(+1)'
MODELDCB JULTU225.MODEL
GDGLIMIT(6)
COPY TABLESPACE DBLT2501.TPLT2501
FULL YES
COPYDDN (COPYTEMP)
SHRLEVEL REFERENCE
/*
例 9: テンプレートを使用して GDG データ・セットをテープにコピーする
この例では、 OPTIONS ユーティリティー制御ステートメントの指定によって、後続の TEMPLATE ステートメントは PREVIEW モードで実行します。このモード の場合、Db2 は TEMPLATE ステートメントの 構文を検査します。Db2 は、構文が有効であると 判断すると、データ・セット名を展開します。OPTIONS OFF ステートメントは、PREVIEW モードの処理を終了させます。 後続の COPY ユーティリティー制御ステートメントは通常に実行し ます。COPY ステートメントは、Db2 が、 表スペース DBLT4301.TPLT4301 のローカル・イメージ・コピーを、COPYTEMP テンプレートに定義された特性に従って動的に割り振られるデータ・セットに 書き込むことを指定しています。 COPYTEMP テンプレートに従うと、このデータ・セットの名前は JULTU243.GDG(+1) (DSN オプションで 示されている) であり、テープ・ボリューム 99543 にスタックされます (UNIT、STACK、およ び VOLUMES オプションで示されている)。 データ・セットの後処理は DISP オプションで指定されてい ます。GDGLIMIT オプションでは、GDG ベースに 50 項目が作成されることを指定しています。
/*
//*************************************************
//* COMMENT: COPY GDG DATA SET TO TAPE
//*************************************************
//STEP1 EXEC DSNUPROC,UID='JULTU243.GDG',
// UTPROC='',
// SYSTEM='SSTR'
//SYSIN DD *
OPTIONS PREVIEW
TEMPLATE COPYTEMP
UNIT TAPE
DSN 'JULTU243.GDG(+1)'
VOLUMES (99543)
GDGLIMIT(50)
DISP(NEW,CATLG,CATLG)
STACK YES
OPTIONS OFF
COPY TABLESPACE DBLT4301.TPLT4301
FULL YES
COPYDDN (COPYTEMP)
SHRLEVEL REFERENCE
/*
例 10: LOB オブジェクトのアンロードに使用できるテンプレートを作成する
この例の TEMPLATE 制御ステートメント は、LOBFRV という名前のテンプレートを定義しています。後続の UNLOAD ステートメントは、LOBFRV テンプレートに定義された特性に応じて動的に割り振られるファイルに、RESUME 列の各 CLOB がアンロードされることを指定しています。 この場合、それらのファイルは区分データ・セット (DSNTYPE オプションで指定) になります。各データ・セットは、UNLODTEST. database-name.LOB-table-space-name.RESUME という名前 (DSN オプションで指定) が付くことになります。各 CLOB PDS の名前は、アンロード・データ・セットに書き込まれます。デフォルトでは、このアンロード・データ・セットは、SYSREC DD ステートメントまたはテンプレートで定義されます。
TEMPLATE LOBFRV DSN 'UNLDTEST.&DB..&TS..RESUME'
DSNTYPE(PDS) UNIT(SYSDA)
UNLOAD DATA
FROM TABLE DSN8910.EMP_PHOTO_RESUME
(EMPNO CHAR(6),
RESUME VARCHAR(255) CLOBF LOBFRV)
SHRLEVEL CHANGE
例 11: テンプレート切り替えを使用する
以下の TEMPLATE 制御ステートメントは、表スペース SMALL.TS が 10 シリンダーを、 表スペース LARGE.TS が 100 シリンダーを使用すると想定しています。両方の COPY ステートメントとも、 限度として 20 シリンダーが指定されている SMALLTP テンプレートを使用しています。表スペース SMALL.TS はこの限度よりも小さいので、切り替えは実行されません。表スペース SMALL.TS 用の出力データ・セット は、UNIT=SYSALLDA に割り振られます。表スペース LARGE.TS はこの限度よりも大きいので、テンプレート は LARGETP テンプレートに切り替わります。表スペース LARGE.TS 用の出力データ・セット は、UNIT=TAPE に割り振られます。
TEMPLATE LARGETP DSN &DB..&TS..D&DA..T&TI. UNIT=TAPE
TEMPLATE SMALLTP DSN &DB..&TS..D&DA..T&TI. UNIT=SYSALLDA LIMIT( 20 CYL, LARGETP )
COPY TABLESPACE SMALL.TS COPYDDN( SMALLTP )
COPY TABLESPACE LARGE.TS COPYDDN( SMALLTP )