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

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

cciThrowException

この関数を使用して、例外をスローします。 例外は、ブローカー・インターフェースによってスローされ、例外データとして指定される引数を含んでいます。

構文

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

パラメーター

returnCode
関数からの戻りコード (出力)。 考えられる戻りコードは CCI_INV_DATA_POINTER です。
type
例外のタイプ (入力)。 有効な値は以下のとおりです。
  • CCI_FATAL_EXCEPTION
  • CCI_RECOVERABLE_EXCEPTION
  • CCI_CONFIGURATION_EXCEPTION
  • CCI_PARSER_EXCEPTION
  • CCI_CONVERSION_EXCEPTION
  • CCI_DATABASE_EXCEPTION
  • CCI_USER_EXCEPTION
file
例外が生成されたソース・ファイル名 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
line
例外が生成されたソース・ファイルでの行番号 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
function
例外が生成された関数の名前 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
messageSource
Windows メッセージ・ソース、または LinuxUNIXz/OS® のメッセージ・カタログの、完全修飾の場所および名前。

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

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

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

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

戻り値

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

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

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

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


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