|
|
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
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|