名前

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() は NULL を返しますが tperrno は設定しません。

使用例

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

関連項目