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

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

cciLogW

cciLogW は、エラー、警告、または通知イベントをログに記録します。 イベントは、ブローカー・インターフェースによってログ記録され、指定される引数をログ・データとして使用します。

構文

void cciLogW(
  int*              returnCode,
  CCI_LOG_TYPE      type,
  const char*       file,
  int               line,
  const char*       function,
  const CciChar*    messageSource,
  int               messageNumber,
  const CciChar*    traceText,
                    ...
);

パラメーター

returnCode
関数からの戻りコード (出力)。 messageSource パラメーターが NULL の場合、returnCode は CCI_INV_DATA_POINTER に設定されます。
type
CCI_LOG_TYPE で定義されるイベントのタイプ (入力)。 有効な値は以下のとおりです。
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
関数が呼び出されたソース・ファイル名 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
line
関数が呼び出されたソース・ファイルでの行番号 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
function
ログ関数を呼び出した関数名 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
messageSource
Windows メッセージ・ソース、または LinuxUNIXz/OS® のメッセージ・カタログの、完全修飾の場所および名前。

現行のブローカー・メッセージ・カタログを使用するには、 すべてのオペレーティング・システムで BIPmsgs を指定します。 あるいは、独自のメッセージ・カタログを作成することもできます。

messageNumber
イベントを識別するメッセージ番号 (入力)。 messageNumber にゼロが指定されている場合、メッセージが利用不能であると想定します。 messageNumber がゼロでない場合、 指定したメッセージがブローカー・イベント・ログに書き込まれ、 変数引数リストに任意の挿入が提供されます (例を参照)。
traceText
ブローカー・サービス・トレース・ログに書き込まれるトレース情報 (入力)。 この情報はオプションですが、デバッグ目的に役立てることができます。
...
メッセージに付随する任意のメッセージ挿入を含む C 変数引数リスト (入力)。 これらの挿入は文字ストリングとして扱われ、変数引数はタイプが pointer to CciChar (CciChar へのポインター) であると見なされます。

このリストの最後の引数は、(Ccichar*)0 でなければなりません

戻り値

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

void logSomethingWithBroker(CciChar* helpfulText, 
                            char* file,
                            int line,  
                            char* func 
                            ){
  int rc = CCI_SUCCESS;
  /* set up the message catalog name */
  const CciChar* catalog = CciString("BIPmsgs", BIP_DEF_COMP_CCSID);

  cciLogW(&rc,
          CCI_LOG_INFORMATION 
          file, line, func,
          catalog, BIP2111,
          helpfulText,
          helpfulText,
          (CciChar*)0 
          );     
  
  if(CCI_SUCCESS != rc){
    const CciChar* message = CciString("Failed to log message",
                                       BIP_DEF_COMP_CCSID);
    raiseExceptionWithBroker(message, 
                             __FILE__, 
                             __LINE__, 
                             "logSomethingWithBroker");
  }   
} 
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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