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 の戻りコード:

表 2. 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';