セクション 3c

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo C リファレンス > セクション 3c - C 関数

Tuxedo C リファレンス

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 を次の値に設定します。

[TPEINVAL]

tranid が NULL ポインタか、または存在しないトランザクション識別子 (前に完了しているトランザクションやタイムアウトしたトランザクションを含む) を指しているか、あるいは呼び出し元が再開することを許可されていないトランザクション識別子を指しています。トランザクションに関する呼び出し元の状態は変化しません。

[TPEMATCH]

tranid が、他のプロセスが既に再開したトランザクション識別子を指しています。トランザクションに関する呼び出し元の状態は変化しません。

[TPETRAN]

呼び出し元が少なくとも一つ以上のリソース・マネージャでグローバル・トランザクションの外部の作業に関与しているため、BEA Tuxedo システムがグローバル・トランザクションを再開できません。そのような作業はすべて、グローバル・トランザクションを再開する前に完了していなければなりません。ローカル・トランザクションについての呼び出し元の状態は、変更されません。

[TPEPROTO]

tpresume() が不正なコンテキストで呼び出されました (たとえば、呼び出し元が既にトランザクション・モードになっている)。トランザクションに関する呼び出し元の状態は変化しません。

[TPESYSTEM]

BEA Tuxedo システムのエラーが発生しました。エラーの正確な内容がログ・ファイルに書き込まれます。

[TPEOS]

オペレーティング・システムのエラーが発生しました。

注意

XA 準拠のリソース・マネージャがグローバル・トランザクションに含まれるようにするには、そのリソース・マネージャが正常にオープンされている必要があります(詳細については、tpopen(3c) を参照)。

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