名前
ecobpg -- 埋め込みSQL用COBOLプリプロセッサを使用する
記述形式
ecobpg [option...] file...
説明
ecobpgは、COBOLプログラム用の埋め込みSQLプリプロセッサです。 SQL呼び出しを特殊な関数呼び出しに置き換えることによって、埋め込みSQL文を含むCOBOLプログラムを、通常のCOBOLコードに変換します。 これにより、出力ファイルは、COBOLコンパイラツールを使用して処理することができます。
ecobpgは、コマンドラインで指定される各入力ファイルを対応するCの出力ファイルに変換します。 入力ファイルに.pcoという拡張子を付けておくと、出力ファイル名の拡張子が.cobに置き換えられるので便利です。 入力ファイルの拡張子が.pcoでない場合、そのファイルのフルネームの末尾に.cobを追加したものが出力ファイル名となります。 出力ファイル名は、-oオプションによって上書きすることもできます。
パラメータ
ecobpgは、以下のコマンドライン引数を受け付けます。
SQLコードから有効なCOBOLコードを自動的に生成します。 現在、このオプションはEXEC SQL TYPEに対して使用できます。
追加のインクルード用パスを指定します。 これは、EXEC SQL INCLUDEを使用してインクルードされるファイルを検索する際に使用されます。 デフォルトでは.（現ディレクトリ）のみです。
ecobpgが全ての出力をfilenameに書き込むことを指定します。
COBOLコードの記法を指定します。formatには以下のいずれかを指定します。指定がない場合はfixed(固定形式)が指定されたものとして扱います。
固定形式を指定します。B領域は72カラムまで指定できます。73カラム以降の文字はプレコンパイルされたソースから削除されます。
可変形式を指定します。B領域は251カラムまで指定できます。252カラム以降の文字はプレコンパイルされたソースから削除されます。
実行時の動作を選択します。 以下のいずれかをoptionとして取ることができます。
すべての文を使用する前に準備します。 libecpgは準備済みの文のキャッシュを保持し、再実行される場合に文を再利用します。 キャッシュが満杯になった場合、libecpgは最も古い文を解放します。
互換性という理由でクエスチョンマークをプレースホルダとして許します。 これは長い間デフォルトとして使用されていました。
トランザクションの自動コミットを有効にします。 このモードでは、各SQLコマンドは明示的なトランザクションブロックの内部にない限り、自動的にコミットされます。 デフォルトのモードでは、EXEC SQL COMMITが発行された時にのみコマンドがコミットされます。
VARCHAR型ホスト変数を変換するとき、プレフィックスとしてホスト変数の名前を付与します。
LENとARRの替わりに、(ホスト変数名)-LENと(ホスト変数名)-ARRが使用されます。
COBOLソースのエンコードを設定します。エンコードは“UTF8”、“SJIS”、“EUC_JP”のいずれかを設定することができます。
本オプションを省略した場合はロケールで処理します。
バージョンやインクルード用パスなどの補足情報を表示します。
ecobpgのバージョンを表示し、終了します。
ecobpgのコマンドライン引数の使用方法を表示し、終了します。
注釈
前処理されたCOBOLコードファイルをコンパイルする際、コンパイラはPostgreSQLのインクルードディレクトリ内にある登録集ファイルを検索できるようにしなければなりません。
SQLが埋め込まれたCOBOLプログラムには、リンカのライブラリに関するオプションを使用するなどして、libecpgライブラリをリンクする必要があります。
使用するシステムにおいて上記の2つに対応するディレクトリを調べるには、pg_configを使用します。
参照
pg_configの詳細については、“PostgreSQL Documentation”の“Reference”の“pg_config”を参照してください。
使用例
埋め込みSQLを使用したprog1.pcoというCOBOLソースファイルがある場合、次のコマンドを実行すれば、コンパイル可能なソースコードを作成することができます。 ソースコードのコンパイル方法は、使用するコンパイラの情報を参照してください。
ecobpg prog1.pco
