BEA Logo BEA Tuxedo Release 8.0

  BEA ホーム  |  イベント  |  ソリューション  |  パートナ  |  製品  |  サービス  |  ダウンロード  |  ディベロッパ・センタ  |  WebSUPPORT

 

   Tuxedoホーム   |   BEA Tuxedo C リファレンス   |   先頭へ   |   前へ   |   次へ   |   目次

 


tx_set_transaction_control(3c)

名前

tx_set_transaction_control()-transaction_control 特性を設定する

形式

#include <tx.h> 
int tx_set_transaction_control(TRANSACTION_CONTROL control)

機能説明

tx_set_transaction_control() は、control で指定されている値に transaction_control 特性を設定します。この特性は、tx_commit() および tx_rollback() のどちらかが、これらの呼び出し側に返る前に、新しいトランザクションを開始するかどうかを決めます。tx_set_transaction_control() は、アプリケーション・プログラムがトランザクション・モードかどうかにかかわらず呼び出すことができます。この設定は、後に呼び出される tx_set_transaction_control() で変更されるまで有効です。

この特性の初期設定は、TX_UNCHAINED です。

control の有効な設定を次に示します。

TX_UNCHAINED

このフラグは、tx_commit() および tx_rollback() が、これらの呼び出し側に返る前に新しいトランザクションを開始してはならないことを示しています。呼び出し側は新しいトランザクションを開始するために tx_begin() を出さなければなりません。

TX_CHAINED

このフラグは、tx_commit() および tx_rollback() が、これらの呼び出し側に返る前に新しいトランザクションを開始することを示しています。

マルチスレッドのアプリケーションの場合、TPINVALIDCONTEXT 状態のスレッドは tx_set_transaction_control() の呼び出しを発行できません。

戻り値

正常終了の場合、tx_set_transaction_control() は、負でない戻り値 TX_OK を返します。

エラー

次の条件の場合、tx_set_transaction_control() は、transaction_control 特性の設定を変更することなく、次に示す 3 つの負の値のうちの 1 つを返します。

[TX_EINVAL]

control が、TX_UNCHAINED または TX_CHAINED のいずれでもありません。

[TX_PROTOCOL_ERROR]

この関数が不正なコンテキストで呼び出されました (たとえば、呼び出し側がまだ tx_open() を呼び出していません)。

[TX_FAIL]

トランザクション・マネージャが致命的エラーを検出しました。このエラーでは、トランザクション・マネージャは、アプリケーションのために作業を行うことができなくなります。エラーの正確な内容はログ・ファイルに書き込まれます。

関連項目

tx_begin(3c)tx_commit(3c)tx_info(3c)tx_open(3c)tx_rollback(3c)

警告

X/Open TX インターフェイスと X-Window システムは、いずれも型 XID を定義します。同一のファイルで X-Window コールと TX コールの両方を使用することはできません。

 

先頭へ戻る 前のトピックへ 次のトピックへ