tibems_status


Type

Purpose

Functions return status codes to indicate return conditions.

Table 18 Status Codes (Sheet 1 of 6)
Constant
Code
Description
TIBEMS_OK 
0 
The call completed normally.
TIBEMS_ILLEGAL_STATE 
1 

A function call or server request occurred in an inappropriate context.

For example, tibemsSession_Commit indicates this status when the session is non-transactional.

TIBEMS_INVALID_CLIENT_ID 
2 

The provider rejects the connection’s client ID.

Setting a connection’s client ID to an invalid or duplicate value results in this exception. (A duplicate value is one that is already in use by another connection.)

TIBEMS_INVALID_DESTINATION 
3 

tibemsd cannot locate the destination.

TIBEMS_INVALID_SELECTOR 
4 

The client passed a message selector with invalid syntax; see Message Selectors.

TIBEMS_EXCEPTION 
5 
Non-specific error code.
TIBEMS_SECURITY_EXCEPTION 
6 

The function cannot complete because of a security restriction.

For example, the provider rejects a user or the user’s authentication.

TIBEMS_MSG_EOF 
7 

The data stream within a message ended unexpectedly.

tibemsBytesMsg contains a stream of bytes. tibemsStreamMsg contains a stream of characters. If any of their read functions detects the end of a stream unexpectedly, it indicates this status.

TIBEMS_MSG_NOT_READABLE 
9 
Attempt to read from a message in write-only mode.
TIBEMS_MSG_NOT_WRITEABLE 
10 

Attempt to write to a message in read-only mode.

See also, tibemsMsg_MakeWriteable .

TIBEMS_SERVER_NOT_CONNECTED 
11 
  • An attempt to connect to the server has failed.
  • The operation requires a server connection, but the program is not connected.
TIBEMS_SUBJECT_COLLISION 
13 
The server cannot create a topic or durable because the name is already in use. (Also applies to collisions with external subjects, such as Rendezvous.)
TIBEMS_INVALID_PROTOCOL 
15 
Cannot create a connection or transaction because the specified protocol does not exist.
TIBEMS_INVALID_HOSTNAME 
17 
The connection URL includes an invalid hostname, or an attempt to lookup the host address failed.
Host names must be less than 128 characters.
TIBEMS_INVALID_PORT 
18 
The connection URL includes an invalid port number.
TIBEMS_NO_MEMORY 
19 
The program exceeded available memory during the call.
TIBEMS_INVALID_ARG 
20 
The function received an illegal value as an argument.
TIBEMS_SERVER_LIMIT 
21 
The server has exceeded the maximum number of licensed connections or hosts that it can service.
TIBEMS_NOT_PERMITTED 
27 
The function call is not permitted (for example, closing a connection within a callback).
TIBEMS_SERVER_RECONNECTED 
28 
Exception callback handler functions receive this code to indicate that the server has reconnected.
TIBEMS_INVALID_NAME 
30 

In a lookup request, the name has incorrect syntax.

The most common syntax error is a prefix other than tibjmsnaming:// (or a misspelling).

TIBEMS_INVALID_SIZE 
32 
An argument is outside the range of valid values.
TIBEMS_NOT_FOUND 
35 

1. The name lookup repository cannot find a name; the name is not bound. See also, tibemsLookupContext

2. A function that gets a message field or property value cannot find the specified item because the name is not bound in the message.

TIBEMS_CONVERSION_FAILED 
38 
A datatype conversion failed while parsing a message (converting UTF-8 data to native datatypes).
TIBEMS_INVALID_MSG 
42 
The message is uninitialized or corrupt.
TIBEMS_INVALID_FIELD 
43 
The message contains an invalid field. The message might be corrupt.
TIBEMS_CORRUPT_MSG 
45 
The message is corrupt.
TIBEMS_TIMEOUT 
50 
The timeout has expired while waiting for a message.
TIBEMS_INTR 
51 
A blocking operation has been interrupted. See tibemsMsgConsumer_Receive .
TIBEMS_QUEUE_LIMIT_EXCEEDED 
52 
A server queue has exceeded its size limit, and cannot add a new message.
TIBEMS_MEM_LIMIT_EXCEEDED 
53 
The server has exceeded its memory limit.
TIBEMS_USER_INTR 
54 
Mainframe only. A blocking operation has been interrupted. See tibx_MVSConsole_SetConsumer() .
TIBEMS_INVALID_IO_SOURCE 
65 
The function detected an invalid I/O source (such as a socket or file).
TIBEMS_OS_ERROR 
68 
An operating system error occurred during the call.
TIBEMS_INSUFFICIENT_BUFFER 
70 
The result of the call overflowed the buffer supplied by the program.
TIBEMS_EOF 
71 
The call detected an unexpected end-of-file.
TIBEMS_INVALID_FILE 
72 
The function detected an invalid file.
TIBEMS_FILE_NOT_FOUND 
73 
The specified file does not exist.
TIBEMS_IO_FAILED 
74 
An operating system I/O call failed.
TIBEMS_ALREADY_EXISTS 
91 
Cannot create an item that already exists.
TIBEMS_INVALID_CONNECTION 
100 
The connection is invalid.
TIBEMS_INVALID_SESSION 
101 
The session is invalid.
TIBEMS_INVALID_CONSUMER 
102 
The consumer is invalid.
TIBEMS_INVALID_PRODUCER 
103 
The producer is invalid.
TIBEMS_INVALID_USER 
104 
The server could not authenticate the user.
TIBEMS_TRANSACTION_FAILED 
106 
A transaction failed at the server during a commit call.
TIBEMS_TRANSACTION_ROLLBACK 
107 

Failure during prepare or commit caused automatic rollback of a transaction. This type of rollback can occur during fault tolerance failover.

TIBEMS_TRANSACTION_RETRY 
108 
A transaction failed during two-phase commit; the program may attempt to commit it again.
TIBEMS_INVALID_XARESOURCE 
109 
When a session uses an XA transaction manager, the XA resource is the correct locus for all commit and rollback requests. Local commit or rollback calls are not permitted, and indicate this status.
TIBEMS_FT_SERVER_LACKS_TRANSACTION 
110 
The producer attempted to send a message immediately after a fault tolerance failover to another server. The new server has no record of the transaction.
SSL
TIBEMS_INVALID_CERT 
150 
SSL detected an invalid X.509 certificate.
TIBEMS_INVALID_CERT_NOT_YET 
151 
SSL detected an X.509 certificate that is not yet valid; that is, the current date is before the first date for which the certificate becomes valid.
TIBEMS_INVALID_CERT_EXPIRED 
152 
SSL detected an X.509 certificate that is no longer valid; that is, the current date is after the expiration date.
TIBEMS_INVALID_CERT_DATA 
153 
SSL detected an X.509 certificate containing corrupt data.
TIBEMS_ALGORITHM_ERROR 
154 
Error loading a cipher suite algorithm.
TIBEMS_SSL_ERROR 
155 
Generic SSL error code.
TIBEMS_INVALID_PRIVATE_KEY 
156 
SSL detected a private key that does not match its public key.
TIBEMS_INVALID_ENCODING 
157 
SSL detected a certificate encoding that it cannot read.
TIBEMS_NOT_ENOUGH_RANDOM 
158 
SSL lacks sufficient random data to complete an operation securely.
TIBEMS_INVALID_CRL_DATA 
159 
SSL detected a corrupt certificate revocation list (CRL) file; it could not load the CRL file.
Unimplemented
TIBEMS_NOT_IMPLEMENTED 
255 
The function is not implemented.

 

TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com