IBM WebSphere MQ queue settings (MQ Config) - Middleware News

• Use this panel to browse or change the configuration properties defined to WebSphere MQ for the selected queue destination.
  

  To view this page, use the administrative console to complete the following steps:
  

  1. In the navigation pane, expand Resources > JMS > JMS providers .
  2. If appropriate, in the content pane, change the scope of the WebSphere MQ messaging provider. If the scope is set to node or server scope for a Version 5 node, the administrative console presents the subset of resources and properties that are applicable to WebSphere Application Server Version 5.
  3. In the content pane, click the name of the WebSphere MQ messaging provider that you want to support the JMS destination.
  4. In the content pane, under Additional Resources, click Queues. This displays a list of any existing JMS queue destinations.
  5. Click the name of the JMS queue destination that you want to work with.
  6. Under Additional Resources, click MQ Config.

  A WebSphere MQ queue destination is used to configure the properties of a JMS queue. A queue for use with the WebSphere MQ JMS provider has the following extra properties defined to WebSphere MQ.
  

  Notes

  Note:
  

  • To be able to browse or change these MQ Config properties, the WebSphere MQ Queue Manager on which the queue resides must be configured for remote administration and be running. You must also have installed the WebSphere MQ client. If you have not done this, the administrative console displays messages like the following:

    The WMQQueueDefiner MBean has encountered an error.
    WMSG0331E: The MQ Client is required for this functionality, but it is not installed.

  • These MQ Config properties can be used only to view or change the properties of local queues. You cannot use MQ Config to administer alias or remote queues.
  • Some properties displayed are read-only and cannot be changed.
  • The property values that you specify must match the values that you specified when configuring WebSphere MQ JMS resources. For more information about configuring WebSphere MQ JMS resources, see the WebSphere MQ: Using Java book, which is available from the WebSphere MQ library at http://www.ibm.com/software/integration/wmq/library/.
  • In WebSphere MQ, names can have a maximum of 48 characters, with the exception of channels which have a maximum of 20 characters.

  Base Queue Name

  The name of the local queue to which messages are sent, on the queue manager specified by the Base Queue Manager Name property.
  

  Data type

  String

  Base Queue Manager Name

  The name of the WebSphere MQ queue manager to which messages are sent.
  This queue manager provides the queue specified by the Base Queue Name property.
  

  Data type

  String

  Queue Manager Host

  The name of host for the queue manager on which the queue destination is created.
  

  Data type

  String

  Queue Manager Port

  The number of the port used by the queue manager on which this queue is defined.
  

  Data type	Integer
  Range	A valid TCP/IP port number. This port must be configured on the WebSphere MQ queue manager.

  Server Connection Channel Name

  The name of the channel used for connection to the WebSphere MQ queue manager.
  

  Data type	String
  Range	1 through 20 ASCII characters

  User ID

  The user ID used, with the Password property, for authentication when connecting to the queue manager to define the queue destination.
  If you specify a value for the User ID property, you must also specify a value for the Password property.
  

  Data type

  String

  Password

  The password, used with the User ID property, for authentication when connecting to the queue manager to define the queue destination.
  If you specify a value for the User ID property, you must also specify a value for the Password property.
  

  Data type

  String

  Description

  The WebSphere MQ queue description, for administrative purposes within WebSphere MQ.
  

  Data type	String
  Default	Null
  Range	1 through 64 ASCII characters.

  Inhibit Put

  Whether or not put operations are allowed for this queue.
  

  Data type	Enum
  Default	Put Inhibited
  Range	Put Allowed Put operations are allowed for this queue. Put Inhibited Put operations are not allowed for this queue.

  Persistence

  Whether messages on the queue are persistent or non-persistent.
  

  Data type	Enum
  Default	Persistent
  Range	Persistent Messages on the queue are persistent. Non persistent Messages on the queue are not persistent.

  Cluster Name

  The name of the cluster to which the WebSphere MQ queue manager belongs.
  If you specify a value for Cluster Name, you should not specify a value for Cluster Name List. Cluster names must conform to the rules described in the WebSphere MQ MQSC Command Reference book, which is available from the WebSphere MQ library at http://www.ibm.com/software/integration/wmq/library/.
  

  Data type	String
  Default	Null
  Range	A valid WebSphere MQ name for a queue manager cluster, as 1 through 48 ASCII characters

  Cluster Name List

  The name of the cluster namelist to which the WebSphere MQ queue manager belongs.
  If you specify a value for Cluster Name, you should not specify a value for Cluster Name List. Cluster names must conform to the rules described in the WebSphere MQ MQSC Command Reference book.
  

  Data type	String
  Default	Null
  Range	A valid WebSphere MQ name for a list of queue manager clusters, as 1 through 48 ASCII characters

  Default Binding

  The default binding to be used when the queue is defined as a cluster queue.
  

  Data type	Enum
  Default	On Open
  Range	On Open The queue handle is bound to a specific instance of the cluster queue when the queue is opened. Not Fixed The queue handle is not bound to any particular instance of the cluster queue. This allows the queue manager to select a specific queue instance when the message is put, and to change that selection subsequently should the need arise.

  Inhibit Get

  Whether or not get operations are allowed for this queue.
  

  Data type	Enum
  Default	Get Inhibited
  Range	Get Inhibited Get operations are not allowed for this queue. Get Allowed Get operations are allowed for this queue.

  Maximum Queue Depth

  The maximum number of messages allowed on the queue.
  

  Data type	Integer
  Units	Number of messages
  Default	0
  Range	A value greater than or equal to zero, and less than or equal to 640 000. For more information about the maximum value allowed, see the WebSphere MQ MQSC Command Reference. If this value is reduced, any messages that are already on the queue are not affected, even if the number of messages exceeds the new maximum.

  Maximum Message Length

  The maximum length, in bytes, of messages on this queue.
  

  Data type	Integer
  Units	Number of bytes
  Default	0
  Range	A value greater than or equal to zero, and less than or equal to the maximum message length for the queue manager and WebSphere MQ platform. For more information about the maximum value allowed, see the WebSphere MQ MQSC Command Reference.If this value is reduced, any message that is already on the queue are not affected, even if the message length exceeds the new maximum.

  Shareability

  Whether multiple applications can get messages from this queue.
  

  Data type	Enum
  Default	Shareable
  Range	Shareable More than one application instance can get messages from the queue. Not Shareable Only one application instance can get messages from the queue.

  Input Open Option

  The default share option for applications opening this queue for input
  

  Data type	Enum
  Default	Exclusive
  Range	Exclusive The open request is for exclusive input from the queue. Shared The open request is for shared input from the queue.

  Message Delivery Sequence

  The order in which messages are delivered from the queue in response to get requests.
  

  Data type	Enum
  Default	FIFO
  Range	FIFO Messages are delivered in first in first out (FIFO) order. Priority is ignored for messages on this queue. Priority Messages are delivered in first-in-first-out (FIFO) order within priority. This is the default supplied with WebSphere MQ, but your installation might have changed it.

  Backout Threshold

  The maximum number of times that a message can be backed out. If this threshold is reached, the message is requeued on the backout queue specified by the Backout Requeue Name property.
  The WebSphere MQ queue manager keeps a record of the number of times that each message has been backed out. When this number reaches a configurable threshold, the connection consumer requeues the message on a named backout queue. If this requeue fails for any reason, the message is removed from the queue and either requeued to the dead-letter queue, or discarded.
  

  Data type	Integer
  Default	0
  Range	0 Never requeue messages 1 or more The number of times that a message has been backed, at which the message is requeued on a named backout queue.

  Backout Requeue Name

  The name of the backout queue to which messages are requeued if they have been backed out more than the backout threshold.
  The WebSphere MQ queue manager keeps a record of the number of times that each message has been backed out. When this number reaches a configurable threshold, the connection consumer requeues the message on a named backout queue. If this requeue fails for any reason, the message is removed from the queue and either requeued to the dead-letter queue, or discarded.
  

  Data type	String
  Default	Null
  Range	1 through 48 characters.

  Harden Get Backout

  Whether hardening should be used to ensure that the count of the number of times that a message has been backed out is accurate.
  

  Data type	Enum
  Default	Hardened
  Range	Hardened The count is hardened. Not Hardened The count is not hardened. This is the default supplied with WebSphere MQ, but your installation might have changed it.

  Default Priority

  The default message priority for this destination, used if no priority is provided with a message.
  

  Data type	Integer
  Default	0
  Range	0 (lowest priority) through 9 (highest priority)