名前
sqlcc -- SQL埋込みCプログラムのコンパイル・リンク
形式
sqlcc [ -l ソースリストを出力するディレクトリ ]
[ -t Cプログラムソースを出力するディレクトリ ]
[ { -I インクルードファイルの配置ディレクトリ} ... ]
[ -d データベース名 ]
[ { -W { 88 | 92 | 95 | 96 | 2000 | 2007 } | -R } ]
[ -C ]
[ -T ]
[ -v9 ]
[ -L リンカへのオプション ]
SQL埋込みCプログラムのファイル名
[ clコマンド用のオプション ]機能説明
SQL埋込みCプログラムを、コンパイルおよびリンクします。
オプション
本コマンドのオプションはすべて環境変数“SQLPC”で指定することができます。
環境変数“SQLPC”にパラメタを設定しておくと、コマンド実行時にオプションを指定する必要がなくなります。
パラメタが重複した場合の優先順位は、本コマンドのオプション、環境変数“SQLPC”の順番となります。
環境変数“SQLPC”の設定は、setコマンドで行うことができます。
以下にsetコマンドの例を示します。
set SQLPC= -l c:\rdb2\sqlapp\list -t c:\rdb2\sqlapp\csrc
-I c:\rdb2\sqlapp\includeソースリストの出力先ディレクトリを指定します。
ディレクトリに指定できる長さは、1024バイトまでです。
ソースリストとは、SQL埋込みCプログラムの内容と行番号を、コンパイル後のソースファイルの行番号と対応付けたリストです。
ソースリストのファイル名は、SQL埋込みCプログラムのファイル名の拡張子を“.lst”に変換したものになります。
本オプションを省略した場合、カレントディレクトリに出力されます。
コンパイル後のCプログラムのソースファイルを出力するディレクトリを指定します。
ディレクトリに指定できる長さは、1024バイトまでです。
ソースファイル名は、SQL埋込みCプログラムのファイル名の拡張子を“.c”に変換したものとなります。
本オプションを省略した場合、カレントディレクトリに出力されます。
SQL埋込みCプログラム中にINCLUDE文を記述している場合、取り込むファイルの配置先ディレクトリを指定します。
ディレクトリに指定できる長さは、1024バイトまでです。
このオプションは、複数回指定できますが、有効となるディレクトリの数は、環境変数での指定も含めて10個までです。
sqlccによるディレクトリのサーチ手順は、以下のようになります。
カレントディレクトリ
sqlccコマンドの-Iオプション
環境変数“SQLPC”の-Iオプション
環境変数“INCLUDE”
SQL埋込みCプログラムで利用するデータベース名を指定します。
SQL文の予約語とSQL機能のレベルをSQL88、SQL92、SQL95、SQL96、SQL2000またはSQL2007でコンパイルする場合に指定します。
-Wオプションを指定した場合は、予約語とSQL機能のレベルを1つ選んで指定します。
また、-Rオプションを指定した場合は、SQL88でコンパイルします。
本オプションを省略した場合は、SQL2007でコンパイルします。
文字型のホスト変数に対してSQL埋込みCプログラムの実行時に、NULLを意識した処理をする場合に指定します。
(NULLまでの文字をデータとして扱うなど)
64ビットのSQL埋込みCプログラムを作成する場合に指定します。
マルチスレッド上で動作するまたはセションを操作する関数を利用するSQL埋込みCプログラムを作成する場合に指定します。
リンカへのオプションを指定します。
複数のオプションを指定する場合などで途中に空白を含む場合は、二重引用符（"）で囲んでください。
オペランド
コンパイルおよびリンクの対象とする、SQL埋込みCプログラムのソースファイル名を指定します。
sqlccは、SQL埋込みCプログラムのロードモジュールを作成するために、clコマンドを実行します。
このとき、clコマンドに渡すオプションを指定します。
使用例
SQL埋込みCプログラムは“demo01.ec”に格納されているとします。
作成するロードモジュールのファイル名は“demo01.exe”とします。
また、INCLUDE文により取り込むファイルが配置されたディレクトリは“c:\rdb\sqlapl\include”とします。
sqlcc -I c:\rdb\sqlapl\include demo01.ec
終了ステータス
以下の終了ステータスが返されます。
0 : 正常終了
0以外 : 異常終了
注意
オプション指定後の最初のオペランドを、SQL埋込みCプログラムのファイル名とみなします。
SQL埋込みCプログラムのファイル名の拡張子に“.c”および“.lst”は指定できません。
-dオプション指定をした場合は、同一システム内であることが必要です。
-dオプション指定をした場合は、SQL埋込みCプログラムにCONNECT文を記述してはいけません。
環境変数RDBDBにデータベース名を指定している場合でも、本コマンドで-dオプションを指定している場合は、-dオプションで指定したデータベース名が有効となります。
sqlccで作成されるファイルの一覧を表に示します。ファイル名は、SQL埋込みCプログラムのファイル名の拡張子を、表で示す拡張子に置き換えた名前となります。
ファイルの種類 | 拡張子 | 備考 |
|---|---|---|
ソースファイル | ～.c | 作業用(注2) |
ソースリストファイル | ～.lst | 作業用 |
ロードモジュール | (注1) | SQL埋込みCプログラム |
注1) ロードモジュールのファイル名は、リンカ用の -out: オプションで指定します。
注2) C言語のデバッグを使用してデバッグを行う場合に必要となります。
sqlccの処理には、2つの段階があります。 sqlccを実行すると、処理中の段階が以下のように表示されます。
“Preprocess”の表示は、コンパイル前処理の実行中を示します。ホスト変数の使用方法などに誤りがある場合のエラーは、この段階で検出されます。
“C compile”の表示は、clコマンドによるコンパイル・リンクの実行中を示します。C言語の記述やロードモジュールのリンクに関するエラーは、この段階で検出されます。