DSNTIAD
DSNTIAD プログラムは、SELECT ステートメント以外の SQL ステートメントを 動的に実行するために使用します。
DSNTIAD パラメーター:
- RC0
- このパラメーターが指定されている場合、DSNTIAD プログラムは SQL エラーが発生しても戻りコード 0 で終了 します。RC0 が指定されていない場合、DSNTIAD は、発生したエラーの重大度を 反映する戻りコードで終了します。RC0 が指定されていない場合、DSNTIAD は、1 回の実行中に 10 個を超える SQL エラーが 発生すると終了します。
- SQLTERM(termchar)
- このパラメーターを使用して、
各 SQL ステートメントを終わらせるために使用する文字を指定します。
以下の表にリストされている文字を除く任意の特殊文字を
使用できます。デフォルトは SQLTERM(;) です。
表 1. SQL 終了文字には無効な特殊文字 名前 文字 16 進表記 ブランク X'40' コンマ , X'6B' 二重引用符 " X'7F' 左括弧 ( X'4D' 右括弧 ) X'5D' 単一引用符 ' X'7D' 下線 _ X'6D' 組み込みセミコロンが含まれているステートメントを実行する予定の場合、 セミコロン以外の文字を使用してください。
例:パラメーター SQLTERM(#) を指定して、文字 # がステートメント終了文字であることを指定すると想定します。そうすると、組み込みセミコロンのある CREATE TRIGGER ステートメントは、 次のようになります。
CREATE TRIGGER NEW_HIRE AFTER INSERT ON EMP FOR EACH ROW MODE DB2SQL BEGIN ATOMIC UPDATE COMPANY_STATS SET NBEMP = NBEMP + 1; END#組み込みセミコロンのある CREATE PROCEDURE ステートメント は、次のようになります。
CREATE PROCEDURE PROC1 (IN PARM1 INT, OUT SCODE INT) LANGUAGE SQL BEGIN DECLARE SQLCODE INT; DECLARE EXIT HANDLER FOR SQLEXCEPTION SET SCODE = SQLCODE; UPDATE TBL1 SET COL1 = PARM1; END #ステートメント内で使用されない文字をステートメント終了文字として 選択するよう注意してください。
DSNTIAD データ・セット:
- データ・セット
- 説明
- SYSIN
- 入力データ・セット。このデータ・セットには、任意の数の SELECT 以外の SQL ステートメント (それぞれがセミコロンで
終わっている) を入れることができます。1 つのステートメントが複数行にまたがっていてもかまいませんが、
DSNTIAD は各行の最初の 72 バイトしか読み取りません。
DSNTIAD 入力にコメントを入れることはできません。
- SYSPRINT
- 出力データ・セット。DSNTIAD は、通知メッセージとエラー・メッセージをこの データ・セットに書き込みます。DSNTIAD は、このデータ・セットのレコード長を 121 バイトに 設定し、ブロック・サイズを 1210 バイトに設定します。
すべてのデータ・セットを順次データ・セットとして定義してください。
DSNTIAD の戻りコード:
| 戻りコード | 意味 |
|---|---|
| 0 | 正常終了、または、ユーザー指定のパラメーター RC0。 |
| 4 | 警告コードを受け取った SQL ステートメントがある。 |
| 8 | エラー・コードを受け取った SQL ステートメントがある。 |
| 12 | DSNTIAD がデータ・セットをオープンできなかったか、長さが 2 MB バイトを超えた SQL ステートメントがあるか、重大エラー・コード (-8nn または -9nn) を戻した SQL ステートメントがあるか、 または、SQL メッセージ・フォーマット設定ルーチンでエラーが発生した。 |
DSNTIAD 呼び出しの例:
20 個の UPDATE ステートメントを実行する必要があり、10 個を超えるエラーが発生しても DSNTIAD が終了しないようにすると仮定します。この場合の呼び出しは、次の図の ようになります。
//RUNTIAD EXEC PGM=IKJEFT01,DYNAMNBR=20
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
DSN SYSTEM(DSN)
RUN PROGRAM(DSNTIAD) PLAN(DSNTIAB1) PARMS('RC0') -
LIB('DSN1110.RUNLIB.LOAD')
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSIN DD *
UPDATE DSN8B10.PROJ SET DEPTNO='J01' WHERE DEPTNO='A01';
UPDATE DSN8B10.PROJ SET DEPTNO='J02' WHERE DEPTNO='A02';
⋮
UPDATE DSN8B10.PROJ SET DEPTNO='J20' WHERE DEPTNO='A20';