JetNet/Oracle Tuxedo Guide


Appendix D. JetNet/Oracle Tuxedo Exception Event Types

Each exception event type that is generated by the middleware adapter can be identified by one of the constants shown in the following table and its corresponding integer code. These constants are accessible in JPL and C functions; they are also stored in the application variable tp_exc_names (stripped of the TP_ prefix), and are indexed according to the corresponding integer codes.

Table D-1 Exception event type constants and integer codes

Exception type constant Code Description

TP_ALREADY_CANCELLED

1

Attempting to cancel a request that has already been cancelled

TP_BEGIN_FAILED

2

Unable to begin a new transaction

TP_COMMIT_FAILED

3

Unable to commit a transaction

TP_COMMIT_PARTIAL

4

Transaction has (or may have been) partially rolled back

TP_COMMIT_ROLLEDBACK

5

Unable to commit a transaction because it has already been rolled back

TP_CONNECTION_CLOSE_FAILED

6

Unable to terminate a connection to the middleware

TP_CONNECTION_LIMIT

7

The connection limit for the middleware session has been exceeded

TP_CONNECTION_OPEN_FAILED

8

Unable to initiate a connection to the middleware

TP_DATAFUNC_FAILED

9

Failure reported from DATAFUNC function

TP_EVTBROKER_ACCESS_FAILED

10

Unable to access event broker server

TP_EXPLICIT_CANCEL

11

A service request has been cancelled by the service_cancel command

TP_GROUP_NOT_IN_JIF

12

The service group has not been defined in the JIF

TP_HANDLER_MISSING

13

An invoked handler cannot be located

TP_IDENTIFIER_TRUNCATED

14

An identifier has been truncated

TP_INTERNAL_ERROR

15

Internal error

TP_INVALID_ARGUMENT

16

Name, syntax, or use of an argument is invalid

TP_INVALID_ARGUMENT_COMPONENT

17

Component of an argument is invalid

TP_INVALID_ARGUMENT_LIST

18

Argument list is invalid

TP_INVALID_BUFFER

19

Data buffer received from a client or a service is of the wrong type as specified in the JIF; or a client has received an unsolicited message that is of a type not supported

TP_INVALID_BUFFER_VERSION

20

Received data buffer from a client or a service is of an incompatible version; or a client has received an unsolicited message that is of an incompatible version

TP_INVALID_CALL

21

Service call does not exist

TP_INVALID_CLIENT_COMMAND

22

Function or JPL command is only available to servers, not clients

TP_INVALID_CLIENT_OPTION

23

Function or JPL command option is only available to servers, not clients

TP_INVALID_COMMAND

24

Function or JPL command is invalid

TP_INVALID_COMMAND_SYNTAX

25

Function or JPL command syntax is invalid

TP_INVALID_CONNECTION

26

Specified connection does not exist

TP_INVALID_CONTEXT

27

Attempt to perform action out of context

TP_INVALID_FORWARD

28

A conversational service cannot be forwarded

TP_INVALID_VARIABLE_REF

29

Unable to resolve reference to the Panther variable

TP_INVALID_MONITOR_COMMAND

30

Function or JPL command is not available for the middleware adapter

TP_INVALID_MONITOR_OPTION

31

Function or JPL command option is not available for the middleware adapter

TP_INVALID_OPTION

32

Option is invalid in this context

TP_INVALID_OPTION_VALUE

33

Value for option is invalid

TP_INVALID_SERVER_COMMAND

34

Function or JPL command is available only to clients, not servers

TP_INVALID_SERVER_OPTION

35

Function or JPL command option is available only to clients, not servers

TP_INVALID_SERVICE

36

Service is invalid

TP_INVALID_TRANSACTION

37

Transaction does not exist

TP_JIF_ACCESS_FAILED

38

JIF or the Panther library containing it could not be accessed

TP_JIF_LOWER_VERSION

39

New JIF has lower version than the current one

TP_LOGFILE_ERROR

40

Unable to write to the ULOG file

TP_MONITOR_ERROR

41

Error reported from middleware adapter

TP_NONTRANSACTIONAL_ACTION

42

Requested action cannot be performed within a transaction

TP_NONTRANSACTIONAL_SERVICE

43

The service cannot be executed within a transaction

TP_NO_OUTSIDE_TRANSACTION

44

Option OUTSIDE_TRANSACTION is ignored because no transaction exists

TP_NO_OUTSTANDING_CALLS

45

The specified requests are no longer outstanding

TP_NO_OUTSTANDING_MESSAGE

46

There are no outstanding unsolicited messages

TP_NO_SERVICES_ADVERTISED

47

No services advertised or unadvertised

TP_NO_SIGNALS

48

Client is not capable of signal-based notification

TP_OUT_OF_MEMORY

49

Unable to allocate sufficient memory; program will exit

TP_PERMISSION_DENIED

50

Unable to perform action because permission has been denied

TP_POSTING_FAILED

51

Posting a transactional event to either a service or to a storage queue failed

TP_QUEUE_BAD_MSGID

52

Invalid message identifier

TP_QUEUE_BAD_NAMESPACE

53

Invalid resource manager identifier

TP_QUEUE_BAD_QUEUE

54

Invalid or deleted queue name

TP_QUEUE_CANT_START_TRAN

55

Error starting separate transaction for queuing operation

TP_QUEUE_FULL

56

No space left on queue for any additional messages

TP_QUEUE_MSG_IN_USE

57

Selected message (or all messages) is in use by another transaction

TP_QUEUE_NO_MSG

58

No message was available for dequeuing

TP_QUEUE_NOT_IN_QSPACE

59

Unable to find the specified queue in the specified queue space in the JIF.

TP_QUEUE_RSRC_NOT_OPEN

60

Resource manager is not currently open

TP_QUEUE_SPACE_NOT_IN_JIF

61

Unable to find specified queue space in JIF.

TP_QUEUE_TRAN_ABORTED

62

Transaction enclosing queuing operation was aborted

TP_QUEUE_TRAN_ABSENT

63

Queuing operation was done when transaction state was not active

TP_QUEUE_UNEXPECTED

64

Undocumented queuing error produced by monitor

TP_REQUEST_LIMIT

65

The limit on the number of outstanding requests has been exceeded

TP_ROLLBACK_COMMITTED

66

Unable to roll back the transaction because it has already been committed

TP_ROLLBACK_FAILED

67

Unable to roll back the transaction

TP_SERVICE_FAILED

68

Service returned a failure status

TP_SERVICE_NOT_IN_JIF

69

Service could not be found in the JIF

TP_SERVICE_PROTOCOL_ERROR

70

Service has violated protocol and has been abnormally terminated

TP_SUBSCRIPTION_LIMIT

71

Maximum number of subscriptions has been reached

TP_SUBSCRIPTION_MATCH

72

Subscription matches one already listed with event broker

TP_SVCROUTINE_MISSING

73

Unable to locate service routine

TP_SVC_ADVERTISE_LIMIT

74

The limit on the number of advertised services has been exceeded

TP_SVC_WORK_OUTSTANDING

75

There is work which this service has begun that has not completed

TP_SVRINIT_WORK_OUTSTANDING

76

Server init routine has begun work that has not yet completed

TP_TIMEOUT

77

Action terminated due to timeout condition

TP_TRANSACTION_LIMIT

78

A new transaction would exceed transaction limit for the middleware session

TP_UNLOAD_FAILED

79

Failure reported from unload event handler

TP_UNSUPPORTED_BUFFER

80

Specified buffer type is not supported

TP_USER_ABORT

81

Action has been explicitly aborted

TP_WORK_OUTSTANDING

82

Work is still being performed within this transaction

TP_XA_CLOSE_FAILED

83

Unable to close XA-connection resource managers

TP_XA_OPEN_FAILED

84

Unable to open XA-connection resource managers