COPYTOCOPY 制御ステートメントのサンプル

以下の制御ステートメントのサンプルを、独自の COPYTOCOPY 制御ステートメントを作成するためのモデルとして使用できます。

例 1: ローカル・バックアップ・コピーを作成する

次の制御ステートメントの指定によって、COPYTOCOPY ユーティリティーは、最新の フル・イメージ・コピーまたは増分イメージ・コピーのいずれか新しい方の ローカル・バックアップ・コピーを作成し ます。COPYDDN オプションは、ローカル・サイトのバックアップ・イメージ・コピー用のデータ・セット が COPY2 DD ステートメントによって定義されることを指定しています。 通常は COPYDDN オプションの最初のパラメーターである、ローカル・サイトの 1 次イメージ・コピー のデータ・セットが指定されていないため、COPYTOCOPY はこのコピーは既に存在しているものと 見なします。 存在しない場合、Db2® はエラー・メッセージを出して、 ジョブを終了させます。

//STEP1    EXEC DSNUPROC,UID='DH109001.COPY1',
//         UTPROC='',
//         SYSTEM='DSN'
//COPY2    DD DSN=DH109001.C2C01.STEP2.COPY2,DISP=(MOD,CATLG,CATLG),
//         SPACE=(1000,(20,20),,,ROUND)
//SYSIN    DD *
   COPYTOCOPY TABLESPACE DBA90101.TLA9011A COPYDDN(,COPY2)
//

例 2: 最新のコピーをコピーする

次の制御ステートメントの指定に よって、COPYTOCOPY は、表スペース DBA90102.TPA9012C のローカル・サイトのバックアップ・コピー、 リカバリー・サイトの 1 次コピー、およびリカバリー・サイトのバックアップ・コピー を作成します。また、COPYDDN および RECOVERYDDN オプションは、これらのコピーが書き込まれるデータ・セット も示しています。 例えば、リカバリー・サイトの 1 次コピーは、COPY3 データ・セットに書き込まれ ます。FROMLASTCOPY オプションは、最新のフル・イメージ・コピー または増分イメージ・コピーを入力コピー・データ・セットとして使用することを指定します。 このオプションがデフォルトであるため、指定する必要はありません。

COPYTOCOPY TABLESPACE DBA90102.TPA9012C
      FROMLASTCOPY COPYDDN(,COPY2)
      RECOVERYDDN(COPY3,COPY4)

例 3: 最新のフル・イメージ・コピーをコピーする

次の制御ステートメントは、 COPYTOCOPY が表スペース DBA90201.TPA9021C についてリカバリー・サイトの 1 次コピーとバックアップ・コピーを 作成するよう指定しています。FROMLASTFULLCOPY オプションは、最新のフル・イメージ・コピー を入力コピー・データ・セットとして使用することを指定します。

COPYTOCOPY TABLESPACE DBA90201.TPA9021C
      FROMLASTFULLCOPY
      RECOVERYDDN(COPY3,COPY4)

例 4: 入力コピー・データ・セットを指定する

次の 制御ステートメントは、COPYTOCOPY がデータ・セット DH109003.COPY1.STEP1.COPY3 から、 リカバリー・サイトの 1 次コピーとリカバリー・サイトのバックアップ・コピーを 作成するよう指定しています。入力データ・セットは FROMCOPY オプションによって指定されています。 出力データ・セット (COPY2、COPY3、および COPY4) は、COPYDDN および RECOVERYDDN オプション によって指定されています。

COPYTOCOPY TABLESPACE DBA90301.TPA9031C
      FROMCOPY DH109003.COPY1.STEP1.COPY3
      COPYDDN(,COPY2)
      RECOVERYDDN(COPY3,COPY4)

例 5: カタログされたイメージ・コピー・データ・セットを指定する

次の制御ステートメント は、COPYTOCOPY が DH109003.COPY1.STEP1.COPY4 という名前のカタログ式データ・セットから、ローカル・サイトの バックアップ・コピーを作成するよう指定しています。このデータ・セットは、FROMCOPY および FROMVOLUME オプションによって示されてい ます。FROMCOPY オプションは入力データ・セット名を指定し、FROMVOLUME CATALOG オプションはその 入力データ・セットがカタログされていることを指定しています。 同じ名前を持つ他のデータ・セットからデータ・セットを識別する ために、FROMVOLUME オプションを使用します。

COPYTOCOPY TABLESPACE DBA90302.TLA9032A
      FROMCOPY DH109003.COPY1.STEP1.COPY4
      FROMVOLUME CATALOG
      COPYDDN(,COPY2)

例 6: カタログされていないイメージ・コピー・データ・セットを指定する

次の制御ステートメント は、COPYTOCOPY がローカル・サイトのバックアップ・コピー、リカバリー・サイトの 1 次コピー、および リカバリー・サイトのバックアップ・コピーを、カタログされていないデータ・セット JUKQU2BP.COPY1.STEP1.TP01 から作成することを 指定しています。FROMCOPY オプションはこの入力データ・セット名を示しており、FROMVOLUME オプションはその 入力データ・セットのボリューム (SCR03) を示しています。 同じ名前を持つ他のデータ・セットからデータ・セットを識別する ために、FROMVOLUME オプションを使用します。 COPYDDN オプションは、ローカル・サイトのバックアップ・コピーのデータ・セット を示しています。 このデータ・セットは、C2C1_T1 テンプレートの指定に従って動的に割り振られます。 このテンプレートは、先行する TEMPLATE 制御ステートメントの 1 つで定義されてい ます。RECOVERYDDN オプションは、リカバリー・サイトのコピーのためのデータ・セットを示しています。 これらのデータ・セットは、C2C1_T2 および C2C1_T3 テンプレートの指定に従って動的に割り振られます。 これらのテンプレートは、先行する TEMPLATE 制御ステートメントで定義されてい ます。

図 1. カタログされていないイメージ・コピー・データ・セットの指定例
//STEP1    EXEC DSNUPROC,UID='JUKQU2BP.C2C1',
//         UTPROC='',
//         SYSTEM='SSTR'
//SYSIN    DD *

   TEMPLATE C2C1_T1
            DSN(JUKQU2BP.C2C1.LB.&SN.)
            DISP(NEW,CATLG,CATLG)
            UNIT(SYSDA)

   TEMPLATE C2C1_T2
            DSN(JUKQU2BP.C2C1.RP.&SN.)
            DISP(NEW,CATLG,CATLG)
            UNIT(SYSDA)

   TEMPLATE C2C1_T3
            DSN(JUKQU2BP.C2C1.RB.&SN.)
            DISP(NEW,CATLG,CATLG)
            UNIT(SYSDA)

   COPYTOCOPY TABLESPACE DBKQBP01.TPKQBP01
              FROMCOPY JUKQU2BP.COPY1.STEP1.TP01
              FROMVOLUME SCR03
              COPYDDN(,C2C1_T1)
              RECOVERYDDN(C2C1_T2,C2C1_T3)
/*  

例 7: オブジェクトのリストを処理する

次の 制御ステートメントの指定によって、COPYTOCOPY は、DSNUM オプション (パーティション 2、3、 および 4) によって指定された、表スペース DBA90402.TPA9042C の 3 つのパーティションのローカル・サイト・ バックアップ・コピーを作成します。COPYTOCOPY は、FROMLASTFULLCOPY、FROMLASTCOPY、およ び FROMLASTINCRCOPY オプションで示している ように、以下の入力コピー・データ・セットを使用します。

  • パーティション 2 の最新のフル・イメージ・コピー
  • パーティション 3 の最新のフル・イメージ・コピーまたは増分イメージ・コピーのいずれか新しい方
  • パーティション 4 の最新の増分イメージ・コピー

それぞれのパーティションの COPYDDN オプションは、出力データ・セット (COPY2、COPY3、および COPY4) を 示しています。

COPYTOCOPY
      TABLESPACE DBA90402.TPA9042C DSNUM 2
          FROMLASTFULLCOPY COPYDDN(,COPY2)
      TABLESPACE DBA90402.TPA9042C DSNUM 3
          FROMLASTCOPY COPYDDN(,COPY3)
      TABLESPACE DBA90402.TPA9042C DSNUM 4
          FROMLASTINCRCOPY COPYDDN(,COPY4)

例 8: LISTDEF および TEMPLATE 切り替えを使用する

次の COPYTOCOPY 制御ステートメント は、このユーティリティーが、LISTDEF 制御ステートメントによって定義された CPY1 リストに 含まれるオブジェクトをコピーする指定を行っています。これらのコピーは、TEMPLATE 制御ステートメントに 定義されている T3 テンプレートで定義されるデータ・セットに書き込まれます。さらに、T3 テンプレート には LIMIT キーワードが定義されているので、指定された限界値 5 MB よりも出力データ・セットのサイズが大きい場合は、 テンプレートは T3 から T4 に切り替わります。このテンプレートは、動的に割り振られる出力データ・セットの命名規則を定義しています。

LISTDEF ステートメントの前の OPTIONS PREVIEW ステートメントは、CPY1 リストの内容 を出力に組み込むために使用されています。長いリストの場合は、このステートメントの使用は お勧めできません。その理由は、これが原因で出力が非常に長くなる恐れがあるため です。OPTIONS OFF ステートメントは、その後の TEMPLATE および COPYTOCOPY ジョブが 正常に実行するように、PREVIEW モードの処理を終了させます。

OPTIONS PREVIEW
   LISTDEF CPY1 INCLUDE TABLESPACES TABLESPACE DBA906*.T*A906*
           INCLUDE INDEXSPACES COPY YES INDEXSPACE ADMF001.I?A906*
   OPTIONS OFF
	TEMPLATE T4 UNIT(3B0)
						DSN(T4.&SN..T&TI..COPY&IC.&LOCREM.)
   TEMPLATE T3 UNIT(SYSDA) SPACE CYL
						DSN(T3.&SN..T&TI..COPY&IC.&LOCREM.)
   					LIMIT(5 MB,T4)
	COPYTOCOPY LIST CPY1 COPYDDN(T3,T3)

例 8: LISTDEF および TEMPLATE を CLONE オプションと一緒に使用する

次の COPYTOCOPY 制御ステートメント は、このユーティリティーが、LISTDEF 制御ステートメントによって定義された C2C1_LIST リストに 含まれるオブジェクトをコピーする指定を行っています。CLONE オプションは、 COPYTOCOPY がクローン・オブジェクトに対して作成されたイメージ・コピー・データ・セットのみを 処理することを指示します。

LISTDEF C2C1_LIST                                        
          INCLUDE TABLESPACES TABLESPACE DBKQBS01.TPKQBS01 
          INCLUDE INDEXSPACES INDEXSPACE DBKQBS01.IPKQBS11 
          INCLUDE INDEXSPACES INDEXSPACE DBKQBS01.IXKQBS12 
          INCLUDE TABLESPACES TABLESPACE DBKQBS02.TSKQBS02 
          INCLUDE INDEXSPACES INDEXSPACE DBKQBS02.IXKQBS21 
          INCLUDE INDEXSPACES INDEXSPACE DBKQBS02.IXKQBS22 
                                                           
  TEMPLATE C2C1_T1                                         
           DSN(JUKQU2BS.C2C1.LB.&SN.)                      
           DISP(NEW,CATLG,CATLG)                           
           UNIT(SYSDA)                                     
                                                           
  TEMPLATE C2C1_T2                                         
           DSN(JUKQU2BS.C2C1.RP.&SN.)                      
           DISP(NEW,CATLG,CATLG)                           
           UNIT(SYSDA)                                     
                                                           
  TEMPLATE C2C1_T3                                         
           DSN(JUKQU2BS.C2C1.RB.&SN.)                      
           DISP(NEW,CATLG,CATLG)                           
           UNIT(SYSDA)                                     
                                                           
  COPYTOCOPY LIST C2C1_LIST                                
             FROMLASTFULLCOPY                              
             COPYDDN(,C2C1_T1)                             
             RECOVERYDDN(C2C1_T2,C2C1_T3)                  
             CLONE