FREE LOCATOR ステートメント

FREE LOCATOR ステートメントは、ラージ・オブジェクトのロケーター変数とその値との間の関連を除去します。

呼び出し

このステートメントは、アプリケーション・プログラムに組み込んだり、動的 SQL ステートメントを使用して発行したりすることができます。 このステートメントは、動的に作成できる実行可能ステートメントです。

許可

必要ありません。

構文

Read syntax diagramSkip visual syntax diagramFREELOCATOR,variable-name

説明

LOCATOR 変数名 ...
1 つまたは複数のラージ・オブジェクトのロケーター変数を指定します。 それらは、ロケーター変数の宣言規則に従って宣言されていなければなりません。

ロケーター変数には、現在ロケーターが割り当てられていなければなりません。 つまり、ロケーターはこの作業単位で割り当てられている (CALL、FETCH、SELECT INTO、または VALUES INTO ステートメントによって) 必要があり、 またその後解放されて (FREE LOCATOR ステートメントによって) いないことが必要です。 これに違反する場合には、エラーが戻されます (SQLSTATE 0F001)。

複数のロケーターを指定すると、 リスト中の他のロケーターにエラーがあるか否かには関係なく、 解放可能なすべてのロケーターは解放されることになります。

例

COBOL プログラムで、BLOB ロケーター変数 TKN-VIDEO と TKN-BUF、 および CLOB ロケーター変数 LIFE-STORY-LOCATOR を解放します。
   EXEC SQL
   FREE LOCATOR :TKN-VIDEO, :TKN-BUF, :LIFE-STORY-LOCATOR
   END-EXEC.