クライアントでマルチコンテキストを使用するためのコーディング

クライアントでマルチコンテキストを使用するには、次の内容をコーディングします。

注記 この節で示す手順とコード例は、BEA Tuxedo システムで提供される C 言語のライブラリ関数を参照します。それらに相当する COBOL ライブラリ関数も利用できます。詳細については、『BEA Tuxedo COBOL リファレンス』を参照してください。

コンテキストの属性

コンテキストを使用する場合、コーディングで以下の事柄に注意してください。

初期化時のマルチコンテキストの設定

クライアントのマルチコンテキスト・アプリケーションへの参加

#include <stdio.h>
#include <atmi.h>

TPINIT   *   tpinitbuf;

main()
{
      tpinitbuf = tpalloc(TPINIT, NULL, TPINITNEED(0));

      tpinitbuf->flags = TPMULTICONTEXTS;
            .
            .
            .
      if (tpinit (tpinitbuf) == -1) {

           ERROR_PROCESSING_CODE
      }
                  .
                  .
                  .

}

新しいアプリケーションとの対応付けが生成され、TUXCONFIG または WSENVFILE/WSNADDR 環境変数で指定された BEA Tuxedo ドメインに割り当てられます。

マルチコンテキスト・クライアントのセキュリティのインプリメント

同じプロセス内の各アプリケーションとの対応付けには、別個にセキュリティ検査を行う必要があります。検査の内容は、アプリケーションで使用されているセキュリティ・メカニズムのタイプによって異なります。たとえば、BEA Tuxedo アプリケーションでは、システム・レベルのパスワードまたはアプリケーション・パスワードを使用します。

マルチコンテキスト・アプリケーションのプログラマは、アプリケーションで使用するセキュリティのタイプを決定し、そのセキュリティをプロセス内の各アプリケーションとの対応付けにインプリメントします。

クライアント終了前のスレッドの同期

注記 BEA Tuxedo システムでは、COBOL アプリケーションのマルチスレッドはサポートされていません。

コンテキストの切り替え

次は、2 つのコンテキストからサービスを呼び出すクライアントで行われる処理の手順をまとめたものです。

次のコード例は、この手順を示しています。

注記 コードを簡単にするために、エラー・チェックは省略してあります。

クライアントでのコンテキストの切り替え

#include <stdio.h>　
#include "atmi.h"/* BEA Tuxedo ヘッダ・ファイル */　
　
#if defined(__STDC__) || defined(__cplusplus)　
main(int argc, char *argv[])　
#else　
main(argc, argv)　
int argc;　
char *argv[];　
#endif　
{　
　
   TPINIT   *   tpinitbuf;　
   TPCONTEXT_T firstapp_contextID, secondapp_contextID;　
   /* TUXCONFIG が /home/firstapp/TUXCONFIG に設定されていることを前提とします。*/　
   /* 　
    * BEA Tuxedo システムにマルチコンテキスト・モードで接続します。　
    */　
   tpinitbuf=tpalloc(TPINIT, NULL, TPINITNEED(0));　
   tpinitbuf->flags = TPMULTICONTEXTS;　
　
   if (tpinit((TPINIT *) tpinitbuf) == -1) {　
      (void) fprintf(stderr, "Tpinit failed\n");　
      exit(1);　
}　
　
   /*　
    * 現在のコンテキストへのハンドルを取得します。　
    */　
   tpgetctxt(&firstapp_contextID, 0);　
　
   /*　
    * tuxputenv を使用して TUXCONFIG の値を変更し、　
    * 別のアプリケーションに参加 (tpinit) します。　
    */　
   tuxputenv("TUXCONFIG=/home/second_app/TUXCONFIG");　
　
   /*　
    * secondapp に参加 (tpinit) します。
    */　
   if (tpinit((TPINIT *) tpinitbuf) == -1) {　
      (void) fprintf(stderr, "Tpinit failed\n");　
      exit(1);　
}　
　
   /*　
    * secondapp のコンテキストへのハンドルを取得します。　
    */　
   tpgetctxt(&secondapp_contextID, 0);　
　
   /*　
    * tpgetctxt から取得したハンドルと tpsetctxt を使用して、　
    * 2 つのコンテキスト間で切り替えができます。firstapp から開始します。
    */　
　
   tpsetctxt(firstapp_contextID, 0);　
　
   /*　
    * firstapp で提供されるサービスを呼び出し、次に secondapp に切り替えます。　
    */　
　
   tpsetctxt(secondapp_contextID, 0);　
　
   /*　
    * secondapp で提供されるサービスを呼び出します。
    * 次に firstapp に戻ります。
    */　
　
   tpsetctxt(firstapp_contextID, 0);　
　
   /*　
    * firstapp で提供されるサービスを呼び出します。操作が終了したら
    * firstapp のコンテキストを終了します。
    */　
　
   tpterm();　
　
   /*　
    * secondapp に戻ります。
    */　
　
   tpsetctxt(secondapp_contextID, 0);　
   /*　
    * secondapp で提供されるサービスを呼び出します。操作が終了したら 
    * secondapp のコンテキストを終了し、プログラムを終了します。
    */　
　
   tpterm();　
　
   return(0);　
}

任意通知型メッセージの処理

任意通知型メッセージを処理する各コンテキストでは、任意通知型メッセージ・ハンドラを設定するか、またはプロセス・ハンドラのデフォルトが設定されている場合はそれを使用する必要があります。

マルチスレッドおよびマルチコンテキスト・アプリケーションにおけるトランザクションのコーディング規則

トランザクションを使用する場合、コーディングで以下の事柄に注意してください。

関連項目