DSNH メッセージ
Db2® プリコンパイラーまたは Db2 コプロセッサー に関する情報を伝える、DSNH で始まるメッセージ番号。
Db2 プリコンパイラーについての記述は、 特に明示しない限り、Db2 コプロセッサーにも当てはまります。 Db2 コプロセッサーは、コンパイラーを通じて呼び出されます。
メッセージ行番号
DSNH メッセージの行番号 nnnn は、 元のソース行に順次番号を割り当てることによって生成されます。 これらの番号は、SQL Db2 プリコンパイラー・ソース・リストに印刷されます (プリコンパイラーに対して、SOURCE オプションが指定されている場合)。 Db2 コプロセッサーを使用する場合、 エラー・メッセージとその行番号 (該当がある場合) が、コンパイラー出力リストに印刷されます。 行番号は、その SQL ステートメントの先頭を指します。 桁番号 (判定可能な場合) は、エラーがある SQL ステートメントの先頭からの相対番号になります。
メッセージの中の「COL cc」は、条件が検出されたソースの桁を示します。 示されている桁 'cc' は、通常、 関連するソース・トークンの最初の文字が含まれている桁のロケーションです。 しかし、プリコンパイラーがこのロケーションを判別できない場合は、 ステートメントの先頭のロケーションが示されます。 検出されたエラーが、有効ではあるが別の構造に類似している場合があるので、 SQL 構文解析で、エラーに関して間違ったロケーションが示されることがあります。
メッセージ重大度コード
各プリコンパイラー・メッセージの前には、プログラマーに対する手助けとして、 文字 I、W、E、S、または U の 1 つが示されます。 これらの文字は、重大度レベルを以下のように示します。
| I | 0 | 通知 |
| W | 4 | 警告 |
| E | 8 | エラー |
| S | 12 | 重大エラー |
| U | 16 | 回復不能エラー |
SQL(ALL) プリコンパイル時にサポートされない非 Db2 ステートメントが検出されたとき、戻りコードが 8 で、かつホスト関連エラーが検出されなかった場合には、戻りコードは強制的に 4 にセットされます。この処置がとられるのは、アプリケーションがコンパイルおよびリンク・エディット・ステップを続行できるようにし、 これにより構文検査がバインド時まで延期されるようにするためです。 重大度 8 のプリコンパイラー・エラー・メッセージがホスト関連エラーでない場合、 プリコンパイラーは、このエラーを警告として取り扱い、 プリコンパイラー出力リストでは E の代わりに W を入れます。 このインスタンスでは、プリコンパイラーからの実際の戻りコード 8 が 4 に変更されたことを示すため、 プリコンパイラーは DSNH049I も発行します。
重大度レベル 8 のプリコンパイラー・メッセージのうち、 SQL(ALL) が有効なとき、エラーから警告に変更されないメッセージは、次のとおりです。
- DSNH051I
- DSNH080I
- DSNH290I
- DSNH291I
- DSNH292I
- DSNH312I
- DSNH313I
- DSNH314I
- DSNH504I
ソース・トークン
ソース・プログラムからのトークンは、プログラムで現れるのとちょうど同じように、 いつもメッセージ中でも現れるわけではありません。 例えば、先行ゼロは整数トークンから除去されています。