デフォルトではないオプションの動作を可能にします。
注: OPTION は非推奨です。下位互換性のみを目的として提供されています。代わりに同等の SQL コンパイラ指令オプションを使用することをお奨めします。
構文:
OPTION={SPCOMMITONRETURN | [NO]IGNORESCHEMAERRORS |
NESTEDCLRDEBUG | PROCOB | [NO]SPDISPLAY | [DESCRIBEVARCHARPICX |
DESCRIBEVARCHAR49] | [DESCRIBEDTREC | DESCRIBEDTCHAR] | OPTIMIZESPCURSORS}...
パラメーター:
- SPCOMMITONRETURN
- ストアド プロシージャが呼び出し元アプリケーションに返るとき、そのストアド プロシージャによって実行される処理にコミットします。
- IGNORESCHEMAERRORS
- 同時に SQL(CHECK) を指定する場合、スキーマ オブジェクトの欠落によって生じるコンパイル時のエラーが抑制されます。このモードでは、データベース スキーマを参照せずに OpenESQL を使用して SQL 構文エラーを検証できます。この場合、最初にデータベース スキーマを移行する必要なしに COBOL コンパイラと OpenESQL を使用して修正を必要とする文を特定できるので、アプリケーション移行の予定がある場合に便利です。さらに、開発段階で OpenESQL 構文のより高度な検証を実行できます。デフォルトは NOIGNORESCHEMAERRORS です。
- NESTEDCLRDEBUG
- ネストされたストアド プロシージャの呼び出しをデバックできます。このパラメーターを使わないと、結果セットを戻すストアド プロシージャをデバッグできません。これは、Microsoft SQL Common Language Runtime の制限によるものです。NESTEDCLRDEBUG は、ネストされたストアド プロシージャの呼び出しから戻される結果セットをすべて破棄するようにプロセッサに指示します。これにより、デバッグが可能になります。
- PROCOB
- DATE SQL コンパイラ指令オプションを .NET アプリケーションの場合のみ、つまり DBMAN=ADO の場合に EXTERNAL に設定します。
- SPDISPLAY
- COBOL DISPLAY 情報にどこでアクセスできるかを指定します。SQL CLR ストアド プロシージャに設定した場合、COBOL DISPLAY が SQL Server 情報メッセージとして呼び出し側に返送されます。COBOL アプリケーションに設定した場合、SQL Server 情報メッセージがコンソールに記述されます。SQL Server Management Studio など対話式の SQL ツールを使用して COBOL ストアド プロシージャを呼び出すと、情報メッセージがそのツールから出力されるメッセージによって表示されます。
SPDISPLAY は、デバッグ中のトレーシングやディプロイされたアプリケーションへのログインにも便利です。設定しない場合、COBOL DISPLAY 文は意味を持ちません。デフォルトは NOSPDISPLAY です。
- DESCRIBEVARCHARPICX
- VARCHAR 列は PIC X ホスト変数に適しています。これはデフォルトです。
- DESCRIBEVARCHAR49
- VARCHAR 列は、長さとデータにレベル 49 サブフィールドを使用する VARCHAR ホスト変数に適しています。
- DESCRIBEDTREC
- DATE、TIME、DATETIME 列は、DATE、TIME、および ODBC 形式レコード構造の TIMESTAMP-RECORD SQL TYPE に適しています。これはデフォルトです。
- DESCRIBEDTCHAR
- DATE、TIME、DATETIME 列は、PIC X(n) 文字列ホスト変数または DATE、TIME、TIMESTAMP SQL TYPE に適しています。
- OPTIMIZESPCURSORS
- SQL CLR ストアド プロシージャでは、順方向読み取り専用カーソルをファイアホース カーソルとして開き、後続のカーソルが開くと、結果セットの残りをメモリに読み込んでパフォーマンスを最適化します。
依存性:
BEHAVIOR=OPTIMIZED は自動的に DESCRIBEDTCHAR を設定します。
範囲:
コンパイル時の使用: |
あり |
実行時の動作: |
ソース ファイル |
詳細については、「範囲 - OpenESQL SQL コンパイラ指令オプション」を参照してください。
説明:
OPTION の各インスタンスはスペースで区切ります。
例:
SQL(OPTION=DESCRIBEVARCHARPIX OPTION=NESTEDCLRDEBUG)
SQL(OPTION=DESCRIBEVARCHARPIX OPTION=IGNORESCHEMAERRORS OPTION=OPTIMIZESPCURSORS OPTION=PROCOB)