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® メッセージ・ソース、または Linux®UNIX®z/OS® のメッセージ・カタログの、完全修飾の場所および名前。

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

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("BIPv600", 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, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:44:41

as24570_