Websphere MQ Everyplace

com.ibm.mqe.mqbridge
Interface MQeBridgeExceptionCodes


public interface MQeBridgeExceptionCodes

An interface which defines symbolic names for exception codes which can be thrown by MQe bridge code.


Field Summary
static int Except_Adapter_Not_Found
          
static int Except_Bridge_Internal_Error
          An unexpected error occurred.
static int Except_Bridge_Not_On_PreLoad_List
          You tried to access a bridge resource and the MQbridges object is not loaded.
static int Except_Bridges_Already_Loaded
          Two MQeBridges objects were attempted to be instantiated in one JVM.
static int Except_Characteristic_Not_Found_In_Input
          A resource in the WebSphere MQ-bridge was trying to find a specific characteristic in an MQeFields object but it didn’t exist in the MQeFields object.
static int Except_Characteristic_Read_Only_Violation
          You tried to set a characteristic that cannot be set.
static int Except_Characteristic_Unknown
          You tried to query a characteristic by sending an Inquire or InquireAll administration message to the bridge.
static int Except_Class_Not_MQeRules
          A rules class was invoked that does not inherit from MQeRules.
static int Except_Client_Con_Not_Available
          An attempt was made to access a Client Connection object that does not exist.
static int Except_Could_Not_Delete_Myself
          An unexpected error occurred.
static int Except_Delete_Children_First
          The user tried to delete an administered object in the WebSphere MQ-bridgeparent-child hierarchy, without having first deleted its children.
static int Except_Exit_Class_Init_Error
          A user exit defined as part of your Client Connection object could not be initialised.
static int Except_Field_Type_Mismatch
          
static int Except_Generic_MQ_Error
          When communicating with the WebSphere MQ Everyplace server, the WebSphere MQ classes for Java returned an error code.
static int Except_Invalid_Characteristic
          The user is probably trying to set the value of a characteristic via a update admin message, or a create admin message.
static int Except_Invalid_Reg_Type
          The registry did not understand the registry type used.
static int Except_Invalid_Registry_Entry_Name
          The WebSphere MQ-bridge was attempting to build the registry entry name of one of its objects, probably based off input from the user, through an administration message.
static int Except_Invalid_Return_Type
          
static int Except_Invalid_Run_State
          An unexpected error occurred.
static int Except_InvalidName
          A WebSphere MQ-bridge name contained invalid characters or is too long or too short.
static int Except_Listener_State_Error
          An error occurred while the listener tried to read or write state logging information.
static int Except_Lost_MQ_Connection
          The MQeMQAdapter could not acquire a valid handle to WebSphere MQ.
static int Except_Lost_MQ_Q_Handle
          A reference to an open WebSphere MQ queue was suddenly found to be invalid.
static int Except_Message_Undelivered
          The listener was told (by a rule) to stop as a result of a message being undelivered.
static int Except_MQ_Q_InvalidName
          A WebSphere MQ queue field contained invalid characters or is too long or too short.
static int Except_MQ_QMgr_InvalidName
          A WebSphere MQ queue manger field contained invalid characters or is too long or too short.
static int Except_MQ_QMgr_Unavailable
          When communicating with the WebSphere MQ server, the Java Client returned an error code.
static int Except_No_Transformer_Found
          The name of the default transformer could not be found.
static int Except_Not_Transmission_Queue
          The MQBridge listener was told to listen for messages on a WebSphere MQ queue that was not a transmission queue.
static int Except_Object_Not_Started
          Thrown by a client connection object if it was asked to allocate a connection when its run state was ’stopped’.
static int Except_Parent_Not_Running
          An unexpected error occurred.
static int Except_Registry_Update_Failed
          An administration message has been sent to the WebSphere MQ-bridge in order to create or update the value of a characteristic of one specific bridge resource.
static int Except_Resource_Not_Found
          An administration message was directed at a WebSphere MQ-bridge resource that does not exist.
static int Except_ShutDown_Children_First
          An unexpected error occurred.
static int Except_Transformation_Error
          A problem occurred while trying to transform a WebSphere MQ message into an WebSphere MQ Everyplace message (or while trying to transform an WebSphere MQ Everyplace message into a WebSphere MQ message).
 

Field Detail

Except_Generic_MQ_Error

public static final int Except_Generic_MQ_Error

When communicating with the WebSphere MQ Everyplace server, the WebSphere MQ classes for Java returned an error code. The WebSphere MQ reason code is included in the exception.

User action : Refer to the WebSphere MQ Application Programming Reference for details on how to interpret this error.

See Also:
Constant Field Values
Value:
600

Except_MQ_QMgr_Unavailable

public static final int Except_MQ_QMgr_Unavailable

When communicating with the WebSphere MQ server, the Java Client returned an error code. The error returned seems to suggest that the WebSphere MQ queue manger is unavailable. The WebSphere MQ reason code is included in the exception.

User action : Refer to the WebSphere MQ Application Programming Reference for details on how to interpret this error.

See Also:
Constant Field Values
Value:
601

Except_Characteristic_Unknown

public static final int Except_Characteristic_Unknown

You tried to query a characteristic by sending an Inquire or InquireAll administration message to the bridge. The characteristic you asked for is not known to the object you directed the Inquire message at.

User action : Amend the application that generates the administration message so that it enquires only valid characteristics.

See Also:
Constant Field Values
Value:
602

Except_Characteristic_Read_Only_Violation

public static final int Except_Characteristic_Read_Only_Violation

You tried to set a characteristic that cannot be set. For example, the name of the object cannot be changed. Neither can it’s run state, without using a start/stop administration message.

User action : Amend the application that sets the characteristic so that it does not try to set any read-only attributes.

See Also:
Constant Field Values
Value:
603

Except_Bridge_Not_On_PreLoad_List

public static final int Except_Bridge_Not_On_PreLoad_List

You tried to access a bridge resource and the MQbridges object is not loaded.

User action : You must set up the MQBridge class alias and restart the server before you can use a bridge resource on the WebSphere MQ Everyplace server. The server program must also load and activate the bridge.

See Also:
Constant Field Values
Value:
604

Except_Registry_Update_Failed

public static final int Except_Registry_Update_Failed

An administration message has been sent to the WebSphere MQ-bridge in order to create or update the value of a characteristic of one specific bridge resource. The bridge tried to store the new updated value in the registry but the store operation failed.

User action : Investigate why the registry could not store the information and retry the operation.

See Also:
Constant Field Values
Value:
605

Except_Characteristic_Not_Found_In_Input

public static final int Except_Characteristic_Not_Found_In_Input

A resource in the WebSphere MQ-bridge was trying to find a specific characteristic in an MQeFields object but it didn’t exist in the MQeFields object. This could occur if some of the registry entry for this WebSphere MQ-bridge resource has been removed.

User action : Only attempt to access valid characteristics from MQeFields objects.

See Also:
Constant Field Values
Value:
606

Except_Field_Type_Mismatch

public static final int Except_Field_Type_Mismatch

See Also:
Constant Field Values
Value:
607

Except_Invalid_Registry_Entry_Name

public static final int Except_Invalid_Registry_Entry_Name

The WebSphere MQ-bridge was attempting to build the registry entry name of one of its objects, probably based off input from the user, through an administration message. The name does not conform to the rules set by the registry.

User action : Check if the characters in the registry entry name which were invalid, or the name was too long. Amend and try again.

See Also:
Constant Field Values
Value:
608

Except_Not_Transmission_Queue

public static final int Except_Not_Transmission_Queue

The MQBridge listener was told to listen for messages on a WebSphere MQ queue that was not a transmission queue.

User action : Change the listener’s configuration so that it gets messages from a transmission queue, or change the queue definition on the server so that its usage is as a transmission queue.

See Also:
Constant Field Values
Value:
609

Except_Bridge_Internal_Error

public static final int Except_Bridge_Internal_Error

An unexpected error occurred.

User action : Contact your local support representative.

See Also:
Constant Field Values
Value:
610

Except_MQ_QMgr_InvalidName

public static final int Except_MQ_QMgr_InvalidName

A WebSphere MQ queue manger field contained invalid characters or is too long or too short.

User action : Ensure that the name of the WebSphere MQ queue manager you are trying to access matches the value that is configured in WebSphere MQ Everyplace.

See Also:
Constant Field Values
Value:
611

Except_MQ_Q_InvalidName

public static final int Except_MQ_Q_InvalidName

A WebSphere MQ queue field contained invalid characters or is too long or too short.

User action : Ensure that the name of the WebSphere MQ queue you are trying to access matches the value that is configured in WebSphere MQ Everyplace.

See Also:
Constant Field Values
Value:
612

Except_Lost_MQ_Q_Handle

public static final int Except_Lost_MQ_Q_Handle

A reference to an open WebSphere MQ queue was suddenly found to be invalid.

User action : Determine how and why the connection to WebSphere MQ failed. Try to restart the MQBridge object.

See Also:
Constant Field Values
Value:
613

Except_Resource_Not_Found

public static final int Except_Resource_Not_Found

An administration message was directed at a WebSphere MQ-bridge resource that does not exist. (For example sending a stop message to a listener that does not exist).

User action : Check that all the "name" fields of the administration message to make sure the objects all exist.

See Also:
Constant Field Values
Value:
614

Except_Transformation_Error

public static final int Except_Transformation_Error

A problem occurred while trying to transform a WebSphere MQ message into an WebSphere MQ Everyplace message (or while trying to transform an WebSphere MQ Everyplace message into a WebSphere MQ message).

User action : If you’re using a custom transformer, check your application logic so that it correctly transforms messages.

See Also:
Constant Field Values
Value:
615

Except_Parent_Not_Running

public static final int Except_Parent_Not_Running

An unexpected error occurred.

User action : Contact your local support representative.

See Also:
Constant Field Values
Value:
616

Except_Invalid_Run_State

public static final int Except_Invalid_Run_State

An unexpected error occurred.

User action : Contact your local support representative.

See Also:
Constant Field Values
Value:
617

Except_Could_Not_Delete_Myself

public static final int Except_Could_Not_Delete_Myself

An unexpected error occurred.

User action : Contact your local support representative.

See Also:
Constant Field Values
Value:
618

Except_Listener_State_Error

public static final int Except_Listener_State_Error

An error occurred while the listener tried to read or write state logging information.

User action : Verify that the listener state store class is correct, and that the state file is read/writable (in the case of MQeDiskFieldsAdapter) or the sync queue is accessible and with put and get enabled (in the case of MQeMQAdapter).

See Also:
Constant Field Values
Value:
619

Except_Invalid_Characteristic

public static final int Except_Invalid_Characteristic

The user is probably trying to set the value of a characteristic via a update admin message, or a create admin message. For instance, the value is too high or too low.

User action : Check the range of values a particular characteristic can take, amend your request and try again.

See Also:
Constant Field Values
Value:
620

Except_Delete_Children_First

public static final int Except_Delete_Children_First

The user tried to delete an administered object in the WebSphere MQ-bridgeparent-child hierarchy, without having first deleted its children. This also means that the "effect-children" flag has not been set, so the delete event does not propogate to the administered object’s children first. The children of the administered object must be deleted before the administered object can be deleted.

User action : Either delete all the administered object’s children individually, or use the "effect-children" to cause them all to be deleted in the same action as deleting this administered object.

See Also:
Constant Field Values
Value:
621

Except_InvalidName

public static final int Except_InvalidName

A WebSphere MQ-bridge name contained invalid characters or is too long or too short.

User action : Choose a bridge name that is shorter than 40 characters, and contains only alphanumeric characters.

See Also:
Constant Field Values
Value:
622

Except_Class_Not_MQeRules

public static final int Except_Class_Not_MQeRules

A rules class was invoked that does not inherit from MQeRules.

User action : All rules must inherit from com.ibm.MQe.MQeRules. In other words, they must implement the Permit() method. Ensure that the rules classes specified in the configuration information is valid. See elsewhere in the documentation for a complete list of rule classes used by the WebSphere MQ-bridge, and where they are used.

See Also:
Constant Field Values
Value:
623

Except_Adapter_Not_Found

public static final int Except_Adapter_Not_Found

See Also:
Constant Field Values
Value:
624

Except_Object_Not_Started

public static final int Except_Object_Not_Started

Thrown by a client connection object if it was asked to allocate a connection when its run state was ’stopped’.

User action : Ensure that the client connection object is started before trying to perform a WebSphere MQ -bound operation.

See Also:
Constant Field Values
Value:
625

Except_ShutDown_Children_First

public static final int Except_ShutDown_Children_First

An unexpected error occurred.

User action : Contact your local support representative.

See Also:
Constant Field Values
Value:
626

Except_Invalid_Reg_Type

public static final int Except_Invalid_Reg_Type

The registry did not understand the registry type used.

User action : The WebSphere MQ Everyplace registry uses the concept of a "registry type" to indicate which sort of registry record it is currently dealing with. Entries of the same type are stored in the same file directory. Ensure that this registry type is valid.

See Also:
Constant Field Values
Value:
627

Except_Invalid_Return_Type

public static final int Except_Invalid_Return_Type

See Also:
Constant Field Values
Value:
628

Except_Message_Undelivered

public static final int Except_Message_Undelivered

The listener was told (by a rule) to stop as a result of a message being undelivered. Alternatively, the listener can pass this MQeException onto the Undelivered Message Rules class after an unspecified error occurred during the put.

User action : Amend the Undelivered Message Rule if you do not want this exception to be thrown.

See Also:
Constant Field Values
Value:
629

Except_Bridges_Already_Loaded

public static final int Except_Bridges_Already_Loaded

Two MQeBridges objects were attempted to be instantiated in one JVM. This is not allowed.

User action : Ensure that your configuration does not allow this to happen.

See Also:
Constant Field Values
Value:
630

Except_No_Transformer_Found

public static final int Except_No_Transformer_Found

The name of the default transformer could not be found.

User action : Set the classname of the transformer you wish to use inside the MQeMQBridgeQueue definition. In addtion, a default transformer should be set inside the bridge’s configuration.

See Also:
Constant Field Values
Value:
631

Except_Lost_MQ_Connection

public static final int Except_Lost_MQ_Connection

The MQeMQAdapter could not acquire a valid handle to WebSphere MQ.

User action : Review any previous information to determine why the connection to WebSphere MQ failed. Correct the problem and retry.

See Also:
Constant Field Values
Value:
632

Except_Client_Con_Not_Available

public static final int Except_Client_Con_Not_Available

An attempt was made to access a Client Connection object that does not exist.

User action : Ensure that your WebSphere MQ-bridge objects point to a valid Client Connection object. If necessary, inquire that the Client Connection exists and is accessible.

See Also:
Constant Field Values
Value:
633

Except_Exit_Class_Init_Error

public static final int Except_Exit_Class_Init_Error

A user exit defined as part of your Client Connection object could not be initialised.

User action : Ensure that your exits conform to the WebSphere MQ Classes for Java user exits interfaces. Refer to the WebSphere MQ Using Java book for more information.

See Also:
Constant Field Values
Value:
634

Websphere MQ Everyplace