Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo File Formats and Data Descriptions Reference

tperrno - BEA Tuxedo system error codes

#include <atmi.h>

The numerical value represented by the symbolic name of an error condition is assigned to tperrno for errors that occur when executing a BEA Tuxedo system library routine.

The name tperrno expands to a modifiable lvalue that has type int, the value of which is set to a positive error number by several BEA Tuxedo system library routines. tperrno need not be the identifier of an object; it might expand to a modifiable lvalue resulting from a function call. It is unspecified whether tperrno is a macro or an identifier declared with external linkage. If a tperrno macro definition is suppressed to access an actual object, or if a program defines an identifier with the name tperrno, the behavior is undefined.

The reference pages for BEA Tuxedo system library routines list possible error conditions for each routine and the meaning of the error in that context. The order in which possible errors are listed is not significant and does not imply precedence. The value of tperrno should be checked only after an error has been indicated; that is, when the return value of the component indicates an error and the component definition specifies that tperrno is set on error. An application that checks the value of tperrno must include the <atmi.h> header file.

The following list describes the general meaning of each error:

TPEABORT

A transaction could not commit because either the work performed by the initiator or by one or more of its participants could not commit.

TPEBADDESC

A call descriptor is invalid or is not the descriptor with which a conversational service was invoked.

TPEBLOCK

A blocking condition exists and TPNOBLOCK was specified.

TPEDIAGNOSTIC

The enqueuing of a message on the specified queue failed. The reason for failure can be determined by the diagnostic returned via ctl.

TPEEVENT

An event occurred; the event type is returned in revent.

TPEGOTSIG

A signal was received and TPSIGRSTRT was not specified.

TPEHAZARD

Due to some failure, the work done on behalf of the transaction could have been heuristically completed.

TPEHEURISTIC

Due to a heuristic decision, the work done on behalf of the transaction was partially committed and partially aborted.

TPEINVAL

An invalid argument was detected.

TPEITYPE

The type and sub-type of the input buffer is not one of the types and sub-types that the service accepts.

TPELIMIT

The caller's request was not sent because the maximum number of outstanding requests or connections has been reached.

TPEMATCH

svcname is already advertised for the server but with a function other than func.

TPEMIB

The administrative request failed. outbuf is updated and returned to the caller with FML32 fields indicating the cause of the error, as described in MIB(5) and TM_MIB(5).

TPENOENT

Cannot send to svc because it does not exist or is not the correct type of service.

TPEOS

An operating system error has occurred.

TPEOTYPE

The type and sub-type of the reply are not known to the caller.

TPEPERM

A client cannot join an application because it does not have permission to do so or because it has not supplied the correct application password.

TPEPROTO

A library routine was called in an improper context.

TPERELEASE

When the TPACK is set and the target is a client from a prior release of the BEA Tuxedo system that does not support the acknowledgment protocol.

TPERMERR

A resource manager failed to open or close correctly.

TPESVCERR

A service routine encountered an error either in tpreturn() or tpforward() (for example, bad arguments were passed).

TPESVCFAIL

The service routine sending the caller's reply called tpreturn() with TPFAIL. This is an application-level failure.

TPESYSTEM

A BEA Tuxedo system error has occurred.

TPETIME

A timeout occurred.

TPETRAN

The caller cannot be placed in transaction mode.

Some routines do not have an error return value. Because no routine sets tperrno to zero, an application can set tperrno to zero, call a routine and then check tperrno again to see if an error has occurred.

See the ERRORS section of the individual BEA Tuxedo library routines for a more detailed description of the meaning of the error codes returned by each routine.