---

tpstrerror(3)

Name

tpstrerror(3)-get error message string for a BEA TUXEDO system error

Synopsis

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

Description

tpstrerror() is used to retrieve the text of an error message from LIBTUX_CAT. err is the error code set in tperrno when a BEA TUXEDO system function call returns a -1 or other failure value.

You can use the pointer returned by tpstrerror() as an argument to userlog(3c) or the UNIX function fprintf(3).

Return Values

If err is an invalid error code, tpstrerror() returns a NULL. On success, the function returns a pointer to a string that contains the error message text.

Errors

tpstrerror() returns a NULL on error, but does not set tperrno.

Example

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

See Also

Fstrerror(3), userlog(3c)

---

---