Interstage Application Server アプリケーション作成ガイド （イベントサービス編）

C.3 使用時の注意事項

　サンプルプログラムを使用するときに注意すべき点を以下に示します。

　C言語サンプルプログラムに関する注意事項
　C++言語サンプルプログラムに関する注意事項
　Java言語サンプルプログラムに関する注意事項
　COBOLサンプルプログラムに関する注意事項

C言語サンプルプログラムに関する注意事項

• ネーミングサービスを使用します。事前に起動してください。
• Pushモデルにおいてコンシューマのサンプルプログラムをタスクの終了などで終了した場合は、イベントチャネルを再起動してください。
  イベントチャネルを再起動せずに、再度コンシューマのサンプルプログラムを起動した場合、同一のイベントデータが複数個配信されます。
• 接続情報取得のサンプルプログラムは、イベントサービスのイベントチャネル用です。ノーティフィケーションサービスのイベントチャネル用に変更する場合は、接続情報取得関数インタフェース、およびライブラリを変更する必要があります。接続情報取得関数インタフェースの変更については“イベントチャネルの接続情報の取得”を、ライブラリについては“アプリケーションの作成方法”を参照してください。
• Microsoft(R) Visual Studio(R)でサンプルプログラムを翻訳する場合の注意事項
  • オプションを設定する必要があります。[プロジェクト]-[プロパティ]-[構成プロパティ]-[C/C++］で以下の表に示すオプションを設定してください。

    カテゴリ	設定項目	設定値
    コード生成	構造体メンバのアライメント	8バイト
    	使用するランタイム	マルチスレッド（DLL）
    最適化		デフォルトを推奨
    プリプロセッサ	プリプロセッサの定義	“OM_PC”、“OM_WIN32_BUILD”、“__STDC__”を追加
    言語	wchar_tをビルトイン型として扱う	いいえ
    詳細	コンパイル言語の選択	Cコードとしてコンパイル（/TC）

  • インクルードファイルの格納パスを設定する必要があります。[ツール]-[オプション]-[プロジェクトおよびソリューション]-[VC++ディレクトリ]で、以下のように設定してください。
    • プラットフォーム：Itanium
    • ディレクトリを表示するプロジェクト：インクルードファイル
    • 格納パス：(Visual Studio(R)をC:\MSDEVにインストールし、Windows Server 2003 for Itanium-based SystemsのインクルードファイルをC:\Interstage\includeにコピーした場合)
      C:\MSDEV\INCLUDE;C:\MSDEV\atlmfc\INCLUDE;C:\MSDEV\PlatformSDK\include;C:\Interstage\ODWIN\INCLUDE;C:\Interstage\ESWIN\INCLUDE;C:\Interstage\OTS\INCLUDE
  • ライブラリファイルの格納パスを設定する必要があります。[ツール]-[オプション]-[プロジェクトおよびソリューション]-[VC++ディレクトリ]で、以下のように設定してください。
    • プラットフォーム：Itanium
    • ディレクトリを表示するプロジェクト：ライブラリファイル
    • 格納パス：(Visual Studio(R)をC:\MSDEVにインストールした場合)
      C:\MSDEV\lib\ia64;C:\MSDEV\atlmfc\lib\ia64;C:\MSDEV\PlatformSDK\lib\ia64;C:\Interstage\ODWIN\LIB\IA64;C:\Interstage\ESWIN\LIB\IA64;C:\Interstage\OTS\LIB
  • サンプルプログラムの翻訳時に警告メッセージが出力されることがありますが、動作上は問題ありません。
• Microsoft Platform SDK for Windows Server 2003でサンプルプログラムを翻訳する場合の注意事項
  • サンプルプログラムの翻訳時に、オプションを設定する必要があります。以下のオプションを設定してください。
    /D "OM_PC" /D "OM_WIN32_BUILD" /D "__STDC__" /D "_ESWIN_" /MD /Zp8 /I "C:\Interstage\ODWIN\INCLUDE" /I "C:\Interstage\ESWIN\INCLUDE" /I "C:\Interstage\OTS\INCLUDE"
  • サンプルプログラムのリンク時に、ライブラリの格納パスを設定する必要があります。/LIBPATH:オプションで以下のように設定してください。
    /LIBPATH:"C:\Interstage\ODWIN\LIB\IA64" /LIBPATH:"C:\Interstage\ESWIN\LIB\IA64" /LIBPATH:"C:\Interstage\OTS\LIB"
    なお、スケルトンオブジェクトを使用する場合は、以下の順にライブラリの格納パスを指定してください。
    1. C:\Interstage\ESWIN\LIB\IA64\P_SDK
    2. C:\Interstage\ESWIN\LIB\IA64
  • サンプルプログラムの翻訳時に警告メッセージが出力されることがありますが、動作上は問題ありません。
• グローバルトランザクションのサンプルプログラム(16)(17)に関する注意事項
  • サンプルプログラムを実行する場合は、データベース連携サービスが必要です。Interstageをtype2で初期化してください。
  • サーバマシン上でサンプルプログラムを翻訳・実行する場合は、以下の操作を行ってください。
    1. C:\Interstage\ots\lib\libCurrent.libをリンクします（C:\Interstage\odwin\lib\odwin.libより先に設定されている必要があります）。
  • クライアントマシン上でサンプルプログラムを翻訳・実行する場合は、以下の操作を行ってください。
    1. サーバ上の以下のファイルをコピーします。
       −　グローバルトランザクションのサンプルプログラム
       −　C:\Interstage\ots\pc\lib\C\otscurrent.dll
       −　C:\Interstage\ots\pc\lib\C\otscurrent.lib
    2. 1.でコピーしたotscurrent.libをリンクします（C:\Interstage\odwin\lib\odwin.libより先に設定されている必要があります）。
    3. 環境変数PATHに、1.でotscurrent.dllをコピーしたディレクトリを追加します。

C++言語サンプルプログラムに関する注意事項

• ネーミングサービスを使用します。事前に起動してください。
• Pushモデルにおいてコンシューマのサンプルプログラムをタスクの終了などで終了した場合は、イベントチャネルを再起動してください。
  イベントチャネルを再起動せずに、再度コンシューマのサンプルプログラムを起動した場合、同一のイベントデータが複数個配信されます。
• 接続情報取得のサンプルプログラムは、イベントサービスのイベントチャネル用です。ノーティフィケーションサービスのイベントチャネル用に変更する場合は、接続情報取得関数インタフェース、およびライブラリを変更する必要があります。接続情報取得関数インタフェースの変更については“イベントチャネルの接続情報の取得”を、ライブラリについては“アプリケーションの作成方法” を参照してください。
• Microsoft(R) Visual Studio(R)でサンプルプログラムを翻訳する場合の注意事項
  • オプションを設定する必要があります。[プロジェクト]-[プロパティ]-[構成プロパティ]-[C/C++］で、以下の表に示すオプションを設定してください。

    カテゴリ	設定項目	設定値
    コード生成	構造体メンバのアライメント	8バイト
    	使用するランタイム	マルチスレッド（DLL）
    最適化		デフォルトを推奨
    プリプロセッサ	プリプロセッサの定義	“OM_PC”、“OM_WIN32_BUILD”、“__STDC__”を追加
    言語	wchar_tをビルトイン型として扱う	いいえ
    詳細	コンパイル言語の選択	Cコードとしてコンパイル（/TC）

  • インクルードファイルの格納パスを設定する必要があります。[ツール]-[オプション]-[プロジェクトおよびソリューション]-[VC++ディレクトリ]で、以下のように設定してください。
    • プラットフォーム：Itanium
    • ディレクトリを表示するプロジェクト：インクルードファイル
    • 格納パス：(Visual Studio(R)をC:\MSDEVにインストールし、Windows Server 2003 for Itanium-based SystemsのインクルードファイルをC:\Interstage\includeにコピーした場合)
      C:\MSDEV\INCLUDE;C:\MSDEV\atlmfc\INCLUDE;C:\MSDEV\PlatformSDK\include;C:\Interstage\ODWIN\INCLUDE;C:\Interstage\ESWIN\INCLUDE;C:\Interstage\OTS\INCLUDE
  • ライブラリファイルの格納パスを設定する必要があります。[ツール]-[オプション]-[プロジェクトおよびソリューション]-[VC++ディレクトリ]で、以下のように設定してください。
    • プラットフォーム：Itanium
    • ディレクトリを表示するプロジェクト：ライブラリファイル
    • 格納パス：(Visual Studio(R)をC:\MSDEVにインストールした場合)
      C:\MSDEV\lib\ia64;C:\MSDEV\atlmfc\lib\ia64;C:\MSDEV\PlatformSDK\lib\ia64;C:\Interstage\ODWIN\LIB\IA64;C:\Interstage\ESWIN\LIB\IA64;C:\Interstage\OTS\LIB
  • サンプルプログラムの翻訳時に警告メッセージが出力されることがありますが、動作上は問題ありません。
• Microsoft Platform SDK for Windows Server 2003でサンプルプログラムを翻訳する場合の注意事項
  • サンプルプログラムの翻訳時に、オプションを設定する必要があります。以下のオプションを設定してください。
    /D "OM_PC" /D "OM_WIN32_BUILD" /D "__STDC__" /D "_ESWIN_" /MD /Zp8 /I "C:\Interstage\ODWIN\INCLUDE" /I "C:\Interstage\ESWIN\INCLUDE" /I "C:\Interstage\OTS\INCLUDE"
  • サンプルプログラムのリンク時に、ライブラリの格納パスを設定する必要があります。/LIBPATH:オプションで以下のように設定してください。
    /LIBPATH:"C:\Interstage\ODWIN\LIB\IA64" /LIBPATH:"C:\Interstage\ESWIN\LIB\IA64" /LIBPATH:"C:\Interstage\OTS\LIB"
    なお、スケルトンオブジェクトを使用する場合は、以下の順にライブラリの格納パスを指定してください。
    1. C:\Interstage\ESWIN\LIB\IA64\P_SDK
    2. C:\Interstage\ESWIN\LIB\IA64
  • サンプルプログラムの翻訳時に警告メッセージが出力されることがありますが、動作上は問題ありません。

Java言語サンプルプログラムに関する注意事項

• 事前に“アプリケーション作成ガイド（CORBAサービス編）”の“アプリケーションの開発（Java言語）”を参照してください。
• ネーミングサービスを使用します。事前に起動しておいてください。
• Pushモデルにおいてコンシューマのサンプルプログラムをタスクの終了などで終了した場合は、イベントチャネルを再起動してください。
  イベントチャネルを再起動せずに、再度コンシューマのサンプルプログラムを起動した場合、イベントデータは1個配信されます。このとき、エラーメッセージes10802が出力される場合がありますが、問題ありません。
• 接続情報取得のサンプルプログラムは、イベントサービスのイベントチャネル用です。ノーティフィケーションサービスのイベントチャネル用に変更する場合は、接続情報取得関数インタフェース、およびライブラリを変更する必要があります。接続情報取得関数インタフェースの変更については“イベントチャネルの接続情報の取得”を、ライブラリについては“アプリケーションの作成方法”を参照してください。
• サンプルプログラムを翻訳・実行する場合は、環境変数CLASSPATHにCORBAサービスおよびイベントサービスのクラスライブラリを指定する必要があります。設定方法については、“クライアントアプリケーションの作成方法”を参照してください。
• グローバルトランザクションのサンプルプログラム(16)(17)に関する注意事項
  • サンプルプログラムを実行する場合は、データベース連携サービスが必要です。Interstageをtype2で初期化してください。
  • クライアントマシン上でサンプルプログラムを翻訳・実行する場合は、クライアントマシン上で以下の操作で行ってください。
    1. サーバ上の以下のファイルをコピーします。
       −　グローバルトランザクションのサンプルプログラム
       −　C:\Interstage\ots\pc\lib\C\otscurrent.dll
       −　C:\Interstage\ots\pc\lib\JAVA\otscurrent_java.dll
       −　C:\Interstage\ots\pc\lib\JAVA\otscurrent_java2.jar
    2. 環境変数PATHに、1.でotscurrent.dllとotscurrent_java.dllをコピーしたディレクトリを追加します。
    3. 環境変数CLASSPATHに、1.でotscurrent_java2.jarをコピーしたディレクトリを設定します。
  • サーバマシン上でサンプルプログラムを翻訳・実行する場合は、以下の操作を行ってください。
    1. 環境変数CLASSPATHに、以下のファイルを設定します。
       −　C:\Interstage\ots\etc\class\otscurrentsv_java2.jar

COBOLサンプルプログラムに関する注意事項

• ネーミングサービスを使用します。事前に起動してください。
• Pushモデルにおいてコンシューマのサンプルプログラムをタスクの終了などで終了した場合は、イベントチャネルを再起動してください。
  イベントチャネルを再起動せずに、再度コンシューマのサンプルプログラムを起動した場合、同一のイベントデータが複数個配信されます。
• 接続情報取得のサンプルプログラムは、イベントサービスのイベントチャネル用です。ノーティフィケーションサービスのイベントチャネル用に変更する場合は、接続情報取得関数インタフェース、およびライブラリを変更する必要があります。接続情報取得関数インタフェースの変更については“イベントチャネルの接続情報の取得”を、ライブラリについては“アプリケーションの作成方法”を参照してください。