TEMPLATE 制御ステートメントの構文とオプション
TEMPLATE ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。
制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。
構文図
>>-TEMPLATE--template-name--------------------------------------> >--+---DSN--| name-expression |----+--------------------+--+------------------+--+-------------+-+->< | '-| common-options |-' +-| disk-options |-+ '-SUBSYS-spec-' | | '-| tape-options |-' | '-path-expression-----------------------------------------------------------------------------'
name-expression:
.-.------------------------. V | >>---| qualifier-expression |-+---------------------------------> (1) >--+----------------------------+------------------------------>< '-(parenthetical-expression)-'
- name-expression 全体が 1 つの文字ストリングを表します。 中にブランクを含んでいてはなりません。
qualifier-expression:
.--------------------------------------------------. V | >>---+-character-expression-------------------------+-+-------->< | (2) | '-&variable-+--------------------------+-.-----' | (1) | '-(start-+---------+-)-----' '-,length-'
- サブストリング表記を使用する場合は、DSN オペランド全体を単一引用符で囲む必要があります。 例えば、DSN オペランド 'P&PA(4,2).' は、 サブストリング表記を使用しているため、単一引用符で囲まれています。
- &PA. 変数は一度しか使用できません。
common-options:
.-UNIT--SYSALLDA-. >>-+----------------+--+------------------+---------------------> '-UNIT--name-----' '-MODELDCB--dsname-' .-BUFNO--30------. >--+----------------+--+----------------+--+----------------+---> '-BUFNO--integer-' '-DATACLAS--name-' '-MGMTCLAS--name-' >--+----------------+--+--------------+-------------------------> '-STORCLAS--name-' +-RETPDinteger-+ '-EXPDL' date'-' >--+-------------------------+--+-----------------+-------------> | .-,------. | '-VOLCNT--integer-' | V | | '-VOLUMES--(---volser-+-)-' .-GDGLIMIT--99------. >--+----------------+--+-------------------+--------------------> '-UNCNT--integer-' '-GDGLIMIT--integer-' >--+-----------------------------------------------------+------> '-DISP--(--+-NEW-+--,--+-DELETE--+--,--+-DELETE--+--)-' +-OLD-+ +-KEEP----+ +-KEEP----+ +-SHR-+ +-CATLG---+ +-CATLG---+ '-MOD-' '-UNCATLG-' '-UNCATLG-' >--+--------------------------------+--+----------------+------>< '-LIMIT(n-+-CYL-+-,new_template)-' '-TIME-+-LOCAL-+-' +-GB--+ '-UTC---' '-MB--'
disk-options:
.-SPACE--CYL------------------------------. >>-+-----------------------------------------+------------------> '-SPACE--+---------------------+--+-CYL-+-' '-(primary,secondary)-' +-TRK-+ '-MB--' .-PCTPRIME--100-----. >--+-------------------+--+-------------------+-----------------> '-PCTPRIME--integer-' '-MAXPRIME--integer-' .-NBRSECND--10------. >--+-------------------+--+--------------+----------------------> '-NBRSECND--integer-' '-DIR--integer-' >--+----------------------+--+-------+------------------------->< '-DSNTYPE--+-LIBRARY-+-' '-EATTR-' +-PDS-----+ +-HFS-----+ +-NULL----+ +-BASIC---+ +-LARGE---+ +-EXTREQ--+ '-EXTPREF-'
tape-options:
.-STACK--NO--. .-TRTCH--NONE-------. >>-+------------+--+-------------------+----------------------->< '-STACK--YES-' '-TRTCH--+-COMP---+-' '-NOCOMP-'
SUBSYS-spec
>>-SUBSYS--name--LRECL--int--RECFM--+-F--+--------------------->< +-FB-+ +-V--+ '-VB-'
path-expression
>>-PATH--pathname-----------------------------------------------> .-FILEDATA--RECORD--RECFM--VB--LRECL--32756-------. >--+-------------------------------------------------+----------> '-FILEDATA--+-TEXT---+--RECFM--+-VB-+--LRECL--int-' '-BINARY-' +-V--+ +-FB-+ '-F--' (1) .-PATHOPTS--(--+-ORDONLY------------+--)-. | | (2) | | | '-OCREAT,OWRONLY-----' | >--+----------------------------------------+-------------------> | .-,-------------. | | V .-ORDONLY---. | | '-PATHOPTS--(----+-OCREAT----+-+--)------' +-OWRONLY---+ '-ONONBLOCK-' .-PATHMODE--(SIRUSR)-------------. >--+--------------------------------+---------------------------> | .-,----------. | | V | | '-PATHMODE--(----+-SIRUSR-+-+--)-' +-SIWUSR-+ +-SIXUSR-+ +-SIRWXU-+ +-SIRGRP-+ +-SIWGRP-+ +-SIXGRP + +-SIRWXG-+ +-SIROTH-+ +-SIWOTH-+ +-SIXOTH-+ '-SIRWXO-' .-PATHDISP--(KEEP,KEEP)---------------------. >--+-------------------------------------------+--------------->< '-PATHDISP--(--+-KEEP---+--,--+-KEEP---+--)-' '-DELETE-' '-DELETE-'
- LOAD の場合、デフォルトは PATHOPTS(ORDONLY) です。
- UNLOAD の場合、デフォルトは PATHOPTS(OCREAT,OWRONLY) です。
オプションの説明
- TEMPLATE template-name
- データ・セット割り振りテンプレートを定義し、後続の Db2® ユーティリティー制御ステートメントで参照
できるように、定義したテンプレートに名前 template-name を割り当てます。template-name は
最長 8 文字の英数字で、先頭は英字でなければなりません。
template-name で UTPRINT および SORTLIB は使用できず、 SORTWK または SYS で開始することもできません。
template-name の後ろには、テープおよびディスクのデータ・セットの割り当てを制御する キーワードが続きます。1 つの TEMPLATE ステートメントで、ディスク・オプションとテープ・オプションの両方を 持つことはできません。UNIT キーワードは、ご使用のシステムで定義されている総称装置名を指定します。 この値は、ディスクまたはテープ・データ・セットのいずれが割り振られるかを判別する際に使用され ます。TEMPLATE 制御ステートメントに指定する他のすべてのキーワードは、 指定した装置タイプと整合していなければなりません。
- DSN name-expression
- z/OS® データ・セット名のテンプレートを指定します。データ・セット
名 name-expression の指定には、シンボリック変数、変数ではない英数字、
国別文字、またはそれらの任意の組み合わせを使用できます。結果の名前は、その長さ、有効な文字、名前の構造と修飾子の長さなど、z/OS データ・セット名
の命名規則に準拠していなければなりません。このユーティリティーで割り振られる各データ・セットごとに、およびユーティリティーの各起動に
対して、固有の DSN 表現を 1 つ指定する必要があります。
FlashCopy® イメージ・コピーのテンプレートは、DSN name-expression だけを指定する必要があります。 Db2 は FlashCopy イメージ・コピーについて、TEMPLATE 制御ステートメント内の他のオプションを使用しません。
データ・セット名は、一連の修飾子 qualifier-expression を ピリオド (.) で区切り、オプションで 1 つの括弧付きの式を加えて構成します。 組み込みブランクを含めることはできません。 区分データ・セット (PDS) は、入力データ・セットとして使用するために TEMPLATE で定義することはできません。
DSN 名オペランドに特殊文字を含める場合は、全体を単一引用符で囲む必要があります。 例えば、次の TEMPLATE ステートメントでは、DSN オペランドには括弧という特殊文字が 含まれているため、全体を単一引用符で囲んでいます。
TEMPLATE X DSN 'A.GDG.VERSION(+1)'DSN 名オペランドを、オプションで、括弧で囲むこともできます。 次の DSN の指定では、括弧を使用しています。
DSN(&DB..&TS..D&DATE.) - character-expression
- 非変数の英数字か国別文字を使用し、データ・セット名、またはデータ・セット名の一部を指定します。
- parenthetical-expression
- 非変数の英数字か国別文字を使い、データ・セット名の一部を括弧で囲んで指定します。 例えば、Q1.Q2.Q3(member) および Q1.Q2.Q3(+1) という式は、 有効な parenthetical expressions (括弧付きの式) です。括弧付きの式内では変数置換は実行されません。
- &variable.
- シンボリック変数を使用し、データ・セット名、またはデータ・セット名の一部を指定します。
下の表に、使用できる変数がリストされています。
それぞれのシンボリック変数は、実行時に、関連付けられている値に置き換えられて、 特定のデータ・セット名を形成します。 DSN 表現で使用される場合、次の例のように、置換変数は、 アンパーサンド記号 (&) で始まり、ピリオド (.) で終わります。
DSN &DB..&TS..D&JDATE..COPY&ICTYPE.数値変数だけを使用すると、 すべて数値タイプの変数 (すべての日付タイプまたは時刻タイプの変数など (例えば、&SEQ. または &PART.)) の 場合は無効なデータ・セット修飾子が生成されてしまいます。有効な DSN 修飾子を形成するには、これらの変数の頭に文字定数を付ける必要があります。 以下の例は、有効な指定です。
P&PART.D&DATE.互換性のないユーティリティーで TEMPLATE を使用する場合、一部の置換変数は無効です。 例えば、LOAD SYSDISC で TEMPLATE ステートメントを使用した場合は、ICTYPE は無意味です。他の変数は、その値が不明の場合は、 デフォルト値が想定されます。例えば、&PART. は、非パーティション化オブジェクトでは 00000 になります。
また、データ・セット名の変数にはサブストリング表記も使用できます。 この表記によって、データ・セット名が最大 44 文字を超えることのないようにすることができます。 サブストリング表記を使用する場合は、DSN オペランド全体を単一引用符で囲む必要があります。 サブストリングを指定するには、&variable(start). または &variable(start,length). の形式 を使用します。
- start
- 実行時における現行の変数の基本値内で、サブストリングの先頭のバイト・ロケーションを指定し ます。start は、1 から 128 までの整数でなければなりません。
- 長さ
- サブストリングの長さを指定します。 start を指定しても length を指定しなかった場合は、 デフォルトにより、length は start の文字から、 実行時の変数値の最後の文字までの文字数となります。 例えば、基本値が 5 桁の場合、&PART(4). はその値の 4 桁目と 5 桁目を 指定することになります。length は、サブストリングが基本値の終わりを越えてしまう ことにならないような範囲の整数でなければなりません。
パーティション表スペースに対して UNLOAD を実行する場合、DSN 引数にパーティション変数 (&PART. または &PA.) のサブストリング表記を使用すると、データ・セット名がすべてのパーティションに対して固有でなくなる可能性があり、そうなると Db2 はパーティションに対して並列 UNLOAD 操作を実行できません。 そのため、Db2 は &PA の値を「00000」に設定し、すべてのパーティションに単一の UNLDDN データ・セットを使用します。このアクションは、同じ表スペースの他のパーティションの後続の UNLOAD ジョブで、データ・セット重複エラーを発生させることがあります。
JOB 変数とその説明を次の表に示します。
表 1. JOB 変数 変数 説明 &JOBNAME. または &JO. z/OS ジョブ名。 &STEPNAME. または &ST. z/OS ステップ名。2 つの異なるジョブ・ステップのデータ・セット名が競合する場合は、 この変数が必要になることがあります。 &USERID. または &US. ユーティリティーを実行している人のユーザー ID。 値の長さは 1 から 8 文字です。 &UTILID. または &UT. 8 文字に切り捨てられ、無効な DSN 文字がないか検査された、ユーティリティー ID。 &SSID. または &SS.
サブシステム ID (非データ共用) またはグループ接続名 (データ共用)。
UTILITY 変数とその説明を次の表に示します。
表 2. UTILITY 変数 変数 説明 &ICTYPE. または &IC. 単一文字イメージ・コピー・タイプ。この変数は、イメージ・コピー・テンプレート の場合のみ有効です。 ユーザーが、フル・イメージ・コピー (F)、増分イメージ・コピー (I)、 または CHANGELIMIT イメージ・コピー (C) を指定したかどうかによって、置換が決まります。 &UTILNAME. または &UN. 一部のユーティリティーの場合は、特殊値が割り当てられます。CHECK DATA に は CHECKD、CHECK INDEX には CHECKI、CHECK LOB には CHECKL、REORG INDEX に は REORGI、REORG TABLESPACE には REORGT が割り当てられます。8 文字より長いユーティリティー名は、8 文字 に切り捨てられます。 &SEQ. または &SQ.
処理対象の LISTDEF リスト項目のシーケンス番号。
&LOCREM. または &LR. ddname がローカル・サイト (COPYDDN) 用か、 またはリカバリー・サイト (RECOVERYDDN) 用かを示す標識。 このユーティリティーが COPYDDN ddname を定義する場合は、単一文字 L を使用します。 このユーティリティーが RECOVERYDDN ddname を定義する場合は、単一文字 R を使用し ます。SYSCOPY ICBACKUP の列情報は、&LOCREM. および &PRIBAC. 変数の 両方を使用することによって、複製することができます。 この変数は、イメージ・コピー・テンプレートの場合のみ有効です。 &PRIBAC. または &PB. ddname が、1 次コピー・データ・セット (ddname1) 用か、 またはバックアップ・コピー・データ・セット (ddname2) 用かを示す標識。 このユーティリティーが ddname1 を定義する場合は、単一文字 P を使用します。 このユーティリティーが ddname2 を定義する場合は、単一文字 B を使用し ます。SYSCOPY ICBACKUP の列情報は、&LOCREM. および &PRIBAC. 変数の 両方を使用することによって、複製することができます。 この変数は、イメージ・コピー・テンプレートの場合のみ有効です。 OBJECT 変数とその説明を次の表に示します。
表 3. OBJECT 変数 変数 説明 &LIST. または &LI. LISTDEF 制御ステートメントを使用して定義され、この TEMPLATE と同じ制御ステートメント で参照されるリストの名前。この変数は、COPY FILTERDDN テンプレートで使用されます。リスト中のすべてのオブジェクトは、1 つのデータ・セットにコピーされます。 したがって、&TS. と &IS. は無意味です。 &DB. データベース名 &TS.1 表スペース名。 &IS. 1 索引スペース名。 &SN.1 スペース名 (表スペースまたは索引スペース)。
&PART. または &PA.2、3、4
5 桁のパーティション番号。先行ゼロが埋め込まれている。
&DSNUM3、4
先行ゼロを埋め込んだ、5 桁のパーティション番号 (パーティション化されたオブジェクトの場合) または 5 桁の部分番号 (線形オブジェクトの場合)。 注:- &TS. 変数、&IS. 変数、または &SN. 変数を、BLOBF、CLOBF、または DBCLOBF が指定された UNLOAD ステートメントが使用するテンプレート で指定すると、Db2 は、 基本表スペース名ではなく、LOB 列値を保管する表スペースの名前を置換 します。この置換によって、Db2 は、 パーティション化表スペースを持つ各 LOB 列に対して、固有のデータ・セット名を生成できます。
- PARTLEVEL キーワードまたはデータに応じてパーティション化された副次索引を持つ LISTDEF リストを 処理する場合は、&PA. 変数を使用してください。 そうしないと、Db2 は重複するデータ・セット名を 生成する可能性があります。
- FlashCopy イメージ・コピーのテンプレートには、&PART または &DSNUM のいずれかを含めることができます。パーティション化されたオブジェクトおよび線形オブジェクトの両方 をコピーする場合は、&DSNUM を使用してください。
FlashCopy イメージ・コピーは常に、パーティション・レベルまたは部分レベルで行われます。
この動作は、COPY ユーティリティー・ステートメントに DSNUM ALL を指定して FlashCopy イメージ・コピーを要求したり、PARTLEVEL キーワードを指定せずに LISTDEF リストに FlashCopy イメージ・コピーを含めたりしても、発生します。このため、FlashCopy イメージ・コピーの変数 &PART.、&PA.、または &DSNUM. が含まれたテンプレートでは、結果として生じるデータ・セットの数や名前が、他のユーティリティーで同じテンプレートが使用された場合の結果と異なる可能性があります。
結果は、テンプレートをプレビューする際に表示されるデータ・セット名とも異なる可能性があります。(テンプレートのプレビューについては、主な TEMPLATE の操作 を参照してください。)
次の表に、DATE 変数と TIME 変数、およびその説明を示します。
表 4. DATE 変数および TIME 変数 変数 説明 &DATE. または &DT. YYYYDDD &TIME. または &TI. HHMMSS &JDATE. または &JU. YYYYDDD &YEAR. または &YE. &DATE. の YYYY 部分 &MONTH. または &MO. MM &DAY. または &DA. DD &JDAY. または &JD. &DATE. の DDD 部分 &HOUR. または &HO. &TIME. の HH 部分 &MINUTE. または &MI. &TIME. の MM 部分 &SECOND. または &SC. &TIME. の SS 部分 &UNIQ. または &UQ. Db2 が割り振り時にシステム・クロックから派生させる固有の 8 文字。この一連の文字は英字で始まり、その後に 7 文字の英字または数字が続きます。 注:
日付と時刻値は STCK 命令で設定されます。値は、TIME オプションまたは TEMPLATE_TIME サブシステム・パラメーターに応じて、現地時間あるいは協定世界時 (UTC) となります。
&UNIQ. 変数と &UQ. 変数を除き、DATE および TIME の値は、各ユーティリティーの UTILINIT フェーズで取り込まれ、ユーティリティーが終了するまで一定のままです。&UNIQ. と &UQ. には、割り振りごとに固有値が割り当てられます。
- SUBSYS name
- MVS™ BATCHPIPES SUBSYSTEM 名を
指定します。SUBSYS オペランドは、有効な BATCHPIPES SUBSYSTEM 名でなければならず、長さが 8 文字を
超えてはなりません。SUBSYS が指定されている場合、LRECL および RECFM が必要です。SUBSYS が
指定されている場合、TEMPLATE のキーワードのうち SUBSYS と互換でないもの (UNIT など) は
無視されます。制約事項: BATCHPIPES、TEMPLATE、および SUBSYS キーワードを使用すると、ユーティリティーを再開できず、LOAD DISCARDDN キーワードはサポートされません。
- LRECL int
- MVS BATCHPIPES SUBSYSTEM ファイルまたは z/OS UNIX ファイルのレコード長を指定します。SUBSYS を指定する場合は、LRECL を指定しなければなりません。
TEMPLATE PATH を指定し、デフォルト値の FILEDATA RECORD を受け入れた場合、LRECL のデフォルト値は 32756 です。これ以外の場合、LRECL はデフォルト値を持ちません。
- RECFM
- MVS BATCHPIPES SUBSYSTEM ファイルまたは z/OS UNIX ファイルのレコード・フォーマットを指定します。SUBSYS を指定する場合は、RECFM を指定しなければなりません。
RECFM の有効な値は、F、FB、V、または VB です。
TEMPLATE PATH を指定し、デフォルト値の FILEDATA RECORD を受け入れた場合、RECFM のデフォルト値は VB です。これ以外の場合、RECFM はデフォルト値を持ちません。
- UNIT
- データ・セットの装置番号、装置タイプ (総称)、グループ名を指定します。
その他の TEMPLATE キーワードはすべて、指定された装置のタイプ (ディスクまたはテープ) に基づいて、
検証されます。
デフォルト値は SYSALLDA です。
- MODELDCB dsname
- テンプレートが基にしているデータ・セットの名前を指定し ます。DCB 情報は、このモデル・データ・セットから読み取られます。
- BUFNO integer
- BSAM バッファー数を指定します。
指定する値は、0 から 99 の範囲になければなりません。
デフォルト値は 30 です。
- DATACLAS name
- SMS データ・クラスを指定します。
name 値は、有効な SMS データ・クラスでなければならず、長さが 8 文字を超えてはなりません。
DATACLAS を指定すると、データ・セットはカタログされます。 このオプションを省略すると、SMS に対して DATACLAS は何も指定されません。
- MGMTCLAS name
- SMS 管理クラスを指定します。
name 値は、有効な SMS 管理クラスでなければならず、長さが 8 文字を超えてはなりません。
MGMTCLAS を指定すると、データ・セットはカタログされます。 このオプションを省略すると、SMS に対して MGMTCLAS は何も指定されません。
- STORCLAS name
- SMS ストレージ・クラスを指定します。
name 値は、有効な SMS ストレージ・クラスでなければならず、長さが 8 文字を超えてはなりません。
STORCLAS を指定すると、データ・セットはカタログされます。 このオプションを省略すると、SMS に対して STORCLAS は何も指定されません。
- RETPD integer
- データ・セットの保存期間を日数で指定します。
整数値は、0 から 9999 の範囲にある必要があります。
DATACLAS、MGMTCLAS、または STORCLAS を指定する場合は、そのクラス定義がこの保存を制御することがあり ます。RETPD は EXPDL とともに指定できません。
- EXPDL 'date'
- データ・セットの有効期限を YYYYDDD の形式で指定します。
ここで、YYYY は年を表す 4 桁の数字で、DDD は 3 桁のユリウス日
です。'date' 値は、単一引用符で囲む必要があります。
DATACLAS、MGMTCLAS、または STORCLAS を指定する場合は、そのクラス定義がこの保存を制御することがあり ます。EXPDL は RETPD とともに指定できません。
- VOLUMES (vol1,vol2,...)
- この割り振りのボリューム通し番号のリストを指定します。データ・セットが
カタログされていない場合、このリストは SYSIBM.SYSCOPY に保管される際に、
必要であれば切り捨てられます。指定されるボリューム数は、VOLCNT に指定された値、またはデフォルト値を
超えてはなりません。
最初のボリュームには、1 次スペース割り振りのための十分なスペースが必要です。
個々のボリューム通し番号に先行ゼロがある場合は、 通し番号を単一引用符で囲む必要があります。
- VOLCNT (integer)
- 出力データ・セットが必要とする可能性のあるボリュームの最大数を指定します。
指定する値は、0 から 255 までの範囲内でなければなりません。
テープ・テンプレートの 場合のデフォルト値は 95 です。ディスク・テンプレートの場合は、ユーティリティーはデフォルトを設定しません。 オペレーティング・システムのデフォルトが適用されます。
- UNCNT integer
- 割り振られる装置数を指定します。
指定する値は、0 から 59 の範囲にある必要があります。
UNIT で特定の装置番号を指定した場合は、UNCNT の値は 1 に設定するか、もしくは省略する必要があります。
- GDGLIMIT (integer)
- GDG DSN が指定されていて、ベースがまだ存在しない場合、GDG ベース内に作成される
項目数を指定します。GDG ベースがまだ存在せず、
ベースを定義しない場合は、GDGLIMIT をゼロ (0) に指定してください。
デフォルト値は 99 です。最小値は 0 です。最大値は、サブシステムが実行されている z/OS のリリースによって異なります。z/OS V2R1 以前の場合、最大値は 255 です。z/OS V2R2 以降の場合、最大値は 999 です。255 より大きい値を使用する場合は、前もってデータベース管理者またはシステム・プログラマーに、SYS1.PARMLIB(IGGCATxx) で GDGEXTENDED(YES) が指定されていることを確認してください。
指定されていない場合、255 より大きい値は割り振り中に失敗します。
- DISP (status, normal-termination, abnormal-termination)
- 3 つの定位置パラメーター (status、normal-termination、abnormal-termination) を使用して、
データ・セット後処理を指定します。3 つのパラメーターはすべて指定する必要があります。
- status
- 標準 z/OS 値 (NEW、OLD、SHR、MOD) を指定できます。
- normal-termination
- 標準 z/OS 値 (DELETE、KEEP、CATLG、UNCATLG) を指定できます。
- abnormal-termination
- 標準 z/OS 値 (DELETE、KEEP、CATLG、UNCATLG) を指定できます。
DISP のデフォルト値は、ユーティリティーと割り振られるデータ・セットによって異なります。 また、再始動されたユーティリティーのデフォルトは、新規ユーティリティー実行の場合のデフォルト とも異なります。デフォルト値を下の各表に示します。
次の表は、 新たにユーティリティーが実行されるときに動的に割り振られるデータ・セットの後処理を示しています。
注: パイプ・データを使用するユーティリティーからの出力が、新しいユーティリティーの実行に動的に割り振られない場合があります。表 5. 新たにユーティリティーを実行する場合に、 動的に割り振られるデータ・セットのデータの後処理 DD 名 (ddname) CHECK DATA CHECK INDEX または CHECK LOB COPY COPY- TOCOPY LOAD MERGE- COPY REBUILD INDEX REORG INDEX REORG TABLE- SPACE UNLOAD SYSREC 無視 無視 無視 無視 OLD KEEP KEEP 無視 無視 無視 NEW CATLG CATLG NEW CATLG CATLG SYSDISC 無視 無視 無視 無視 NEW CATLG CATLG 無視 無視 無視 NEW CATLG CATLG 無視 SYSPUNCH 無視 無視 無視 無視 無視 無視 無視 無視 NEW CATLG CATLG NEW CATLG CATLG SYSCOPY 無視 無視 NEW CATLG CATLG 無視 NEW CATLG CATLG NEW CATLG CATLG 無視 無視 NEW CATLG CATLG 無視 SYSCOPY2 無視 無視 NEW CATLG CATLG 無視 NEW CATLG CATLG NEW CATLG CATLG 無視 無視 NEW CATLG CATLG 無視 SYSRCPY1 無視 無視 NEW CATLG CATLG 無視 NEW CATLG CATLG NEW CATLG CATLG 無視 無視 NEW CATLG CATLG 無視 SYSRCPY2 無視 無視 NEW CATLG CATLG 無視 NEW CATLG CATLG NEW CATLG CATLG 無視 無視 NEW CATLG CATLG 無視 SYSUT1 NEW DELETE CATLG NEW DELETE CATLG 無視 無視 NEW DELETE CATLG 無視 NEW DELETE CATLG NEW CATLG CATLG NEW DELETE CATLG 無視 SORTOUT NEW DELETE CATLG 無視 無視 無視 NEW DELETE CATLG 無視 無視 NEW DELETE CATLG NEW DELETE CATLG 無視 SYSMAP 無視 無視 無視 無視 NEW CATLG CATLG 無視 無視 無視 無視 無視 SYSERR NEW CATLG CATLG 無視 無視 無視 NEW CATLG CATLG 無視 無視 無視 無視 無視 FILTERDDS 無視 無視 NEW DELETE DELETE 無視 無視 無視 無視 無視 無視 無視 次の表は、 RESTART 時に動的に割り振られるデータ・セットの後処理を示しています。
表 6. RESTART で動的に割り振られたデータ・セットのデータ後処理 DD 名 (ddname) CHECK DATA CHECK INDEX または CHECK LOB COPY COPY- TOCOPY LOAD MERGE- COPY REBUILD INDEX REORG INDEX REORG TABLE- SPACE UNLOAD SYSREC 無視 無視 無視 無視 OLD KEEP KEEP 無視 無視 無視 MOD CATLG CATLG MOD CATLG CATLG SYSDISC 無視 無視 無視 無視 MOD CATLG CATLG 無視 無視 無視 MOD CATLG CATLG 無視 SYSPUNCH 無視 無視 無視 無視 無視 無視 無視 無視 MOD CATLG CATLG MOD CATLG CATLG SYSCOPY 無視 無視 MOD CATLG CATLG 無視 MOD CATLG CATLG MOD CATLG CATLG 無視 無視 MOD CATLG CATLG 無視 SYSCOPY2 無視 無視 MOD CATLG CATLG 無視 MOD CATLG CATLG MOD CATLG CATLG 無視 無視 MOD CATLG CATLG 無視 SYSRCPY1 無視 無視 MOD CATLG CATLG 無視 MOD CATLG CATLG MOD CATLG CATLG 無視 無視 MOD CATLG CATLG 無視 SYSRCPY2 無視 無視 MOD CATLG CATLG 無視 MOD CATLG CATLG MOD CATLG CATLG 無視 無視 MOD CATLG CATLG 無視 SYSUT1 MOD DELETE CATLG MOD DELETE CATLG 無視 無視 MOD DELETE CATLG 無視 MOD DELETE CATLG MOD CATLG CATLG MOD DELETE CATLG 無視 SORTOUT MOD DELETE CATLG 無視 無視 無視 MOD DELETE CATLG 無視 無視 MOD DELETE CATLG MOD DELETE CATLG 無視 SYSMAP 無視 無視 無視 無視 MOD CATLG CATLG 無視 無視 無視 無視 無視 SYSERR MOD CATLG CATLG 無視 無視 無視 MOD CATLG CATLG 無視 無視 無視 無視 無視 FILTERDDS 無視 無視 NEW DELETE DELETE 無視 無視 無視 無視 無視 無視 無視 - LIMIT
- テンプレート切り替えを指定します。
- n
- この TEMPLATE を使用して許可される、最大の 1 次割り振り量を指定します。
- CYL
- シリンダー
- GB
- ギガバイト
- MB
- メガバイト
- new_template
- サイズ制限を超えた場合に使用する TEMPLATE の名前を指定する文字ストリングを 指定します。
Db2 は、以下のユーティリティーの COPYDDN または RECOVERYDDN キーワードで参照される TEMPLATE 制御ステートメントでのみ、LIMIT キーワードをサポートします。
- COPY FULL YES|NO
- COPY CONCURRENT
- COPYTOCOPY
- MERGECOPY
- LOAD
- REORG
制約事項:- DD カードへの切り替えはできません。
- LIMIT が参照するテンプレート制御ステートメントは、SYSIN または SYSTEMPL に存在 していなければならず、それ自体を参照することはできません。
- 切り替えは、割り振り当たり 1 回だけ実行可能です。 複数回の切り替えは実行できません。
- ユーティリティー PREVIEW 機能は、LIMIT キーワードを無視し、 元の TEMPLATE 制御ステートメントのみがプレビューされます。LIMIT キーワードは、 新テンプレートについては無視されます。
TIME
日付と時刻の DSN 変数の拡張に使用される時間を指定します。
デフォルトの TIME 値は、TEMPLATE_TIME サブシステム・パラメーターによって決まります。
ヒント: すべての Db2 データ共有メンバーを同じ値に設定します。- LOCAL
- DSN 変数の日付と時刻の拡張で Db2 サーバーの現地時間を使用します。
- UTC
- DSN 変数の日付と時刻の拡張で協定世界時 (UTC) を使用します。

- SPACE (primary,secondary)
- z/OS ディスク・スペース割り振りパラメーター
を 1 から 1677215 の範囲で指定します。(primary,secondary) 値を
指定すると、これらの値が Db2 が計算する値の代わりに使用されます。1 次および 2 次数量を
指定する場合は、両方の値を指定するか、両方とも省略
するかのいずれかでなければなりません。
1 次 数量に上限を設定する場合は MAXPRIME を使用します。
- CYL
- 割り振り量が指定されている場合は、それらがシリンダー数で表されていて、 割り振りがシリンダー単位で行われることを指定します。SPACE CYL が (primary,secondary) なしで 指定されている場合、Db2 が計算した量がシリンダー単位で割り振られます。 その際、バイト変換のために 3390 装置の容量が使用されます。TRK および MB を省略した場合のデフォルトは、CYL です。
- TRK
- 割り振り量が指定されている場合は、それらがトラック数で表されていて、 割り振りがトラック単位で行われることを指定します。SPACE TRK が (primary,secondary) なしで 指定されている場合、Db2 が計算した量がトラック単位で割り振られます。 その際、バイト変換のために 3390 装置の容量が使用されます。
- MB
- 割り振り量が指定されている場合は、それらがメガバイト数で表されていて、 割り振りがレコード単位で行われることを指定します。1 メガバイトは 1 048 576 バイトです。SPACE MB を指定した場合は、指定されている (primary,secondary) の量または Db2 が計算した量がトラック単位またはシリンダー単位で割り振られます。 1 次割り振りまたは 2 次割り振りの量が 20 MB より大きいデータ・セットは、 シリンダー単位で割り振られます。小さいデータ・セットは、 トラック単位で割り振られます。3390 装置の能力が TRK と CYL の変換に 使用されます。
- PCTPRIME integer
- 必要スペース見積もり量の何パーセントを 1 次量として
取得するのかを指定します。
デフォルト値は 100 です。
ラージ・オブジェクトについてこの値に上限を設定する場合は、MAXPRIME を使用してください。
- MAXPRIME integer
- 許容される最大 1 次スペース割り振り量をシリンダー数 (CYL) で 指定します。この値は、primary スペース値と PCTPRIME 計算を制限し、各 2 次割り振りのサイズも制限します。
- NBRSECND integer
- 2 次スペース割り振りの分割を指定し
ます。1 次スペースの割り振り後、見積もり必要量に等しいスペース量が、
指定された 2 次割り振り回数に分割されます。
個々のユーティリティーは、ローカライズによるスペース見積もりの不確実さを補うために、より大きな 2 次エクステントを要求することがあります。
整数値は、1 から 10 の範囲にある必要があります。 デフォルト値は 10 です。
- DIR integer
- 256 バイト長のレコード数を指定します。このレコード数が新規の区分データ・セットのディレクトリー用に割り振られます。このオペランドの指定が必要なのは、新規の区分データ・セットを割り振る場合です。
BLOBF、CLOBF、または DBCLOBF を指定した UNLOAD で このテンプレートを使用しようとしていて、DSNTYPE に LIBRARY または PDS と指定されているが、DIR が指定されていない 場合は、Db2 が見積もりレコード数を 20 で除算 して、割り振る 256 バイト長レコード数を計算します。
- DSNTYPE
割り振るデータ・セットのタイプを指定します。
- LIBRARY
- 拡張区分データ・セット (PDSE) を割り振ることを指定します。
- PDS
- 区分データ・セット (PDS) が割り振り対象であることを指定します。
- HFS
- 階層ファイル・システム (HFS) ファイルが割り振り対象であることを示します。
- NULL
- NULL ファイルを指定します。UNLOAD CLOBF、BLOBF、または DBCLOBF 指定でテンプレートに対してこの NULL 値を使って、NULL の LOB 値をアンロードします。この場合、アンロード・データ・セットには NULL ファイル名が入ります。
BASIC
基本フォーマット・データ・セットを指定します。65535 までのトラックを割り振ることができます。
LARGE
ラージ・フォーマット・データ・セットを指定します。65535 よりも多くのトラックを割り振ることができます。
EXTREQ
拡張フォーマット・データ・セットが必須であることを指定します。
EXTPREF
拡張フォーマット・データ・セットが優先であることを指定します。
DSNTYPE が省略されている場合、データ・セットのタイプは、他のデータ・セット属性、データ・セットのデータ・クラス、またはインストール・デフォルトで決まります。
- EATTR
- データ・セットが拡張属性をサポートできることを指定します。
- STACK
- 出力データ・セットを、同じテープ・ボリューム上に連続してスタックするかどうかを指定します。
- NO
- 出力データ・セットをテープ上に連続してスタックしないことを指定します。
- YES
- 類似の出力データ・セットを 1 つの論理テープ・ボリューム上に 連続ファイルとしてスタックすることを指定します。1 つの論理テープ・ボリュームは、マルチボリュームの集合体から構成され ます。1 回のユーティリティー実行の中では、出力データ・セットは同じ用途タイプの 1 つの論理テープ・ボリューム上にスタックされます。 例えば、LOCAL PRIMARY イメージ・コピーは、LOCAL BACKUP イメージ・コピーとは別々にスタックされます。
- TRTCH
- 改良データ記録機能を備えた磁気テープ・ドライブのトラック記録技法を指定します。
- NONE
- TRTCH 指定を動的割り振りから除去することを指定します。
- COMP
- データを圧縮形式で書き込むことを指定します。
- NOCOMP
- データを標準形式で書き込むことを指定します。
- PATH
- z/OS UNIX ファイル・パス名を指定します。Unix System Services (USS) パイプ、HFS ファイル、または zFS ファイルの名前を指定できます。
制約事項:
- テンプレートの PATH を指定した場合、そのテンプレートを使用するユーティリティーを再始動することはできません。
- PATH にテンプレートを使用できるのは、LOAD ユーティリティーの 入力データ・セット (INDDN オプションで指定) および UNLOAD ユーティリティー の出力データ・セット (UNLDDN オプションで指定) のみです。 LOAD ユーティリティーおよび REORG ユーティリティーの DISCARDDN データ・セット に、これらのテンプレートを使用することはできません。
PATH を指定するときは、以下の要件に従ってください。
- パス名を SBCS EBCDIC 形式で指定します。
- 255 バイトより長いパス名を指定しないでください。
- ブランクを含むパス名は、単一引用符で囲みます。
- PATH を指定し、FILEDATA(RECORD) は指定しない場合は、LRECL および RECFM に値を指定します。
- FILEDATA
- PATH オプションに指定する z/OS UNIX ファイルのコンテンツ・タイプを指定します。有効な値は、TEXT、BINARY、および RECORD です。RECORD は、ファイルがバイナリー・データとテキスト・データの両方を含むことを示します。
デフォルト値は RECORD です。
- PATHOPTS
- PATH オプションに指定する z/OS UNIX ファイルのアクセス権限および状況を指定します。
PATHOPTS には、以下の1 つ以上の z/OS オプションを指定できます。
- ORDONLY
- OCREAT
- OWRONLY
- ONONBLOCK
これらのオプションについて 詳しくは、「PATHOPTS パラメーター」を参照してください。
ORDONLY のデフォルトは、LOAD です。 UNLOAD のデフォルトは OCREAT、OWRONLY です。
- PATHMODE
- PATH オプションに指定する HFS ファイルのファイル・モードを指定します。
PATHMODE には、以下の1 つ以上の z/OS オプションを指定できます。
- SIRUSR
- SIWUSR
- SIXUSR
- SIRWXU
- SIRGRP
- SIWGRP
- SIXGRP
- SIRWXG
- SIROTH
- SIWOTH
- SIXOTH
- SIRWXO
これらのオプションについて 詳しくは、「PATHMODE パラメーター」を参照してください。
デフォルト値は SIRUSR です。
- PATHDISP
- PATH オプションに指定する z/OS UNIX ファイルのファイル属性指定を指定します。PATHDISP には、パラメーターを 2 つ指定する必要があります。
- 最初のパラメーターには、ジョブが正常に終了したときに、ファイルを保持 するかそれとも削除するかを指定します。
- 2 番目のパラメーターには、ジョブが異常終了したときに、ファイルを保持 するかそれとも削除するかを指定します。
それぞれのパラメーターの有効な値は、KEEP または DELETE です。
デフォルト値は、KEEP、KEEP です。