Interstage Application Server リファレンスマニュアル（コマンド編）

28.3 otsmkxapgm

名前

　otsmkxapgm　−　XA連携用プログラムの作成

形式

otsmkxapgm [-java] | [-t {process|thread}] -s switch_name... -r "library" [-c] -o name

otsmkxapgm [-java -r "library"] | [-t {process|thread}] -s switch_name... [-c] -o name

機能説明

　otsmkxapgmコマンドは、サーバアプリケーションがデータベースとのXA連携を可能にするためのプログラムをライブラリファイルとして2つ作成します。

　otsmkxapgmコマンドは、対象となるデータベースのxa_switch_t構造体の名前と出力ファイル名を入力します。またデータベースベンダが公開するライブラリも指定します。Java言語のサーバアプリケーション用にXA連携プログラムを作成する場合は、-javaオプションを指定してください。
　なお、当コマンドを実行するとMicrosoft(R) Visual(R) C++のコンパイルコマンドとリンクコマンドが動作します。

　otsmkxapgmコマンドは、サーバアプリケーションがデータベースとのXA連携を可能にするためのプログラムをオブジェクトファイルとして作成します。
　otsmkxapgmコマンドは、対象となるデータベースのxa_switch_t構造体の名前と出力ファイル名を入力します。
　マルチリソース連携用のXA連携用プログラムを作成する場合は、xa_switch_t構造体名を連携する分指定します。

　以下に、otsmkxapgmコマンドのオプションを説明します。

-s

　XA連携するデータベースのxa_switch_t構造体の名前を指定します。
　オプションとオプション引数は、複数指定することが可能です。省略することはできません。

-java

　Java言語を利用したサーバアプリケーション（Javaサーバ）用のXA連携用プログラムを作成します。Javaサーバ用XA連携用プログラムを作成する場合のみ指定してください。

　Javaサーバ用XA連携用プログラムには、libthread.soがリンクされます。

　Javaサーバ用XA連携用プログラムには、libpthread.soがリンクされます

-r

　データベースベンダが公開するライブラリを1024バイト以内で指定します。省略することはできません。
　以下の規約でコマンドを指定してください。なお、マルチリソース用のXA連携用プログラムを作成する場合は、以下の規約で指定した情報を、空白文字を区切り文字として複数指定します。ただし、SQL Serverの場合は、オブジェクトファイル名を指定するだけです。

　-r"/libpath:'librarypathname'□/libpath:'librarypathname'* libraryname*"

　□:空白文字
　librarypathname: ライブラリ格納パス
　librarypath:　各データベースベンダが公開するライブラリ名

Symfoware/RDB:
　"/libpath:'ライブラリの格納パス' F3CWXA.LIB F3CWDRV.LIB"

Oracle V8.0.x 系:
　"/libpath:'ライブラリの格納パス' XA80.LIB"

Oracle V8.1.x 系:
　"/libpath:'ライブラリの格納パス' ORAXA8.LIB"

Oracle V9.0.x 系:
　"/libpath:'ライブラリの格納パス' ORAXA9.LIB"

SQL Server:
　"XASWITCH.OBJ"

注)ライブラリ情報やオブジェクト情報は、ダブルクォート(")で囲まなければなりません。ライブラリの格納パスは、シングルクォート(')で囲まなければなりません。

　データベースベンダが公開するライブラリを2048バイト以内で指定します。
　以下の規約でコマンドを指定してください。

Symfoware/RDB:
　"-L'ライブラリの格納パス' -lrdbxam -lsqldrvm"

Oracle V8.1.x 系:
　"-L'ライブラリの格納パス' -lclntsh -lclient8 -lsql8 -lcommon8 -lcore8 -lnls8"

Oracle V9.0.x 系:
　"-L'ライブラリの格納パス' -lclntsh -lclient9 -lsql9 -lcommon9 -lcore9 -lnls9"

注)ライブラリ情報やオブジェクト情報は、ダブルクォート(")で囲まなければなりません。ライブラリの格納パスは、シングルクォート(')で囲まなければなりません。

　データベースベンダが公開するライブラリを2048バイト以内で指定します。
　以下の規約でコマンドを指定してください。

Oracle V9.0.x 系:
　"-L'ライブラリの格納パス' -lclntsh -lclient9 -lsql9 -lcommon9 -lcore9 -lnls9"

注)ライブラリ情報やオブジェクト情報は、ダブルクォート(")で囲まなければなりません。ライブラリの格納パスは、シングルクォート(')で囲まなければなりません。

-t {process|thread}

　processが指定された場合はプロセスモードとして作成します。
　threadが指定された場合はスレッドモードとして作成します。
　本オプションを省略した場合はprocessとみなします。

-c

　XA連携プログラムをバックアップ対象とする場合は、本オプションを指定します。本オプションを指定した場合は、-oオプションで指定するXA連携プログラム名はファイル名のみとします。
　XA連携プログラムは以下に作成されます。

　Interstageインストール先\ots\var\clone

　/opt/FSUNots/var/clone

　/opt/FJSVots/var/clone

-o

　出力するXA連携用プログラム名を指定します。XA連携用プログラム名に指定できるパス名の最大長は255バイトです。
　このオプションは、省略することはできません。

　また、ファイルの拡張子を"DLL"としてください。指定したファイルの拡張子 "DLL"と"LIB"のライブラリファイルをコマンドの結果として作成します。指定は、絶対パス名でも、ファイル名でもかまいませんが、ファイル名指定の場合は、コマンド実行時のカレントフォルダに作成されます。

　通常は、ファイルの拡張子を"o"としてください。また、-javaと同時に指定した場合はファイルの拡張子を"so"としてください。指定は、絶対パス名でも、ファイル名でもかまいませんが、ファイル名指定の場合は、コマンド実行時のカレントディレクトリに作成されます。

注意事項

• マルチリソースアクセス機能を使用する場合のXA連携用プログラムは、サーバアプリケーションを作成するときにだけ利用可能です。
• マルチリソースアクセス機能を使用するには、そのためのXA連携用プログラムと定義（ワークユニット定義およびインプリメンテーションリポジトリに対して登録するための定義情報）をしなければなりません。このとき、以下に示すようにワークユニット起動／OTSのinitメソッドが異常終了する場合があります。

  

  XA連携用プログラム	ワークユニット定義／ CORBAサービスへの登録定義	ワークユニット起動／ OTSのinitメソッド
  1つのリソースアクセス用	リソース定義ファイルの指定が1つ	正常終了
  	同じリソース種別のリソース定義ファイルの指定が複数	正常終了
  	異なるリソース種別のリソース定義ファイルの指定が複数	異常終了
  複数のリソースアクセス用	リソース定義ファイルの指定が1つ	異常終了
  	リソース定義ファイルの指定が複数	該当RM名があれば正常終了 該当RM名がなければ異常終了

  

  XA連携用プログラム	ワークユニット定義／ CORBAサービスへの登録定義	ワークユニット起動／ OTSのinitメソッド
  1つのリソースアクセス用	リソース定義ファイルの指定が1つ	正常終了
  	リソース定義ファイルの指定が複数	異常終了
  複数のリソースアクセス用	リソース定義ファイルの指定が複数	異常終了
  	リソース定義ファイルの指定が複数	該当RM名があれば正常終了 該当RM名がなければ異常終了

• ファイルの拡張子"DLL"と"LIB"の2つのライブラリファイルを作成します。ファイルの拡張子"LIB"のファイルはotslinkrscコマンドおよびtdlinkapmコマンドの入力情報になります。また、ファイルの拡張子"DLL"のライブラリファイルは、リソース管理プログラムを運用する場合、システム環境変数PATHにファイルの格納場所を設定してください。
• otsmkxapgmコマンドを使用する場合、Microsoft(R) Visual(R) C++が必要となります。また、コマンドを実行する前に、システム環境変数に、Microsoft(R) Visual(R) C++のインストールでユーザ環境変数に設定される以下の環境変数を設定してください。
  −PATH
  −INCLUDE
  −LIB
• Javaサーバアプリケーション用のXA連携用プログラムは、サーバアプリケーションを作成するときにだけ利用可能です。
• SQL Server用のXA連携用プログラムを作成する場合、コマンドを実行する前に、システム環境変数に、SQL Serverのインストールでユーザ環境変数に設定される以下の環境変数を設定してください。
  • PATH
  • INCLUDE
  • LIB
• otsmkxapgmコマンド実行時に、コマンドが異常終了した場合、一時作業ファイル（ファイル名：otsenvxamkpgm.c）が回収されない場合があります。この場合、以下の環境配下に作成されたフォルダと一時作業ファイルを削除してください。作成されるフォルダ名は、otsmkxapgmnnnnnn_nnです。（nnnnnn:コマンドのプロセスID、nn:任意な2けたの数値）
  • 環境変数TMPがあればその配下
  • 環境変数TMPがなく、TEMPがあれば、その配下
  • 環境変数TMP、TEMPがなければ、コマンド実行時のカレントフォルダ配下
• コマンド実行時には、データベース連携サービス(サービス名:ObjectTransactionService)およびCORBAサービス(サービス名:OD_start,Naming Service)が起動されている必要があります。停止している場合には、手動でサービスを起動してからコマンドを投入するようにしてください。

• /opt/FSUNots/program/xa配下に以下のXA連携用プログラムを提供しています。これらのXA連携用プログラムを使用する範囲の運用であれば、新たにXA連携用プログラムを作成する必要がありません。
  • Oracle用XA連携用プログラム（libotsxaora.o)（プロセスモード）
  • Symfoware/RDB用XA連携用プログラム（libotsxasym.o)（プロセスモード）
  • MQD用XA連携用プログラム（libotsxamqd.o)（プロセスモード）
  • OracleとMQDを使用する場合のXA連携用プログラム（libotsxamqd_ora.o)（プロセスモード）
  • Symfoware/RDBとMQDを使用する場合のXA連携用プログラム（libotsxamqd_sym.o)（プロセスモード）
• otsmkxapgmコマンドを使用する場合、SPARCompilerが必要となります。

• /opt/FJSVots/program/xa配下に以下のXA連携用プログラムを提供しています。これらのXA連携用プログラムを使用する範囲の運用であれば、新たにXA連携用プログラムを作成する必要がありません。
  • Oracle用XA連携用プログラム（libotsxaora.o)（プロセスモード）
• otsmkxapgmコマンドを使用する場合、コンパイラが必要となります。

使用例

　Symfoware用のXA連携用プログラム「otssymxa.dll」を作成する場合

　otsmkxapgm -s RDBII_xa_switch
　　-r "/libpath:'c:\Program Files\SFWSV\ESQL\LIB'F3CWXA.LIB F3CWDRV.LIB"
　　-o D:\temp\ots\otssymxa.dll

　Oracle用のXA連携用プログラム「otsoraxa.dll」を作成する場合
　なお、Oracleのバージョンは8.1.6です。

　otsmkxapgm -s xaosw
　　-r "/libpath:'C:\Oracle\Ora81\RDBMS\XA' ORAXA8.LIB "
　　-o D:\temp\ots\otsoraxa.dll

　SQL Server用のXA連携用プログラム「otsmsqlxa.dll」を作成する場合
　なお、SQL Serverのバージョンは、7.0です。

　otsmkxapgm -s msqlsrvxa1
　　-r "XASWITCH.OBJ"
　　-o D:\temp\ots\otsmsqlxa.dll

　Symfoware用のXA連携用プログラム（Javaサーバアプリケーション用）「otssymxaj.dll」を作成する場合

　otsmkxapgm -java -s RDBII_xa_switch
　　-r "/libpath:'C:\Program Files\SFWSV\ESQL\LIB' F3CWXA.LIB F3CWDRV.LIB"
　　-o D:\temp\ots\otssymxaj.dll

　SymfowareとOracleの2つのデータベースと連携する1つのXA連携用プログラムを作成する場合（１つのアプリケーション上で２つのデータベースにアクセスする場合）

　otsmkxapgm -s RDBII_xa_switch -s xaosw
　　-r "/libpath:'C:\Program Files\SFWSV\ESQL\LIB'
　　　/libpath:'C:\Oracle\Ora81\RDBMS\XA' F3CWXA.LIB F3CWDRV.LIB ORAXA8.LIB"
　　-o D:\temp\ots\otsmultixa.dll

　Symfoware用のXA連携用プログラム「otssymxa.o」をスレッドモードで作成する場合

　otsmkxapgm -t thread -s RDBII_xa_switch -o otssymxa.o

　SymfowareとOracleの2つのデータベースと連携する1つのXA連携用プログラム「otsmultixa.o」を作成する場合（１つのアプリケーション上で２つのデータベースにアクセスする場合）

　otsmkxapgm -s RDBII_xa_switch -s xaosw -o otsmultixa.o

　Symfoware用のXA連携用プログラム（Javaサーバアプリケーション用）「libsymxaj.o」を作成する場合。環境変数RDB2LIBにはSymfoware/RDBのライブラリディレクトリを指定する必要があります。

　otsmkxapgm -java -r "-L$(RDB2LIB) -lrdbxa -lsqldrv" -s RDBII_xa_switch
　　　　　　　-o libsymxaj.so

　Oracle用のXA連携用プログラム「otsoraxa.o」を作成する場合

　otsmkxapgm -s xaosw -o otsoraxa.o