|
|
tpgetlev(3c)
名前
tpgetlev()-トランザクション・モードかどうかチェックするルーチン
形式
#include <atmi.h>
int tpgetlev()
機能説明
tpgetlev() は現在のトランザクション・レベルを呼び出し元に返します。現時点では、定義されているレベルは 0 と 1 だけです。
マルチスレッドのアプリケーションの場合、TPINVALIDCONTEXT 状態のスレッドは、tpgetlev() の呼び出しを発行できません。
戻り値
正常終了時 tpgetlev() は、トランザクション・モードではないということを示す 0 、またはトランザクション・モードだということを示す 1 のどちらかを返します。
異常終了すると、tpgetlev() は -1 を返し、tperrno() を設定してエラー条件を示します。
エラー
異常終了時には、tpgetlev() は tperrno() を次のいずれかの値に設定します。
注意事項
BEA Tuxedo ATMI システムのトランザクションを記述するために tpbegin()、tpcommit()、および tpabort() を使用する場合、XA インターフェイスに準拠した (呼び出し元に妥当にリンクされている) リソース・マネージャが行う作業のみがトランザクションの特性を備えていることを記憶しておくことが重要です。トランザクションにおいて実行される他のすべての操作は、tpcommit() あるいは tpabort() のいずれにも影響されません。リソース・マネージャによって実行される操作が、BEA Tuxedo システムのトランザクションの一部となるように、XA インターフェイスを満たすリソース・マネージャをサーバにリンクします。詳細については buildserver(1) を参照してください。
関連項目
tpabort(3c)、tpbegin(3c)、tpcommit(3c)、tpscmt(3c)
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|