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

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

例 1: フィールド位置を指定する

以下の 制御ステートメントは、LOAD ユーティリティーが、SYSREC DD ステートメントで定義されたデータ・セットからレコードを表 DSN8810.DEPT にロードすることを指定しています。SYSREC はデフォルトの入力データ・セットです。

それぞれの POSITION 文節は、入力レコードのフィールドのロケーションを 指定しています。 この例では、LOAD は 図 2 に示された入力を受け入れ、 それを以下のように解釈します。

  • それぞれのレコードの最初の 3 バイトが表の DEPTNO 列にロードされる。
  • 次の 36 バイト (末尾ブランクを含む) は DEPTNAME 列にロードされる。

    この入力列が VARCHAR(36) と定義されている場合は、データの前に 2 バイトの 2 進数の 長さフィールドを入力データに含めておく必要があります。 この 2 進数フィールドは、位置 4 から始まります。

  • その後の 3 つのフィールドは、CHAR(6)、CHAR(3)、および CHAR(16) として 定義された列にロードされます。

RESUME YES 文節は、表スペースが空である必要はないことを指定します。 新しいレコードは表の終わりに追加されます。

図 1. フィールド位置を指定した LOAD ステートメントの例
LOAD DATA
 RESUME YES
 INTO TABLE DSN8B10.DEPT
 (DEPTNO    POSITION (1:3)     CHAR(3),
    DEPTNAME POSITION (4:39)    CHAR(36),
    MGRNO     POSITION (40:45)   CHAR(6),
    ADMRDEPT POSITION (46:48)   CHAR(3),
    LOCATION POSITION (49:64)   CHAR(16))

図 2. は、上記の LOAD ジョブの入力を示しています。

図 2. LOAD 用の入力データ・セットにあるレコード
A00SPIFFY COMPUTER SERVICE DIV.        000010A00USIBMSTODB21
B01PLANNING                            000020A00USIBMSTODB21
C01INFORMATION CENTER                  000030A00USIBMSTODB21
D01DEVELOPMENT CENTER                        A00USIBMSTODB21

次の表は、上記の入力レコードがロードされた後にステートメント SELECT * FROM DSN8B10.DEPT を 実行した結果を示します。

表 1. 表にロードされるデータ
DEPTNO DEPTNAME MGRNO ADMRDEPT LOCATION
A00 SPIFFY COMPUTER SERVICE DIV. 00010 A00 USIBMSTODB21
B01 PLANNING 000020 A00 USIBMSTODB21
C01 INFORMATION CENTER 000030 A00 USIBMSTODB21
D01 DEVELOPMENT CENTER   A00 USIBMSTODB21

例 2: 所定のパーティションのデータを置き換える。

次の制御ステートメントは、SYSREC DD ステートメントで定義されたデータ・セットから 表 DSN8810.DEPT の先頭パーティションにレコードをロードする指定を行っています。 デフォルトの入力データ・セットは SYSREC です。REPLACE オプションは、指定された パーティションのみを入力データが置き換えることを示しています。REPLACE オプションが PART オプションの前に 指定された場合は、REPLACE は、全体の表スペースが置き換えられること、およびデータは指定された パーティションにロードされることを指定します。 キーワード DATA の指定は不要であることに注意してください。

LOAD 
  INTO TABLE DSN8B10.DEPT PART 1 REPLACE

例 3: 選択されたレコードを複数の表に ロードする。

次の制御ステートメント は、LOAD ユーティリティーが、特定のデータを EMPLDS 入力データ・セットから表 DSN8B10.EMP、SMITH.EMPEMPL、および DSN8810.DEPT へ ロードする指定を行っています。 入力データ・セットは、INDDN オプションによって示されてい ます。WHEN 文節は、それぞれの表に ロードされるレコードを示しています。EMP および DEPT 表の場合、ユーティリティーはストリング LKA で 始まるレコードのみをロードします。EMPEMPL 表の場合、ユーティリティーはストリング ABC で始まる レコードのみをロードします。RESUME YES オプションは、LOAD ジョブを進めるために表スペースを空にする 必要はないことを示しています。新しい行は表の最後に追加されます。この例では、ロードされる最初の 2 つの表はまったく同じフォーマットであり、入力データはそのフォーマットと一致することを前提としています。したがって、この 2 つの INTO TABLE 文節にはフィールド仕様は必要ありません。3 番目の表のフォーマットは異なるので、フィールド仕様が必要であり、例では指定されています。

ロードされる 3 つの表には、それぞれ異なる数のレコードが含まれます。 LOAD ユーティリティーで必要とされるソート作業データ・セットのサイジングを改善するには、各表にロードされるレコードの数を、各表の NUMRECS キーワードに指定します。

POSITION 文節は、DEPT 表の入力データにおけるフィールドのロケーションを指定しています。DEPT 表にロードされるそれぞれのソース・レコードごとに、以下のようになっています。

  • 7 桁目から 9 桁目にある文字が DEPTNO 列にロードされる
  • 10 桁目から 35 桁目にある文字が DEPTNAME 列にロードされる
  • 36 桁目から 41 桁目にある文字が MGRNO 列にロードされる
  • 42 桁目から 44 桁目にある文字が ADMRDEPT 列にロードされる
図 3. 選択されたレコードを複数の表にロードする LOAD ステートメントの例
LOAD DATA INDDN EMPLDS
 RESUME YES
 INTO TABLE DSN8B10.EMP
 NUMRECS   100000
 WHEN (1:3)='LKA'
 INTO TABLE SMITH.EMPEMPL
 NUMRECS   100
 WHEN (1:3)='ABC'
 INTO TABLE DSN8B10.DEPT 
 NUMRECS   500
 WHEN (1:3)='LKA'
 (DEPTNO POSITION (7:9) CHAR,
   DEPTNAME POSITION (10:35) CHAR,
   MGRNO POSITION (36:41) CHAR,
   ADMRDEPT POSITION (42:44) CHAR)

例 4: データ・タイプの異なるデータをロードする

次の制御ステートメントは、LOAD がデータ を SYSRECPJ 入力データ・セットから表 DSN8B10.PROJ へロードする指定を行っています。入力データ・セットは、INDDN オプションによって示されてい ます。 表 DSN8B10.PROJ を含んでいる表スペースは、現在、空であると想定しています。

それぞれの入力レコードごとに、指定された列 (すなわち、PROJNO、 PROJNAME、DEPTNO など) にデータがロードされ、表の行を形成します。LOAD 制御ステートメントで指定されていない PROJ 列は いずれも、デフォルト値に設定されます。

POSITION 文節は、入力データ・セットにおけるフィールドの開始位置を定義しています。 入力データ・セットのフィールドの終了位置は、データ・タイプ・オプションの 長さ指定 (CHAR length)、または外部数値データ・タイプの 長さ指定 (LENGTH) のいずれかによって暗黙的に定義されます。

SQL 定数形式 (EXTERNAL 形式) で表された数値データは、LOAD 処理によって 正しい内部形式に変換され、指示された列名に入れられ ます。2 つの日付 (PRSTDATE および PRENDATE) は米国形式 (例えば、11/15/2006) のよう に、8 桁の数字と 2 桁の区切り記号で表されるものと想定します。 日付フィールドの長さは、多くの場合デフォルトも同じ長さですが、明示的に 10 として与えられています。

図 4. データ・タイプの異なるデータのロード
LOAD DATA INDDN(SYSRECPJ)
 INTO TABLE DSN8B10.PROJ
  (PROJNO   POSITION  (1) CHAR(6),
   PROJNAME POSITION  (8) CHAR(22),
   DEPTNO   POSITION (31) CHAR(3),
   RESPEMP  POSITION (35) CHAR(6),
   PRSTAFF  POSITION (42) DECIMAL EXTERNAL(5),
   PRSTDATE POSITION (48) DATE EXTERNAL(10),
   PRENDATE POSITION (59) DATE EXTERNAL(10),
   MAJPROJ  POSITION (70) CHAR(6))

例 5: 区切り文字で区切られたファイル形式のデータをロードする

次の 制御ステートメントは、区切り文字で区切られた 形式のデータを、表 TBQB0103 の指定された列 (FILENO、DATE1、TIME1、および TIMESTMP) に ロードする指定を行っています。FORMAT DELIMITED オプションは、データが区切り文字で区切られた 形式であることを示しています。 データは、デフォルトである SYSREC データ・セットからロードされます。

COLDEL オプションは、列区切り文字はコンマ (,) であることを示してい ます。CHARDEL オプションは、文字ストリング区切り文字は二重引用符 (") であることを示してい ます。DECPT オプションは、小数点文字はピリオド (.) であることを示しています。 これらの特殊文字はすべてデフォルトであるため、明示的に指定する必要はありません。

図 5. 区切り文字で区切られたファイル形式のデータをロードする例
//*                              
//STEP3    EXEC DSNUPROC,UID='JUQBU101.LOAD2',TIME=1440,     
//         UTPROC='',                                        
//         SYSTEM='SSTR'                         
//SYSERR   DD DSN=JUQBU101.LOAD2.STEP3.SYSERR,               
//         DISP=(MOD,DELETE,CATLG),UNIT=SYSDA,               
//         SPACE=(4096,(20,20),,,ROUND)                      
//SYSDISC  DD DSN=JUQBU101.LOAD2.STEP3.SYSDISC,              
//         DISP=(MOD,DELETE,CATLG),UNIT=SYSDA,               
//         SPACE=(4096,(20,20),,,ROUND)                      
//SYSMAP   DD DSN=JUQBU101.LOAD2.STEP3.SYSMAP,               
//         DISP=(MOD,DELETE,CATLG),UNIT=SYSDA,               
//         SPACE=(4096,(20,20),,,ROUND)                      
//SYSUT1   DD DSN=JUQBU101.LOAD2.STEP3.SYSUT1,               
//         DISP=(MOD,DELETE,CATLG),UNIT=SYSDA,               
//         SPACE=(4096,(20,20),,,ROUND) 
//UTPRINT  DD SYSOUT=*                                        
//SORTOUT  DD DSN=JUQBU101.LOAD2.STEP3.SORTOUT,               
//         DISP=(MOD,DELETE,CATLG),UNIT=SYSDA,                
//         SPACE=(4096,(20,20),,,ROUND)                       
//SYSIN    DD *                                              
   LOAD DATA                                                   
        FORMAT DELIMITED COLDEL ',' CHARDEL '"' DECPT '.'      
        INTO TABLE TBQB0103                                    
            (FILENO   CHAR,                                    
             DATE1    DATE EXTERNAL,                           
             TIME1    TIME EXTERNAL,                           
             TIMESTMP TIMESTAMP EXTERNAL)                      
 /*                                                            
//SYSREC   DD *                                               
 "001", 2000-02-16, 00.00.00, 2000-02-16-00.00.00.0000         
 "002", 2001-04-17, 06.30.00, 2001-04-17-06.30.00.2000         
 "003", 2002-06-18, 12.30.59, 2002-06-18-12.30.59.4000         
 "004", 1991-08-19, 18.59.30, 1991-08-19-18.59.30.8000         
 "005", 2000-12-20, 24.00.00, 2000-12-20-24.00.00.0000         
 /*

例 6: 複数の入力レコードを連結する

次の 制御ステートメントは、SYSRECOV 入力データ・セットからのデータを表 DSN8B10.TOPTVAL にロードする 指定を行っています。入力データ・セットは、INDDN オプションによって示されてい ます。TOPTVAL 表を含んでいる表スペースは、現在、空です。

単一行にロードされる一部のデータは、複数の入力レコードにまたがっています。 この場合、72 桁目の X は、入力レコードが次の入力レコードのフィールドと同じ行にロード されるフィールドを含んでいることを示しています。この LOAD 制御ステートメントの CONTINUEIF(72:72)='X' は、 LOAD はデータをロードする前に、72 桁目に X が入っている入力レコードをその次のレコードと連結することを 示しています。

組み立てられた各入力レコードごとに (すなわち、連結後)、 フィールドが DSN8B10.TOPTVAL 表列 (すなわち、MAJSYS、ACTION、OBJECT …、 DSPINDEX) に ロードされ、表の行を形成します。LOAD 制御ステートメントで指定されていない列はいずれ も、デフォルト値に設定されます。

POSITION 文節は、組み立てられた入力レコードにおけるフィールドの開始位置 を定義しています。 開始位置は、順次データ・セットの入力レコードの始めからではなく、 内部的に組み立てられた入力レコードの最初の桁から数えます。 フィールドの終了位置は、データ・タイプの 長さ指定 (CHAR length) によって暗黙的に定義されます。

指定された列は、固定長文字ストリングとしても定義されているため、入力文字ストリング をその列にロードする際に変換は不要です。 ただし、列 INFOTXT、 HELPTXT、および PFKTXT は長さが 79 文字と定義されていますが、 ロードされるストリングの長さは 71 文字であるため、 これらのストリングはロードの際にブランクで埋め込まれます。

図 6. データのロード前に複数の入力レコードを連結する例
LOAD DATA INDDN(SYSRECOV) CONTINUEIF(72:72)='X'
  INTO TABLE DSN8B10.TOPTVAL
  (MAJSYS   POSITION   (2) CHAR(1),
   ACTION   POSITION   (4) CHAR(1),
   OBJECT   POSITION   (6) CHAR(2),
   SRCHCRIT POSITION   (9) CHAR(2),
   SCRTYPE  POSITION  (12) CHAR(1),
   HEADTXT  POSITION  (80) CHAR(50),
   SELTXT   POSITION (159) CHAR(50),
   INFOTXT  POSITION (238) CHAR(71),
   HELPTXT  POSITION (317) CHAR(71),
   PFKTXT   POSITION (396) CHAR(71),
   DSPINDEX POSITION (475) CHAR(2))

例 7: NULL 値をロードする。

次の 制御ステートメントは、SYSRECST データ・セット からのデータを表 SYSIBM.SYSSTRINGS の指定された列にロードする指定を行っています。 入力データ・セットは、INDDN オプションによって示されてい ます。ERRORBYTE および SUBBYTE 列の NULLIF オプションは、入力フィールドにブランクが含まれている場合 は、LOAD は、特定の行の示された列に NULL 値を入れることを指定し ます。TRANSTAB 列の DEFAULTIF オプションは、入力フィールド値が GG の場合、ユーティリティーが この列にデフォルト値をロードすることを示してい ます。CONTINUEIF オプションでは、LOAD は、データをロードする前に、80 桁目に X を持つ入力レコード があれば次のレコードと連結することを示しています。

図 7. NULL 値をロードする例
LOAD DATA INDDN(SYSRECST) CONTINUEIF(80:80)='X' RESUME(YES)      
     INTO TABLE SYSIBM.SYSSTRINGS                                
           (INCCSID   POSITION(  1) INTEGER EXTERNAL(5),          
            OUTCCSID  POSITION(  7) INTEGER EXTERNAL(5),          
            TRANSTYPE POSITION( 13) CHAR(2),                      
            ERRORBYTE POSITION( 16) CHAR(1) NULLIF(ERRORBYTE=' '),
            SUBBYTE   POSITION( 18) CHAR(1) NULLIF(SUBBYTE=' '),  
            TRANSPROC POSITION( 20) CHAR(8),                      
            IBMREQD   POSITION( 29) CHAR(1),                      
            TRANSTAB  POSITION( 31) CHAR(256) DEFAULTIF(TRANSTYPE='GG'))

例 8: データをロードする際に、参照制約を実施する

次の 制御ステートメントは、SYSREC 入力データ・セット からのデータを表 DSN8B10.PROJ にロードする指定を行っています。 デフォルトの入力データ・セットは SYSREC です。PROJ 表を含んでいる表スペースは空では ありません。RESUME YES は、レコードが表の最後に追加されることを示しています。

ENFORCE CONSTRAINTS オプションでは、LOAD は、追加されるデータに参照制約を 実施することを示しています。 このオプションもデフォルトです。 違反はすべて出力に報告されます。 このような違反を引き起こしたすべてのレコードはロードされず、SYSDISC データ・セットに 入れられます。これは、廃棄レコードのデフォルトのデータ・セットです。

CONTINUEIF オプションでは、LOAD は、データをロードする前に、72 桁目 に X を持つ入力レコードがあれば次のレコードと連結することを示しています。

図 8. データのロード時に参照制約を実施する例
LOAD DATA INDDN(SYSREC) CONTINUEIF(72:72)='X'
 RESUME YES
 ENFORCE CONSTRAINTS
 INTO TABLE DSN8B10.PROJ
  (PROJNO POSITION (1) CHAR (6),
   PROJNAME POSITION (8) VARCHAR,
   DEPTNO POSITION (33) CHAR (3),
   RESPEMP POSITION (37) CHAR (6),
   PRSTAFF POSITION (44) DECIMAL EXTERNAL (5),
   PRSTDATE POSITION (50) DATE EXTERNAL,
   PRENDATE POSITION (61) DATE EXTERNAL,
   MAJPROJ POSITION (80) CHAR (6) NULLIF(MAJPROJ='      '))

例 9: 参照制約を実施せずにデータをロードする

次の 制御ステートメントは、SYSRECAC 入力データ・セット からのデータを表 DSN8810.ACT にロードする指定を行ってい ます。INDDN オプションは、入力データ・セットを示しています。

ENFORCE NO は、LOAD ユーティリティーが参照制約を実施しないこと、 および表を CHECK ペンディング状況にすることを示しています。 すべての表がロードされるまで参照制約が検査できないような関連があるいくつかの表にデータをロードする場合は、このオプションを使用します。 例えば、表 A の列は表 B に依存しており、表 B の列は表 C の列に依存し、表 C の列は表 A に 依存しているような場合です。

POSITION 文節は、入力データ・セットにおけるフィールドの開始位置を定義しています。 入力データ・セットのフィールドの終了位置は、データ・タイプの 長さ指定 (CHAR length) によって暗黙的に定義されます。 この場合、1 桁目から 3 桁目の文字は ACTNO 列にロードされ、5 桁目から 10 桁目は ACTKWD 列 にロードされ、さらに 13 桁目から先は ACTDESC 列にロードされ ます。ACTDESC 列はタイプが VARCHAR であるため、入力データには、文字フィールド長が 入った 2 バイトの 2 進数フィールドが含まれている必要があります。 この 2 進数フィールドは、13 桁目から始まります。

図 9. 参照制約の実施なしのデータのロード例
//STEP1    EXEC DSNUPROC,UID='IUIQU2UB.LOAD',
//         UTPROC='',
//         SYSTEM='DSN'
//SYSRECAC   DD DSN=IUIQU2UB.LOAD.DATA,DISP=SHR,VOL=SER=SCR03,
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND)
//SYSUT1   DD DSN=IUIQU2UB.LOAD.STEP1.SYSUT1,
//         DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND)
//SORTOUT  DD DSN=IUIQU2UB.LOAD.STEP1.SORTOUT,
//         DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND)
//SYSIN    DD *
LOAD DATA INDDN(SYSRECAC) RESUME YES
     INTO TABLE DSN8B10.ACT
          (ACTNO    POSITION(1) INTEGER EXTERNAL(3),
           ACTKWD   POSITION(5) CHAR(6),
           ACTDESC POSITION(13) VARCHAR)
     ENFORCE NO
//*

例 10: 並列索引作成を使用して、データをロードする

次の 制御ステートメントは、SYSREC 入力データ・セット からのデータを表 DSN8810.DEPT にロードする指定を行ってい ます。3 つの索引を持つ表 DSN8B10.DEPT に、22 000 行をロードする必要があると想定します。この例では、並列索引作成を実施することによって、SORTKEYS オプションを使用して パフォーマンスを改善します。SORTKEYS オプションでは、SORTBLD フェーズで並行してソートするキー数の見積もりとして 66 000 を指定しています。(この見積もりは、LOAD パフォーマンスの向上で説明している計算を使用して算出されたものです。) 複数の索引を作成する必要があるため、LOAD は並列に索引を作成します。

SORTDEVT および SORTNUM キーワードは、ソート・プログラムが必要なデータ・セットを動的に割り振るよう指定します。仮想ストレージ・リソースが十分にある場合は、それぞれの索引を作成するために ユーティリティー・サブタスクのペアが開始されます。 この例では UTPRINnn DD ステートメントを必要としません。その理由は、 ユーティリティー処理を呼び出すのに DSNUPROC を使用しており、 その中に、UTPRINT を SYSOUT に割り振る DD ステートメントが組み込まれているためです。

CONTINUEIF オプションでは、LOAD は、データをロードする前に、79 桁目に正符号 (+) と 80 桁目に正符号 (+) を持つ入力レコードがあれば次のレコードと 連結することを示しています。

図 10. 並列索引作成を使用したデータのロード
//SAMPJOB  JOB  …
//STEP1    EXEC DSNUPROC,UID='SAMPJOB.LOAD',UTPROC='',SYSTEM='DSN'
//SORTOUT  DD DSN=SAMPJOB.LOAD.STEP1.SORTOUT,DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(CYL,(10,20),,,ROUND)
//SYSUT1   DD DSN=SAMPJOB.LOAD.STEP1.SYSUT1,DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(CYL,(10,20),,,ROUND)
//SYSERR   DD DSN=SAMPJOB.LOAD.STEP1.SYSERR,DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(2000,(20,20),,,ROUND)
//         DCB=(RECFM=FB,LRECL=80,BLKSIZE=2400)
//SYSMAP   DD DSN=SAMPJOB.LOAD.STEP1.SYSMAP,DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(2000,(20,20),,,ROUND),
//         DCB=(RECFM=FB,LRECL=80,BLKSIZE=2400)
//SYSREC   DSN=SAMPJOB.TEMP.DATA,DISP=SHR,UNIT=SYSDA
//SYSIN    DD *
LOAD DATA REPLACE INDDN SYSREC CONTINUEIF(79:80)='++'
 SORTKEYS 66000 SORTDEVT SYSDA SORTNUM 3
 INTO TABLE DSN8B10.DEPT
/*

例 11: インライン・コピーを作成する

次の制御 ステートメントは、LOAD ユーティリティー が、SYSREC DD ステートメントで定義されたデータ・セットから表 ADMF001.TB0S3902 の指定された列に、 データをロードする指定を行っています。

COPYDDN(COPYT1) は、LOAD がインライン・コピーを作成し、1 次イメージ・コピー を COPYT1 テンプレートで定義されたデータ・セットに書き込むことを示してい ます。このテンプレートは、その前のいずれかの TEMPLATE 制御ステートメントで定義されたもの です。インライン・コピーを作成するには、REPLACE オプションも指定する必要があります。 このオプションは、表スペースにあるデータをいずれも置き換えることを示しています。

CONTINUEIF(79:80)='++' では、LOAD は、 データをロードする前に、79 桁目に正符号 (+) と 80 桁目に正符号 (+) を持つ入力レコード があれば次のレコードと連結することを示しています。

ERRDDN(ERRDDN) および MAPDDN(MAP) オプションは、エラーに関する情報 が、ERRDDN および MAP テンプレートによって定義されたデータ・セットに書き込まれる ことを示しています。DISCARDDN(DISCARD) は、廃棄されたレコード (参照制約に違反したレコード) が 、DISCARD テンプレートによって定義されたデータ・セットに書き込まれることを示してい ます。WORKDDN(UT1,OUT) は、ソート入出力用の一時作業ファイルを指定してい ます。LOAD は、UT1 テンプレートで定義されたデータ・セットをソート入力用に、OUT テンプレートで 定義されたデータ・セットをソート出力用に使用します。

図 11. インライン・コピーの作成例
//STEP1    EXEC DSNUPROC,UID='JUOSU339.LOAD1',TIME=1440,                 
//         UTPROC='',                                                    
//         SYSTEM='SSTR'                                     
//SYSREC   DD DSN=CUST.FM.CINT135.DATA,DISP=SHR,VOL=SER=FORDMD,          
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND)                       
//SYSIN    DD *                                                          
  TEMPLATE ERRDDN  UNIT(SYSDA)                                           
                   DSN(JUOSU339.T&TI..&ST..ERRDDN)                       
                   SPACE(50,10) TRK                                      
  TEMPLATE UT1     UNIT(SYSDA)                                           
                   DSN(JUOSU339.T&TI..&ST..SYSUT1)                       
                   SPACE(50,10) TRK                                      
  TEMPLATE OUT     UNIT(SYSDA)                                          
                   DSN(JUOSU339.T&TI..&ST..SYSOUT)                       
                   SPACE(50,10) TRK                                      
  TEMPLATE MAP     UNIT(SYSDA)                                           
                   DSN(JUOSU339.T&TI..&ST..SYSMAP)            
                   SPACE(50,10) TRK                           
  TEMPLATE DISCARD UNIT(SYSDA)                                
                   DSN(JUOSU339.T&TI..&ST..DISCARD)           
                   SPACE(50,10) TRK                           
  TEMPLATE COPYT1                                             
           UNIT(SYSDA)                                        
           DSN(JUOSU339.COPY1.STEP1.&SN..COPY&LR.&PB.)        
           DISP(MOD,CATLG,CATLG)                              
           SPACE(60,30) TRK                                   
  LOAD DATA INDDN SYSREC REPLACE                              
   CONTINUEIF(79:80)='++'                                     
   COPYDDN(COPYT1)                                            
   ERRDDN(ERRDDN)                                       
   WORKDDN(UT1,OUT)                                     
   MAPDDN(MAP)                                          
   DISCARDDN(DISCARD)                                   
  INTO TABLE                                            
       ADMF001.TBOS3902                                 
  ( ID_PARTITION       POSITION(1)   CHAR(1),                      
    CD_PLANT           POSITION(2)   CHAR(5),                      
    NO_PART_BASE       POSITION(7)   CHAR(9),                      
    NO_PART_PREFIX     POSITION(16)  CHAR(7),                      
   NO_PART_SUFFIX     POSITION(23)  CHAR(8),                        
  NO_PART_CONTROL    POSITION(31)   CHAR(3),                        
  DT_TRANS_EFFECTIVE POSITION(34)   DATE EXTERNAL(10),                        
  CD_INV_TRANSACTION POSITION(44)   CHAR(3),                        
  TS_PROCESS         POSITION(47)   TIMESTAMP EXTERNAL(26),                        
  QT_INV_TRANSACTION POSITION(73)   INTEGER,                        
  CD_UNIT_MEAS_USAGE POSITION(77)   CHAR(2),                        
  CD_USER_ID         POSITION(79)   CHAR(7),                        
  NO_DEPT            POSITION(86)   CHAR(4),                        
  NO_WORK_CENTER     POSITION(90)   CHAR(6))               
/*  

例 12: 統計を収集する

この 例は、前の例に似ていますが、STATISTICS オプションと その他の関連オプションが追加され、LOAD ジョブ中に、Db2® は表スペース の統計も収集します。これらの統計を収集することにより、LOAD 操作の完了後に RUNSTATS ユーティリティーを実行する 必要がなくなります。

TABLE、COLUMN、および INDEX オプションは、列 QT_INV_TRANSACTION、 NO_DEPT、NO_PART_PREFIX、DT_TRANS_EFFECTIVE および表 TB0S3902 の 索引 ID0S3902 についての情報を収集することを指定し ます。SAMPLE 53 は、索引の非先行索引列または非索引列に関する統計を収集する際に、LOAD が 53% の行をサンプリングすることを示しています。索引の場合、デフォルトでは、キー列のすべての組み合わせで、すべての DISTINCT 値に関する統計が収集されます。FREQVAL NUMCOLS 4 COUNT 20 は、最初の 4 つのキー列を 連結して、20 の頻度値を収集することを示しています。

REPORT YES は、統計を出力として SYSPRINT に送ることを示してい ます。UPDATE ALL および HISTORY ALL は、収集されたすべての統計をカタログ履歴表で更新することを示します。

図 12. 統計の収集の例
//STEP1    EXEC DSNUPROC,UID='JUOSU339.LOAD1',TIME=1440,                 
//         UTPROC='',                                                    
//         SYSTEM='SSTR'                                     
//SYSREC   DD DSN=CUST.FM.CINT135.DATA,DISP=SHR,VOL=SER=FORDMD,          
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND)                       
//SYSIN    DD *                                                          
  TEMPLATE ERRDDN  UNIT(SYSDA)                                           
                   DSN(JUOSU339.T&TI..&ST..ERRDDN)                       
                   SPACE(50,10) TRK                                      
  TEMPLATE UT1     UNIT(SYSDA)                                           
                   DSN(JUOSU339.T&TI..&ST..SYSUT1)                       
                   SPACE(50,10) TRK                                      
  TEMPLATE OUT     UNIT(SYSDA)                                          
                   DSN(JUOSU339.T&TI..&ST..SYSOUT)                       
                   SPACE(50,10) TRK                                      
  TEMPLATE MAP     UNIT(SYSDA)                                           
                   DSN(JUOSU339.T&TI..&ST..SYSMAP)            
                   SPACE(50,10) TRK                           
  TEMPLATE DISCARD UNIT(SYSDA)                                
                   DSN(JUOSU339.T&TI..&ST..DISCARD)           
                   SPACE(50,10) TRK                           
  TEMPLATE COPYT1                                             
           UNIT(SYSDA)                                        
           DSN(JUOSU339.COPY1.STEP1.&SN..COPY&LR.&PB.)        
           DISP(MOD,CATLG,CATLG)                              
           SPACE(60,30) TRK                                   
  LOAD DATA INDDN SYSREC REPLACE                              
   CONTINUEIF(79:80)='++'                                     
   COPYDDN(COPYT1)                                            
   STATISTICS                                                 
     TABLE (TBOS3902) SAMPLE 53                               
       COLUMN (QT_INV_TRANSACTION,                            
               NO_DEPT,                                       
               NO_PART_PREFIX,                                
               DT_TRANS_EFFECTIVE)                                             
     INDEX (IDOS3902                             
       FREQVAL NUMCOLS 4 COUNT 20)                      
     REPORT YES UPDATE ALL HISTORY ALL                  
   ERRDDN(ERRDDN)                                       
   WORKDDN(UT1,OUT)                                     
   MAPDDN(MAP)                                          
   DISCARDDN(DISCARD)                                   
  INTO TABLE                                            
       ADMF001.TBOS3902                                 
  ( ID_PARTITION       POSITION(1)   CHAR(1),                      
    CD_PLANT           POSITION(2)   CHAR(5),                      
    NO_PART_BASE       POSITION(7)   CHAR(9),                      
    NO_PART_PREFIX     POSITION(16)  CHAR(7),                      
   NO_PART_SUFFIX     POSITION(23)  CHAR(8),                        
  NO_PART_CONTROL    POSITION(31)   CHAR(3),                        
  DT_TRANS_EFFECTIVE POSITION(34)   DATE EXTERNAL(10),                        
  CD_INV_TRANSACTION POSITION(44)   CHAR(3),                        
  TS_PROCESS         POSITION(47)   TIMESTAMP EXTERNAL(26),                        
  QT_INV_TRANSACTION POSITION(73)   INTEGER,                        
  CD_UNIT_MEAS_USAGE POSITION(77)   CHAR(2),                        
  CD_USER_ID         POSITION(79)   CHAR(7),                        
  NO_DEPT            POSITION(86)   CHAR(4),                        
  NO_WORK_CENTER     POSITION(90)   CHAR(6))               
/*  

例 13: ユニコード・データをロードする

次の制御 ステートメントは、REC1 入力データ・セットからのユニコード・データが 表 ADMF001.TBMG0301 にロードされる指定を行っています。UNICODE オプションは、入力データの タイプを指定しています。WHEN 文節で指定された条件を満たしているデータのみがロードされ ます。CCSID オプションは、入力ファイルに対して 3 つのコード化文字セット ID を指定します。 1 つは SBCS データ用、1 つは混合データ用、もう 1 つは DBCS データ用 です。LOG YES は、LOAD ジョブの際に、ロギングが行われることを示しています。

LOAD DATA INDDN REC1     LOG YES REPLACE           
   UNICODE CCSID(00367,01208,01200)                  
   INTO TABLE "ADMF001 "."TBMG0301"        
   WHEN(00004:00005 = X'0003')                       

例 14: パーティションの並列処理を使用して、複数の入力データ・セットからデータをロードする

この例の LOAD 制御ステートメントは、 どのデータが表 DBA01.TBLX3303 の、どのパーティションにロードされるかを指定した、 一連の INTO TABLE ステートメントを含んでいます。 それぞれの INTO TABLE ステートメントごとに、以下のことを行います。

  • データを、PART オプションで示されたパーティションにロードします。 例えば、最初の INTO TABLE ステートメントは、表 DBA01.TBLX3303 の先頭 パーティションにデータをロードすることを指定します。
  • データを、INDDN オプションで示されたデータ・セットからロードします。 例えば、PART1 データ・セットからのデータが先頭パーティションにロードされます。
  • 廃棄された行はいずれも、DISCARDDN オプションで指定されたデータ・セットに書き込まれます。 例えば、PART1 データ・セットからのデータのロードの際に廃棄された行は、DISC1 データ・セットに書き込まれます。
  • データは、指定された列 (EMPNO、LASTNAME、および SALARY) にロードされます。

LOAD は、パーティションの並列処理を使用して、データをこれらのパーティション にロードします。

TEMPLATE ユーティリティー制御ステートメントは、次の LOAD ジョブの際に動的に 割り振る必要のあるデータ・セットについて、データ・セット名命名規則を定義します。 テンプレートの名前は ERR3 です。LOAD ステートメントの ERRDDN オプションは、 いずれのエラーも ERR3 テンプレートで定義されたデータ・セットに書き込むことを 指定します。

図 13. 個々のデータ・セットからのデータのロードの例
 TEMPLATE ERR3                                  
         DSN &UT..&JO..&ST..ERR3&MO.&DAY.      
         UNIT SYSDA  DISP(NEW,CATLG,CATLG)     
  LOAD DATA                                      
    REPLACE          
    ERRDDN ERR3                                  
    INTO TABLE DBA01.TBLX3303                    
      PART 1                                     
      INDDN PART1                                
      DISCARDDN DISC1                            
        (EMPNO      POSITION(1)    CHAR(6),      
         LASTNAME   POSITION(8)    VARCHAR(15),  
         SALARY     POSITION(25)   DECIMAL(9,2)) 
    .                                            
    .                                            
    .                                            
    INTO TABLE DBA01.TBLX3303                   
      PART 5                                    
      INDDN PART5                               
      DISCARDDN DISC5                           
        (EMPNO      POSITION(1)    CHAR(6),     
         LASTNAME   POSITION(8)    VARCHAR(15), 
         SALARY     POSITION(25)   DECIMAL(9,2))
/* 

例 15: 宣言されたカーソルを使用して、同じシステムの別の表からのデータをロードする

次の LOAD 制御ステートメントは、カーソル C1 で示されているすべての 行を、表 MYEMP にロードする指定を行ってい ます。INCURSOR オプションを使用して、カーソル C1 を指定しています。 このカーソルは、EXEC SQL ユーティリティー制御ステートメントで定義されています。 カーソル C1 は、ステートメント SELECT * FROM DSN8810.EMP を実行することによって戻される 行を指しています。 この例では、表 DSN8810.EMP の列名は、表 MYEMP の列名と同じです。 カーソルは、Db2 がデータをロードする先と同じ表では定義できないことに注意してください。

EXEC SQL
  DECLARE C1 CURSOR FOR SELECT * FROM DSN8810.EMP
ENDEXEC
LOAD DATA
INCURSOR(C1)
REPLACE
INTO TABLE MYEMP
STATISTICS

例 16: 宣言されたカーソルを使用して、リモート・サイトからデータ・パーティションを並列にロードする

この例の LOAD 制御ステートメント は、表 MYEMPP の指定されたそれぞれのパーティションごとに、指定されたカーソルで示された行をロードする 指定を行っています。 それぞれの INTO TABLE ステートメントで、PART オプションはパーティション番号を指定し、 さらに INCURSOR オプションはカーソルを指定しています。 例えば、カーソル C1 で示されている行が先頭パーティションにロードされます。 それぞれのパーティションごとに、データは並列にロードされます。

それぞれのカーソルは別々の EXEC SQL ユーティリティー制御ステートメントで 定義され、指定された SELECT ステートメントを実行することによって戻された行を指しています。 このような SELECT ステートメントは、リモート・サーバーの表で実行されるため、3 部構成の名前 を使用して表を識別しています。 この例では、表 CHICAGO.DSN8810.EMP の列名は、表 MYEMPP の列名と同じです。

ロードされる 4 つのパーティションには、それぞれ異なる数のレコードが含まれます。 LOAD ユーティリティーで必要とされるソート作業データ・セットのサイジングを改善するには、各パーティションにロードされるレコードの数を、各表の NUMRECS キーワードに指定します。

図 14. 宣言されたカーソルを使用してデータ・パーティションを並列にロード
EXEC SQL
  DECLARE C1 CURSOR FOR SELECT * FROM CHICAGO.DSN8810.EMP
  WHERE EMPNO <= '099999'
ENDEXEC
EXEC SQL
  DECLARE C2 CURSOR FOR SELECT * FROM CHICAGO.DSN8810.EMP
  WHERE EMPNO > '099999' AND EMPNO <= '199999'
ENDEXEC
EXEC SQL
  DECLARE C3 CURSOR FOR SELECT * FROM CHICAGO.DSN8810.EMP
  WHERE EMPNO > '199999' AND EMPNO <= '299999'
ENDEXEC
EXEC SQL
  DECLARE C4 CURSOR FOR SELECT * FROM CHICAGO.DSN8810.EMP
  WHERE EMPNO > '299999' AND EMPNO <= '999999'
ENDEXEC
LOAD DATA
  INTO TABLE MYEMPP PART 1 REPLACE INCURSOR(C1) NUMRECS 10000
  INTO TABLE MYEMPP PART 2 REPLACE INCURSOR(C2) NUMRECS 50000
  INTO TABLE MYEMPP PART 3 REPLACE INCURSOR(C3) NUMRECS 100000
  INTO TABLE MYEMPP PART 4 REPLACE INCURSOR(C4) NUMRECS 50000

例 17: ファイルから LOB データをロードする

この例にある LOAD 制御ステートメントには、000130DSN!10.SDSNIVPD(DSN8R130) からのデータを MY_EMP_PHOTO_RESUME 表にロードすることを指定しています。1 から 6 の位置にある文字が EMPNO 列にロードされ、位置 7 から始まる文字が RESUME 列にロードされます。CLOBF の意味は、位置 7 にある文字がファイル名であり、そのファイルから CLOB をロードすることを示します。

REPLACE の意味は、新規データがすべての既存データを置き換えることを示します。LOG NO オプションに示されているとおり、ロギングは行われませんが、NOCOPYPEND が指定されているので、表スペースは CHECK ペンディング状況に設定されません。

SORTKEYS 1 の意味は、1 つの索引キーがソートされることを示します。

図 15. ファイルからの LOB データのロード例
//*****************************************************************
//*   LOAD LOB from file
//*****************************************************************
//LOADIT   EXEC DSNUPROC,UID='LOADIT',TIME=1440,
//         UTPROC='',
//         SYSTEM='DSN'
//SYSREC   DD*
000130DSN!10.SDSNIVPD(DSN8R130)
//SYSUT1   DD DSN=SYSADM.LOAD.SYSUT1,DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND)
//SORTOUT  DD DSN=SYSADM.LOAD.SORTOUT,DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND)
//SYSIN    DD  *
 LOAD DATA
   REPLACE LOG NO NOCOPYPEND
   SORTKEYS 1
      INTO TABLE MY_EMP_PHOTO_RESUME
      (EMPNO    POSITION(1:6) CHAR(6),
       RESUME   POSITION(7:31)   CHAR CLOBF)
変更の始まり

例 18: 並列サブタスクを使用してロードする

次の LOAD ステートメントは、PARALLEL キーワードで指示されているとおり、複数の並列サブタスクが LOAD で使用されることを指定します。PARALLEL キーワードに値が指定されていないので、Db2 が最適の並列処理の度合いを判別します。このように並列処理を使用すると、大量のデータをロードする際に要する経過時間を削減できる可能性があります。
LOAD DATA                                                       
PARALLEL                                                        
RESUME YES                                                      
SHRLEVEL NONE                                                   
INDDN INPUT1                                                    
EBCDIC                                                          
CONTINUEIF(80:80)='-'                                           
INTO TABLE SCTX1300.TB_HISTORY_PART                             
(HISTORY_DAILY POSITION(1:11) INT EXTERNAL,                     
 HISTORY_ROWNUM POSITION(13:23) INT EXTERNAL,                   
 HISTORY_CUSTOMER_ID POSITION(25:35) INT EXTERNAL,              
 HISTORY_CUSTOMER_ACCOUNT_ID POSITION(37:50) DECIMAL EXTERNAL,  
 HISTORY_CUSTOMER_DISTRICT_ID POSITION(52:53) CHAR,             
 HISTORY_CUSTOMER_WAREHOUSE_ID POSITION(55:64) CHAR,            
 HISTORY_DISTRICT_ID POSITION(66:67) CHAR,                      
 HISTORY_TRANSACTION_ID POSITION(69:70) CHAR,                   
 HISTORY_WAREHOUSE_ID POSITION(72:81) CHAR,                     
 HISTORY_DATE POSITION(83:108) TIMESTAMP EXTERNAL,              
 HISTORY_AMOUNT POSITION(110:126) DECIMAL EXTERNAL,             
 HISTORY_STATUS POSITION(128:144) VARCHAR,                      
 HISTORY_DATA POSITION(3874:3899) VARCHAR)                      
変更の終わり