bea ホーム | 製品 | dev2dev | support | askBEA
BEA Logo Tuxedo
 ドキュメントのダウンロード   サイトマップ   用語集 
検索
0

Tuxedo C リファレンス

 Previous Next Contents View as PDF  

tpgetlev(3c)

名前

tpgetlev()−トランザクション・モードかどうかチェックするルーチン

形式

#include <atmi.h> 
int tpgetlev()

機能説明

tpgetlev() は現在のトランザクション・レベルを呼び出し元に返します。現時点では、定義されているレベルは 0 と 1 だけです。

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

戻り値

正常終了時 tpgetlev() は、トランザクション・モードではないということを示す 0 、またはトランザクション・モードだということを示す 1 のどちらかを返します。

異常終了すると、tpgetlev() は -1 を返し、tperrno を設定してエラー条件を示します。

エラー

異常終了時には、tpgetlev()tperrno を次のいずれかの値に設定します。

[TPEPROTO]

tpgetlev() が不正に呼び出されました。

[TPESYSTEM]

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

[TPEOS]

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

注意事項

BEA Tuxedo ATMI システムのトランザクションを記述するために tpbegin()tpcommit()、および tpabort() を使用する場合、XA インターフェイスに準拠した (呼び出し元に妥当にリンクされている) リソース・マネージャが行う作業のみがトランザクションの特性を備えていることを記憶しておくことが重要です。トランザクションにおいて実行される他のすべての操作は、tpcommit() あるいは tpabort() のいずれにも影響されません。そのリソース・マネージャが行った処理が BEA Tuxedo ATMI システムのトランザクションの一部となるよう、XA インターフェイスを満たすリソース・マネージャをサーバにリンクする方法については、buildserver(1) を参照してください。

関連項目

tpabort(3c)tpbegin(3c)tpcommit(3c)tpscmt(3c)

 

Back to Top Previous Next
Contact e-docsContact BEAwebmasterprivacy