cciLog

cciLog を使用して、エラー、警告、または通知イベントを書き込みます。

イベントは、ブローカー・インターフェースによってログ記録され、ログ・データとして指定される引数を含んでいます。

構文

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

パラメーター

returnCode
関数からの戻りコード (出力)。考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_INV_DATA_POINTER
  • CCI_INV_LOG_TYPE
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 char (文字へのポインター) であると見なされます。

char* 文字は、ASCII (Latin) または EBCDIC (1047) のストリングでなければなりません。

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

戻り値

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

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:44:38

as08552_