WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

cciOutputMessageCallback

cciOutputMessageCallback 関数は、コールバックとして登録することができ、メッセージが出力ノードから送信されるたびに呼び出されます。

cciOutputMessageCallback 関数は、ユーザー出口の状態がアクティブの場合、コールバックが登録された実行グループまたはメッセージ・フロー内で正常に送信される出力メッセージごとに呼び出されます。 ノードが LocalEnvironment ツリーで WrittenDestination 情報を提供する場合、コールバックはこの情報が作成された後に起動されます。

呼び出しは、以下の操作が完了した後に行われます。
  • 出力または Reply ノードからのメッセージの送信 (WebSphere® MQ、JMS、TCPIP、HTTP、または SOAP ノード用)。
  • 要求ノードからのメッセージの送信 (TCPIP、HTTP、または SOAP ノード)。 コールバックは、応答を受信した後に行われます。
  • ファイルへの書き込み (FileOutput ノード)。
  • E メールの送信 (EmailOutput ノード)。
  • アダプター要求の完了 (WebSphere Adapters の要求ノード)。

コールバックを登録するには、この関数へのポインターを cciRegisterUserExit に渡される CCI_UE_VFT 構造の iFpOutputMessageCallback フィールドに指定します。 iFpOutputMessageCallback フィールドは、CCI_UE_VFT 構造バージョン 2 で追加されました。

このコールバックをインプリメントするときは、ノードに特定の操作を実行する前に、 cciGetNodeType を使用してノード・タイプを確認してください。

構文

typedef void (*cciOutputMessageCallback)     ( 
                                 CciDataContext*  userContext,
                                 CciMessage*      message,
                                 CciMessage*      localEnvironment,
                                 CciMessage*      exceptionList,
                                 CciMessage*      environment,
                                 CciNode*         node);

パラメーター

userContext (入力)
cciRegisterUserExit 関数に渡された値。
message (入力)
メッセージ・オブジェクトへのハンドル。 このツリー内のトランスポート・ヘッダーまたはプロパティー・エレメントを更新してはなりません。

メッセージ本体は更新できます。 ただし、このコールバックはメッセージがトランスポートに送信された後に呼び出されるので、 変更内容はメッセージに表れません。 変更内容が表示されるのは、出力ノードの下流に接続されたノードに対してだけです。 メッセージを更新すると、それ以外の方法ではメッセージ・フロー内のメッセージ・ツリーが変更されない場合には特に、パフォーマンスに影響を与えることがあります。

localEnvironment (入力)
ローカル環境オブジェクトへのハンドル。 ハンドルには、WrittenDestination サブツリーに書き込まれた、メッセージの宛先に関する情報が含まれることがあります。 詳しくは、各ノードの文書を参照してください。
exceptionList (入力)
例外リスト・オブジェクトへのハンドル。
environment (入力)
現行メッセージ・フローの環境オブジェクトへのハンドル。
node (入力)
出力メッセージを送信したノードへのハンドル。 ハンドルを使用して、cciGetNodeNamecciGetNodeType、 および cniGetBrokerInfo などの関数への呼び出しを行うことができます。

戻り値

なし。

void myOutputMessageCallback(
                      CciDataContext*  userContext,
                      CciMessage*      message,
                      CciMessage*      localEnvironment,
                      CciMessage*      exceptionList,
                      CciMessage*      environment,
                      CciNode*         node){
}
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:48:12


参照トピック参照トピック | バージョン 8.0.0.5 | as35965_