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

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

cciServiceTrace

サービス・トレースがアクティブである場合、メッセージをサービス・トレースに書き込みます。

サービス・トレースに書き込まれるメッセージは、以下の形式になります。
<date-time stamp> <threadNumber> +cciServiceTrace <nodeName> <nodeType> <traceText>, <nodeLabel>

構文

void cciServiceTrace(
  int*           returnCode,
  CciObject*     object,
  const char*    traceText
);

パラメーター

returnCode
関数からの戻りコードを受け取ります (出力)。 NULL ポインター入力パラメーターは、ユーザー定義ノードがエラーを処理しないことを示します。 この呼び出しの実行時にスローされた例外は、フロー内の次のアップストリーム・ノードに対して再度スローされます。 入力パラメーターが NULL でない場合、出力は呼び出しの成功状況を示します。 実行時に例外が発生する場合、出力時に *returnCode が CCI_EXCEPTION に設定されます。 この例外の詳細を取得するには、CciGetLastExceptionData を使用します。
object (入力)
トレース・エントリーに関連付けられるオブジェクトのアドレス (入力)。 このオブジェクトは CciNode または CciParser のアドレスとなります。 CciNode を指定した場合には、そのノードの名前がトレースに書き込まれます。 CciParser を指定した場合には、パーサーを作成したノードの名前がトレースに書き込まれます。 このオブジェクトは、エントリーをトレースに書き込むかどうかを決定するためにも使用されます。 エントリーは、ノードにおいてトレースがアクティブである場合にのみ書き込まれます。 現行では、ノードはメッセージ・フローからトレース設定を継承します。
このパラメーターが NULL の場合は、以下のアクションが実行されます。
  • <nodeName>、<nodeType>、<nodeLabel>、および <messageFlowLabel> がトレース・エントリーから省略されます。
  • 実行グループのトレース設定を基にしてエントリーが書き込まれます。
traceText (入力)
NULL で終了する、文字のストリング (入力)。 このストリングは、サービス・トレースに書き込まれます。そのストリングを使用すれば、トレース・エントリーと、ソース・コードの中でたどってきたパスとを相関させることができます。 例えば、トレースに書き出されたメッセージは同じでも (messageSource および messageNumber)、コードの中でたどってきたパスは何通りかあるかもしれません。 traceText を使用すると、これらの異なるパスを区別することができます。 つまり、traceText ストリングは、ソース内の静的なリテラル・ストリングであるため、 同じストリングが、ソース・コード・ファイルとフォーマット設定されたトレース・ファイルの両方に存在します。
このストリングは、分散プラットフォームで稼働するユーザー定義拡張機能では ISO-8859-1 (ibm-819) コード・ページのストリングでなければならず、z/OS® で稼働するユーザー定義拡張機能では EBCDIC (1047) のストリングでなければなりません。

戻り値

なし。 エラーが発生した場合、returnCode パラメーターがエラーの理由を示します。

    CciNode*         thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;

    cciServiceTrace(&rc,(CciObject*)thisNode,">>_Switch_evaluate()");
    checkRC(rc);
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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