Websphere MQ Everyplace

com.ibm.mqe
Interface MQeExceptionCodes

All Known Implementing Classes:
MQe, MQeException, MQeUdpipBasicAdapter

public interface MQeExceptionCodes

Holds all the codes used by the MQeException class.

The codes themselves all have symbolic names starting with the "Except_" prefix.

The codes themselves are retrieved using the MQeException.code() method.

See Also:
MQeException, MQeException.code()

Field Summary
static int Except_Active
          This exception is thrown to indicate an action failed because the required object is already active.
static int Except_AdapterException
          Exception thrown to indicate that a problem has occurred at the adapter layer of the communications stack.
static int Except_AdapterMissingRemoteAddress
          Exception thrown to indicate that an initiator for an adapter has without the required address for the responder.
static int Except_Admin_ActionNotSupported
          The action is not supported in the base class.
static int Except_Admin_InvalidField
          An unsupported field was specified in the MQeAdminMsg request.
static int Except_Admin_NotAdminMsg
          A message arrived on the administration queue that was not a descendant of MQeAdminMsg.
static int Except_AdminAction
          Exception thrown to indicate a problem with an adminstrative action.
static int Except_Authenticate
          The information provided to authenticate an action failed.
static int Except_BadRequest
          An encrypt/decrypt key has not been set, or some bad hexadecimal data was passed for conversion.
static int Except_BridgeListener
          Exception thrown to indicate a problem with the bridge listener.
static int Except_Chnl_Attributes
          WebSphere MQ Everyplace channel attribute mis-match.
static int Except_Chnl_ID
          The WebSphere MQ Everyplace channel is no longer available.
static int Except_Chnl_Limit
          The maximum number of channels has been exceeded.
static int Except_Chnl_Overrun
          An MQePeerChannel has received two replies.
static int Except_Closed
          A communications channel is closed.
static int Except_Con_AdapterRequired
          An adapter is required when a channel has been specified.
static int Except_Con_AliasAlreadyExists
          The connection alias already exists.
static int Except_Con_AlreadyExists
          The connection already Exists.
static int Except_Con_InvalidName
          The connection name does not conform to the naming standards.
static int Except_Connect_Failure
          Exception thrown to indicate that an attempt to establish a connection to a remote queue manager failed.
static int Except_ConnectonType
          Exception thrown to indicate an invalid JMX connection type.
static int Except_Cryptor
          Exception thrown to indicate a problem with a cryptor.
static int Except_Data
          This exception occurs when WebSphere MQ Everyplace detects a problem with the data.
static int Except_Duplicate
          An MQeFields object was being copied and a duplicate item was detected.
static int Except_JmxProperties
          The JMX properties are invalid.
static int Except_Listener
          Exception thrown to indicate a problem with the listener.
static int Except_MessageStore
          The default message store exception code.
static int Except_MiniCertReg_ActivateFailed
          The activate may fail for several reasons.
static int Except_MiniCertReg_BadPIN
          Thrown when the PIN is required for MiniCert Registry.
static int Except_MiniCertReg_NotOpen
          Thrown when the MiniCert Registry is required but not opened.
static int Except_NotActive
          This exception is thrown to indicate an action failed because some state change is required in the object before such a request can be completed.
static int Except_NotAllowed
          This occurs when WebSphere MQ Everyplace detects a problem with the request and the state of a resource.
static int Except_NotFound
          The object is not found.
static int Except_NotSupported
          This exception is thrown when an invalid method or operation is invoked for an object.
static int Except_PrivateReg_ActivateFailed
          The activate may fail for several reasons.
static int Except_PrivateReg_BadPIN
          A PIN is required for a Private registry.
static int Except_PrivateReg_NotOpen
          Thrown when the Private registry is unable to open.
static int Except_PublicReg_ActivateFailed
          The activate may fail for several reasons.
static int Except_PublicReg_InvalidAddress
          The address for the public registry is invalid.
static int Except_PublicReg_InvalidRequest
          The request type was not recognised.
static int Except_Q_Full
          The queue is full, as specified by the value set for MQeQueueAdminMsg.Queue_MaxQSize.
static int Except_Q_InvalidName
          The queue name does not conform to the naming standards.
static int Except_Q_InvalidPriority
          A queue’s default priority is outside the valid range.
static int Except_Q_MsgTooLarge
          The message about to be put to a queue exceeds the value set for MQeQueueAdminMsg.Queue_MaxMsgSize.
static int Except_Q_NoMatchingMsg
          On a getMessage there were no messages matching the filter.
static int Except_Q_TargetRegistryRequired
          The authenticator object indicates a registry is required for this queue, but none is set.
static int Except_QMgr_Activated
          The queue manager is being either restored or reactivated when it is still active.
static int Except_QMgr_AlreadyExists
          The queue manager already exists in the registry or in a connection definition.
static int Except_QMgr_InvalidQMgrName
          The queue manager name does not conform to the naming standards.
static int Except_QMgr_InvalidQName
          The queue manager name and queue name combination is invalid.
static int Except_QMgr_NotActive
          The queue manager is not in an active state to process this request.
static int Except_QMgr_NotBridgeEnabled
          The queue manager is not bridge enabled and therefore some actions may not be valid.
static int Except_QMgr_NotConfigured
          The queue manager’s registry cannot be correctly validated.
static int Except_QMgr_QDoesNotExist
          A queue, queue alias, or a store-and-forward queue definition does not exist for this queue manager/queue combination.
static int Except_QMgr_QExists
          A queue, queue alias, home-server queue, or a store-and-forward queue definition already exists for this queue manager/queue combination.
static int Except_QMgr_QNotEmpty
          An attempt has been made to delete a queue that still contains messages.
static int Except_QMgr_RegistryDataVersion
          A queue manager has been asked to start from a registry which it considers to be back-level.
static int Except_QMgr_UnknownQMgr
          The queue manager referenced has not been defined to this queue manager.
static int Except_QMgr_WrongQType
          A queue can only be created with a type of MQeQueue.Queue_Synchronous or MQeQueue.Queue_ASynchronous.
static int Except_Reg_AddFailed
          Creating a new registry entry has failed.
static int Except_Reg_AlreadyExists
          Either creating or renaming a registry entry the target name already exists.
static int Except_Reg_AlreadyOpen
          An attempt has been made to activate the registry a second time.
static int Except_Reg_CRTKeyDecFailed
          Decrypting data using the PrivateRegistry credentials has failed.
static int Except_Reg_CRTKeySignFailed
          Digitally signing (ISO9796) data using the PrivateRegistry credentials has failed.
static int Except_Reg_DeleteFailed
          Deleting a registry entry has failed.
static int Except_Reg_DeleteRegistryFailed
          Cleanup of the registry has failed.
static int Except_Reg_DoesNotExist
          A registry entry cannot be located.
static int Except_Reg_InvalidSession
          Either the registry session is not active or LocalRegType is not specified.
static int Except_Reg_ListFailed
          Listing registry entries has failed.
static int Except_Reg_NotDefined
          The registry type is null.
static int Except_Reg_NotSecure
          A secure registry is required but not available.
static int Except_Reg_NullName
          Rename of a registry entry has failed because one of the arguments is null.
static int Except_Reg_OpenFailed
          Unable to open the registry.
static int Except_Reg_ReadFailed
          Reading a registry entry has failed.
static int Except_Reg_RenameFailed
          Renaming a registry entry has failed.
static int Except_Reg_ResetPINFailed
          Resetting the PIN on the registry entry has failed.
static int Except_Reg_SearchFailed
          Searching registry entries has failed.
static int Except_Reg_UpdateFailed
          Updating a registry entry has failed.
static int Except_RemoteException
          Exception thrown to indicate that a problem has occured while performing remote operations.
static int Except_Rule
          The MQeQueueRules class can’t be loaded or a WebSphere MQ Everyplace rules class has determined the action should be disallowed.
static int Except_S_BadIntegrity
          The data digest sent as part of a message protected with either the MQeMAttribute or the MQeMTrustAttribute does not correspond to the data in the message.
static int Except_S_BadSubject
          The subject name encoded in a mini-certificate is not the same as the name of the certificate in the registry.
static int Except_S_CertificateExpired
          The mini-certificate has expired.
static int Except_S_Cipher
          The wrong cipher or key was used when decrypting data.
static int Except_S_InvalidAttribute
          There may be serveral reasons for this exception to be thrown.
static int Except_S_InvalidSignature
          The digital signature failed the ISO9796 verification.
static int Except_S_MiniCertNotAvailable
          The mini-certificate is not available.
static int Except_S_MissingSection
          A section is missing from the startup parameters for the mini-certificate server.
static int Except_S_NoPresetKeyAvailable
          A key has not been provided when putting or sending a message with the MQeMAttribute.
static int Except_S_RegistryNotAvailable
          A private or public registry is not available.
static int Except_Stopped
          A communications channel is not in the correct state.
static int Except_Syntax
          This exception is thrown when a WebSphere MQ Everyplace object is expecting some data to be in a particular format or style and it isn’t.
static int Except_TimeOut
          This exception is thrown when a WebSphere MQ Everyplace channel fails to connect after a timeout period.
static int Except_Transporter
          Exception thrown to indicate a problem caught in the transporter.
static int Except_TriggerTransmission
          Trigger transmission error, used to log an error as the trigger transmission thread does not throw exceptions.
static int Except_Trnsport_QMgr
          To indicate that the queue manager is not active when communications to another queue manager was attempted.
static int Except_Trnsport_Request
          Unknown WebSphere MQ Everyplace command request received.
static int Except_Type
          The class object passed to a WebSphere MQ Everyplace method is not of the correct type.
static int Except_UdpipAdapterStateException
          Exception thrown to indicate that the MQeUdpipBasicAdapter is in the incorrect state for the method called.
static int Except_UdpipAdapterTimeOut
          Exception thrown to indicate that the MQeUdpipBasicAdapter has timed out.
static int Except_UdpipAdapterUnableToConfirmSuccess
          Exception thrown to indicate that although the message has been received and the initiator has received the response we have been unable to confirm success.
static int Except_UnCoded
          The code used to indicate that no error has occurred.
static int Except_Uncontactable_DontTransmit
          This exception is thrown to indicate that the destination is uncontactable.
 

Field Detail

Except_UnCoded

public static final int Except_UnCoded

The code used to indicate that no error has occurred.

Reported using the com.ibm.mqe.MQeException class.

Often used to initialise an error variable before any error has been detected. Should never be the code inside an MQeException instance.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
0

Except_NotSupported

public static final int Except_NotSupported

This exception is thrown when an invalid method or operation is invoked for an object. This exception can also occur if an unrecognised error is thrown by the proxy when using the MQeWESAuthenticationAdapter.

User action: Determine why you are calling an inappropriate method for the class object. For example, a putMessage is not supported for MQeHomeServerQueue, MQeRemoteQueue and MQeStoreAndForwardQueue objects and will result in this exception being thrown. Correct the problem and try again.

Reported using the com.ibm.mqe.MQeException class.

Normally indicates that an action has been attempted on an object which cannot perform that action.
For example, trying to get a message from an asynchronous remote queue is not valid, because asynchronous gets are not supported.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
2

Except_Syntax

public static final int Except_Syntax

This exception is thrown when a WebSphere MQ Everyplace object is expecting some data to be in a particular format or style and it isn’t.

User action: The text accompanying the exception should provide a clue as to the nature of the problem. For example, an WebSphere MQ Everyplace adapter requires a correct specification that includes at least one colon (:) in the string - Network:127.0.0.1:8080

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
3

Except_Type

public static final int Except_Type

The class object passed to a WebSphere MQ Everyplace method is not of the correct type.

User action: The text accompanying the exception should provide additional information to resolve this problem.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
4

Except_NotFound

public static final int Except_NotFound

The object is not found. For example, it may be a message, queue manager, field, or connection definition. This exception can also occur if the requested resource could not be located by the proxy when using the MQeWESAuthenticationAdapter.

This exception is commonly returned when a field within the com.ibm.mqe.MQeFields class is manipulated, but that field does not exist.

User action: The additional text accompanying this exception should enable you to understand this condition. Correct the problem and try again.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), MQeFields, Constant Field Values
Value:
6

Except_Data

public static final int Except_Data

This exception occurs when WebSphere MQ Everyplace detects a problem with the data. It may be to do with encryption/decryption or some corruption.

User action: The text accompanying this exception should be sufficient to determine why this problem was found.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
7

Except_BadRequest

public static final int Except_BadRequest

An encrypt/decrypt key has not been set, or some bad hexadecimal data was passed for conversion.

User action: The associated text will be should provide guidance.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
8

Except_Stopped

public static final int Except_Stopped

A communications channel is not in the correct state. This need not be a problem since WebSphere MQ Everyplace should handle this condition internally.

User action: If you are writing rules class extensions or developing a WebSphere MQ Everyplace peer-to-peer solution then you may need to handle this exception.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
9

Except_Closed

public static final int Except_Closed

A communications channel is closed.

User action: This need not be a problem since WebSphere MQ Everyplace should handle this condition internally. If you are developing a WebSphere MQ Everyplace peer-to-peer solution you may need to handle this exception.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
10

Except_Duplicate

public static final int Except_Duplicate

An MQeFields object was being copied and a duplicate item was detected.

User action: Consider setting the replace parameter to true on the MQeFields.copy method.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
11

Except_NotAllowed

public static final int Except_NotAllowed

This occurs when WebSphere MQ Everyplace detects a problem with the request and the state of a resource.

Often indicates that items which are settable only once cannot be re-set. For example, a key on a security attribute.

User action: The text accompanying this exception should be sufficient to determine why this problem was found.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException.code(), MQeException, Constant Field Values
Value:
12

Except_Rule

public static final int Except_Rule

The MQeQueueRules class can’t be loaded or a WebSphere MQ Everyplace rules class has determined the action should be disallowed.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
13

Except_TimeOut

public static final int Except_TimeOut

This exception is thrown when a WebSphere MQ Everyplace channel fails to connect after a timeout period.

User action: Ensure the remote queue manager is contactable. Networking problems may be attributable to this condition.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
14

Except_NotActive

public static final int Except_NotActive

This exception is thrown to indicate an action failed because some state change is required in the object before such a request can be completed.

For example, a request to get a digital certificate without first establishing a communications channel between the queue manager and the certificate issuance service might result in this exception code being generated.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
15

Except_Active

public static final int Except_Active

This exception is thrown to indicate an action failed because the required object is already active.

For example, a request to activate a queue manager when it is already active.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
16

Except_Chnl_Attributes

public static final int Except_Chnl_Attributes

WebSphere MQ Everyplace channel attribute mis-match.

User action: The text accompanying this exception should be sufficient to determine why this problem occurred.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
20

Except_Chnl_Limit

public static final int Except_Chnl_Limit

The maximum number of channels has been exceeded.

User action: You may consider increasing the maximum number of channels by adjusting the MaxChannels setting in the queue managers startup ini file.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
23

Except_Chnl_ID

public static final int Except_Chnl_ID

The WebSphere MQ Everyplace channel is no longer available.

User action: Ensure that the remote queue manager is contactable. Determine whether the remote queue manager has closed this channel.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
24

Except_Chnl_Overrun

public static final int Except_Chnl_Overrun

An MQePeerChannel has received two replies.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
25

Except_Trnsport_QMgr

public static final int Except_Trnsport_QMgr

To indicate that the queue manager is not active when communications to another queue manager was attempted.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
40

Except_Trnsport_Request

public static final int Except_Trnsport_Request

Unknown WebSphere MQ Everyplace command request received.

User action: Contact your local IBM support representative.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
41

Except_QMgr_NotActive

public static final int Except_QMgr_NotActive

The queue manager is not in an active state to process this request.

User action: The MQeQueueManager.activate method is used to start a queue manager, and MQeQueueManager.close method is used to stop the queue manager. Restart the queue manager and repeat your request.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
100

Except_QMgr_InvalidQMgrName

public static final int Except_QMgr_InvalidQMgrName

The queue manager name does not conform to the naming standards.

User action: The queue manager name is an ascii string of at least 1 character long and in the range 21 to 127. The characters can be any of the following:

     – Uppercase A-Z
     – Lowercase a-z
     – Numerics 0-9 Period (.)
     – Underscore (_)
     – Percent sign (%)
  The first and last character must not be a period (.)
 

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
101

Except_QMgr_Activated

public static final int Except_QMgr_Activated

The queue manager is being either restored or reactivated when it is still active. This is not allowed.

User action: Stop the queue manager using the MQeQueueManager.close method before attempting to restore or activate it.

Returned using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
102

Except_QMgr_AlreadyExists

public static final int Except_QMgr_AlreadyExists

The queue manager already exists in the registry or in a connection definition.

User action: Choose a new queue manager name.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
103

Except_QMgr_InvalidQName

public static final int Except_QMgr_InvalidQName

The queue manager name and queue name combination is invalid.

User action: Check that the name is not null or zero length.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
104

Except_QMgr_QExists

public static final int Except_QMgr_QExists

A queue, queue alias, home-server queue, or a store-and-forward queue definition already exists for this queue manager/queue combination.

User action: Only one homeserver-queue or one store-and-forward queue definition is allowed to a given destination.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
105

Except_QMgr_UnknownQMgr

public static final int Except_QMgr_UnknownQMgr

The queue manager referenced has not been defined to this queue manager.

User action: Create a definition to the remote queue manager.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
106

Except_QMgr_QNotEmpty

public static final int Except_QMgr_QNotEmpty

An attempt has been made to delete a queue that still contains messages.

User action: Determine if you need to empty this queue before attempting to delete it. This may be an asynchronous queue which has not been able to transfer its messages to a remote queue manager.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
107

Except_QMgr_QDoesNotExist

public static final int Except_QMgr_QDoesNotExist

A queue, queue alias, or a store-and-forward queue definition does not exist for this queue manager/queue combination.

User action: Create the queue, or queue alias, or add a queue manager to a store-and-forward queue.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
108

Except_QMgr_RegistryDataVersion

public static final int Except_QMgr_RegistryDataVersion

A queue manager has been asked to start from a registry which it considers to be back-level. The registry requires migration before the queue mager can be started using this level of code.

See Also:
Constant Field Values

Except_QMgr_WrongQType

public static final int Except_QMgr_WrongQType

A queue can only be created with a type of MQeQueue.Queue_Synchronous or MQeQueue.Queue_ASynchronous. The type specified is not recognised.

User action: Specify a correct value for the queue type.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
110

Except_QMgr_NotConfigured

public static final int Except_QMgr_NotConfigured

The queue manager’s registry cannot be correctly validated.

User action: Determine if the registry subdirectory and files are in the correct location as specified in the ini file.

Queue managers must be configured using the com.ibm.mqe.MQeQueueManagerConfigure class before they can be used.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), MQeQueueManagerConfigure, Constant Field Values
Value:
113

Except_QMgr_NotBridgeEnabled

public static final int Except_QMgr_NotBridgeEnabled

The queue manager is not bridge enabled and therefore some actions may not be valid.

User action: Check your classpath contains the necessary WebSphere MQ Java classes.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
116

Except_Q_NoMatchingMsg

public static final int Except_Q_NoMatchingMsg

On a getMessage there were no messages matching the filter.

User action: Check your filter is correctly specified. Check for messages in the queues’ message store.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
121

Except_Q_InvalidPriority

public static final int Except_Q_InvalidPriority

A queue’s default priority is outside the valid range.

User action: Determine if your are attempting to set a queues’ priority to a value outside the accepted range of 0-9.

The field MQe.Msg_Priority is the field within the message holding the priority of the message.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), MQe.Msg_Priority, Constant Field Values
Value:
124

Except_Q_Full

public static final int Except_Q_Full

The queue is full, as specified by the value set for MQeQueueAdminMsg.Queue_MaxQSize.

User action: Determine if the queue size is sufficient for your solution. You may need to handle this exception.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
125

Except_Q_MsgTooLarge

public static final int Except_Q_MsgTooLarge

The message about to be put to a queue exceeds the value set for MQeQueueAdminMsg.Queue_MaxMsgSize.

User action: Determine if the max message size for this queue is sufficient for your solution. You may need to handle this exception.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
126

Except_Q_InvalidName

public static final int Except_Q_InvalidName

The queue name does not conform to the naming standards.

User action: The queue name is an ascii string of at least 1 character long and in the range 21 to127. The characters can be any of the following:

      – Uppercase A-Z
      – Lowercase a-z Numerics 0-9
      – Period (.)
      – Underscore (_)
      – Percent sign (%)
 The first and last character must not be a period (.)
 

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
129

Except_Q_TargetRegistryRequired

public static final int Except_Q_TargetRegistryRequired

The authenticator object indicates a registry is required for this queue, but none is set.

User action: Ensure that the queue registry characteristics match those specified in the authenticator object.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
130

Except_Uncontactable_DontTransmit

public static final int Except_Uncontactable_DontTransmit

This exception is thrown to indicate that the destination is uncontactable. Hence the transmission is not possible.

Reported using the com.ibm.mqe.MQeException class

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
180

Except_Connect_Failure

public static final int Except_Connect_Failure

Exception thrown to indicate that an attempt to establish a connection to a remote queue manager failed.

Reported using the com.ibm.mqe.MQeException class.

This may be the result of:

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
212

Except_Con_AlreadyExists

public static final int Except_Con_AlreadyExists

The connection already Exists.

User action: Choose a diiferent connection name.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
230

Except_Con_AliasAlreadyExists

public static final int Except_Con_AliasAlreadyExists

The connection alias already exists.

Note: This constant has been deprecated and will not be used in future releases WebSphere MQ Everyplace.

User action: This connection alias is defined already, choose a new alias name. You may need to handle this exception.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
231

Except_Con_AdapterRequired

public static final int Except_Con_AdapterRequired

An adapter is required when a channel has been specified.

User action: Specify an adapter to use with the channel.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
232

Except_Con_InvalidName

public static final int Except_Con_InvalidName

The connection name does not conform to the naming standards.

User action: The connection name is an ascii string of at least 1 character long with a value between 32 and 127 inclusive. The characters can be any of the following:

      – Uppercase A-Z
      – Lowercase a-z
      – Numerics 0-9
      – Period (.)
      – Underscore (_)
      – Percent sign (%)
 The first and last character must not be a period (.)
 

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
233

Except_Reg_NullName

public static final int Except_Reg_NullName

Rename of a registry entry has failed because one of the arguments is null.

User action: Determine why the argument is null and correct it.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
301

Except_Reg_AlreadyExists

public static final int Except_Reg_AlreadyExists

Either creating or renaming a registry entry the target name already exists.

User action: Choose a new target name.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
302

Except_Reg_DoesNotExist

public static final int Except_Reg_DoesNotExist

A registry entry cannot be located.

User action: Determine why the entry does not exist.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
303

Except_Reg_OpenFailed

public static final int Except_Reg_OpenFailed

Unable to open the registry.

User action: The accompanying text to this exception gives more details. Check that the file and correct permissions exist.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
304

Except_Reg_InvalidSession

public static final int Except_Reg_InvalidSession

Either the registry session is not active or LocalRegType is not specified.

User action: Check that the LocalRegType entry exists in the [Registry ] section of the queue manager startup ini file.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
305

Except_Reg_NotDefined

public static final int Except_Reg_NotDefined

The registry type is null.

User action: The registry type may be QueueManager, Queue or RemoteQMgr.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
306

Except_Reg_AddFailed

public static final int Except_Reg_AddFailed

Creating a new registry entry has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
309

Except_Reg_DeleteFailed

public static final int Except_Reg_DeleteFailed

Deleting a registry entry has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
310

Except_Reg_ReadFailed

public static final int Except_Reg_ReadFailed

Reading a registry entry has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
311

Except_Reg_UpdateFailed

public static final int Except_Reg_UpdateFailed

Updating a registry entry has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
312

Except_Reg_ListFailed

public static final int Except_Reg_ListFailed

Listing registry entries has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
313

Except_Reg_SearchFailed

public static final int Except_Reg_SearchFailed

Searching registry entries has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
314

Except_Reg_RenameFailed

public static final int Except_Reg_RenameFailed

Renaming a registry entry has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
315

Except_Reg_ResetPINFailed

public static final int Except_Reg_ResetPINFailed

Resetting the PIN on the registry entry has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
316

Except_Reg_CRTKeyDecFailed

public static final int Except_Reg_CRTKeyDecFailed

Decrypting data using the PrivateRegistry credentials has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
317

Except_Reg_CRTKeySignFailed

public static final int Except_Reg_CRTKeySignFailed

Digitally signing (ISO9796) data using the PrivateRegistry credentials has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
318

Except_Reg_DeleteRegistryFailed

public static final int Except_Reg_DeleteRegistryFailed

Cleanup of the registry has failed.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
319

Except_Reg_AlreadyOpen

public static final int Except_Reg_AlreadyOpen

An attempt has been made to activate the registry a second time.

User action: The registry is already open. Determine why a second attempt is being made.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
320

Except_Reg_NotSecure

public static final int Except_Reg_NotSecure

A secure registry is required but not available.

User action: Check to see why the registry is not secure.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
321

Except_PrivateReg_BadPIN

public static final int Except_PrivateReg_BadPIN

A PIN is required for a Private registry.

User action: Supply a valid PIN.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
350

Except_PrivateReg_ActivateFailed

public static final int Except_PrivateReg_ActivateFailed

The activate may fail for several reasons.

       – A keyRingPassword was not supplied
       – A certificate request failed
       – A failure in the registration process
 

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
351

Except_PrivateReg_NotOpen

public static final int Except_PrivateReg_NotOpen

Thrown when the Private registry is unable to open.

User action: Provide the proper credentials to open the registry and then activate it.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
352

Except_MiniCertReg_BadPIN

public static final int Except_MiniCertReg_BadPIN

Thrown when the PIN is required for MiniCert Registry.

User action: Supply a valid PIN.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
360

Except_MiniCertReg_ActivateFailed

public static final int Except_MiniCertReg_ActivateFailed

The activate may fail for several reasons.

       – A keyRingPassword was not supplied
       – A certificate request failed
       – A failure in the registration process
 

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
361

Except_MiniCertReg_NotOpen

public static final int Except_MiniCertReg_NotOpen

Thrown when the MiniCert Registry is required but not opened.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
362

Except_PublicReg_ActivateFailed

public static final int Except_PublicReg_ActivateFailed

The activate may fail for several reasons. The text accompanying the exception gives more information about the reason for failure.

User action: Resolve the problem and try again.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
370

Except_PublicReg_InvalidRequest

public static final int Except_PublicReg_InvalidRequest

The request type was not recognised.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
371

Except_Admin_NotAdminMsg

public static final int Except_Admin_NotAdminMsg

A message arrived on the administration queue that was not a descendant of MQeAdminMsg.

User action: This need not be a problem since WebSphere MQ Everyplace should handle this condition internally.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
400

Except_Admin_ActionNotSupported

public static final int Except_Admin_ActionNotSupported

The action is not supported in the base class. Sub-classes over-ride these blocked methods.

User action: This need not be a problem since WebSphere MQ Everyplace should handle this condition internally.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
401

Except_Admin_InvalidField

public static final int Except_Admin_InvalidField

An unsupported field was specified in the MQeAdminMsg request.

User action: The supported MQeAdminMsg fields are available through the characteristics method.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
402

Except_Authenticate

public static final int Except_Authenticate

The information provided to authenticate an action failed.

User action: Ensure that the credentials supplied are valid and repeat the request.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
500

Except_S_Cipher

public static final int Except_S_Cipher

The wrong cipher or key was used when decrypting data.

User action: Ensure that the correct cipher and key are specified.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
501

Except_S_InvalidSignature

public static final int Except_S_InvalidSignature
The digital signature failed the ISO9796 verification. If the text accompanying the exception starts with ?validating data ...?, this happened when checking the signature on a message sent with the MQeMTrustAttribute. If the text accompanying the exception starts with ?MiniCert = ?the mini-certificate named in the text was invalid.

User action: Report the problem to your security administrator.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
502

Except_S_CertificateExpired

public static final int Except_S_CertificateExpired

The mini-certificate has expired.

User action: Report the problem to your security administrator and renew the certificate.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
503

Except_S_InvalidAttribute

public static final int Except_S_InvalidAttribute

There may be serveral reasons for this exception to be thrown.

User action: The accompanying text to this exception gives more details.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
504

Except_S_MiniCertNotAvailable

public static final int Except_S_MiniCertNotAvailable

The mini-certificate is not available. The text accompanying the exception specifies which certificate could not be found.

User action: If this happened putting or getting a message with the MQeMTrustAttribute, ensure that the sender and receiver mini-certificates are available in the appropriate public registries. If this happened with the MQeWTLSCertAuthenticator, one of the participating queue managers or queues may not have obtained their credentials correctly.

Report the problem to your security administrator.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
505

Except_S_RegistryNotAvailable

public static final int Except_S_RegistryNotAvailable

A private or public registry is not available.

User action: If this happened putting or getting a message with the MQeMTrustAttribute, ensure that you give the attribute the correct private and public registries. If this happened with the MQeWTLSCertAuthenticator, one of the participating queue managers or queues has not been set up correctly.

Report the problem to your security administrator.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
506

Except_S_BadIntegrity

public static final int Except_S_BadIntegrity

The data digest sent as part of a message protected with either the MQeMAttribute or the MQeMTrustAttribute does not correspond to the data in the message. The message may have been tampered with.

User action: Report the problem to your security administrator.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
507

Except_S_NoPresetKeyAvailable

public static final int Except_S_NoPresetKeyAvailable

A key has not been provided when putting or sending a message with the MQeMAttribute.

User action: Provide the attribute with a key.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
508

Except_S_MissingSection

public static final int Except_S_MissingSection

A section is missing from the startup parameters for the mini-certificate server.

User action: Ensure that all the sections are included in the startup parameters.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
509

Except_S_BadSubject

public static final int Except_S_BadSubject

The subject name encoded in a mini-certificate is not the same as the name of the certificate in the registry. Someone may have been tampering with the certificate.

User action: Report the problem to your security administrator.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
510

Except_RemoteException

public static final int Except_RemoteException

Exception thrown to indicate that a problem has occured while performing remote operations.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
600

Except_AdapterException

public static final int Except_AdapterException

Exception thrown to indicate that a problem has occurred at the adapter layer of the communications stack.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
700

Except_UdpipAdapterStateException

public static final int Except_UdpipAdapterStateException

Exception thrown to indicate that the MQeUdpipBasicAdapter is in the incorrect state for the method called.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
701

Except_UdpipAdapterTimeOut

public static final int Except_UdpipAdapterTimeOut

Exception thrown to indicate that the MQeUdpipBasicAdapter has timed out.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
702

Except_AdapterMissingRemoteAddress

public static final int Except_AdapterMissingRemoteAddress

Exception thrown to indicate that an initiator for an adapter has without the required address for the responder.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
703

Except_UdpipAdapterUnableToConfirmSuccess

public static final int Except_UdpipAdapterUnableToConfirmSuccess

Exception thrown to indicate that although the message has been received and the initiator has received the response we have been unable to confirm success. The initiator keeps requesting the close of session packet. We therefore have to assume the initiator will report failure.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
704

Except_Listener

public static final int Except_Listener

Exception thrown to indicate a problem with the listener.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
705

Except_AdminAction

public static final int Except_AdminAction

Exception thrown to indicate a problem with an adminstrative action.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
706

Except_ConnectonType

public static final int Except_ConnectonType

Exception thrown to indicate an invalid JMX connection type.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
707

Except_Cryptor

public static final int Except_Cryptor

Exception thrown to indicate a problem with a cryptor.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
708

Except_BridgeListener

public static final int Except_BridgeListener

Exception thrown to indicate a problem with the bridge listener.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
709

Except_Transporter

public static final int Except_Transporter

Exception thrown to indicate a problem caught in the transporter.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
710

Except_PublicReg_InvalidAddress

public static final int Except_PublicReg_InvalidAddress

The address for the public registry is invalid.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
711

Except_JmxProperties

public static final int Except_JmxProperties

The JMX properties are invalid.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
712

Except_MessageStore

public static final int Except_MessageStore

The default message store exception code.

Reported using the com.ibm.mqe.MQeException class.

See Also:
MQeException, MQeException.code(), Constant Field Values
Value:
713

Except_TriggerTransmission

public static final int Except_TriggerTransmission

Trigger transmission error, used to log an error as the trigger transmission thread does not throw exceptions.

See Also:
Constant Field Values

Websphere MQ Everyplace