tpurcode(5)

Name

tpurcode—BEA Tuxedo system global variable for an application-specified return code

Synopsis

#include <atmi.h>

Description

tpurcode is a global variable defined in atmi.h. Its value is the same long integer used as the value of the rcode argument of tpreturn(). tpurcode may be used by the application to return additional information to the process that calls an application service. For details, see tpreturn().

Assigning meanings to values in tpurcode is the responsibility of the application.

Examples

Following are examples showing the use of tpurcode:

If you return the value myval through rcode in an application service:

.
.
.
tpreturn(TPSUCCESS, myval, rqst->data, 0L, 0);
.
.
.

Then the code in the client module might be as follows:

.
.
.
ret = tpcall("TOUPPER", (char *)sendbuf, 0, (char **)&rcvbuf, \ &rcvlen, (long)0);
.
.
.
(void) fprintf(stdout, "Returned string is: %s\n", rcvbuf);
(void) fprintf(stdout, "Returned tpurcode is: %d\n", tpurcode);

If we call the sample client, simpcl, with the value of "My String," the output will look like this:

%simpcl "My String"
Returned string is: MY STRING
Returned tpurcode is: myval

The significance of myval must be defined by the application.

See Also