目次

• 例一覧
• 図一覧
• 表一覧
• タイトルと著作権情報
• 1 Oracle Tuxedoプログラミングの紹介
  • 1.1 Oracle Tuxedo分散アプリケーションのプログラミング
  • 1.2 通信パラダイム
  • 1.3 Oracle Tuxedoクライアント
  • 1.4 Oracle Tuxedoサーバー
    • 1.4.1 サーバーの基本的な動作
    • 1.4.2 リクエスタとしてのサーバー
  • 1.5 Oracle Tuxedo API: ATMI
• 2 型付きバッファの管理
  • 2.1 型付きバッファの概要
  • 2.2 型付きバッファの割当て
  • 2.3 データのバッファへの格納
  • 2.4 型付きバッファのサイズの変更
  • 2.5 バッファ・タイプの確認
  • 2.6 型付きバッファの解放
  • 2.7 VIEW型バッファの使用
    • 2.7.1 VIEW型バッファの環境変数の設定
    • 2.7.2 VIEW記述ファイルの作成
    • 2.7.3 VIEWコンパイラの実行
  • 2.8 RECORD型バッファの使用
    • 2.8.1 RECORD型バッファの環境変数の設定
    • 2.8.2 コピーブック・ファイルの作成
    • 2.8.3 RECORD記述ファイルの生成
  • 2.9 FML型バッファ
    • 2.9.1 FML型バッファの環境変数の設定
    • 2.9.2 フィールド表ファイルの作成
    • 2.9.3 FMLヘッダー・ファイルの作成
  • 2.10 XML型バッファとApache Xerces C++パーサーの使用
    • 2.10.1 XML型バッファについて
    • 2.10.2 Apache Xerces C++パーサーについて
      • 2.10.2.1 XMLパーサーの制御
      • 2.10.2.2 XMLパーサーでのICUのサポート
      • 2.10.2.3 XMLパーサーのサンプル・アプリケーション
      • 2.10.2.4 Xercesスキーマのサンプル
    • 2.10.3 XMLデータとFML/FML32バッファ間の変換
      • 2.10.3.1 オンデマンド変換の使い方
        • 2.10.3.1.1 オンデマンド変換を開始する
        • 2.10.3.1.2 オンデマンド変換とXercesパーサーXML検証
      • 2.10.3.2 自動変換の使い方
        • 2.10.3.2.1 自動変換を開始する
        • 2.10.3.2.2 自動変換とXercesパーサーXML検証
      • 2.10.3.3 XMLとFML/FML32フィールド型のマッピング
      • 2.10.3.4 変換の制限事項
  • 2.11 MBSTRING型バッファの使用
    • 2.11.1 マルチバイト文字エンコードの制御
    • 2.11.2 MBSTRINGを自己記述型にする
      • 2.11.2.1 実装
      • 2.11.2.2 安全/危険なエンコード名
    • 2.11.3 マルチバイト文字サポートの制限
    • 2.11.4 マルチバイト文字エンコードでのlibiconvのサポート
  • 2.12 バッファのカスタマイズ
    • 2.12.1 独自のバッファ・タイプの定義
      • 2.12.1.1 スイッチ要素ルーチンのコーディング
      • 2.12.1.2 tm_typeswへの新しいバッファ・タイプの追加
      • 2.12.1.3 新しいtm_typeswのコンパイルとリンク
      • 2.12.1.4 16ビットWindowsプラットフォーム用の新しいtm_typeswのコンパイルとリンク
    • 2.12.2 データ変換
• 3 プログラミング環境
  • 3.1 UBBCONFIG構成ファイルの更新
  • 3.2 環境変数の設定
  • 3.3 必要なヘッダー・ファイルのインクルード
  • 3.4 アプリケーションの起動と停止
• 4 クライアントのコーディング
  • 4.1 アプリケーションへの参加
  • 4.2 TPINIT型バッファの機能の使用
    • 4.2.1 クライアントの名前付け
    • 4.2.2 非請求通知の処理
    • 4.2.3 システム・アクセス・モード
    • 4.2.4 リソース・マネージャとの関連付け
    • 4.2.5 クライアント認証
  • 4.3 アプリケーションからの分離
  • 4.4 クライアントのビルド
  • 4.5 クライアント・プロセスの例
• 5 サーバーのコーディング
  • 5.1 Oracle Tuxedoシステムのmain()
  • 5.2 システムで提供されるサーバーおよびサービス
    • 5.2.1 システムで提供されるサーバー: AUTHSVR( )
    • 5.2.2 システムで提供されるサービス: tpsvrinit( )関数
      • 5.2.2.1 コマンド行オプションの取得
      • 5.2.2.2 リソース・マネージャのオープン
    • 5.2.3 システムで提供されるサービス: tpsvrdone( )関数
  • 5.3 サーバーのコーディングのためのガイドライン
  • 5.4 サービスの定義
    • 5.4.1 例: バッファ・タイプの確認
    • 5.4.2 例: サービス・リクエストの優先度の確認
  • 5.5 サービス・ルーチンの終了
    • 5.5.1 応答の送信
    • 5.5.2 記述子の無効化
    • 5.5.3 リクエストの転送
  • 5.6 サービスの通知と通知解除
    • 5.6.1 サービスの通知
      • 5.6.1.1 tpadvertise()
      • 5.6.1.2 tpadvertisex()
    • 5.6.2 サービスの通知解除
    • 5.6.3 例:サービスの動的な公開と通知解除
  • 5.7 サーバーのビルド
  • 5.8 C++コンパイラの使用
    • 5.8.1 サービス関数の宣言
    • 5.8.2 コンストラクタとデストラクタの使用
• 6 リクエスト/レスポンス通信のコーディング
  • 6.1 リクエスト/レスポンス通信の概要
  • 6.2 同期メッセージの送信
    • 6.2.1 例: リクエスト・メッセージと応答メッセージに同じバッファの使用
    • 6.2.2 例: 応答バッファのサイズ変更の確認
    • 6.2.3 例: TPSIGRSTRTフラグを設定した同期メッセージの送信
    • 6.2.4 例: TPNOTRANフラグを設定した同期メッセージの送信
    • 6.2.5 例: TPNOCHANGEフラグを設定した同期メッセージの送信
  • 6.3 非同期メッセージの送信
    • 6.3.1 非同期リクエストの送信
      • 6.3.1.1 例: TPNOTRANとTPNOREPLYフラグを設定した非同期メッセージの送信
      • 6.3.1.2 例: 非同期リクエストの送信
    • 6.3.2 非同期応答の受信
  • 6.4 メッセージの優先度の設定および取得
    • 6.4.1 メッセージの優先度の設定
    • 6.4.2 メッセージの優先度の取得
• 7 会話型クライアントおよびサーバーのコーディング
  • 7.1 会話型通信の概要
  • 7.2 アプリケーションへの参加
  • 7.3 接続の確立
  • 7.4 メッセージの送受信
    • 7.4.1 メッセージの送信
    • 7.4.2 メッセージの受信
  • 7.5 会話の終了
    • 7.5.1 例: 単純な会話の終了
    • 7.5.2 例: 階層構造の会話の終了
    • 7.5.3 無秩序な切断の実行
  • 7.6 会話型のクライアントおよびサーバーのビルド
  • 7.7 会話型通信のイベントについて
• 8 イベント・ベースのクライアントおよびサーバーのコーディング
  • 8.1 イベントの概要
    • 8.1.1 非請求イベント
    • 8.1.2 ブローカ・イベント
      • 8.1.2.1 通知処理
      • 8.1.2.2 イベント・ブローカ・サーバー
      • 8.1.2.3 システム定義のイベント
      • 8.1.2.4 イベント・ブローカ・プログラミング・インタフェース
  • 8.2 非請求メッセージ・ハンドラの定義
  • 8.3 非請求メッセージの送信
    • 8.3.1 名前によるメッセージのブロードキャスト
    • 8.3.2 識別子によるメッセージのブロードキャスト
  • 8.4 非請求メッセージの確認
  • 8.5 イベントのサブスクライブ
    • 8.5.1 非請求メッセージを使用した通知
    • 8.5.2 サービス呼び出しまたは信頼できるキューを使用した通知
  • 8.6 イベントに対するサブスクリプションの削除
  • 8.7 イベントのポスト
  • 8.8 イベントのサブスクリプションの例
• 9 グローバル・トランザクションのコーディング
  • 9.1 グローバル・トランザクションとは
  • 9.2 トランザクションの開始
  • 9.3 トランザクションの中断と再開
    • 9.3.1 トランザクションの中断
    • 9.3.2 トランザクションの再開
    • 9.3.3 例: トランザクションの中断と再開
  • 9.4 トランザクションの終了
    • 9.4.1 現在のトランザクションのコミット
      • 9.4.1.1 トランザクションをコミットするための条件
      • 9.4.1.2 2フェーズ・コミット・プロトコル
        • 9.4.1.2.1 コミットの成功条件の選択
        • 9.4.1.2.2 コミット条件での妥協点
    • 9.4.2 現在のトランザクションの中断
    • 9.4.3 例: 会話モードによるトランザクションのコミット
    • 9.4.4 例: 参加リソースのエラーの確認
  • 9.5 グローバル・トランザクションの暗黙的な定義
    • 9.5.1 サービス・ルーチンのトランザクションの暗黙的な定義
  • 9.6 XA準拠のサーバー・グループに対するグローバル・トランザクションの定義
  • 9.7 トランザクションが開始されたことの確認
• 10 マルチスレッドおよびマルチコンテキストATMIアプリケーションのプログラミング
  • 10.1 マルチスレッド/マルチコンテキストATMIアプリケーションのプログラミングに対するサポート
    • 10.1.1 マルチスレッドおよびマルチコンテキスト・アプリケーションに関するプラットフォーム固有の検討事項
  • 10.2 マルチスレッド/マルチコンテキストATMIアプリケーションの計画と設計
    • 10.2.1 マルチスレッドおよびマルチコンテキストとは
      • 10.2.1.1 マルチスレッドとは
      • 10.2.1.2 マルチコンテキストとは
    • 10.2.2 マルチスレッド・アプリケーションまたはマルチコンテキスト・アプリケーションの監査
    • 10.2.3 マルチスレッド/マルチコンテキストATMIアプリケーションの利点と問題点
      • 10.2.3.1 マルチスレッド/マルチコンテキストATMIアプリケーションの利点
      • 10.2.3.2 マルチスレッド/マルチコンテキストATMIアプリケーションの問題点
    • 10.2.4 クライアントでのマルチスレッドとマルチコンテキストの動作
      • 10.2.4.1 起動フェーズ
        • 10.2.4.1.1 クライアント・スレッドの複数コンテキストへの参加
        • 10.2.4.1.2 クライアント・スレッドの既存のコンテキストへの切り替わり
      • 10.2.4.2 作業フェーズ
        • 10.2.4.2.1 サービス・リクエスト
        • 10.2.4.2.2 サービス・リクエストに対する応答
        • 10.2.4.2.3 トランザクション
        • 10.2.4.2.4 非請求メッセージ
        • 10.2.4.2.5 ユーザー・ログで保持されるスレッド固有の情報
      • 10.2.4.3 完了フェーズ
    • 10.2.5 ATMIサーバーでのサーバー・ディスパッチ・スレッドのマルチスレッドとマルチコンテキストの動作
      • 10.2.5.1 起動フェーズ
      • 10.2.5.2 作業フェーズ
        • 10.2.5.2.1 サーバー・ディスパッチ・スレッドの使用方法
        • 10.2.5.2.2 BBLによるシステム・プロセスの正常性チェック
        • 10.2.5.2.3 システムで保持されるサーバー・スレッドの統計
        • 10.2.5.2.4 ユーザー・ログで保持されるスレッド固有の情報
      • 10.2.5.3 完了フェーズ
    • 10.2.6 ATMIサーバーのアプリケーション生成スレッドのマルチスレッドとマルチコンテキストの動作
      • 10.2.6.1 起動フェーズ
      • 10.2.6.2 作業フェーズ
        • 10.2.6.2.1 ユーザー・ログで保持されるスレッド固有の情報
      • 10.2.6.3 完了フェーズ
    • 10.2.7 マルチスレッドおよびマルチコンテキストATMIアプリケーションの設計上の検討事項
      • 10.2.7.1 環境の要件
      • 10.2.7.2 設計の要件
        • 10.2.7.2.1 マルチスレッドやマルチコンテキストに適するアプリケーションのタスク
        • 10.2.7.2.2 必要なアプリケーションと接続の数
        • 10.2.7.2.3 同期に関する検討事項
        • 10.2.7.2.4 アプリケーションの移植
        • 10.2.7.2.5 最適なスレッド・モデル
      • 10.2.7.3 ワークステーション・クライアントの相互運用性に関する制約
  • 10.3 マルチスレッドおよびマルチコンテキストATMIアプリケーションの実装
    • 10.3.1 マルチスレッド/マルチコンテキストATMIアプリケーションのプログラミング開始前のガイドライン
      • 10.3.1.1 マルチスレッドATMIアプリケーションに必要な条件
      • 10.3.1.2 マルチスレッド・アプリケーションのプログラミングでの一般的な検討事項
      • 10.3.1.3 同時実行性に関する検討事項
    • 10.3.2 ATMIクライアントでマルチコンテキストを使用するためのコーディング
      • 10.3.2.1 コンテキストの属性
      • 10.3.2.2 初期化時のマルチコンテキストの設定
      • 10.3.2.3 マルチコンテキストATMIクライアントのセキュリティの実装
      • 10.3.2.4 ATMIクライアント終了前のスレッドの同期
      • 10.3.2.5 コンテキストの切替え
      • 10.3.2.6 非請求メッセージの処理
      • 10.3.2.7 マルチスレッド/マルチコンテキストATMIアプリケーションにおけるトランザクションのコーディング規則
    • 10.3.3 ATMIサーバーでサーバー・ディスパッチのマルチコンテキストおよびマルチスレッドのスレッドを使用するためのコーディング
      • 10.3.3.1 コンテキストの属性
      • 10.3.3.2 マルチコンテキストATMIサーバーでのサーバー・ディスパッチ・スレッドのコーディング規則
      • 10.3.3.3 ATMIサーバーおよびATMIサーバー・スレッドの初期化と終了
    • 10.3.4 ATMIサーバーのアプリケーション生成スレッドでマルチコンテキストを使用するためのコーディング
      • 10.3.4.1 スレッドの生成
      • 10.3.4.2 コンテキストへのアプリケーション・スレッドの関連付け
      • 10.3.4.3 既存のサーバー・ディスパッチ・コンテキストへのアプリケーション・スレッドの関連付け
      • 10.3.4.4 マルチコンテキスト・サーバーでの既存のサーバー・ディスパッチ・コンテキストにアプリケーション・スレッドを関連付けするためのサンプル・コード
      • 10.3.4.5 アプリケーション生成のコンテキストへのアプリケーション・スレッドの関連付け
        • 10.3.4.5.1 コンテキストの属性
        • 10.3.4.5.2 アプリケーション生成のコンテキストでのATMIサーバーのアプリケーション生成スレッドのコーディング規則
      • 10.3.4.6 マルチコンテキスト・サーバーでのアプリケーション生成のサーバー・コンテキストにアプリケーション・スレッドを関連付けするためのサンプル・コード
    • 10.3.5 マルチスレッドATMIクライアントのコーディング
      • 10.3.5.1 マルチスレッドATMIクライアントのコーディング規則
      • 10.3.5.2 ATMIクライアントの複数のコンテキストへの初期化
      • 10.3.5.3 ATMIクライアント・スレッドのコンテキスト状態の変化
      • 10.3.5.4 マルチスレッド環境での応答の取得
      • 10.3.5.5 マルチスレッド・マルチコンテキスト環境の環境変数の使用
    • 10.3.6 マルチスレッドATMIクライアントでのコンテキスト単位の関数とデータ構造体
    • 10.3.7 マルチスレッドATMIクライアントでのプロセス単位の関数とデータ構造体
    • 10.3.8 マルチスレッドATMIクライアントでのスレッド単位の関数とデータ構造体
    • 10.3.9 マルチスレッドATMIクライアントのサンプル・コード
    • 10.3.10 マルチスレッドATMIサーバーのコーディング
    • 10.3.11 マルチスレッド/マルチコンテキストATMIアプリケーションのコードのコンパイル
  • 10.4 マルチスレッド/マルチコンテキストATMIアプリケーションのテスト
    • 10.4.1 マルチスレッド/マルチコンテキストATMIアプリケーションのテスト時の推奨事項
    • 10.4.2 マルチスレッド/マルチコンテキストATMIアプリケーションのトラブルシューティング
      • 10.4.2.1 tpinit( )のTPMULTICONTEXTSフラグの間違った使用
      • 10.4.2.2 TPMULTICONTEXTSが設定されていない場合のtpinit()の呼出し
      • 10.4.2.3 スレッドのスタック・サイズの不足
    • 10.4.3 マルチスレッド/マルチコンテキストATMIアプリケーションのエラー処理
• 11 エラーの管理
  • 11.1 システム・エラー
  • 11.2 中断エラー
  • 11.3 Oracle Tuxedoのシステム・エラー
  • 11.4 呼出し記述子のエラー
    • 11.4.1 上限値に関するエラー
    • 11.4.2 無効な記述子によるエラー
  • 11.5 会話に関するエラー
  • 11.6 複製オブジェクトに関するエラー
  • 11.7 一般的な通信呼出しのエラー
    • 11.7.1 TPESVCFAILおよびTPESVCERRエラー
    • 11.7.2 TPEBLOCKおよびTPGOTSIGエラー
  • 11.8 無効な引数によるエラー
  • 11.9 MIBエラー
  • 11.10 エントリがないために発生するエラー
  • 11.11 オペレーティング・システムのエラー
  • 11.12 パーミッション・エラー
  • 11.13 プロトコル・エラー
  • 11.14 キューに関するエラー
  • 11.15 リリース間の互換性に関するエラー
  • 11.16 リソース・マネージャ・エラー
  • 11.17 タイムアウト・エラー
  • 11.18 トランザクション・エラー
  • 11.19 型付きバッファのエラー
  • 11.20 アプリケーション・エラー
  • 11.21 エラーの処理
  • 11.22 トランザクションについて
  • 11.23 通信規則
  • 11.24 トランザクション・エラー
    • 11.24.1 致命的ではないトランザクション・エラー
    • 11.24.2 致命的なトランザクション・エラー
    • 11.24.3 ヒューリスティックな判断に関するエラー
  • 11.25 トランザクション・タイムアウト
    • 11.25.1 tpcommit()関数への影響
    • 11.25.2 TPNOTRANフラグへの影響
  • 11.26 tpreturn()およびtpforward()関数
  • 11.27 tpterm()関数
  • 11.28 リソース・マネージャ
  • 11.29 トランザクションのサンプル・シナリオ
    • 11.29.1 呼出し側と同じトランザクションでのサービス呼出し
    • 11.29.2 AUTOTRANが設定された別のトランザクションでのサービス呼出し
    • 11.29.3 新しい明示的なトランザクションを開始するサービスの呼出し
  • 11.30 Oracle Tuxedoシステムで提供されるサブルーチン
  • 11.31 中央イベント・ログ
    • 11.31.1 ログの名前
    • 11.31.2 ログ・エントリの形式
    • 11.31.3 イベント・ログへの書込み
  • 11.32 アプリケーション・プロセスのデバッグ
    • 11.32.1 UNIXプラットフォーム上でのアプリケーション・プロセスのデバッグ
    • 11.32.2 Windows 2003プラットフォーム上でのアプリケーション・プロセスのデバッグ
  • 11.33 全般的なサンプル・コード