DSNTIAUL

DSNTIAUL プログラムは、Db2® 表からデータを アンロードして順次データ・セットに入れるために使用します。データはデータ・セットにコピーされ、表からは削除されません。

複数行フェッチが使用されると、照会のトップレベル照会ブロック内の最後の並列グループで、並列処理が使用不可になる場合があります。非常に単純な照会の場合、複数行フェッチが使用されると、照会全体で並列処理が使用不可になる場合があります。DSNTIAUL 実行時に完全並列処理を行うには、1 回のフェッチ当たりの行数を指定するパラメーターに 1 を指定して、DSNTIAUL を単一行フェッチ・モードに切り替えてください。

DSNTIAUL は、SQL を使用して Db2 にアクセスします。行レベルまたは列レベルのアクセス制御が実施された表に対する操作には、アクセス制御に指定された規則が適用されます。表で行レベルのアクセス制御が実施されている場合は、DSNTIAUL は、ユーザーの行の許可を満たす表の行のみを受け取り、戻します。表で列レベルのアクセス制御が実施されている場合は、DSNTIAUL は、ユーザーの列マスクで変更された列値で値を受け取り、戻します。

DSNTIAUL パラメーター:

SQL
SQL の指定は、入力データ・セットが 1 つ以上の完全な SQL ステートメント (それぞれがセミコロンで終わっている) を含むことを 指定します。動的に実行可能な任意の SQL ステートメントを入力データ・セットに入れることができます。 さらに、静的 SQL ステートメントの CONNECT、 SET CONNECTION、または RELEASE も含めることができます。 静的 SQL ステートメントは大文字でなければなりません。

DSNTIAUL は、アンロードする表を決定するために SELECT ステートメントを使用し、(CONNECT、SET CONNECTION、および RELEASE を除く) 他のすべてのステートメントを動的に実行します。 DSNTIAUL は、CONNECT、SET CONNECTION、および RELEASE を 静的に実行して、リモート・ロケーションに接続します。

number of rows per fetch
DSNTIAUL が 1 回のフェッチで取得する行の数を、1 から 32767 の 範囲で指定します。この数が指定されていない場合、DSNTIAUL はフェッチ当たり 100 行 を取得します。このパラメーターは、SQL パラメーターと共に指定できます。
TOLWARN
NO (デフォルト) または YES を指定して、DSNTIAUL が SQL 警告を 受け取った後に行の取得を続行するかどうかを指示します。
(NO)
DSNTIAUL が行を取得するために OPEN または FETCH を実行しているときに警告が発生した場合、 DSNTIAUL は行の取得を停止します。DSNTIAUL が行を取得するために FETCH を実行する際に SQLWARN1、SQLWARN2、SQLWARN6、または SQLWARN7 フラグが設定された場合、DSNTIAUL は行の取得を続行します。
(YES)
DSNTIAUL が行を取得するために OPEN または FETCH を実行しているときに警告が発生した場合、 DSNTIAUL は行の取得を続行します。
LOBFILE(prefix)
DSNTIAUL がデータ・セット (各データ・セットが 1 つの LOB セルの全内容を受け取る) を 動的に割り振るようにするには、LOBFILE を指定します (LOB セル とは、行と LOB 列の交点です)。LOBFILE オプション を指定しない場合、1 つの LOB 列から 32 KB までのデータしかアンロードできません。
接頭部 (prefix)
これらの動的に割り振られるデータ・セットの高位修飾子を指定します。 最大 17 文字まで指定できます。この修飾子は、TSO データ・セット名の命名規則に 準拠していなければなりません。
DSNTIAUL は、これらの動的に割り振られるデータ・セットの高位修飾子 の命名規則として prefix.Qiiiiiii.Cjjjjjjj.Rkkkkkkk を使用します。 修飾子の値は次のとおりです。
接頭部 (prefix)
LOBFILE オプションに指定する高位修飾子。
Qiiiiiii
1 つ以上の LOB 列を戻す照会のシーケンス番号 (0 から始まる)。
Cjjjjjjj
1 つ以上の LOB 列を戻す照会内の列のシーケンス番号 (0 から始まる)。
Rkkkkkkk
1 つ以上の LOB 列が含まれる結果セットの行のシーケンス番号 (0 から始まる)。

生成される LOAD ステートメント には、LOB ファイル参照変数が含まれています。これらの変数を、動的に割り振られるこれらのデータ・セットから データをロードするために使用できます。

SQL パラメーターを指定しない場合、入力データ・セットには、以下の構文を使用する 1 つ以上の 単一行ステートメント (セミコロンなし) が入っていなければ なりません。
table or view name [WHERE conditions] [ORDER BY columns]
各入力ステートメント は、SELECT * FROM 文節が省略され、終わりのセミコロンがない、有効な SQL SELECT ステートメントでなければなりません。DSNTIAUL は、 入力した各ステートメントごとに、SELECT * FROM に入力行を付加して 1 つの SELECT ステートメントを生成し、 その結果を使用してアンロード元の表を決定します。この入力フォーマットでは、 表仕様のテキストは最大 72 バイトまでであり、複数行にまたがっていてはなりません。

入力ステートメントを使用して、複数の表を結合する SELECT ステートメント、 または、表から特定の列を選択する SELECT ステートメントを指定することができます。列を指定する場合は、 DSNTIAUL が生成する LOAD ステートメントを変更する必要があります。

DSNTIAUL データ・セット:

データ・セット
説明
SYSIN
入力データ・セット。

DSNTIAUL 入力にコメントを入れることはできません。

この入力データ・セットの レコード長は 72 バイト以上でなければなりません。DSNTIAUL は、各レコードの 最初の 72 バイトしか読み取りません。

SYSPRINT
出力データ・セット。DSNTIAUL は、通知メッセージとエラー・メッセージをこの データ・セットに書き込みます。

SYSPRINT データ・セットのレコード長は 121 バイトです。

SYSPUNCH
出力データ・セット。DSNTIAUL は、LOAD ユーティリティー制御ステートメントをこの データ・セットに書き込みます。
SYSRECnn
出力データ・セット。値 nn の範囲は 00 から 99 まで です。1 回の DSNTIAUL の実行用に最大 100 個の出力データ・セットを 用意できます。各データ・セットには、入力データ・セット から 1 つの SELECT ステートメントを DSNTIAUL が処理するときにアンロードされるデータが収容されます。従って、 出力データ・セット数は、SELECT ステートメントの数と一致する (パラメーター SQL を 指定した場合) か、入力データ・セット内の表仕様の数と一致しなければなりません。

すべてのデータ・セットを順次データ・セットとして定義してください。SYSPUNCH データ・セットと SYSRECnn データ・セットの レコード長およびブロック・サイズを指定することができます。SYSPUNCH データ・セットと SYSRECnn データ・セットの 最大レコード長は 32760 バイトです。

DSNTIAUL の戻りコード:

表 1. DSNTIAUL の戻りコード
戻りコード 意味
0 正常終了。
4 警告コードを受け取った SQL ステートメントがある。
  • TOLWARN(YES) が指定されており、SELECT ステートメントの処理中に FETCH または OPEN で警告が発生した場合、Db2 はアンロード操作を実行します。
  • それ以外の場合で、その SQL ステートメントが SELECT ステートメントであった場合、Db2 は関連するアンロード操作を実行しませんでした。
Db2 が +394 (最適化のヒントを使用していることを示す) または +395 (1 つ以上の無効な最適化のヒントを示す) を戻す場合、Db2 はアンロード操作を実行します。
8 エラー・コードを受け取った SQL ステートメントがある。その SQL ステートメントが SELECT ステートメントの場合、Db2 は関連するアンロード操作を実行していないか、操作を完了していません。
12 DSNTIAUL がデータ・セットを開けなかったか、重大エラー・コード (-144、-302、-804、-805、-818、-902、-906、-911、-913、-922、-923、-924、または -927) を返した SQL ステートメントがあるか、または SQL メッセージ・フォーマット設定ルーチンでエラーが発生した。

ある 1 つの表内の行のサブセットをアンロードするための DSNTIAUL の使用例:

プロジェクト表から部門 D01 の行をアンロードする必要があると想定します。表仕様を 1 行に収めることができ、 SELECT 以外のステートメントを何も実行しないため、SQL パラメーターを指定する必要はありません。この場合の呼び出しは、次の図の ようになります。

//UNLOAD  EXEC PGM=IKJEFT01,DYNAMNBR=20
//SYSTSPRT DD  SYSOUT=*
//SYSTSIN  DD  *
 DSN SYSTEM(DSN)
 RUN  PROGRAM(DSNTIAUL) PLAN(DSNTIBB1) -
       LIB('DSN1110.RUNLIB.LOAD')
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSREC00 DD DSN=DSN8UNLD.SYSREC00,
//            UNIT=SYSDA,SPACE=(32760,(1000,500)),DISP=(,CATLG),
//            VOL=SER=SCR03
//SYSPUNCH DD DSN=DSN8UNLD.SYSPUNCH,
//            UNIT=SYSDA,SPACE=(800,(15,15)),DISP=(,CATLG),
//            VOL=SER=SCR03,RECFM=FB,LRECL=120,BLKSIZE=1200
//SYSIN    DD *DSN8B10
.PROJ WHERE DEPTNO='D01'

複数の表内の行のサブセットをアンロードするための DSNTIAUL の使用例:

DSNTIAUL を使用して、さらに以下のアクションを実行する必要があると想定します。

  • プロジェクト表からすべての行をアンロードする
  • 部門番号が D で始まる部門の従業員の行のみを従業員表からアンロードし、 アンロードした行を従業員番号順に並べる。
  • アンロードの前に両方の表を共有モードでロックする。
  • フェッチ当たり 250 行を取得する。

上記のアクティビティーを実行するには、DSNTIAUL を実行する際に、SQL パラメーターを 指定し、フェッチ当たりの行数を指定する必要があります。この場合の DSNTIAUL 呼び出しは、 次の図のようになります。

//UNLOAD  EXEC PGM=IKJEFT01,DYNAMNBR=20
//SYSTSPRT DD  SYSOUT=*
//SYSTSIN  DD  *
 DSN SYSTEM(DSN)
 RUN  PROGRAM(DSNTIAUL) PLAN(DSNTIBB1) PARMS('SQL,250') -
       LIB('DSN1110.RUNLIB.LOAD')
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSREC00 DD DSN=DSN8UNLD.SYSREC00,
//            UNIT=SYSDA,SPACE=(32760,(1000,500)),DISP=(,CATLG),
//            VOL=SER=SCR03
//SYSREC01 DD DSN=DSN8UNLD.SYSREC01,
//            UNIT=SYSDA,SPACE=(32760,(1000,500)),DISP=(,CATLG),
//            VOL=SER=SCR03
//SYSPUNCH DD DSN=DSN8UNLD.SYSPUNCH,
//            UNIT=SYSDA,SPACE=(800,(15,15)),DISP=(,CATLG),
//            VOL=SER=SCR03,RECFM=FB,LRECL=120,BLKSIZE=1200
//SYSIN    DD *
LOCK TABLE DSN8B10.EMP IN SHARE MODE;
LOCK TABLE DSN8B10.PROJ IN SHARE MODE;
SELECT * FROM DSN8B10.PROJ;
SELECT * FROM DSN8B10.EMP
  WHERE WORKDEPT LIKE 'D%'
  ORDER BY EMPNO;

LOAD ユーティリティー制御ステートメントを取得するための DSNTIAUL の使用例:

表に行をロードするための LOAD ユーティリティー制御ステートメントを取得する必要があるが、行をアンロードする必要はない場合、SYSRECnn データ・セット名を DUMMY に設定できます。例えば、 部門表に行をロードするためのユーティリティー制御ステートメントを取得する には、次の図に示すように DSNTIAUL を呼び出します。

//UNLOAD  EXEC PGM=IKJEFT01,DYNAMNBR=20
//SYSTSPRT DD  SYSOUT=*
//SYSTSIN  DD  *
 DSN SYSTEM(DSN)
 RUN  PROGRAM(DSNTIAUL) PLAN(DSNTIBB1) -
       LIB('DSN1110.RUNLIB.LOAD')
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSREC00 DD DUMMY
//SYSPUNCH DD DSN=DSN8UNLD.SYSPUNCH,
//            UNIT=SYSDA,SPACE=(800,(15,15)),DISP=(,CATLG),
//            VOL=SER=SCR03,RECFM=FB,LRECL=120,BLKSIZE=1200
//SYSIN    DD *DSN8B10
.DEPT

LOB データをアンロードするための DSNTIAUL の使用例:

この例では、次のような構造のサンプル LOB 表を使用します。

CREATE TABLE DSN8910.EMP_PHOTO_RESUME
( EMPNO CHAR(06) NOT NULL,
EMP_ROWID ROWID NOT NULL GENERATED ALWAYS,
PSEG_PHOTO BLOB(500K),
BMP_PHOTO BLOB(100K),
RESUME CLOB(5K),
PRIMARY KEY (EMPNO))
IN DSN8D91L.DSN8S91B
CCSID EBCDIC;

以下の DSNTIAUL 呼び出しは、このサンプル LOB 表を アンロードします。DSNTIAUL に指定されたパラメーターは、以下のオプションを指定しています。

  • 入力データ・セット (SYSIN) に SQL が入っている。
  • DSNTIAUL はフェッチ当たり 2 行を取得する。
  • DSNTIAUL は高位修飾子 DSN8UNLD のデータ・セットに LOB データを入れる。
//UNLOAD   EXEC PGM=IKJEFT01,DYNAMNBR=20
//SYSTSPRT  DD SYSOUT=*
//SYSTSIN   DD *
  DSN SYSTEM(DSN)
  RUN PROGRAM(DSNTIAUL) PLAN(DSNTIB91) -
  PARMS('SQL,2,LOBFILE(DSN8UNLD)') -
  LIB('DSN910.RUNLIB.LOAD')
//SYSPRINT  DD SYSOUT=*
//SYSUDUMP  DD SYSOUT=*
//SYSREC00  DD DSN=DSN8UNLD.SYSREC00,
//             UNIT=SYSDA,SPACE=(800,(15,15)),DISP=(,CATLG),
//             VOL=SER=SCR03,RECFM=FB
//SYSPUNCH  DD DSN=DSN8UNLD.SYSPUNCH,
//             UNIT=SYSDA,SPACE=(800,(15,15)),DISP=(,CATLG),
//             VOL=SER=SCR03,RECFM=FB
//SYSIN     DD *
  SELECT * FROM DSN8910.EMP_PHOTO_RESUME;

このサンプル LOB 表 に 4 行のデータがあると仮定すると、DSNTIAUL は以下のような出力を生成します。

  • 列 EMPNO および EMP_ROWID のデータが、SYSREC00 DD ステートメント に従って割り振られたデータ・セットに入れられます。データ・セット名は DSN8UNLD.SYSREC00 です。
  • 生成された LOAD ステートメントが、SYSPUNCH DD ステートメント に従って割り振られたデータ・セットに入れられます。データ・セット名は DSN8UNLD.SYSPUNCH です。
  • LOB データを保管するために以下のデータ・セットが動的に作成されます。
    • DSN8UNLD.Q0000000.C0000002.R0000000
    • DSN8UNLD.Q0000000.C0000002.R0000001
    • DSN8UNLD.Q0000000.C0000002.R0000002
    • DSN8UNLD.Q0000000.C0000002.R0000003
    • DSN8UNLD.Q0000000.C0000003.R0000000
    • DSN8UNLD.Q0000000.C0000003.R0000001
    • DSN8UNLD.Q0000000.C0000003.R0000002
    • DSN8UNLD.Q0000000.C0000003.R0000003
    • DSN8UNLD.Q0000000.C0000004.R0000000
    • DSN8UNLD.Q0000000.C0000004.R0000001
    • DSN8UNLD.Q0000000.C0000004.R0000002
    • DSN8UNLD.Q0000000.C0000004.R0000003
    例えば、DSN8UNLD.Q0000000.C0000004.R0000001 は、 最初の照会 (Q0000000) の結果セットの第 2 行 (R0000001) と第 5 列 (C0000004) からアンロードされたデータが このデータ・セットに含まれることを意味します。