Interstage Application Server アプリケーション作成ガイド (コンポーネントトランザクションサービス編)

4.4.5 プロセスモードのアプリケーションのコンパイルとリンク

　サーバアプリケーションのリンク時に指定するライブラリを以下に示します。

［リンク時に指定するライブラリ］

ライブラリ名	格納場所	用途
libtdalcapi_nt.so	TDのインストールディレクトリ/lib	TD ランタイム（必須）
libextpapiskl_nt.so	EXTPのインストールディレクトリ/lib	TD ランタイム（必須）
libcobol.so	COBOLのインストールディレクトリ/lib	COBOL ランタイム（必須）
libOMcbl.so	ODのインストールディレクトリ/lib	ODランタイム（注）

　(注)
　中継用サーバアプリケーションを作成するとき、および、例外を使用するときに必要です。

　なお、リンカにより結合処理を行う場合、以下のオプションを指定してください。

　-dy -G

　サーバアプリケーションとスケルトンをコンパイル後、リンクする手順について例を以下に示します。

［コンパイル・リンク手順の例］

Sun 日本語COBOLの場合

  %cobol -c TD_TDSAMPLE1_INTF_skel.cbl
  %cobol -G -o libtdsample1_nt.so -L/opt/FSUNtd/lib -ltdalcapi_nt
  -L/opt/FSUNextp/lib -lextpapiskl_nt -L/opt/FJSVCOBop/lib -lcobol tdsample1_s.o 　
  TD_TDSAMPLE1_INTF_skel.o

PowerCOBOL97の場合

  %cobol -c TD_TDSAMPLE1_INTF_skel.cbl
  %cobol -G -o libtdsample1_nt.so -L/opt/FSUNtd/lib -ltdalcapi_nt
  -L/opt/FSUNextp/lib -lextpapiskl_nt tdsample1_s.o 　
  TD_TDSAMPLE1_INTF_skel.o

注意

　作成したアプリケーションライブラリにスレッドライブラリが結合されていないことを確認してください。

　アプリケーションのコンパイル／リンクの手順に誤りがあった場合や、libthread.soがリンクされている場合、ワークユニット起動／停止処理またはクライアントとの通信が無応答状態となる可能性があります。その場合、以下の対処を行ってください。

1.　当該ワークユニット配下で動作しているアプリケーションプロセスのプロセスIDを特定します。

　% ps -ef | grep ワークユニット名

2.　当該ワークユニット配下で動作しているアプリケーションプロセスの強制停止

　% kill -9 プロセスＩＤ

リンク時の注意事項

　サーバアプリケーションのリンク時には、上記のライブラリの他に、データベースや連携する他製品のライブラリなど、サーバアプリケーションで必要なライブラリがすべてリンクされていることを確認してください。また、リンクしたライブラリの格納先をワークユニット定義のアプリケーション使用ライブラリパス(Library for Applicationセクション)に設定してください。
　リンクが完全でない場合やワークユニット定義のアプリケーション使用ライブラリパスが完全でない場合は、ワークユニット起動処理において実行ファイルのオープン処理に失敗し、メッセージ(EXTP4640,EXTP4643,EXTP4645,EXTP4508)が出力されます。
　プロセスモードの場合でリンク時にlibOM.soを指定する場合には、必ず“/opt/FSUNod/lib/nt”を指定しなければなりません。

　以下に必要なワークユニット定義の設定例を示します。

ワークユニット定義の設定例

　サーバアプリケーションの実行ファイルが“application1.so”、格納先が/application/lib、サーバアプリケーションにリンクされているライブラリの格納先が、それぞれ、“/product1/lib”、“/product2/lib”で、プロセスモードでかつリンク時にlibOM.soを指定するの場合の定義例を以下に示します。

　[WORK UNIT]
　Name: SAMPLEWU
　Kind: ORB
　[APM]
　Name: TDNORMnt

　[Control Option]
　…
　Path: /application/lib
　Library for Application: /product1/lib
　Library for Application: /product2/lib
　Library for Application: /opt/FSUNod/lib/nt
　…
　Environment Variable: MANPATH=/opt/FJSVCOBop/man/%L:/opt/FJSVCOBop/man
　Environment Variable: NLSPATH=/opt/FJSVCOBop/lib/nls/%1/%c/%N.cat:
　/opt/FJSVCOBop/lib/nls/C/%N.cat;
　…

　[Application Program]
　…
　Executable File： application1.so

　サーバアプリケーションにリンクされているライブラリの格納先が複数存在する場合は、アプリケーション使用ライブラリパス(Library for Applicationセクション)を複数設定してください。
　また、出口プログラムにリンクされているライブラリの格納先についても、同様にアプリケーション使用ライブラリパス(Library for Applicationセクション)に設定してください。

APMの再作成

　コード変換用関数などのように、ユーザアプリケーションから呼び出されているシンボルが、ユーザがアプリケーションにリンクしたライブラリとlibc.soなどのシステムライブラリとの両方に格納されているとき、ユーザアプリケーションを実行すると、無条件にlibc.soなどのシステムライブラリに格納されたシンボルが呼び出されます。これは、APM実行モジュールの先頭にlibc.soなどのシステムライブラリが結合されているためです。この場合、ユーザアプリケーションに結合されたライブラリのシンボルを呼び出すためには、APM実行モジュールの先頭にユーザアプリケーションが使用するライブラリを結合する必要があります。
　APM実行モジュールの先頭にユーザアプリケーションが使用するライブラリを結合するためには、tdlinknormapmコマンドを使用し、APMを再作成してください。tdlinknormapmコマンドの使用方法については“リファレンスマニュアル（コマンド編）”を参照してください。