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

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

オンライン REORG を FASTSWITCH 動作を指定して実行する 場合、データ・セット名の 5 番目の修飾子は、I0001 または J0001 のいずれかです。クローン表の場合、データ・セットは I0002 または J0002 になることもあります。 以下の例では、I0001 を使用します。

例 1: コピーする前に入力データ・セットを検査する

次のステートメントは、DSN1COPY ユーティリティーが SYSUT1 DD ステートメントで示された データ・セットを、SYSUT2 DD ステートメントで示されたデータ・セットにコピーする 指定を行っています。DSN1COPY がこのデータをコピーする前に、ユーティリティーは入力データ・セットの妥当性を 検査します。

//RUNCOPY EXEC PGM=DSN1COPY,PARM='CHECK'
//* COPY VSAM TO SEQUENTIAL AND CHECK PAGES
//STEPLIB  DD DSN=PDS CONTAINING DSN1COPY
//SYSPRINT DD SYSOUT=A
//SYSUT1   DD DSN=DSNCAT.DSNDBC.DSNDB01.SYSUTILX.I0001.A001,DISP=OLD
//SYSUT2   DD DSN=TAPE.DS,UNIT=TAPE,DISP=(NEW,KEEP),VOL=SER=UTLBAK

例 2: Db2 内部 ID を 変換する

この例のステートメント は、DSN1COPY が SYSUT1 DD ステートメントで示されたデータ・セットを、SYSUT2 DD ステートメントで示されたデータ・セットにコピーする指定を行ってい ます。OBIDXLAT オプションは、データ・セットがコピーされる前に、DSN1COPY が OBID を変換する ことを指定しています。OBID は、入力として SYSXLAT DD ステートメントで用意されてい ます。OBIDXLAT オプションが指定されているため、DSN1COPY は、CHECK オプションが指定されていない場合でも、 入力データ・セットの妥当性も検査します。

図 1. OBIDXLAT オプションを用いた DSN1COPY ステートメントの例
//EXECUTE EXEC PGM=DSN1COPY,PARM='OBIDXLAT'
//STEPLIB  DD  DSN=PDS CONTAINING DSN1COPY
//SYSPRINT DD  SYSOUT=A
//SYSUT1   DD  DSN=DSNC110.DSNDBC.DSN8D11P.DSN8S11C.I0001.A001,
//             DISP=OLD
//SYSUT2   DD  DSN=DSNC910.DSNDBC.DSN8D11P.DSN8S11C.I0001.A001,
//             DISP=OLD
//SYSXLAT  DD  *
260,280
2,10
3,55
6,56
7,57
/*

例 3: パーティション化表スペースの 1 ページを印刷する

次のステートメントは、DSN1COPY が、SYSUT1 DD ステートメントで示されたデータ・セットにある 表スペースのページ 2002A1 を印刷する指定を行っています。 この表スペースには、NUMPARTS オプションで示されているように、8 つのパーティションがあります。

//PRINT EXEC PGM=DSN1COPY,PARM='PRINT(2002A1),NUMPARTS(8)'
//* PRINT A PAGE IN THE THIRD PARTITION OF A TABLE SPACE CONSISTING
//* OF 8 PARTITIONS.
//SYSUDUMP DD SYSOUT=A
//SYSPRINT DD SYSOUT=A
//SYSUT2   DD DUMMY
//SYSUT1   DD DSN=DSNCAT.DSNDBD.MMRDB.PARTEMP1.I0001.A003,DISP=OLD

例 4: 非パーティション索引の 16 ページを印刷する

次のステートメントは、DSN1COPY が、SYSUT1 DD ステートメントで定義されたデータ・セットにある 非パーティション索引の 16 ページを印刷する指定を行っています。 ページ範囲は、PRINT オプションで示されているように、ページ F0000 からページ F000F までです。 最大データ・セット・サイズは、PIECESIZ オプションで示されているように、64 MB です。

//PRINT2 EXEC PGM=DSN1COPY,PARM=(PRINT(F0000,F000F),PIECESIZ(64M))
//* PRINT THE FIRST 16 PAGES IN THE 61ST PIECE OF AN NPI WITH PIECE SIZE OF 64M
//SYSUDUMP DD SYSOUT=A
//SYSPRINT DD SYSOUT=A
//SYSUT2    DD DUMMY
//SYSUT1    DD DISP=OLD,DSN=DSNCAT.DSTDBD.MMRDB.NPI1.I0001.A061

例 5: パーティション化表スペースの個々のパーティションを コピーする

次の図の例では、 2 つのジョブ・ステップで、DSN1COPY が、イメージ・コピー・データ・セットからパーティション化表スペースに、 パーティション 1501 とパーティション 1502 をコピーする指定を 行っています。2 つの SYSUT2 DD ステートメントで、データ・セット名の 5 番目のレベルの修飾子は、 それぞれのジョブ・ステップが個々のパーティションを指定しているため、異なっていてもかまいません。 両方のステップで FULLCOPY オプションが使用されており、入力データ・セットはフル・イメージ・コピー であることを示しています。NUMPARTS オプションは、入力データ・セットには 1600 のパーティションが あることを示しています。RESET オプションは、ヘッダー・ページ内の 高フォーマット設定ページ番号を 0 にリセットすることを指示しています。 このオプションが指定されているため、CHECK オプションが指定されていない場合でも、DSN1COPY は 入力データ・セットの妥当性を検査します。

図 2. パーティション用の DSN1COPY ジョブの例
//STEP1    EXEC PGM=DSN1COPY,                                     
//            PARM='NUMPARTS(1600),RESET,FULLCOPY'                  
//SYSUDUMP DD SYSOUT=A                                            
//SYSPRINT DD SYSOUT=A                                            
//SYSUT1   DD DISP=SHR,DSN=PROD.IMAGE.COPY.PART1501                  
//SYSUT2   DD DISP=OLD,DSN=DSNCAT.DSNDBD.TESTDB.TS01.I0001.B501   
//STEP2    EXEC PGM=DSN1COPY,                                     
//            PARM='NUMPARTS(1600),RESET,FULLCOPY'                  
//SYSUDUMP DD SYSOUT=A                                            
//SYSPRINT DD SYSOUT=A                                            
//SYSUT1   DD DISP=SHR,DSN=PROD.IMAGE.COPY.PART1502                  
//SYSUT2   DD DISP=OLD,DSN=DSNCAT.DSNDBD.TESTDB.TS01.J0001.B502   

例 6: パーティション化表スペースのすべてのパーティションをコピーする

次のステートメントは、 DSN1COPY が、あるパーティション化表スペースのフル・イメージ・コピーを入力として使用すること によって、データをその表スペースのすべてのパーティションへ コピーする指定を行っています。 入力イメージ・コピーには、NUMPARTS オプションで示されているように、16 のパーティションがあります。 このようなタイプのジョブ・ストリームを実行する場合はその前に、 データ・セット名の 5 番目のレベルの修飾子 (I0001 または J0001 のいずれか) が 出力表スペースのすべてのパーティションで同じであることを確認する必要があります。

//DSN1COPY EXEC PGM=DSN1COPY,                                   
//            PARM='NUMPARTS(16),RESET,FULLCOPY'                
//SYSUDUMP DD SYSOUT=A                                          
//SYSPRINT DD SYSOUT=A                                          
//SYSUT1   DD DISP=SHR,DSN=PROD.IMAGE.COPY.DSNUMALL             
//SYSUT2   DD DISP=OLD,DSN=DSNCAT.DSNDBD.TESTDB.TS01.I0001.A001 

例 7: UTS 表スペースと共に DSN1COPY を使用する

以下のステートメントは、DSN1COPY が UTS 表スペース VSAM データ・セットを 順次データ・セットにコピーするよう指定しています。

//****************************************************************** 
//* COMMENT: RUN DSN1COPY FOR THE TABLESPACE Part 1 
//****************************************************************** 
//STEP1 EXEC PGM=DSN1COPY, 
// PARM='SEGMENT,RESET' 
//SYSUDUMP DD SYSOUT=A 
//SYSPRINT DD SYSOUT=A 
//SYSOUT DD SYSOUT=A 
//SYSABEND DD SYSOUT=A 
//SYSUT1 DD DSN=DSNCAT.DSNDBD.DBKQBG01.TPKQBG01.I0001.A001,DISP=SHR 
//SYSUT2 DD DSN=JUKQU2BG.DSN1COPY.D1P1,DISP=(NEW,CATLG,CATLG), 
// VOL=SER=SCR03,UNIT=SYSDA,SPACE=(TRK,(55,1)) 
/* 
//****************************************************************** 
//* COMMENT: RUN DSN1COPY FOR THE TABLESPACE Part 2 
//****************************************************************** 
//STEP2 EXEC PGM=DSN1COPY, 
// PARM='SEGMENT,RESET' 
//SYSUDUMP DD SYSOUT=A 
//SYSPRINT DD SYSOUT=A 
//SYSOUT DD SYSOUT=A 
//SYSABEND DD SYSOUT=A 
//SYSUT1 DD DSN=DSNCAT.DSNDBD.DBKQBG01.TPKQBG01.I0001.A002,DISP=SHR 
//SYSUT2 DD DSN=JUKQU2BG.DSN1COPY.D1P2,DISP=(NEW,CATLG,CATLG), 
// VOL=SER=SCR03,UNIT=SYSDA,SPACE=(TRK,(55,1)) 
/* 

例 8: DSN1COPY の Unicode 出力の指定

DSN1COPY に対し UNICODE オプションを指定すると、日本語文字など、非ラテン Unicode 文字が出力で表示されなくなります。UNICODE オプションを指定すると、DSN1COPY は、16 進データを取得し、それをデフォルトの EBCDIC ではなく ASCII としてフォーマットします。

DSN1COPY で処理するデータが UTF-16 のとき、問題が発生する場合があります。UTF-16 データの場合、DSN1COPY はデータの第 2 バイトのみ取得し、データのその部分を ASCII としてフォーマットします。したがって、出力は正しくない場合があります。例えば、UTF-16 の 16 進値である X'0030' と X'1130' は、どちらも 0 として出力されます。これは、それぞれの第 1 バイト (「00」および「11」) が無視されるためです。残りの部分 (「30」) は ASCII の 0 として解釈されます。UTF-16 では、X'0030' は 0 を示す 16 進値で、一方 X'1130' はハングル文字を示す 16 進値です。UTF-16 フォーマットの詳細については、UTFを参照してください。

次の DSN1COPY の例では、3 つの太字の 16 進値 (X'0041'、X'0141'、および X'0241') に注意してください。これらの 3 つすべての値の出力は、それぞれが UTF-16 では異なる文字に対応しているのにも関わらず、A.A.A となります。(X'0041' は A、X'0141' は Ł、X'0241' は声門閉鎖音を示すラテン語の大文字です。)

//STEP1    EXEC PGM=DSN1COPY,                                     
//         PARM='CHECK,PRINT(002),UNICODE'   
//STEPLIB  DD DSN=DB2A.DSNLOAD,DISP=SHR                           
//SYSUDUMP DD SYSOUT=A                                            
//SYSPRINT DD SYSOUT=A                                            
//SYSOUT   DD SYSOUT=A                                            
//SYSABEND DD SYSOUT=A                                            
//SYSUT1   DD DSN=TESTCAT.DSNDBC.DBED2101.TPED2101.I0001.A001,DISP=SHR 
//SYSUT2   DD DSN=DUMMY 
/*                   
DSN1999I START OF DSN1COPY FOR JOB RUNCPYI1 RUNCPYI1
DSN1989I DSN1COPY IS PROCESSED WITH THE FOLLOWING OPTIONS: 
CHECK/   PRINT/ 4K/NO IMAGECOPY/NON-SEGMENT/NUMPARTS=   0/NO OBIDXLAT/NO VALUE/NO RESET/  /   /   /  
DSSIZE=   /PIECESIZ=    /UNICODE/
DSN1998I INPUT  DSNAME = TESTCAT.DSNDBC.DBED2101.TPED2101.I0001.A001 , VSAM
DSN1997I OUTPUT DSNAME = NULLFILE                                    , SEQ 

16 進数での入力データ・セットの内容:

0000 10000075 8C945500 00000200 0FC90033   00000101 02001F00 03018000 00010000
0020 41014102 41002000 20002000 20002000   20002000 00000000 00000000 00000000
.... LINES ARE ALL ZERO. 
0FE0 00000000 00000000 00000000 00000000   00000000 00000000 00000000 001400D5 

ASCII での入力データ・セットの内容:

*...u..U........3................* 
*A.A.A. . . . . . . .............* 
.... LINES ARE ALL ZERO. 
*................................* 

例 9: 複数ピースの非パーティション化表スペース用の出力データ・セットの定義

以下のステートメントは、別のセグメント化表スペースのフル・イメージ・コピーを入力として使用し、DSN1COPY によってセグメント化表スペースのすべてのピースの中にデータをコピーするよう指定しています。

  1. 適切な 1 次数量および 2 次数量を指定することにより、ターゲット・セグメント化表スペースを作成します。
  2. すべての後続ピース用のデータ・セットを定義します。

    次の例では、2 番目のピースのデータ・セットは 'DSNCAT.DSNDBC.TESTDB.TS01.I0001.A002' です。 MODEL オプションを使用して、最初のデータ・セットと同様の新規データ・セットが作成されるようにします。

    //ALCVSAM  EXEC PGM=IDCAMS
    //SYSPRINT DD SYSOUT=*
    //SYSIN    DD *   
      DEFINE CLUSTER +
        (NAME('DSNCAT.DSNDBC.TESTDB.TS01.I0001.A002') +  
         MODEL('DSNCAT.DSNDBC.TESTDB.TS01.I0001.A001')) +
      DATA +
        (NAME('DSNCAT.DSNDBD.TESTDB.TS01.I0001.A002') +
         MODEL('DSNCAT.DSNDBD.TESTDB.TS01.I0001.A001'))
    /*
  3. DSN1COPY を実行します。
    //DSN1COPY EXEC PGM=DSN1COPY,
    // PARM='FULLCOPY'
    //SYSUDUMP DD SYSOUT=A
    //SYSPRINT DD SYSOUT=A
    //SYSUT1 DD DISP=SHR,DSN=PROD.IMAGE.COPY.DSNUMALL
    //SYSUT2 DD DISP=OLD,DSN=DSNCAT.DSNDBD.TESTDB.TS01.I0001.A001