セクション 3(cbl) - COBOL 関数

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

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo COBOL リファレンス > セクション 3(cbl) - COBOL 関数

Tuxedo COBOL リファレンス

TPRESUME(3cbl)

名前

TPRESUME()－グローバル・トランザクションを再開する

形式

01 TPTRXDEF-REC.
 COPY TPTRXDEF. 
 
01 TPSTATUS-REC.
 COPY TPSTATUS.
 
CALL "TPRESUME" USING TPTRXDEF-REC TPSTATUS-REC.

機能説明

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

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

TPRESUME() は、TRANID() に含まれるグローバル・トランザクション識別子に関して、呼び出し元をトランザクション・モードに切り替えます。

戻り値

TPRESUME() は正常終了時には、[TPOK] を設定します。

エラー

次の条件が発生すると、TPRESUME() は異常終了し、TP-STATUS に次の値を設定します。

[TPEINVAL]

TRANID() に設定された識別子が、実在しないトランザクション (以前に終了したトランザクションやタイムアウトになったトランザクションを含む) のものであるか、または呼び出し元が再開することを認められていないトランザクションのものです。トランザクションに関する呼び出し元の状態は変化しません。

[TPEMATCH]

TRANID() に設定された識別子が示すトランザクションは、既に別のプログラムによって再開されています。トランザクションに関する呼び出し元の状態は変化しません。

[TPETRAN]

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

[TPEPROTO]

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

[TPESYSTEM]

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

[TPEOS]

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

注意事項

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

停止されていたトランザクションを再開するプログラムは、そのトランザクションを停止させたプログラムと同じ論理マシン (LMID) 上に存在している必要がありますワークステーション・クライアントの場合、そのワークステーションが接続されているワークステーション・ハンドラ (WSH) は、そのトランザクションを停止させたワークステーション・クライアントのハンドラと同じ論理マシン上に存在している必要があります。