tpstrerror(3c)

名前

tpstrerror()-BEA Tuxedo ATMI システムのエラー・メッセージ文字列の取得

形式

#include <atmi.h>
char *
tpstrerror(int err)

機能説明

tpstrerror() は LIBTUX_CAT からエラー・メッセージのテキストを取得するために使用します。err は、BEA Tuxedo ATMI システムの関数呼び出しが -1 またはその他の異常終了値を返した場合に tperrno() に設定されるエラー・コードです。

ユーザは、tpstrerror() から返されるポインタを、userlog() または fprintf() への引数として使用できます。

マルチスレッドのアプリケーション中のスレッドは、TPINVALIDCONTEXT を含め、どのコンテキスト状態で実行していても tpstrerror() の呼び出しを発行できます。

戻り値

正常終了すると、tpstrerror() はエラー・メッセージ・テキストを含む文字列を指すポインタを返します。

err が無効なエラー・コードであった場合は、tpstrerror() は、NULL を返します。

エラー

異常終了すると、tpstrerror() はヌルを返しますが tperrno() は設定しません。

使用例

#include <atmi.h>
.
.
.
  char *p;
  if (tpbegin(10,0) == -1) {
    p = tpstrerror(tperrno);
    userlog("%s", p);
    (void)tpabort(0);
    (void)tpterm();
    exit(1);
  }

関連項目