MQBACK命令では，最後の同期点以降に発生したメッセージの読み取りと書き込みをすべてロールバックすることをキューマネジャに指示します。トランザクションの一部として書き込まれたメッセージは削除されます。トランザクションの一部として取り出されたメッセージはキューに戻されます。

C言語の場合

 
MQBACK (MQHCONN Hconn, MQLONG *CompCode, MQLONG *Reason)
 

COBOL言語の場合

 
CALL 'MQBACK' USING HCONN, COMPCODE, REASON.
 

●　Hconn（MQHCONN型）　−　input

コネクションハンドルです。

キューマネジャへの接続を示すハンドルです。MQCONN命令の戻り値を指定してください。

●　CompCode（MQLONG型）　−　output

完了コードです。次のどれかが返されます。

MQCC_OK：成功

MQCC_WARNING：警告（一部成功）

MQCC_FAILED：失敗

●　Reason（MQLONG型）　−　output

理由コードです。

表4-2　CompCode引数がMQCC_OKの場合（MQBACK命令の場合）

理由コード	意味
MQRC_NONE	理由コードはありません。

表4-3　CompCode引数がMQCC_WARNINGの場合（MQBACK命令の場合）

理由コード	意味
MQRC_OUTCOME_PENDING	コミットまたはロールバック操作の結果が保留状態です。

表4-4　CompCode引数がMQCC_FAILEDの場合（MQBACK命令の場合）

理由コード	意味
MQRC_CALL_IN_PROGRESS	前の呼び出しが完了する前に，再度MQI呼び出しが実行されました。
MQRC_CONNECTION_BROKEN	キューマネジャとの接続が失われました。
MQRC_ENVIRONMENT_ERROR	呼び出しが環境内で有効ではありません。
MQRC_HCONN_ERROR	コネクションハンドルが無効です。
MQRC_OBJECT_DAMAGED	オブジェクトが破損しています。
MQRC_OUTCOME_MIXED	コミットまたはロールバック操作の結果が混合しています。
MQRC_Q_MGR_STOPPING	キューマネジャが終了処理中です。
MQRC_RESOURCE_PROBLEM	システム資源が不足しています。
MQRC_STORAGE_NOT_AVAILABLE	記憶容量が不足しています。
MQRC_UNEXPECTED_ERROR	予期しないエラーが発生しました。

「理由コード」の詳細については，マニュアル「TP1/Message Queue プログラム作成リファレンス」を参照してください。

• この命令は，適切なTMが存在しない環境でだけ使用できます。
  このような環境では，キューマネジャ自体がトランザクションを管理します（ローカルトランザクション）。
  
  • ローカルトランザクションおよびグローバルトランザクションの詳細については，「MQBEGIN命令」を参照してください。
  • 適切なTMが存在する環境で，トランザクションをロールバックする場合は，MQBACK命令ではなく適切なロールバック命令を使用するか，アプリケーションを異常終了させてトランザクションをロールバックする必要があります。
• 1トランザクションには，一つのコネクションハンドルと同じ有効範囲があります。つまり，特定のトランザクションに影響を与えるMQI命令は，同じコネクションハンドルを使用して実行しなければなりません。例えば，別のアプリケーションで命令を呼び出すなど，別のコネクションハンドルを用いて命令を呼び出すと，別のトランザクションに影響が及びます。
  コネクションハンドルの有効範囲については，マニュアル「TP1/Message Queue プログラム作成リファレンス」のMQCONN命令を参照してください。
  
• この命令で影響を受けるメッセージは，現在のトランザクションの一部として書き込まれたメッセージ，または取り出されたメッセージに限られます。
• 長時間実行しているアプリケーションで，1トランザクションに対してMQGET命令，MQPUT命令，またはMQPUT1命令を呼び出している場合，コミット命令またはロールバック命令を一度も呼び出さないと，ほかのアプリケーションでは使用できないメッセージで，キューがいっぱいになることがあります。
• トランザクションが発生していない状態でMQBACK命令を発行した場合はMQRC_HCONN_ERRORのエラーになります。