MQ_ACK_STATUS_NOT_OK
Message Queue C API Error Codes |
Previous | Contents |
Having found that a Message Queue function has not returned
successfully, you can determine the reason by passing the return status
of that function to the MQGetStatusCode
function, which returns the
error code associated with the specified status. This appendix lists the
error codes that can be returned and provides a description that is
associated with that code. You can retrieve the error string
(description) by calling the MQGetStatusString
function.
Some Message Queue functions, when they fail, might return an MQStatus
result that contains an NSPR or NSS library error code instead of a
Message Queue error code. For NSPR and NSS library error codes, the
MQGetStatusString
function returns the symbolic name of the NSPR or
NSS library error code. Please see NSPR and NSS public documentation for
NSPR and NSS error code symbols and their interpretation at the
following locations:
For NSPR error codes, see the "NSPR Error Handling" chapter at the
following site:
http://www.mozilla.org/projects/nspr/reference/html/index.html
For NSS error codes, see the "NSS and SSL Error Codes" chapter at the
following site:
http://www.mozilla.org/projects/security/pki/nss/ref/ssl/
When checking a Message Queue function for return errors, you should only reference the Message Queue common error code symbol names in order to maintain maximum compatibility with future releases. For each function, Reference lists the common error codes that can be returned by that function.
For information on error handling, see Table A-1.
Table A-1 lists the error codes in alphabetical order. For each code listed, it provides a description for the error code and notes whether it is a common error (Common).
Table A-1 Message Queue C Client Error Codes
Code | Common | Description |
---|---|---|
|
+ |
Acknowledgement status is not OK |
|
+ |
Admin key authorization mismatch |
|
+ |
Bad vector index |
|
+ |
Base 64 encode failure. |
|
+ |
Message Queue basic type size mismatch |
|
+ |
Broker: bad request |
|
+ |
Broker: bad version |
|
+ |
Broker: conflict |
|
|
Broker connection is closed. |
|
+ |
Broker: entity too large |
|
+ |
Broker: error |
|
+ |
Broker: forbidden |
|
+ |
Broker: gone |
|
+ |
Broker: invalid login |
|
+ |
Broker: not allowed |
|
+ |
Broker: not found |
|
+ |
Broker: not implemented |
|
+ |
Broker: precondition failed |
|
+ |
Broker: resource full |
|
+ |
Broker: timeout |
|
+ |
Broker: unauthorized |
|
+ |
Broker: unavailable |
|
|
Callback runtime error occurred |
|
|
Cannot unsubscribe an active consumer. |
|
|
Client id already in use |
|
|
Concurrent access |
|
|
Operation may cause deadlock |
|
+ |
Concurrent access not owner |
|
+ |
Connection failed to create a session. |
|
+ |
Connection failed to open a connection. |
|
+ |
Connection start failed. |
|
|
The transport specified is not supported. |
|
|
The consumer was closed. |
|
+ |
An exception occurred on the consumer. |
|
|
There is no durable name specified |
|
+ |
The consumer has no session. |
|
|
Message consumer not found |
|
|
The consumer is not part of this session. |
|
+ |
The consumer has not been initialized. |
|
|
Could not connect to Broker |
|
|
Could not create thread |
|
|
The number of consumers on the destination exceeded limit. |
|
+ |
The destination does not have a class. |
|
+ |
The destination does not have a name. |
|
+ |
The destination is not temporary |
|
+ |
End of stream |
|
+ |
The property file could not be found |
|
+ |
File output error |
|
+ |
The object could not be deleted because there is another reference to it. |
|
+ |
The object is invalid (i.e. it has not been deleted). |
|
+ |
A handle could not be allocated because the supply of handles has been exhausted. |
|
+ |
The hash table could not be allocated |
|
|
The hash value already exists in the hash table. |
|
|
Illegally closed an XA connection |
|
|
The library is incompatible |
|
+ |
Input stream error |
|
+ |
Generic internal error |
|
|
Invalid acknowledge mode |
|
+ |
Invalid authenticate request |
|
|
Invalid client id |
|
+ |
Invalid consumer id |
|
|
Invalid delivery mode. |
|
|
Invalid destination type. |
|
+ |
Invalid iterator |
|
|
Invalid message selector. |
|
+ |
Invalid packet |
|
+ |
Invalid packet field |
|
+ |
Invalid port |
|
|
Invalid priority |
|
|
Invalid receive mode. |
|
+ |
Invalid transaction id |
|
|
The object could not be converted invalid input |
|
+ |
MD5 Hash failure |
|
+ |
The message does not have a destination |
|
|
The message was not delivered to the session. |
|
+ |
Negative amount |
|
+ |
No authentication handler |
|
+ |
The session’s connection has been closed |
|
|
There was no message to receive. |
|
|
There are no message properties |
|
|
The message does not have a reply to destination. |
|
|
The session is not in async receive mode. |
|
|
Not found |
|
+ |
Not an IPv4 Address |
|
|
The session is not in sync receive mode. |
|
|
The session is not transacted. |
|
|
The connection is not an XA connection. |
|
|
NULL pointer passed to method |
|
+ |
The string is |
|
+ |
Number not a UINT16 |
|
+ |
The object cannot be cloned |
|
|
Out of memory |
|
+ |
Packet output error |
|
+ |
Poll error |
|
+ |
Portmapper error |
|
+ |
Portmapper returned invalid. |
|
+ |
Portmapper is the wrong version |
|
|
Producer closed. |
|
|
The producer has a specified destination |
|
|
The producer does not have a specified destination. |
|
|
The producer is not part of this session |
|
+ |
There was an error reading from the property file |
|
+ |
Property is`NULL`. |
|
|
Property has the wrong value type |
|
+ |
Authenticating to the broker failed. |
|
+ |
Deleting destination failed |
|
+ |
Protocol Handler error |
|
+ |
Error in saying goodbye to broker. |
|
+ |
Error saying hello to the broker. |
|
+ |
Reading a packet from the broker failed. |
|
+ |
Error resume flow from broker. |
|
+ |
Setting client id failed. |
|
+ |
Starting broker connection failed. |
|
+ |
Stopping broker connection failed. |
|
+ |
Received an unexpected reply from the broker. |
|
+ |
Writing a packet to the broker failed. |
|
|
A queue consumer cannot be durable |
|
+ |
Read channel couldn’t dispatch packet. |
|
+ |
ReadQTable error |
|
+ |
The receive queue is closed. |
|
+ |
The Session is not associated with a connection. |
|
+ |
A freed object was referenced. |
|
+ |
Reused consumer id |
|
+ |
Shared subscription must use Topic destination |
|
|
The destination to which this message was sent could not be found. |
|
|
The destination is full and is rejecting new messages. |
|
|
The message exceeds the single message size limit for the server or for the destination. |
|
+ |
Serialize bad class UID |
|
+ |
Serialize bad handle |
|
+ |
Serialize bad magic number |
|
+ |
Serialize bad super class |
|
+ |
Serialize bad version |
|
+ |
Serialize cannot clone |
|
+ |
Serialize corrupted hashtable |
|
+ |
Serialize no class description |
|
+ |
Serialize not class definition |
|
+ |
Serialize not a class object |
|
+ |
Serialize not a hashtable |
|
+ |
Serialize not a handle object |
|
+ |
Serialize string contains`NULL` |
|
+ |
Serialize string too big |
|
+ |
Serialize testing error |
|
+ |
Serialize unexpected bytes |
|
+ |
Serialize unrecognized class |
|
|
Session closed |
|
|
Session is not in client acknowledge mode |
|
+ |
Could not close the socket |
|
+ |
Could not connect socket to the host |
|
+ |
Socket error |
|
+ |
Could not read from the socket |
|
+ |
Could not shutdown socket |
|
+ |
Could not write to the socket |
|
|
SSL has already been initialized |
|
+ |
SSL certification error |
|
+ |
SSL error |
|
+ |
SSL initialization error |
|
|
SSL not initialized |
|
+ |
SSL socket initialization error |
|
|
The connection cannot be deleted because it was not closed. |
|
|
The handle passed to a function is invalid. |
|
+ |
String not a number |
|
|
Success |
|
+ |
TCP already connected. |
|
+ |
TCP connection is closed. |
|
+ |
Invalid TCP port. |
|
|
The temporary destination is not in the connection. |
|
|
The calling thread is not associated with an XA transaction |
|
|
Timeout expired |
|
|
Session is transacted. |
|
+ |
Transaction id in use. |
|
+ |
The object conversion failed because the value is out of bounds |
|
+ |
Received an unexpected acknowledgement |
|
+ |
Unexpected null |
|
+ |
Uninitialized stream |
|
+ |
The packet type was unrecognized |
|
+ |
Unsupported argument value |
|
+ |
Unsupported authentication type |
|
+ |
The JMS message type is not supported |
|
+ |
Vector too big |
|
+ |
Buffer is the wrong size |
|
+ |
An XA session is in progress |
|
+ |
The XA session has no active transaction |
Previous | Contents |