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

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

場合によっては、COPY ユーティリティー・ジョブを複数回実行することがあります。 イメージ・コピー・データ・セットの重複を避けるため、以下の例では DSN 修飾子を使用しています。

例 1: フル・イメージ・コピーを作成する

次の制御ステートメントは、COPY ユーティリティーが、表スペース DSN8D11A.DSN8S11E の フル・イメージ・コピーを作成することを指定しています。 このコピーは、JCL の SYSCOPY DD ステートメントで定義されたデータ・セットに書き込まれ ます。SYSCOPY がデフォルトです。

//STEP1    EXEC DSNUPROC,UID='IUJMU111.COPYTS',
//         UTPROC='',
//         SYSTEM='DSN'
//SYSCOPY  DD DSN=COPY001F.IFDY01,UNIT=SYSDA,VOL=SER=CPY01I,
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)
//SYSIN DD *
COPY TABLESPACE DSN8D11A.DSN8S11E
/*

JCL でデータ・セットを定義する代わりに、テンプレートを使用することができます。 次の例では、前記のジョブはテンプレートを使用するように変更されています。 この例では、テンプレートの名前は LOCALDDN です。LOCALDDN テンプレートは、COPY ステートメント の COPYDDN オプションで示されています。

//STEP1    EXEC DSNUPROC,UID='IUJMU111.COPYTS',
//         UTPROC='',
//         SYSTEM='DSN'
//SYSIN DD *
TEMPLATE LOCALDDN UNIT SYSDA DSN(COPY001F.IFDY01)    
          SPACE(15,1) CYL DISP(NEW,CATLG,CATLG)       
 COPY TABLESPACE DSN8D81A.DSN8S81E COPYDDN(LOCALDDN)                                                                                  
/*
推奨事項: 可能であれば、テンプレートを使用してデータ・セットを割り振る ようにしてください。

例 2: ローカル・サイトおよびリカバリー・サイトのフル・イメージ・コピーを作成する

以下の COPY 制御ステートメントは、COPY が、ローカル・サイトおよびリカバリー・サイトの両方で、 表スペース DSN8D11P.DSN8S11C の 1 次およびバックアップのフル・イメージ・コピーを作成することを 指定しています。COPYDDN オプションは、ローカル・サイトの出力データ・セットを 指定し、RECOVERYDDN オプションは、リカバリー・サイトの出力データ・セットを指定してい ます。PARALLEL オプションは、2 つまでのオブジェクトが並列処理されることを示しています。

先頭にある OPTIONS ステートメントは、要求されたコピーを作成している間に COPY が何らか のエラーを検出した場合 (戻りコード 8) には、Db2® がその特定の項目を無視するように指定してい ます。COPY は、その項目をスキップして、次の項目へ移ります。 例えば、指定されたデータ・セットを COPY1 データ・セットにコピーする際にエラーを Db2 が 検出した場合、Db2 はエラーを無視してその表スペースを COPY2 データ・セットに コピーしようとします。

OPTIONS EVENT(ITEMERROR,SKIP)       
COPY TABLESPACE DSN8D81P.DSN8S81C   
   COPYDDN(COPY1,COPY2)                
   RECOVERYDDN(COPY3,COPY4)            
   PARALLEL(2) 

例 3: オブジェクトのリストのフル・イメージ・コピーを作成する

次の 制御ステートメントは、COPY が以下のオブジェクトについてローカルおよびリカバリーのフル・イメージ・コピー (両方とも 1 次およびバックアップの両方) を作成することを 指定しています。

  • 表スペース DSN8D11A.DSN8S11D およびその索引
    • DSN8B10.XDEPT1
    • DSN8B10.XDEPT2
    • DSN8B10.XDEPT3
  • 表スペース DSN8D11A.DSN8S11E およびその索引
    • DSN8710.XEMP1
    • DSN8710.XEMP2

これらのコピーは、それぞれのオブジェクトごとに、COPYDDN および RECOVERYDDN オプション によって示されるデータ・セットに書き込まれます。COPYDDN オプションは、ローカル・サイトの コピーのデータ・セットを指定し、RECOVERYDDN はリカバリー・サイトのコピーのデータ・セットを 指定します。これらのオプションの最初のパラメーターは、1 次コピーのデータ・セットを 指定し、2 番目のパラメーターはバックアップ・コピーのデータ・セットを指定します。 例えば、リカバリー・サイトの表スペース DSN8D81A.DSN8S81D の 1 次コピーは、COPY3 DD ステートメントで示されるデータ・セットに書き込まれます。

PARALLEL(4) は、これらのオブジェクトの 4 つまでが並列処理できることを示しています。 あるオブジェクトの COPY ジョブが完了すると、リスト上の次のオブジェクトの処理が 並列に開始され、これはすべてのオブジェクトが処理されるまで続きます。

SHRLEVEL REFERENCE は、COPY ジョブの間は更新を許可しないことを指定します。 このオプションはデフォルトであり、イメージ・コピーのデータの整合性を確実なものにするために、 これをお勧めします。

図 1. 複数オブジェクトのフル・イメージ・コピー作成例
//STEP1    EXEC DSNUPROC,UID='IUJMU111.COPYTS',
//         UTPROC='',
//         SYSTEM='DSN'
//COPY1 DD DSN=C81A.S20001.D2003142.T155241.LP,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY2 DD DSN=C81A.S20001.D2003142.T155241.LB,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY3 DD DSN=C81A.S20001.D2003142.T155241.RP,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY4 DD DSN=C81A.S20001.D2003142.T155241.RB,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY5 DD DSN=C81A.S20002.D2003142.T155241.LP,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY6 DD DSN=C81A.S20002.D2003142.T155241.LB,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY7 DD DSN=C81A.S20002.D2003142.T155241.RP,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY8 DD DSN=C81A.S20002.D2003142.T155241.RB,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)
//COPY1 DD DSN=C81A.S20001.D2003142.T155241.LP,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY2 DD DSN=C81A.S20001.D2003142.T155241.LB,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY3 DD DSN=C81A.S20001.D2003142.T155241.RP,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY4 DD DSN=C81A.S20001.D2003142.T155241.RB,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY5 DD DSN=C81A.S20002.D2003142.T155241.LP,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)
//COPY6 DD DSN=C81A.S20002.D2003142.T155241.LB,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY7 DD DSN=C81A.S20002.D2003142.T155241.RP,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)      
//COPY8 DD DSN=C81A.S20002.D2003142.T155241.RB,          
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)
//COPY9 DD DSN=C81A.S20003.D2003142.T155241.LP,       
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY10 DD DSN=C81A.S20003.D2003142.T155241.LB,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY11 DD DSN=C81A.S20003.D2003142.T155241.RP,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY12 DD DSN=C81A.S00003.D2003142.T155241.RB,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY13 DD DSN=C81A.S00004.D2003142.T155241.LP,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY14 DD DSN=C81A.S00004.D2003142.T155241.LB,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY15 DD DSN=C81A.S00004.D2003142.T155241.RP,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)     
//COPY16 DD DSN=C81A.S00004.D2003142.T155241.RB,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY17 DD DSN=C81A.S00005.D2003142.T155241.LP,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY18 DD DSN=C81A.S00005.D2003142.T155241.LB,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY19 DD DSN=C81A.S00005.D2003142.T155241.RP,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY20 DD DSN=C81A.S00005.D2003142.T155241.RB,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY21 DD DSN=C81A.S00006.D2003142.T155241.LP,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY22 DD DSN=C81A.S00006.D2003142.T155241.LB,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY23 DD DSN=C81A.S00006.D2003142.T155241.RP,      
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)   
//COPY24 DD DSN=C81A.S00006.D2003142.T155241.RB,
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)  
//COPY25 DD DSN=C81A.S00007.D2003142.T155241.LP,     
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)  
//COPY26 DD DSN=C81A.S00007.D2003142.T155241.LB,     
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)  
//COPY27 DD DSN=C81A.S00007.D2003142.T155241.RP,     
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)  
//COPY28 DD DSN=C81A.S00007.D2003142.T155241.RB,     
//         SPACE=(CYL,(15,1)),DISP=(NEW,CATLG,CATLG)  
//SYSIN DD *                                               
 COPY
   TABLESPACE DSN8D11A.DSN8S11D
       COPYDDN (COPY1,COPY2)
       RECOVERYDDN (COPY3,COPY4)
  INDEX DSN8B10.XDEPT1
       COPYDDN (COPY5,COPY6)
       RECOVERYDDN (COPY7,COPY8)
  INDEX DSN8B10.XDEPT2
       COPYDDN (COPY9,COPY10)
       RECOVERYDDN (COPY11,COPY12)
  INDEX DSN8B10.XDEPT3
       COPYDDN (COPY13,COPY14)
       RECOVERYDDN (COPY15,COPY16)
  TABLESPACE DSN8D11A.DSN8S11E
       COPYDDN (COPY17,COPY18)
       RECOVERYDDN (COPY19,COPY20)
  INDEX DSN8B10.XEMP1
       COPYDDN (COPY21,COPY22)
       RECOVERYDDN (COPY23,COPY24)
  INDEX DSN8B10.XEMP2
       COPYDDN (COPY25,COPY26)
       RECOVERYDDN (COPY27,COPY28)
 PARALLEL(4)
 SHRLEVEL REFERENCE
/*

また、下に 示すように、この COPY ジョブがリストおよびテンプレートを使用するように指定することもできます。この例では、テンプレートの名前は T1 です。この TEMPLATE ステートメントでは、動的に割り振られるデータ・セットについては、スペース指定は何も 含まれていないことに注意してください。 代わりに、Db2 がスペース所要量を決定します。T1 テンプレートは、 COPY ステートメント内で COPYDDN および RECOVERYDDN オプションによって示されています。 リストの名前は COPYLIST です。このリストは、COPY 制御ステートメントの LIST オプションによって 示されています。

図 2. リストとテンプレートを使用した複数オブジェクトのフル・イメージ・コピー作成例
//STEP1    EXEC DSNUPROC,UID='IUJMU111.COPYTS',
//         UTPROC='',
//         SYSTEM='DSN'
//SYSIN DD *
TEMPLATE T2 UNIT(SYSDA) SPACE CYL           
  		   DSN(T2.&SN..T&TI..COPY&IC.&LOCREM.)  
TEMPLATE T1 UNIT(SYSDA) SPACE CYL           
  		   DSN(T1.&SN..T&TI..COPY&IC.&LOCREM.)
			LIMIT(5 MB,T2)                           
  LISTDEF COPYLIST                                  
         INCLUDE TABLESPACE DSN8D81A.DSN8S81D       
         INCLUDE INDEX DSN8810.XDEPT1               
         INCLUDE INDEX DSN8810.XDEPT2               
         INCLUDE INDEX DSN8810.XDEPT3               
         INCLUDE TABLESPACE DSN8D81A.DSN8S81E       
         INCLUDE INDEX DSN8810.XEMP1                
         INCLUDE INDEX DSN8810.XEMP2                
   COPY LIST COPYLIST COPYDDN(T1,T1)            
         RECOVERYDDN(T1,T1)                     
     PARALLEL(4) SHRLEVEL REFERENCE
/* 

例 4: テンプレート切り替えを使用する

以下の 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 )

TEMPLATE ステートメントの DSN オプションが、コピーの書き込まれる データ・セットの名前を示していることに注意してください。

先行する COPY ジョブのそれぞれが、表スペースおよびその索引の整合ポイントを 作成します。その後、TOLOGPOINT オプションを指定した RECOVER ユーティリティー を使用して、これらのオブジェクトをすべてリカバリーすることができます。

例 5: オブジェクトのリストのテープへのフル・イメージ・コピー作成を並列処理する

次の COPY 制御ステートメント は、COPY が、指定された表スペースとその関連した索引スペースの イメージ・コピーを並列に作成し、それらのコピーを異なる磁気テープ装置でスタックすることを指定しています。

PARALLEL 2 オプションは、2 つまでのオブジェクトが並列に処理できることを 指定します。 TAPEUNITS 2 オプションは、2 台までの磁気テープ装置が一度に動的に割り振りできることを 指定します。 それぞれのオブジェクトに対する COPYDDN オプションは、ローカル・イメージ・コピーに使用される データ・セットを指定します。 この例では、これらのデータ・セットはすべて動的に割り振られ、テンプレートによって 定義されます。 例えば、表スペース DSN8D81A.DSN8S81D は、A1 テンプレートによって定義されたデータ・セットにコピーされます。

TEMPLATE ユーティリティー制御ステートメントは、 テンプレート A1 および A2 を定義しています。

//COPY2A   EXEC DSNUPROC,SYSTEM=DSN 
//SYSIN    DD *   
           TEMPLATE A1 DSN(&DB..&SP..COPY1) UNIT CART STACK YES
           TEMPLATE A2 DSN(&DB..&SP..COPY2) UNIT CART STACK YES  
COPY PARALLEL 2 TAPEUNITS 2       
          TABLESPACE DSN8D81A.DSN8S81D COPYDDN(A1)       
          INDEXSPACE DSN8810.XDEPT COPYDDN(A1)
          TABLESPACE DSN8D81A.DSN8S81E COPYDDN(A2)       
          INDEXSPACE DSN8810.YDEPT COPYDDN(A2)

テンプレートの使用をお勧めしますが、 下の例に示すように、JCL DD ステートメントをコーディングして出力データ・セットを定義することも できます。また、この COPY 制御ステートメントでは、オブジェクトのリストが並列に処理されるように 指定していますが、そのケースでは、データ・セットは DD ステートメントで定義します。 各 DD ステートメントで、VOLUME オプションのパラメーターに注意してください。 以下のように、データ・セットが 3 つの異なる磁気テープ装置上で定義されることを、これらの値は 示しています。

  • 最初の磁気テープ装置には、DD ステートメント DD1 および DD4 で定義されたデータ・セットが 装填されます。(DD4 の場合、VOLUME オプションでは REF パラメーターの値が *.DD1 です。)
  • 2 番目の磁気テープ装置には、DD ステートメント DD2 および DD3 で定義されたデータ・セットが 装填されます。(DD3 の場合、VOLUME オプションでは REF パラメーターの値が *.DD3 です。)
  • 3 番目の磁気テープ装置には、DD ステートメント DD5 で定義されたデータ・セットが装填されます。

次の表スペースは、2 つの異なる磁気テープ装置上で並列処理されます。

  • DD1 DD ステートメントで定義された装置、および DD5 DD ステートメントで定義された装置上 の DSN8D81A.DSN8S81D。
  • DD2 DD ステートメントで定義された装置上の DSN8D81A.DSN8S81E。

次の表スペースのコピー処理は、DSN8D81A.DSN8S81D と DSN8D81A.DSN8S81E の 処理が完了するまで待つ必要があります。

  • DSN8D81A.DSN8S81E の処理終了後の DD2 DD ステートメントで定義された 装置上の DSN8D81A.DSN8S81E。
  • DSN8D81A.DSN8S81D の処理終了後の DD1 DD ステートメントで定義された 装置上の DSN8D81A.DSN8S81G。
図 3. オブジェクトのリストのフル・イメージ・コピー作成をテープ上で並列処理する例
//COPY1A   EXEC DSNUPROC,SYSTEM=DSN
//DD1 DD DSN=DB1.TS1.CLP, 
//       DISP=(NEW,CATLG,CATLG),
//       UNIT=TAPE,LABEL=(1,SL),
//       VOLUME=(,RETAIN)
//DD2 DD DSN=DB2.TS2.CLP, 
//       DISP=(NEW,CATLG,CATLG),
//       UNIT=TAPE,LABEL=(1,SL),
//       VOLUME=(,RETAIN)
//DD3 DD DSN=DB3.TS3.CLB.BACKUP,
//       DISP=(NEW,CATLG,CATLG),
//       UNIT=TAPE,LABEL=(2,SL),
//       VOLUME=(,RETAIN,REF=*.DD2)
//DD4 DD DSN=DB4.TS4.CLB.BACKUP,
//       DISP=(NEW,CATLG,CATLG),
//       UNIT=TAPE,LABEL=(2,SL),
//       VOLUME=(,RETAIN,REF=*.DD1)
//DD5 DD DSN=DB1.TS1.CLB.BACKUP,
//       DISP=(NEW,CATLG,CATLG),
//       UNIT=TAPE,LABEL=(1,SL),
//       VOLUME=(,RETAIN)
 COPY PARALLEL 2 TAPEUNITS 3
      TABLESPACE DSN8D81A.DSN8S81D COPYDDN(DD1,DD5)
      TABLESPACE DSN8D81A.DSN8S81E COPYDDN(DD2)
      TABLESPACE DSN8D81A.DSN8S81F COPYDDN(DD3)
      TABLESPACE DSN8D81A.DSN8S81G COPYDDN(DD4)

例 6: JCL 定義とテンプレート定義の両方のデータ・セットを使用して、オブジェクトのリストをテープにコピーする

この例は、 JCL DD ステートメントとユーティリティー・テンプレートの両方を使用して、 イメージ・コピー用の 4 つのデータ・セットを定義しています。JCL は 2 つのデータ・セット (DB1.TS1.CLP と Db2.TS2.CLB.BACKUP) を 定義し、TEMPLATE ユーティリティー制御ステートメントは、動的に割り振られる 2 つの データ・セット (&DB..&SP..COPY1 と &DB..&SP..COPY2) を定義しています。

COPY 制御ステートメントの COPYDDN オプションは、指定された表スペースの ローカル側の 1 次とバックアップのイメージ・コピー用に使用されるデータ・セットを指定します。 例えば、表スペース DSN8D81A.DSN8S71D の 1 次コピーは DD1 DD ステートメントに よって定義されたデータ・セット (DB1.TS1.CLP) に書き込まれ、表スペース DSN8D81A.DSN8S71E の 1 次コピー は A1 テンプレートによって定義されたデータ・セット (&DB..&SP..COPY1) に書き込まれます。

この COPY ジョブに割り振られた 4 台の磁気テープ装置については、2 台の 磁気テープ装置は JCL が割り振り、あとの 2 台の磁気テープ装置は動的に割り振られること を COPY ステートメントの TAPEUNITS 2 オプションが示してい ます。TAPEUNITS オプションは、TEMPLATE ステートメントによって動的に割り振られる磁気テープ装置 にのみ適用されることに注意してください。

推奨事項: この例ではテンプレートと DD ステートメントの両方を使用する方法を示していますが、 できればテンプレートのみを使用してください。
図 4. JCL 定義とテンプレート定義のデータ・セットを使用して、オブジェクトのリストを磁気テープにコピーする例
 
//COPY1D   EXEC DSNUPROC,SYSTEM=DSN
//DD1 DD DSN=DB1.TS1.CLP,
//       DISP=(,CATLG),
//       UNIT=3490,LABEL=(1,SL)
//       VOLUME=(,RETAIN)
//DD2 DD DSN=DB2.TS2.CLB.BACKUP,
//       DISP=(,CATLG),
//       UNIT=3490,LABEL=(2,SL)
//       VOLUME=(,RETAIN)
//SYSIN    DD *
  TEMPLATE A1 DSN(&DB..&SN..COPY1) UNIT CART STACK YES
  TEMPLATE A2 DSN(&DB..&SN..COPY2) UNIT CART STACK YES
  COPY PARALLEL 2 TAPEUNITS 2
       TABLESPACE DSN8D81A.DSN8S81D COPYDDN(DD1,DD2)
       TABLESPACE DSN8D81A.DSN8S81E COPYDDN(A1,A2)
               

例 7: LISTDEF を使用して、テープに並列にコピーするオブジェクトのリストを定義する

次の例 は、LISTDEF ユーティリティーを使用して、異なるテープ・ソースに並行コピーする オブジェクトのリストを定義しています。 COPY 制御ステートメントは、PAYROLL リストに含まれる表 スペースをコピーすることを指定します。(PAYROLL リストは、LISTDEF 制御ステートメントによって 定義されます。) TEMPLATE 制御ステートメントは、2 つの出力データ・セットを定義します。1 つは、ローカル の 1 次コピー用 (&DB..&COPY..LOCAL) であり、もう 1 つは、 リカバリー 1 次コピー (&DB..&COPY..REMOTE) 用です。

//COPY3A   EXEC DSNUPROC,SYSTEM=DSN
//SYSIN    DD *
           LISTDEF PAYROLL INCLUDE TABLESPACES TABLESPACE DBPAYROLL.* 
           TEMPLATE LOCAL DSN(&DB..&COPY..LOCAL) (+1) UNIT CART STACK YES 
           TEMPLATE REMOTE DSN(&DB..&COPY..REMOTE) (+1) UNIT CART STACK YES 
           COPY LIST PAYROLL PARALLEL(10) TAPEUNITS(8)
             COPYDDN(LOCAL) RECOVERYDDN(REMOTE)

上記の例で、ユーティリティーは TAPEUNITS の値 (8) を出力データ・セット数 (2) で割ることによって、 使用するテープ・ストリーム数を決めます。この例では 4 になります。 それぞれのテープ・ストリームごとに、ユーティリティーは 1 つのサブタスクをアタッチします。 オブジェクトのリストはサイズ順にソートされ、降順に処理されます。 最初に終了したサブタスクが、リスト中の次のオブジェクトを処理します。 この例では、PARALLEL(10) オプションが、並列処理されるオブジェクト数を 10 に制限しており、4 つのサブタスクをアタッチします。 それぞれのサブタスクが、リスト中のオブジェクトを 2 台の磁気テープ装置に 並列にコピーします。一方が 1 次出力データ・セット用であり、もう一方がリカバリー 出力データ・セット用です。

例 8: 更新を許可して増分コピーを作成する

次の COPY 制御ステートメントの FULL NO オプションは、COPY が、指定された任意の オブジェクト増分イメージ・コピーをとることを指定しています。 この場合、コピーされるオブジェクトは、LIST オプションで示されているように、NAME1 リストに含まれているオブジェクトです。 その前の LISTDEF ユーティリティー制御ステートメントは、NAME1 が索引スペース DSN8D81A.XEMP1 および 表スペース DSN8D81A.DSN8S81D を含むように定義しています。 コピーされるオブジェクトの 1 つは索引スペースであり、COPY は索引スペースの増分イメージ・コピーは とりませんが、このジョブは失敗にはなりません。その代わりに、COPY は索引スペースの フル・イメージ・コピーをとります。 ただし、COPY FULL NO ステートメントが、リストの一部ではない索引のみを示している場合は 、その COPY ジョブは失敗します。

すべての指定されたコピー (ローカル側 1 次コピーとバックアップ・コピー、および リモート側 1 次コピーとバックアップ・コピー) は、COPYDS テンプレートの指定に従って 動的に割り振られたデータ・セットに書き込まれます。このテンプレートは、先行する TEMPLATE ユーティリティー制御ステートメントに定義されてい ます。

次の COPY 制御ステートメントの SHRLEVEL CHANGE オプションは、COPY ジョブの際に、更新が 可能になるように指定しています。

TEMPLATE COPYDS DSN &US.2.&SN..&LR.&PB..D&DATE.                     
  LISTDEF NAME1 INCLUDE INDEXSPACE DSN8D81A.XEMP1                     
                INCLUDE TABLESPACE DSN8D81A.DSN8S81D                  
  COPY LIST NAME1 COPYDDN(COPYDS, COPYDS) RECOVERYDDN(COPYDS,COPYDS)  
  FULL NO SHRLEVEL CHANGE 

例 9: 条件付きイメージ・コピーを作成する

次の制御ステートメントの CHANGELIMIT(5) オプションは、表スペース DSN8D81P.DSN8S81C の イメージ・コピー作成に対して、以下の条件を指定しています。

  • 変更されたページの割合が 5% 以上の場合は、表スペースのフル・イメージ・コピーをとる。
  • 変更されたページの割合が 0% より大で 5% より小の場合は、表スペースの増分イメージ・コピーをとる。
  • ページが変更されなかった場合は、イメージ・コピーはとらない。
COPY TABLESPACE DSN8D11P.DSN8S11C CHANGELIMIT(5)

例 10: 表スペースのイメージ・コピー情報を報告する

次の制御ステートメントで、REPORTONLY オプションは、イメージ・コピーはとらずに、 イメージ・コピー情報の表示のみを指定しています。CHANGELIMIT(10,40) オプションは、以下の 情報を表示するように指定しています。

  • 変更されたページの割合が 40% 以上の場合、フル・イメージ・コピー作成の勧告。
  • 変更されたページの割合が 10% より大で 40% より小の場合、増分イメージ・コピー作成の勧告。
  • 変更されたページの割合が 10% 以下の場合、イメージ・コピーを作成しない勧告。
COPY TABLESPACE DSN8D11P.DSN8S11C CHANGELIMIT(10,40) REPORTONLY

例 11: DFSMSdss 並行コピーを起動する

次の COPY 制御ステートメント の CONCURRENT オプションは、DFSMSdss 並行コピー が COPYLIST リスト中のオブジェクト (表スペース DSN8D81A.DSN8S81D と表スペース DSN8D81A.DSN8S81P) のフル・イメージ・コピーを 作成することを指定しています。COPYDDN オプションは、そのコピーを SYSCOPY1 テンプレートで定義されたデータ・セットに書き込む ことを示しています。DSSPRINT DD ステートメントは、メッセージ出力のデータ・セットを指定しています。

図 5. COPY ユーティリティーでの DFSMSdss 並行コピー起動の例
//COPY     EXEC DSNUPROC,SYSTEM=DSN
//SYSPRINT DD DSN=COPY1.PRINT1,DISP=(NEW,CATLG,CATLG),
//         SPACE=(4000,(20,20),,,ROUND),UNIT=SYSDA,VOL=SER=DB2CC5
//DSSPRINT DD DSN=COPY1.PRINT2,DISP=(NEW,CATLG,CATLG),
//         SPACE=(4000,(20,20),,,ROUND),UNIT=SYSDA,VOL=SER=DB2CC5
//SYSIN    DD *
  TEMPLATE SYSCOPY1 DSN &DB..&TS..COPY&IC.&LR.&PB..D&DATE..T&TIME.
           UNIT(SYSDA) DISP (MOD,CATLG,CATLG)                              
  LISTDEF COPYLIST INCLUDE TABLESPACE DSN8D81A.DSN8S81D           
                   INCLUDE TABLESPACE DSN8D81A.DSN8S81P           
  COPY LIST COPYLIST                                             
  COPYDDN (SYSCOPY1)
  CONCURRENT

例 12: DFSMSdss 並行コピーを起動し、フィルター・データ・セットを使用する

以下の制御ステートメント は、DFSMSdss 並行コピー が TSLIST リスト中のオブジェクト (表スペース TS1、TS2、および TS3) のフル・イメージ・コピー を作成するよう指定しています。FILTERDDN オプションは、COPY が、FILT テンプレートで定義された フィルター・データ・セットを使用するように指定します。 すべての出力は、COPYDDN(SYSCOPY) オプションにより示されているように、SYSCOPY データ・セットに送られます。SYSCOPY はデフォルトです。このデータ・セットは、先行する TEMPLATE 制御ステートメントで 定義されています。

図 6. COPY ユーティリティーでの DFSMSdss 並行コピー 起動とフィルター・データ・セット使用の例
LISTDEF TSLIST
        INCLUDE TABLESPACE TS1
        INCLUDE TABLESPACE TS2
        INCLUDE TABLESPACE TS3
TEMPLATE SYSCOPY DSN &DB..&TS..COPY&IC.&LR.&PB..D&DATE..T&TIME.
           UNIT(SYSDA) DISP (MOD,CATLG,CATLG)                              
TEMPLATE FILT DSN FILT.TEST1.&SN..D&DATE.
           UNIT(SYSDA) DISP (MOD,CATLG,DELETE)                              
COPY LIST TSLIST
FILTERDDN(FILT)
COPYDDN(SYSCOPY)
CONCURRENT
    SHRLEVEL REFERENCE

例 13: LOB 表スペースを関連オブジェクトと一緒にコピーする

表スペース TPIQUD01 が基本表スペースであり、表スペース TLIQUDA1、 TLIQUDA2、 TLIQUDA3、および TLIQUDA4 が LOB 表スペースであると想定し ます。下の制御ステートメントは、COPY が以下のアクションを 実行する指定を行っています。

  • 変更されたページの割合が、その表スペースの CHANGELIMIT オプションの 10 進数パーセント表示 の最大値以上の場合は、指定されたそれぞれの表スペースのフル・イメージ・コピーをとります。 例えば、表スペース TPIQUD01 の変更されたページが 6.7% 以上の場合、COPY は フル・イメージ・コピーをとります。
  • 変更されたページの割合が、その表スペースの CHANGELIMIT オプションで指定された 10 進数パーセント表示の値の範囲に入る場合は、指定されたそれぞれの表スペースの増分イメージ・コピーをとります。 例えば、表スペース TLIQUDA1 の変更されたページの割合が 7.9% より大で 25.3% より小の場合、COPY は 増分イメージ・コピーをとります。
  • 変更されたページの割合が、その表スペースの CHANGELIMIT オプションの 10 進数パーセント表示 の最小値以下の場合は、指定されたそれぞれの表スペースのイメージ・コピーはとりません。 例えば、表スペース TLIQUDA2 の変更されたページの割合が 2.2% 以下の場合、COPY は 増分イメージ・コピーをとりません。
  • 索引スペース IPIQUD01、 IXIQUD02、 IUIQUD03、 IXIQUDA1、 IXIQUDA2、 IXIQUDA3、および IXIQUDA4 の フル・イメージ・コピーをとります。
図 7. LOB 表スペースと関連オブジェクトのコピー例
COPY
     TABLESPACE DBIQUD01.TPIQUD01 DSNUM ALL CHANGELIMIT(3.3,6.7)
       COPYDDN(COPYTB1)
     TABLESPACE DBIQUD01.TLIQUDA1 DSNUM ALL CHANGELIMIT(7.9,25.3)
       COPYDDN(COPYTA1)
     TABLESPACE DBIQUD01.TLIQUDA2 DSNUM ALL CHANGELIMIT(2.2,4.3)
       COPYDDN(COPYTA2)
     TABLESPACE DBIQUD01.TLIQUDA3 DSNUM ALL CHANGELIMIT(1.2,9.3)
       COPYDDN(COPYTA3)
     TABLESPACE DBIQUD01.TLIQUDA4 DSNUM ALL CHANGELIMIT(2.2,4.0)
       COPYDDN(COPYTA4)
     INDEXSPACE DBIQUD01.IPIQUD01 DSNUM ALL
       COPYDDN(COPYIX1)
     INDEXSPACE DBIQUD01.IXIQUD02 DSNUM ALL
       COPYDDN(COPYIX2)
     INDEXSPACE DBIQUD01.IUIQUD03 DSNUM ALL
       COPYDDN(COPYIX3)
     INDEXSPACE DBIQUD01.IXIQUDA1 DSNUM ALL
       COPYDDN(COPYIXA1)
     INDEXSPACE DBIQUD01.IXIQUDA2 DSNUM ALL
       COPYDDN(COPYIXA2)
     INDEXSPACE DBIQUD01.IXIQUDA3 DSNUM ALL
       COPYDDN(COPYIXA3)
     INDEXSPACE DBIQUD01.IXIQUDA4 DSNUM ALL
       COPYDDN(COPYIXA4)
 SHRLEVEL REFERENCE

例 14: GDG を使用してフル・イメージ・コピーを作成する

次の制御ステートメントは、COPY ユーティリティーが、表スペース DBLT2501.TPLT2501 の フル・イメージ・コピーを作成することを指定しています。 ローカル・コピーは、COPYTEM1 テンプレートに従って動的に割り振られた データ・セットに書き込まれます。リモート・コピーは、COPYTEM2 テンプレートに従って動的に割り振られた データ・セットに書き込まれます。これら両方のテンプレートについて、DSN オプション は世代別データ・グループの名前 JULTU225 と世代番号 +1 を指定しています (GDG ベースがまだ存在して いない場合、Db2 がそれを作成します)。 これらの出力データ・セットは両方とも、JULTU255.MODEL データ・セットをモデルにしています (TEMPLATE ステートメントの MODELDCB オプションで示されています)。

//*********************************************************** 
//* COMMENT: MAKE A FULL IMAGE COPY OF THE TABLESPACE.        
//*          USE A TEMPLATE FOR THE GDG.                      
//*********************************************************** 
//STEP2    EXEC DSNUPROC,UID='JULTU225.COPY',                 
//         UTPROC='',                                         
//         SYSTEM='SSTR'                                      
//SYSIN    DD *                                               
   TEMPLATE COPYTEM1                   
            UNIT SYSDA                 
            DSN 'JULTU225.GDG.LOCAL.&PB.(+1)'     
            MODELDCB JULTU225.MODEL    
   TEMPLATE COPYTEM2                   
            UNIT SYSDA                 
            DSN 'JULTU225.GDG.REMOTE.&PB.(+1)'     
            MODELDCB JULTU225.MODEL    
   COPY TABLESPACE DBLT2501.TPLT2501   
        FULL YES                       
        COPYDDN (COPYTEM1,COPYTEM1)    
        RECOVERYDDN (COPYTEM2,COPYTEM2)
        SHRLEVEL REFERENCE  

例 15: 更新された表スペース・データをコピーする

次の 制御ステートメントは、COPY が、更新されたオブジェクトのみをコピーするよう指示して います。SCOPE PENDING は、COPY ペンディング状況または通知 COPY ペンディング状況の オブジェクトのみをコピーすることを指示します。

COPY SHRLEVEL REFERENCE                                     
       TABLESPACE DBIQUD01.TPIQUD01 DSNUM ALL CHANGELIMIT(3.3,6.7)  
         COPYDDN(COPYTB1)                                           
       TABLESPACE DBIQUD01.TLIQUDA1 DSNUM ALL CHANGELIMIT(7.9,25.3) 
         COPYDDN(COPYTA1)                                           
       TABLESPACE DBIQUD01.TLIQUDA2 DSNUM ALL CHANGELIMIT(2.2,4.3)  
         COPYDDN(COPYTA2)                                           
       TABLESPACE DBIQUD01.TLIQUDA3 DSNUM ALL CHANGELIMIT(1.2,9.3)  
         COPYDDN(COPYTA3)                                           
       TABLESPACE DBIQUD01.TLIQUDA4 DSNUM ALL CHANGELIMIT(2.2,4.0)  
         COPYDDN(COPYTA4)                                           
       INDEXSPACE DBIQUD01.IPIQUD01 DSNUM ALL                       
         COPYDDN(COPYIX1)PARALLEL(4)
		 SCOPE PENDING
/*

例 16: クローン表データをコピーする

次の 制御ステートメントは、COPY が、指定された表スペースまたは索引内のクローン表データのみを コピーするよう指示しています。

COPY SHRLEVEL REFERENCE CLONE                                     
       TABLESPACE DBIQUD01.TPIQUD01 DSNUM ALL CHANGELIMIT(3.3,6.7)  
         COPYDDN(COPYTB1)                                           
       TABLESPACE DBIQUD01.TLIQUDA1 DSNUM ALL CHANGELIMIT(7.9,25.3) 
         COPYDDN(COPYTA1)                                           
       TABLESPACE DBIQUD01.TLIQUDA2 DSNUM ALL CHANGELIMIT(2.2,4.3)  
         COPYDDN(COPYTA2)                                           
       TABLESPACE DBIQUD01.TLIQUDA3 DSNUM ALL CHANGELIMIT(1.2,9.3)  
         COPYDDN(COPYTA3)                                           
       TABLESPACE DBIQUD01.TLIQUDA4 DSNUM ALL CHANGELIMIT(2.2,4.0)  
         COPYDDN(COPYTA4)                                           
       INDEXSPACE DBIQUD01.IPIQUD01 DSNUM ALL                       
         COPYDDN(COPYIX1)