6.14.7.2 TMM_GET_TX_STATUS関数

トランザクション・イニシエータ・アプリケーションが現在のトランザクション・ステータスを取得するために使用します。

構文

TMM_GET_TX_STATUS (
   microTxTransaction IN MicroTxTransaction,
   forwardHeaders     IN ForwardHeaders DEFAULT NULL)
RETURN VARCHAR2(64);

TMM_GET_TX_STATUS関数のパラメータ

パラメータ	説明
microTxTransaction	必須パラメータです。TMM_BEGIN_TX関数が返すMicroTxTransactionオブジェクト。
forwardHeaders	オプション。アプリケーションは、指定されたヘッダーをMicroTxコーディネータに転送し、コーディネータはアプリケーションとの通信時にこれらのヘッダーを使用します。アプリケーションは、認可トークン、トランザクション・トークン、およびマイクロサービス全体でトランザクションをトレースする一意のIDのヘッダーを転送できます。 コーディネータのvalues.yamlファイルでtmmConfiguration.authorization.authTokenPropagationEnabledをtrueに設定して認可を有効にした場合、アプリケーションは認可トークンを転送する必要があります。 コーディネータのvalues.yamlファイルでtmmConfiguration.transactionToken.transactionTokenEnabledをtrueに設定した場合、アプリケーションはトランザクション・トークンを転送する必要があります。

戻り値

指定されたMicroTxTransactionオブジェクトのトランザクションのステータスを含むVARCHAR2(64)値を返します。

例

次のサンプル・コードは、TMM_GET_TX_STATUS関数を使用して現在のトランザクション・ステータスを取得する方法を示しています。

tx_status = TMM_GET_TX_STATUS (l_microTxTransaction, l_forwardheaders);

ここで、l_microTxTransactionはTMM_BEGIN_TX関数が返すMicroTxTransactionオブジェクトの名前で、l_forwardheadersはアプリケーションが転送するヘッダーです。