DSNH312I   E csect-name LINE line-number COL column-number UNDEFINED OR UNUSABLE HOST VARIABLE variable-name

説明

SQL ステートメント内の指定された変数に関する問題が発生しました。アプリケーション・プログラム内のステートメントの前に宣言が見つからないか、または意図していた使用法には変数の属性が不適切です。

csect-name
メッセージを発行した制御セクションの名前。
line-number
アプリケーション・プログラムのソース・コードの行番号。
column-number
列の数値表現。 最初の列は列 1、2 番目の列は列 2 として示され、以後同様です。
variable-name
エラーを引き起こした変数の名前。

このメッセージは、参照時にのみ出されます。

システムの処置

この変数を含む SQL ステートメントが宣言である場合、その SQL ステートメントは破棄されます。

この変数を含む SQL ステートメントが実行可能である場合、その SQL ステートメントは、実行された場合にホスト言語ステートメントに置き換えられ、SQLCA 内にエラー・コードを設定します。

ユーザーの処置

示されたホスト変数の宣言および属性を検査してください。 その名前で列を参照するつもりであった場合は、コロン (:) があってはなりません。リテラルのつもりであった場合は、値をストリング区切り文字 (アポストロフィまたは引用符) で囲んでください。

ホスト変数を使用するつもりであった場合、Db2® ホスト変数として使用するには、可能な変数を宣言したサブセットだけしか有効ではありません。 SQL ステートメント内のホスト変数の規則に関する情報を参照してください。

問題の原因を判別するには、相互参照リストとソース・リストを使用して、以下のいずれかの状態を適用するかどうかを判別してください。

  • STDSQL(YES) SQL 処理オプションを使用している場合は、すべてのホスト変数宣言が BEGIN DECLARE SECTION と END DECLARE SECTION の中で宣言されるようにしてください。
  • 相互参照リストにホスト変数名が含まれていない場合は、 宣言が欠落しています。 宣言のソースが存在する場合は、注釈またはストリングから 終了文字が抜けているために、この種のエラーが起こることがあります。 マージン設定が原因でこのタイプのエラーが起こることもあります。
  • その名前は存在するが、データ・タイプがリストされていない場合、ホスト変数は使用可能ではありません。ホスト変数が、有効なホスト変数定義に関する規則に従っていません。
  • その名前に関して複数の定義が存在する場合は、 定義よりも前に最初の参照が行われている可能性があります。 この状態で、TWOPASS SQL 処理オプションは、DECLARE ステートメントが 他のタイプのステートメントより前に処理されるようにします。ただし、 ホスト変数宣言およびカーソル宣言は、同じパスで処理されます。カーソル宣言で参照されるホスト変数は、カーソルの定義よりも前にアプリケーション・プログラム内に定義しなければなりません。この規則は、ONEPASS 処理オプションと TWOPASS SQL 処理オプションのどちらが使用されているかにかかわらず適用されます。
  • EXECUTE IMMEDIATE ステートメントでは、 ホスト変数ではなくパラメーター・マーカーが予期されています。
  • CALL ステートメント中で渡されたホスト変数のデータ・タイプが、CHAR または VARCHAR ではありません。
  • CALL ステートメント中で渡された CHAR または VARCHAR ホスト変数の長さ属性が、255 文字を超えます。
  • COBOL のプリコンパイラーを使用している場合は、名前指定されているホスト変数が FILLER エレメントを含む構造内で宣言されているかどうかを確認してください。FILLER エレメントがその構造内の変数を無効にする可能性があります。

重大度

8 (エラー)