---

tperrordetail(3c)

Name

tperrordetail(3c)-get additional detail about an error generated from the last BEA TUXEDO system call

Synopsis

#include <atmi.h>
int tperrordetail(long flags)

Description

tperrordetail returns additional detail related to an error produced by the last BEA TUXEDO system routine called in the current thread. tperrordetail returns a numeric value that is also represented by a symbolic name. If the last BEA TUXEDO system routine called in the current thread did not produce an error, then tperrordetail will return zero. Therefore, tperrordetail should be called after an error has been indicated; that is, when tperrno has been set.

Currently flags is reserved for future use and must be set to 0.

Return Values

tperrordetail returns a -1 on error and sets tperrno to indicate the error condition.

These are the symbolic names and meaning for each numeric value that tperrordetail may return. The order in which these are listed is not significant and does not imply precedence.

TPED_SVCTIMEOUT

A server was terminated due to a service timeout. The service timeout is controlled by the value of SVCTIMEOUT in the ubbconfig file or TA_SVCTIMEOUT in T_SERVER and T_SERVICE classes in the TM_MIB.

TPED_TERM

A Workstation client has been disconnected from the application.

TPED_NOUNSOLHANDLER

A client does not have an unsolicited handler set. The TPACK flag is used in a tpnotify(3c) call and the target of the tpnotify(3c) is in a BEA TUXEDO session, but it has not set an unsolicited notification handler. When tpnotify(3c) fails, tperrno is set to TPENOENT. A subsequent call to tperrordetail(3c) with no intermediate ATMI calls returns TPED_NOUNSOLHANDLER.

TPED_NOCLIENT

No client exists. The TPACK flag is used in a tpnotify call but there is no target for tpnotify(3c). When tpnotify(3c) fails, tperrno is set to TPENOENT. A subsequent call to tperrordetail(3c) with no intermediate ATMI calls returns TPED_NOCLIENT.

TPED_CLIENTDISCONNECTED

A Jolt client is disconnected currently. The TPACK flag is used in a tpnotify(3c) call and the target of tpnotify(3c) is a currently disconnected Jolt client. When tpnotify(3c) fails, a call to tperrordetail(3c) with no intermediate ATMI calls returns TPED_CLIENTDISCONNECTED.

TPED_DOMAINUNREACHABLE

A domain is unreachable. Specifically, a domain that has been configured to satisfy a request that a local domain cannot service, was not reachable when a request was made. If, after the request failure, a call is made to tperrordetail(3c) with no intermediate ATMI calls, TPED_DOMAINUNREACHABLE is returned.

When calls to tpcall(3c), tpgetrply(3c), and tprecv(3c) fail because of an unreachable domain, TPED_DOMAINUNREACHABLE is returned. The following table indicates the corresponding values returned by tperrno.

ATMI Call	tperrno	Error Detail
tpcall	TPESVCERR	TPED_DOMAINUNREACHABLE
tpgetrply	TPESVCERR	TPED_DOMAINUNREACHABLE
tprecv	TPEEVENT TPEV_SVCERR	TPED_DOMAINUNREACHABLE

Note: The TPED_DOMAINUNREACHABLE feature applies to BEA TUXEDO Domains only. It does not apply to other domains products such as Connect OSI TP Domains and Connect SNA Domains.

Errors

Under the following conditions tperrordetail fails and sets tperrno to the following:

TPEINVAL

flags not set to zero

See Also

intro(3c), tpstrerrordetail(3c), tperrno(5)

---

---