COPYTOCOPY 制御ステートメントの構文とオプション
COPYTOCOPY ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。
制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。
構文図
>>-COPYTOCOPY---------------------------------------------------> >--+-LIST--listdef-name--| from-copy-spec |--| data-set-spec |----------+--> | .----------------------------------------------------------------. | | V | | '---+-| ts-num-spec |-----+--| from-copy-spec |--| data-set-spec |-+-' '-| index-name-spec |-' >--+-------+--------------------------------------------------->< '-CLONE-'
ts-num-spec:
>>-TABLESPACE--+----------------+--table-space-name-------------> '-database-name.-' .-DSNUM--ALL-----. >--+----------------+------------------------------------------>< '-DSNUM--integer-'
index-name-spec:
(1) >>-+-INDEXSPACE------+----------------+--index-space-name-+-----> | '-database-name.-' | '-INDEX--+-------------+--index-name-------------------' '-creator-id.-' .-DSNUM--ALL---------. >--+--------------------+-------------------------------------->< | (2) | '-DSNUM--integer-----'
- INDEXSPACE が優先指定。
- パーティションを分けていない索引では無効。
from-copy-spec:
.-FROMLASTCOPY----------------------------------------------------. >>-+-----------------------------------------------------------------+->< +-FROMLASTFULLCOPY------------------------------------------------+ +-FROMLASTINCRCOPY------------------------------------------------+ | (1) | +-FROMLASTFLASHCOPY-----------------------------------------------+ | (2) | '-FROMCOPY------dsn--+------------------------------------------+-' '-FROMVOLUME--+-CATALOG------------------+-' '-volser--+--------------+-' '-FROMSEQNO--n-'
- INDEXSPACE または INDEX キーワードと一緒の場合は無効です。
- LIST キーワードでは無効。
data-set-spec:
(1) (2) >>-+-COPYDDN(-+-ddname1------+----------+-+-)-+------------------------------------------+-+----->< | | '-,ddname2-' | '-RECOVERYDDN(-+-ddname3--+----------+-+-)-' | | '-,ddname2------------------' | '-,ddname4-' | | | '-,ddname4--------------' | '-RECOVERYDDN(-+-ddname3--+----------+-+-)----------------------------------------------' | '-,ddname4-' | '-,ddname4--------------'
- リカバリー・サイトのいずれかのコピー からローカル・サイトの 1 次コピーを作成する場合は、このオプションを使用します。
- COPYDDN および RECOVERYDDN オプションの両方の組み合わせで、3 つまでの DD 名が指定可能です。
オプションの説明
- LIST listdef-name
- 前に定義された LISTDEF リスト名の名前を指定し
ます。このユーティリティーでは、それぞれの COPYTOCOPY 制御ステートメントごとに LIST キーワードを 1 つ
使用することができます。INDEX または TABLESPACE キーワードと共に LIST を指定しないで
ください。Db2® は、リスト全体に対して COPYTOCOPY を一度だけ呼び出します。
このユーティリティーでは、32,000 を超えるオブジェクトを指定するリストはサポートされません。PARTLEVEL キーワード・カウントにより個別のオブジェクトとして含まれる表スペースまたは索引スペースのパーティション。
このユーティリティーは、CLONE キーワードが指定されている場合のみクローン・データを処理します。LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。
パーティションまたは パーティション範囲をリストに指定できます。
- TABLESPACE
- コピーする表スペース (およびオプションで、それが属しているデータベース) を指定します。
database-name は、表スペースが属しているデータベースの名前です。デフォルト値
は DSNDB04 です。
table-space-name は、コピーする表スペースの名前です。
- INDEXSPACE database-name.index-space-name
- コピーする索引スペースの修飾名を指定します。この修飾名は、SYSIBM.SYSINDEXES 表から
得られます。索引スペースは COPY YES 属性で定義してください。
database-name は、オプションで、索引スペースが属しているデータベースの名前を指定します。デフォルト値 は DSNDB04 です。
index-space-name は、コピーする索引スペースの名前を指定します。
- INDEX creator-id.index-name
- コピーする索引の名前を指定します。名前にブランクが含まれている場合は、索引名を引用符で囲みます。
creator-id は、オプションで、索引の作成者を指定します。デフォルト値は、 ユーティリティーのユーザー ID です。
index-name は、コピーする索引の名前を指定します。
- DSNUM
- コピーされる表スペースまたは索引スペース内のパーティションあるいはデータ・セットを示します。
キーワード ALL は、表スペースまたは索引スペース全体をコピーすることを指定します。
非パーティション化索引に対して DSNUM を指定することはできません。
- ALL
- 表スペース全体または索引スペース全体をコピーすることを指定します。パーティション化されていない副次索引の場合は、ALL を使用する必要があります。
- 整数
- コピーされるパーティションまたはデータ・セットの番号です。
パーティション化されていない副次索引の場合、整数値は無効です。
パーティション化表スペースまたは索引スペースの場合、整数はその物理パーティション
番号です。最大は 4096 です。
非パーティション化表スペースの場合、VSAM カタログにカタログされた データ・セット名の終わりにある整数です。データ・セット名の形式は以下のとおりです。
このフォーマットの意味は、以下のとおりです。catname.DSNDBx.dbname.spacename.y000Z.Annn- catname
- VSAM カタログ名または別名
- x
- C または D
- dbname
- データベース名
- spacename
- 表スペース名または索引スペース名
- y
- I または J
- z
- 1 または 2
- nnn
- データ・セット整数
DSNUM(ALL) を指定するか、デフォルト値を使用すると、COPYTOCOPY は すべての表スペース・レベルまたは索引スペース・レベルで作成された入力イメージ・コピーを 探します。
- FROMLASTCOPY
- 表スペースまたは索引スペース用に作成された最新のイメージ・コピー を COPYTOCOPY ユーティリティーへの入力とすることを指定します。これは SYSIBM.SYSCOPY から 取り出されたフル・イメージ・コピーでも増分コピーでも構いません。
- FROMLASTFULLCOPY
- オブジェクト用に作成された最新のフル・イメージ・コピーを COPYTOCOPY ジョブへの 入力とすることを指定します。
- FROMLASTINCRCOPY
- オブジェクト用に作成された最新の増分イメージ・コピーを COPYTOCOPY ジョブへの
入力とすることを指定します。
FROMLASTINCRCOPY は INDEXSPACE または INDEX キーワードでは無効 です。FROMLASTINCRCOPY を INDEXSPACE または INDEX に対して指定すると、COPYTOCOPY は 最後に作成されたフル・コピーがあれば、それを使用します。
FROMLASTFLASHCOPY
オブジェクト用に作成された最新の FlashCopy イメージ・コピーを COPYTOCOPY ジョブへの入力とすることを指定します。
- FROMCOPY dsn
- COPYTOCOPY ジョブに対する入力として、特定のイメージ・コピー・データ・セット (dsn) を
指定します。このオプションは LIST には無効です。
イメージ・コピー・データ・セットが世代別データ・セットの場合は、 絶対世代番号とバージョン番号を含む完全修飾のデータ・セット名を指定します。 イメージ・コピー・データ・セットが世代別データ・セットでなく、しかも 同じデータ・セット名のイメージ・コピー・データ・セットが複数ある 場合は、データ・セットを正確に示すために FROMVOLUME オプションを使用してください。
- FROMVOLUME
- イメージ・コピー・データ・セットを示します。
- CATALOG
- データ・セットがカタログされていることを示します。
このオプションは、カタログ式データ・セットとして作成されたイメージ・コピーの場合に
のみ使用します。(そのボリューム通し番号は、SYSIBM.SYSCOPY に記録されません。)
COPYTOCOPY は、実行時に SYSIBM.SYSCOPY カタログ表を参照し ます。FROMVOLUME CATALOG を使用する場合は、データ・セットはカタログされている必要があります。 データ・セットを、作成後、カタログから除去する場合は、 再度、そのデータ・セットをカタログして、SYSIBM.SYSCOPY に現れる このコピーのレコードとの整合性を維持する必要があります。
- vol-ser
- データ・セットを、その最初のボリュームの、英数字ボリューム通し番号 ID で示します。 このオプションは、非カタログ式データ・セットとして作成された イメージ・コピーの場合にのみ使用します。1 つのデータ・セットが 複数のテープ・ボリュームに保管されている場合にそのデータ・セットを 位置指定するには、SYSCOPY レコードの最初の vol-ser を指定します。 個々のボリューム通し番号に先行ゼロがある場合は、通し番号を単一引用符で囲む必要があります。
- FROMSEQNO n
- イメージ・コピー・データ・セットを、そのファイル・シーケンス番号で示します。 n はファイル・シーケンス番号です。
- COPYDDN (ddname1,ddname2)
- ローカル・サイトのイメージ・コピーの 1 次 (ddname1) および
バックアップ (ddname2) コピー・データ・セット
の DD 名 (ddname) または TEMPLATE 名を指定し
ます。ddname2 が単独で
指定されている場合、COPYTOCOPY はローカル・サイト 1 次イメージ・コピー
が存在すると予期します。存在しない場合、エラー・メッセージ DSNU1401 が発行され、
オブジェクトの処理は終了します。推奨事項: イメージ・コピー・データ・セットをすべてカタログしてください。
重複したイメージ・コピー・データ・セットを持つことはできません。 DD ステートメントが 示している非カタログ式データ・セットが、 既に SYSIBM.SYSCOPY カタログ表に記録されているデータ・セットと名前、ボリューム通し番号、 およびファイル・シーケンス番号が同じである場合は、COPYTOCOPY は メッセージを出して、イメージ・コピーは作成しません。 名前だけが同じカタログ式データ・セットを DD ステートメントが示している場合、コピーは作成されません。 カタログ式イメージ・コピー・データ・セットの場合、正常終了の後処理に対して DD ステートメントで CATLG を指定する必要があります (例えば、DISP=(MOD,CATLG,CATLG))。SYSCOPY 項目の DSVOLSER フィールド はブランクです。
イメージ・コピー・データ・セットをテープ・ボリュームに入れる場合は、DD ステートメントで VOL=SER パラメーターを指定する必要があります。
COPYDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。
- RECOVERYDDN (ddname3,ddname4)
- リカバリー・サイトのイメージ・コピーの 1 次 (ddname3) および
バックアップ (ddname4) コピー・データ・セット
の DD 名 (ddname) または TEMPLATE 名を指定し
ます。ddname4 が単独で
指定されている場合、COPYTOCOPY はリカバリー・サイト 1 次イメージ・コピー
が存在すると予期します。このイメージ・コピーが存在しない場合、エラー・メッセージ DSNU1401 が
発行され、オブジェクトの処理は終了します。
重複したイメージ・コピー・データ・セットを持つことはできません。 RECOVERYDDN には、COPYDDN の場合と同じ規則が適用されます。
RECOVERYDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。
- CLONE
- COPYTOCOPY がクローン表またはクローン表の索引に対して作成された、 イメージ・コピー・データ・セットのみを処理することを指示します。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。 LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。