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-----'   

注:
  1. INDEXSPACE が優先指定。
  2. パーティションを分けていない索引では無効。

from-copy-spec:

   .-FROMLASTCOPY----------------------------------------------------.   
>>-+-----------------------------------------------------------------+-><
   +-FROMLASTFULLCOPY------------------------------------------------+   
   +-FROMLASTINCRCOPY------------------------------------------------+   
   |                   (1)                                           |   
   +-FROMLASTFLASHCOPY-----------------------------------------------+   
   |          (2)                                                    |   
   '-FROMCOPY------dsn--+------------------------------------------+-'   
                        '-FROMVOLUME--+-CATALOG------------------+-'     
                                      '-volser--+--------------+-'       
                                                '-FROMSEQNO--n-'         

注:
  1. INDEXSPACE または INDEX キーワードと一緒の場合は無効です。
  2. LIST キーワードでは無効。

data-set-spec:

                        (1)                                                                  (2)   
>>-+-COPYDDN(-+-ddname1------+----------+-+-)-+------------------------------------------+-+-----><
   |          |              '-,ddname2-' |   '-RECOVERYDDN(-+-ddname3--+----------+-+-)-' |       
   |          '-,ddname2------------------'                  |          '-,ddname4-' |     |       
   |                                                         '-,ddname4--------------'     |       
   '-RECOVERYDDN(-+-ddname3--+----------+-+-)----------------------------------------------'       
                  |          '-,ddname4-' |                                                        
                  '-,ddname4--------------'                                                        

注:
  1. リカバリー・サイトのいずれかのコピー からローカル・サイトの 1 次コピーを作成する場合は、このオプションを使用します。
  2. 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 を使用するのでは不十分です。