マルチスレッド・クライアントのコーディング

ここでは、次の内容について説明します。

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

マルチスレッド・クライアントのコーディング規則

マルチスレッド・クライアントを使用する場合、コーディングで以下の規則に注意してください。

クライアントの複数のコンテキストへの初期化

クライアント・スレッドのコンテキスト状態の変化

クライアント・スレッドのコンテキスト状態の変化

実行する関数	実行後のスレッドのコンテキスト状態
	NULL コンテキスト	シングルコンテキスト	マルチコンテキスト	無効コンテキスト
TPMULTICONTEXTS が設定されていない tpinit()	シングルコンテキスト	シングルコンテキスト	エラー	エラー
TPMULTICONTEXTS が設定された tpinit()	マルチコンテキスト	エラー	マルチコンテキスト	エラー
TPNULLCONTEXT への tpsetctxt(3c)	NULL	エラー	NULL	NULL
コンテキスト 0 への tpsetctxt(3c)	エラー	シングルコンテキスト	エラー	エラー
コンテキスト > 0 への tpsetctxt(3c)	マルチコンテキスト	エラー	マルチコンテキスト	マルチコンテキスト
暗黙的な tpinit()	シングルコンテキスト	該当せず	該当せず	エラー
このスレッドでの tpterm()	NULL	NULL	NULL	NULL
このコンテキストの異なるスレッドでの tpterm()	該当せず	NULL	無効	該当せず

 

マルチスレッド・マルチコンテキスト環境の環境変数

BEA Tuxedo アプリケーションをマルチコンテキスト・マルチスレッド環境で実行する場合、環境変数に関して以下の事柄に注意してください。

マルチスレッド・クライアントでのコンテキスト単位の関数とデータ構造体

以下に示す ATMI 関数は、呼び出し元のアプリケーション・コンテキストだけに影響します。

マルチスレッド・クライアントでのプロセス単位の関数とデータ構造体

以下に示す BEA Tuxedo 関数は、呼び出し元のプロセス全体に影響します。

シングルコンテキスト・モード、マルチコンテキスト・モード、または非初期化モードのどれを使用するかは、プロセス全体に影響します。また、バッファ・タイプ・スイッチ、ビュー・キャッシュ、および環境変数の値も、プロセス単位の関数です。

マルチスレッド・クライアントでのスレッド単位の関数とデータ構造体

以下に示す関数は、呼び出し元のスレッドだけに影響します。

現在のコンテキストの ID は各スレッドに固有です。

マルチスレッド・クライアントのコード例

次のコード例は、ATMI 呼び出しを使用するマルチスレッド・クライアントを示しています。スレッド関数は、オペレーティング・システムによって異なります。この例では、POSIX 関数が使用されています。

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

マルチスレッド・クライアントのコード例

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

TPINIT   *   tpinitbuf;
int          timeout=60;
pthread_t    withdrawalthreadid, stockthreadid;
TPCONTEXT_T  ctxt;
void * stackthread(void *);
void * withdrawalthread(void *);

main()
{
tpinitbuf = tpalloc(TPINIT, NULL, TPINITNEED(0));
/*
 * このコードでは、withdrawal スレッドと deposit スレッドという別のスレッドを
 * 使用して振り込みを行っています。また、BEA 株の現在の価格を別のアプリケーションから取得し、
 * 送金した金額で購入できる株数を計算しています。
 */

tpinitbuf->flags = TPMULTICONTEXTS;

/* 残りの tpinitbuf を設定します。  */
tpinit(tpinitbuf);

tpgetctxt(&ctxt, 0);
tpbegin(timeout, 0);
pthread_create(&withdrawalthreadid, NULL, withdrawalthread, NULL);
tpcall("DEPOSIT", ...);

/* withdrawal スレッドの完了を待機します。 */
pthread_join(withdrawalthreadid, NULL);

tpcommit(0);
tpterm();

/* stock スレッドの完了を待機します。 */
pthread_join(stockthreadid, NULL);

/* 結果を出力します。 */
printf("$%9.2f has been transferred \
from your savings account to your checking account.\n", ...);

printf("At the current BEA stock price of $%8.3f, \
you could purchase %d shares.\n", ...);

exit(0);
}



void *
stockthread(void *arg)
{
　
     /* ほかのスレッドが tpinit() を呼び出しているので、
      * TUXCONFIG を再設定してもスレッドに影響しません。
      */　
　
     tuxputenv("TUXCONFIG=/home/users/xyz/stockconf");　
     tpinitbuf->flags = TPMULTICONTEXTS;　
     /* 残りの tpinitbuf を設定します。 */　
     tpinit(tpinitbuf);　
     tpcall("GETSTOCKPRICE", ...);　
     /* main() でもアクセスできる変数に株価を格納します。 */　
     tpterm();　
     return(NULL);
}



void *
withdrawalthread(void *arg)
{
/* 別のアプリケーションから株価を取得するために新しいスレッドを生成します。*/

　
     pthread_create(&stockthreadid, NULL, stockthread, NULL);　
     tpsetctxt(ctxt, 0);　
     tpcall("WITHDRAWAL", ...);　
     return(NULL);
}

関連項目