PURPOSE

tpstrerror - get error message string for System/T 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 System/T function call returns a -1 or other failure value.

You can use the pointer returned by tpstrerror() as an argument to userlog(3c) or 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