名前

TPTERM()−アプリケーションを抜け出る

形式

01 TPSTATUS-REC.
 COPY TPSTATUS.
CALL "TPTERM" USING TPSTATUS-REC.

機能説明

TPTERM() は、BEA Tuxedo ATMI アプリケーションからクライアントを削除します。クライアントがトランザクション・モードであると、トランザクションはロールバックされます。TPTERM() が正常終了すると、呼び出し元は BEA Tuxedo クライアントの操作を行えなくなります。未終了の会話はただちに切断されます。

TPTERM() を 2 回以上呼び出した場合 (つまり、呼び出し元がアプリケーションから抜け出た後で TPTERM() を呼び出した場合)、処理は何も行われず、正常終了を示す値が返されます。

マルチコンテキストに関する留意事項

TPTERM() が呼び出されると、プログラムは TPNULLCONTEXT コンテキストに置かれます。TPNULLCONTEXT コンテキストのプログラムによって呼び出される ATMI 関数のほとんどは、暗黙的 TPINITIALIZE() を実行します。TPINITIALIZE() の呼び出しが正常終了するかどうかは、通常の決定要因に依存し、コンテキスト固有の事柄とは無関係です。

戻り値

TPTERM() は正常終了時には、TP-STATUS に [TPOK] を設定します。マルチコンテキストのアプリケーションで正常終了すると、アプリケーションの現在のコンテキストは TPNULLCONTEXT に変更されます。その後、TPSETCTXT() を使用してコンテキストを要求に応じて変更するのは、ユーザの責任になります。

異常終了時には、TPTERM() は -1 を返し、TP-STATUS にエラー条件を示す値を設定します。

エラー

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

関連項目