tpresume(3c)

名前

tpresume()-グローバル・トランザクションの再開

形式

#include <atmi.h>
int tpresume(TPTRANID *tranid, long flags)

機能説明

tpresume() を使用して、中断されているトランザクションでの作業を再開します。呼び出し元がトランザクションの作業を再開した場合、その作業は tpsuspend() で再度停止させるか、あるいはあとで tpcommit() または tpabort() を利用して完了させる必要があります。

トランザクションの作業を再開する際には、呼び出し元はリンクされたリソース・マネージャが (tpopen() を利用して) オープンされていることを確認する必要があります。

tpresume() は、tranid でポイントされるグローバル・トランザクション識別子により呼び出し元をトランザクション・モードにします。tranid が NULL の場合はエラーです。

flags は将来使用するために予約されており、0 に設定します。

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

戻り値

tpresume() は、エラーが発生すると -1 を返し、tperrno() を設定してエラー条件を示します。

エラー

次の条件の場合、tpresume() は異常終了し、tperrno() を次の値に設定します。

注意

中断したトランザクションを再開するプロセスは、トランザクションを中断したプロセスと同じ論理マシン (LMID) 上に存在しなければなりません。ワークステーション・クライアントでは、それが接続されるワークステーション・ハンドラ (WSH) が、トランザクションを中断したワークステーション・クライアントのハンドラと同じ論理マシン上に存在しなければなりません。

関連項目