名前

tx_close()−リソース・マネージャ・セットをクローズする

形式

#include <tx.h> 
int tx_close(void)

機能説明

tx_close() は、移植性の高い方法でリソース・マネージャ・セットをクローズします。これにより、トランザクション・マネージャが呼び出されて、リソース・マネージャ固有の情報がトランザクション・マネージャ固有の方法で読み取られ、この情報が呼び出し元にリンクされているリソース・マネージャに渡されます。

tx_close() は、呼び出し元がリンクしているリソース・マネージャをすべてクローズします。この関数は、リソース・マネージャ固有の「クローズ」呼び出しの代わりに使用されるので、アプリケーション・プログラムは、移植性を損なう危険性のある呼び出しを使用することがなくなります。リソース・マネージャは終了の内容がそれぞれで異なるため、個々のリソース・マネージャを「クローズ」するために必要な情報をリソース・マネージャごとに通知しなければなりません。

tx_close() は、アプリケーションの制御スレッドがグローバル・トランザクションに関与する必要がなくなったときに呼び出してください。呼び出し元がトランザクション・モードにあると、tx_close() は ([TX_PROTOCOL_ERROR] を返して) 異常終了します。したがって、現在のトランザクションに関与しない制御スレッドがあっても、リソース・マネージャは一切クローズされません。

tx_close() が正常に終了すると (TX_OK)、呼び出し元のスレッドにリンクしているリソース・マネージャはすべてクローズされます。

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

戻り値

tx_close() は、正常終了時には、負数でない戻り値 TX_OK を返します。

エラー

次の条件の場合、tx_close() は異常終了し、次のいずれかの負の値を返します。

関連項目

警告

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