java.lang.Object | +----java.lang.Throwable | +----java.lang.Exception | +----com.ibm.mq.MQException
An MQException is thrown whenever a WebSphere MQ error occurs. You can change the java.io.OutputStreamWriter to vary where exceptions are logged by setting the value of MQException.log. The default value is System.err.
public MQException(int completionCode, int reasonCode, Object source);
Constructs a new MQException object.
public int
WebSphere MQ completion code giving rise to the error. The possible values are:
public java.lang.Object
The object instance that threw the exception.
public static java.io.OutputStreamWriter
Stream to which exceptions will be logged (the default is System.err). If you set this to null then no logging will occur.
public final static int
Completion code - call failed. The processing of the call did not complete, and the state of the queue manager is normally unchanged; exceptions are specifically noted. The completion code and reason code output parameters have been set; other parameters are unchanged, except where noted. The failure might be the result of a fault in the application program, or of a situation external to the program, for example the user's authority might have been revoked. The reason code parameter gives additional information about the error.
public final static int
Completion code - successful completion. The call completed fully; all output parameters have been set. The Reason parameter always has the value MQRC_NONE in this case.
public final static int
Completion code - unknown.
public final static int
Completion code - warning (partial completion). The call completed partially. Some output parameters might have been set in addition to the completion code and reason code output parameters. The Reason parameter gives additional information about the partial completion.
public final static int
Reason code - unable to load adapter connection module.
public final static int
Reason code - unable to load data conversion services modules.
public final static int
Reason code - adapter subsystem definition module not valid.
public final static int
Reason code - unable to load adapter subsystem definition module.
public final static int
Reason code - unable to load adapter disconnection module.
public final static int
Reason code - adapter not available.
public final static int
Reason code - unable to load adapter service module.
public final static int
Reason code - insufficient storage for adapter.
public final static int
Reason code - alias base queue not a valid type.
public final static int
Reason code - application is already connected.
public final static int
Reason code - another queue manager is already connected.
public final static int
Reason code - unable to load the API exit.
public final static int
Reason code - primary and home ASIDs differ.
public final static int
Reason code - unit of work is backed out.
public final static int
Reason code - backout threshold has been reached.
public final static int
Reason code - buffer parameter is not valid.
public final static int
Reason code - buffer length parameter is not valid.
public final static int
Reason code - MQI was entered before previous call was complete.
public final static int
Reason code - invalid MQCD channel definition. An MQCONNX call was issued to connect to a queue manager, but the MQCD channel definition structure addressed by the ClientConnOffset or ClientConnPtr field in MQCNO contains data that is not valid.
public final static int
Reason code - the coupling-facility structure is unavailable. An MQOPEN or MQPUT1 call was issued to access a shared queue, but the allocation of the coupling-facility structure specified in the queue definition failed because there is no suitable coupling facility to hold the structure, based on the preference list in the active CFRM policy. Only applies to z/OS.
public final static int
Reason code - the user is not authorized to access the coupling-facility structure. An MQOPEN or MQPUT1 call was issued to access a shared queue, but the call failed because the user is not authorized to access the coupling-facility structure specified in the queue definition. Only applies to z/OS.
public final static int
Reason code - coupling-facility structure is not valid. Z/OS only.
public final static int
Reason code - the coupling-facility structure is in use. An MQI call was issued to operate on a shared queue, but the call failed because the coupling-facility structure specified in the queue definition is temporarily unavailable. Only applies to z/OS.
public final static int
Reason code - the list header associated with the coupling-facility structure is in use. An MQGET, MQOPEN, MQPUT1, or MQSET call was issued to access a shared queue, but the call failed because the list header associated with the coupling-facility structure specified in the queue definition is temporarily unavailable. Only applies to z/OS.
public final static int
Reason code - PCF header structure is not valid.
public final static int
Reason code - PCF integer list parameter structure is not valid.
public final static int
Reason code - PCF integer parameter structure is not valid.
public final static int
Reason code - PCF string list parameter structure is not valid.
public final static int
Reason code - PCF string parameter structure is not valid.
public final static int
Reason code - a channel is now able to become active because an active slot has been released by another channel.
public final static int
Reason code - automatically defined error
public final static int
Reason code - Automatic channel definition succeeded.
This condition is detected when the automatic definition of a channel is successful. The channel is defined by the MCA.
public final static int
Reason code - a channel was unable to convert data and the MQGET call to get a message from the transmission queue resulted in a data conversion error.
public final static int
Reason code - a channel is required to become active, but is unable to do so because the limit on the number of active channels has been reached.
public final static int
Reason code - either an operator has issued a Start Channel command or an instance of a channel has been successfully established.
public final static int
Reason code - channel has been stopped.
public final static int
Reason code - channel has been stopped by an operator.
public final static int
Reason code - length of character attributes is not valid.
public final static int
Reason code - character attributes string is not valid.
public final static int
Reason code - not enough space allowed for character attributes.
public final static int
Reason code - returned by the Java MQQueueManager constructor when a required character-set conversion is not available. The conversion required is between two non-Unicode character sets.
public final static int
Reason code - wait request has been rejected by CICS.
public final static int
Reason code - client channel definition table conflict error. An attempt is being made to specify a client channel definition table when the name of the channel has already been defined. Change the channel name to blank and try again. This reason code only occurs with Java applications.
public final static int
Reason code - an MQCONNX call was issued to connect to a queue manager, but the MQCD channel definition structure was not specified correctly.
public final static int
Reason code - Error in client exit
public final static int
Reason code - client exit could not be loaded.
public final static int
Reason code - cluster workload exit has failed.
public final static int
Reason code - unable to load cluster workload exit.
public final static int
Reason code - put calls have been inhibited for all queues in cluster.
public final static int
Reason code - cluster name resolution failed.
public final static int
Reason code - cluster resource error.
public final static int
Reason code - the command server that processes administration commands is not available.
public final static int
Reason code - connection options are not valid.
public final static int
Reason code - COD report option not valid for XCF queue.
public final static int
Reason code - the coded character set ID is not valid.
public final static int
Reason code - connection identifier is already in use.
public final static int
Reason code - an MQDISC call was issued when there was a unit of work outstanding for the connection handle. Only applies to z/OS.
public final static int
Reason code - the connection tag is not usable. An MQCONNX call was issued specifying one of the MQCNO_* or _CONN_TAG_* options, but the call failed because the connection tag specified by ConnTag in MQCNO is being used by the queue manager for recovery processing, and this processing is delayed pending recovery of the coupling facility. Only applies to z/OS.
public final static int
Reason code - connection to queue manager has been lost.
public final static int
Reason code - not authorized for connection.
public final static int
Reason code - connection is quiescing.
public final static int
Reason code - connection is stopping.
public final static int
Reason code - queue handle referred to does not save context.
public final static int
Reason code - context not available for queue handle referred to.
public final static int
Reason code - converted data is too big for buffer.
public final static int
Reason code - converted string is too big for field.
public final static int
Reason code - correlation ID error.
public final static int
Reason code - error in current record.
public final static int
Reason code - data length parameter is not valid.
public final static int
Reason code - an MQOPEN, MQPUT1, or MQSET call was issued to access a shared queue, but the call failed because the queue manager is not connected to a DB2 subsystem. As a result, the queue manager is unable to access the object definition relating to the shared queue. Only applies to z/OS.
public final static int
Reason code - DBCS string is not valid.
public final static int
Reason code - default transmission queue is not local.
public final static int
Reason code - default transmission queue usage error.
public final static int
Reason code - dead letter header structure is not valid.
public final static int
Reason code - recovery coordinator already exists.
public final static int
Reason code - name of dynamic queue is not valid.
public final static int
Reason code - the Encoding field in the message descriptor MQMD contains a value that is not supported.
public final static int
Reason code - call not valid in this environment.
public final static int
Reason code - expiry time is not valid.
public final static int
Reason code - feedback code is not valid.
public final static int
Reason code - file has not been audited.
public final static int
Reason code - error in file system.
public final static int
Reason code - message format is not valid.
public final static int
Reason code - The format field in the message descriptor MQMD contains a value that is not supported.
public final static int
Reason code - An attempt was made to access functionality that is not supported from the environment from which it was called. For example, running the Client Configuration on z/OS
public final static int
Reason code - gets are inhibited for the queue.
public final static int
Reason code - global units of work conflict with each other.
public final static int
Reason code - get-message options object is not valid.
public final static int
Reason code - group identifier is not valid.
public final static int
Reason code - handle is in use for a global unit of work.
public final static int
Reason code - no more handles are available.
public final static int
Reason code - connection handle is not valid.
public final static int
Reason code - WebSphere MQ header structure is not valid.
public final static int
Reason code - object handle is not valid.
public final static int
Reason code - message group is not complete.
public final static int
Reason code - message is not complete.
public final static int
Reason code - browse specification is inconsistent.
public final static int
Reason code - message segments have differing CCSIDs.
public final static int
Reason code - message segments have differing encodings.
public final static int
Reason code - inconsistent persistence specification.
public final static int
Reason code - unit-of-work specification is inconsistent.
public final static int
Reason code - an index parameter to a call or method has a value that is not valid. The value must be zero or greater.
public final static int
Reason code - the specified index is not present.
public final static int
Reason code - value for inhibit-get or inhibit-put queue attribute is not valid.
public final static int
Reason code - count of integer attributes is not valid.
public final static int
Reason code - not enough space has been allowed for integer attributes.
public final static int
Reason code - integer attributes array is not valid.
public final static int
Reason code - message under cursor is not valid for retrieval.
public final static int
Reason code - this reason code is generated when JMS encounters a message that it is unable to parse. If such a message is encountered by a JMS ConnectionConsumer, the message is processed as specified by the disposition options in the Report field in the MQMD of the message.
If the Report field specifies one of the MQRO_EXCEPTION_*
options, this reason code appears in the Feedback field of the report message.
If
the Report field specifies MQRO_DEAD_LETTER_Q, or the
disposition report options are left as default, this reason code appears in
the Reason field of the MQDLH.
public final static int
Reason code - JSSE reported an error (for example, while connecting to a queue manager using SSL encryption). The MQException object containing this reason code references the Exception thrown by JSSE; this can be obtained by using the MQException.getCause() method. From JMS, the MQException is linked to the thrown JMSException.
public final static int
Reason code - global unit of work conflicts with a local unit of work.
public final static int
Reason code - match options are not valid.
public final static int
Reason code - maximum number of connections reached.
public final static int
Reason code - message descriptor is not valid.
public final static int
Reason code - message descriptor extension is not valid.
public final static int
Reason code - missing reply-to queue.
public final static int
Reason code - mismatch of queue IndexType and Format field in MQMD. An MQPUT or MQPUT1 call was issued to put a message on a queue whose IndexType attribute had the value MQIT_MSG_TOKEN, but the Format field in the MQMD was not MQFMT_WORK_INFO_HEADER. This error occurs only when the message arrives at the destination queue manager. Only allies to z/OS.
public final static int
Reason code - message flags are not valid.
public final static int
Reason code - message ID error.
public final static int
Reason code - message is marked
public final static int
Reason code - message is not matched.
public final static int
Reason code - message sequence number is not valid.
public final static int
Reason code - An MQGET call was issued to retrieve a message using the message token as a selection criterion, but the options specified are not valid. only applies to z/OS.
public final static int
Reason code - message is too big for channel.
public final static int
Reason code - message length is greater than maximum for queue.
public final static int
Reason code - message length is greater than maximum for queue manager.
public final static int
Reason code - message type in message descriptor is not valid.
public final static int
Reason code - multiple reason codes have been returned.
public final static int
Reason code - an MQOPEN call was issued to create a dynamic queue, but a queue with the same name as the dynamic queue already exists. The existing queue is one that is logically deleted, but for which there are still one or more open handles. Only applies to z/OS.
public final static int
Reason code - object name is not valid for object type.
public final static int
Reason code - error in offset to next record.
public final static int
Reason code - error in next record.
public final static int
Reason code - no destination queues are available.
public final static int
Reason code - An MQBEGIN call was issued to start a unit of work coordinated by the queue manager, but no participating resource managers have been registered with the queue manager. As a result, only changes to WebSphere MQ resources can be coordinated by the queue manager in the unit of work.
public final static int
Reason code - no message is available.
public final static int
Reason code - no message is locked.
public final static int
Reason code - browse cursor is not positioned on message.
public final static int
Reason code - no record is available.
public final static int
Reason code - none.
public final static int
Reason code - queue is not authorized for access.
public final static int
Reason code - message data has not been converted.
public final static int
Reason code - queue is not open for browse.
public final static int
Reason code - queue is not open for input.
public final static int
Reason code - queue is not open for inquire.
public final static int
Reason code - queue is not open for output.
public final static int
Reason code - queue not open for pass all context.
public final static int
Reason code - queue not open for pass identity context.
public final static int
Reason code - queue is not open for set all context.
public final static int
Reason code - queue not open for set all context.
public final static int
Reason code - queue not open for set identity context.
public final static int
Reason code - object already exists.
public final static int
Reason code - object definition has changed since it opened.
public final static int
Reason code - object has been damaged.
public final static int
Reason code - object is already open with conflicting options.
public final static int
Reason code - object level is incompatible.
public final static int
Reason code - object name is not valid.
public final static int
Reason code - An MQOPEN or MQPUT1 call was issued to access a queue, but the call failed because the queue specified in the MQOD structure cannot be resolved unambiguously. There exists a shared queue with the specified name, and a nonshared queue with the same name. Only applies to z/OS.
public final static int
Reason code - object queue-manager name is not valid.
public final static int
Reason code - object records are not valid.
public final static int
Reason code - object type is not valid.
public final static int
Reason code - object descriptor structure is not valid.
public final static int
Reason code - message segment offset is not valid.
public final static int
Reason code - object did not open successfully.
public final static int
Reason code - an MQGET call with the MQGMO_MARK_SKIP_BACKOUT option specified was issued from a DB2 Stored Procedure. The call failed because the MQGMO_MARK_SKIP_BACKOUT option cannot be used from a DB2 Stored Procedure.
public final static int
Reason code - option is not valid for object type.
public final static int
Reason code - options are not valid or not consistent.
public final static int
Reason code - original length is not valid.
public final static int
Reason code - result of commit or backout operation is mixed.
public final static int
Reason code - result of commit operation is pending.
public final static int
Reason code - error accessing page-set data set.
public final static int
Reason code - external storage medium is full.
public final static int
Reason code - no participating resource managers have been registered.
public final static int
Reason code - participant has not been defined.
public final static int
Reason code - persistence is not valid.
public final static int
Reason code - queue does not support persistent messages.
public final static int
Reason code - put-message options object is not valid.
public final static int
Reason code - put message record flags not valid.
public final static int
Reason code - message priority is not valid.
public final static int
Reason code - message priority exceeds maximum value supported.
public final static int
Reason code - put calls are inhibited for the queue.
public final static int
Reason code - put message records are not valid.
public final static int
Reason code - queue has been deleted.
public final static int
Reason code - Queue depth high limit reached or exceeded.
A message put has caused the queue depth to be incremented to or above the limit specified in the QDepthHighLimit attribute.
public final static int
Reason code - Queue depth low limit reached or exceeded.
A message get has caused the queue depth to be decremented to or below the limit specified in the QDepthLowLimit attribute.
public final static int
Reason code - queue is full.
public final static int
Reason code - the queue manager is active.
public final static int
Reason code - queue manager name is not valid or not known.
public final static int
Reason code - the queue manager is not active.
public final static int
Reason code - queue manager is not available for connection.
public final static int
Reason code - queue manager is quiescing.
public final static int
Reason code - queue manager is shutting down.
public final static int
Reason code - queue contains one or more messages or uncommitted put or get requests.
public final static int
Reason code - Queue service interval high.
No successful gets or puts have been detected within an interval greater than the limit specified in the QServiceInterval attribute.
public final static int
Reason code - Queue service interval OK.
A successful get has been detected within an interval less than or equal to the limit specified in the QServiceInterval attribute.
public final static int
Reason code - no space available on disk for queue.
public final static int
Reason code - queue type not valid.
public final static int
Reason code - number of records present is not valid.
public final static int
Reason code - remote queue name is not valid.
public final static int
Reason code - report options in message descriptor are not valid.
public final static int
Reason code - insufficient system resources are available.
public final static int
Reason code - object records not valid.
public final static int
Reason code - the message contains an MQRFH structure, but the command name contained in the NameValueString field is not valid.
public final static int
Reason code - the message contains an MQRFH structure, but a parameter occurs more than once in the NameValueString field when only one occurrence is valid for the specified command.
public final static int
Reason code - an MQPUT or MQPUT1 call was issued, but the message data contains an MQRFH or MQRFH2 structure that is not valid.
public final static int
Reason code - the message contains an MQRFH structure, but a parameter name contained in the NameValueString field is not valid for the command specified.
public final static int
Reason code - the message contains an MQRFH structure, but the command specified in the NameValueString field requires a parameter that is not present.
public final static int
Reason code - the contents of the NameValueString field in the MQRFH structure are not valid.
public final static int
Reason code - Reference message header structure is not valid.
public final static int
Reason code - a message is already marked.
public final static int
Reason code - a security error has occurred.
public final static int
Reason code - length of data in message segment is zero.
public final static int
Reason code - a signal is outstanding for this handle.
public final static int
Reason code - no message returned (but signal request accepted).
public final static int
Reason code - signal field is not valid.
public final static int
Reason code - source buffer parameter is not valid.
public final static int
Reason code - source coded character set identifier is not valid.
public final static int
Reason code - packed-decimal encoding specified by receiver is not recognized.
public final static int
Reason code - source floating point encoding specified is not recognized.
public final static int
Reason code - source integer encoding not recognized.
public final static int
Reason code - source length parameter is not valid.
public final static int
Reason code - SSL CertStore error.
public final static int
Reason code - SSL certificate has been revoked.
public final static int
Reason code - SSL initialization error.
public final static int
Reason code - SSL key reset error.
public final static int
Reason code - SSL is not allowed.
public final static int
Reason code - SSL error in peer name.
public final static int
Reason code - SSL peer name mismatch.
public final static int
Reason code - call has been rejected by cluster workload exit.
public final static int
Reason code - storage class error.
public final static int
Reason code - insufficient storage is available.
public final static int
Reason code - the string parameter is not valid.
public final static int
The StringLength parameter is not valid.
public final static int
Reason code - the string returned by the call is too long to fit in the buffer provided. The string has been truncated to fit in the buffer.
public final static int
Reason code - call suppressed by exit program.
public final static int
Reason code - no more messages can be handled within current unit of work.
public final static int
Reason code - syncpoint support is not available.
public final static int
Reason code - target buffer parameter is not valid.
public final static int
Reason code - the coded character-set identifier to which the character data is to be converted is not valid or not supported.
public final static int
Reason code - packed-decimal encoding specified by the receiver is not recognized.
public final static int
Reason code - floating-point encoding specified by the receiver is not recognized.
public final static int
Reason code - target coded character set identifier is not valid.
public final static int
Reason code - target length parameter is not valid.
public final static int
Reason code - trigger message structure is not valid.
public final static int
Reason code - character trigger message structure is not valid.
public final static int
Reason code - value for trigger-point attribute is not valid.
public final static int
Reason code - value for trigger-depth attribute is not valid.
public final static int
Reason code - value for trigger-message priority attribute is not valid.
public final static int
Reason code - value for trigger-type attribute is not valid.
public final static int
Reason code - truncated message returned (processing completed).
public final static int
Reason code - truncated message returned (processing not completed).
public final static int
Reason code - returned by the Java MQQueueManager constructor when a required character-set conversion is not available. The conversion required is between the UCS-2 Unicode character set and the queue manager's character set. IBM-500 is used for the queue manager's character set if no specific value is available.
public final static int
Reason code - an unexpected error has occurred.
public final static int
Reason code - the unit of work has not started.
public final static int
Reason code - unknown alias base queue.
public final static int
Reason code - unknown default transmission queue.
public final static int
Reason code - unknown object name.
public final static int
Reason code - unknown object queue manager.
public final static int
Reason code - unknown remote queue manager.
public final static int
Reason code - one or more report options in the in message descriptor are not recognized.
public final static int
Reason code - unknown transmission queue.
public final static int
Reason code - cipher suite is unsupported.
public final static int
Reason code - an MQI call was issued, but the unit of work (TM/MP transaction) being used for the WebSphere MQ operation had been canceled.
public final static int
Reason code - enlistment in a global unit of work failed.
public final static int
Reason code - mixture of unit-of-work calls is not supported.
public final static int
Reason code - unit of work is not available for the queue manager to use.
public final static int
Reason code - wait interval in MQGMO not valid.
public final static int
Reason code - an MQPUT or MQPUT1 call was issued, but the message data contains an MQWIH structure that is not valid.
public final static int
Reason code - wrong version of MQGMO has been supplied.
public final static int
Reason code - wrong version of MQMD has been supplied.
public final static int
Reason code - WXP error.
public final static int
Reason code - transmission queue not local.
public final static int
Reason code - transmission queue not local.
public final static int
Reason code - transmission queue header structure is not valid.
public final static int
Reason code - XA wait has been canceled.
public final static int
Reason code - XA wait error.
public int
WebSphere MQ reason code describing the error.
public String getMessage();
Gets the message detail.
public static void logExclude(Integer avoidCode);
Adds an exception type to be kept out of the log.
public static void logInclude(Integer includeCode);
Allows an exception type to be put in the log.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzaw1362 |