Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Configure advanced queue parameters

Before you begin


After you create a queue, you can define advanced property values, such as specifying unit-of-order parameters, attaching the credentials of message senders, or defining unit-of-work parameters.

To configure advanced general values for a queue:

  1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
  2. In the Administration Console, navigate to the queue resource that you want to configure:
  3. On the Configuration: General page, click the Advanced button.
    1. If you are using the unit-of-order feature, in Auto-generate Unit-of-Order Name, specify whether you want the system to create a system-generated unit- of-order name that is statistically unique for this queue. Any message landing on this queue that does not already belong to a unit-of-order is automatically assigned this default unit-of-order name.
    2. In Attach Sender Credential, specify whether messages landing on this destination should attach the credential of the sending user by selecting either: Supports, which sets the JMSXUserID property with the security principal of the sending user if requested; Never, which never sets the JMSXUserID property with the security principal of the sending user; Always, which always sets the JMSXUserID property with the security principal of the sending user.
    3. In Local JNDI Name, enter a local JNDI name that will be bound on the local server instance, but which will not be globally propagated to the rest of the cluster. A queue can have both a local and global JNDI name.
    4. In Create Destination Identifier, enter a unique queue identifier name. This name must be unique within the scope of the JMS server to which this queue is targeted; however, it does not need to be unique within the scope of a JMS module. Therefore, two queues in the same module can have the same destination identifier as long as those queues are targeted to different JMS servers. See How to Lookup a Destination.
    5. In SAF Export Policy, specify whether a user can send messages to this queue using the Store-and-Forward service.
    6. In Messaging Performance Preference, specify how long the queue should wait (if at all) before creating full batches of available messages for delivery to consumers. The maximum message count of a full batch is controlled by the JMS connection factory's Message Maximum per Session setting.

      Do Not Batch Messages -- Available messages are promptly delivered to consumers.

      Batch Messages Without Waiting -- (default) Less-than-full batches are immediately delivered with available messages.

      Low Waiting Threshold for Message Batching -- Wait briefly before less-than-full batches are delivered with available messages.

      Medium Waiting Threshold for Message Batching -- Wait longer before less-than-full batches are delivered with available messages.

      High Waiting Threshold for Message Batching -- Wait even longer before less-than-full batches are delivered with available messages.

    7. If you are using the Unit-of-Work feature:

      In Unit-of-Work (UOW) Message Handling Policy, specify whether the UOW feature is enabled for this queue. A UOW is a set of messages that are processed as a single unit. Pass-Through - by default, this queue will not treat messages as part of a UOW. Single Message Delivery - this setting should only be selected if UOW consumers are receiving messages on this queue. When selected, UOW messages are formed into a list and are consumed as an ObjectMessage containing the list.

      In Expiration Time for Incomplete UOW Messages, specify the maximum amount of time before undelivered messages in an incomplete UOW are expired. Such messages will then follow the queue's expiration policy defined for undeliverable messages.

      Note: An error destination for UOW messages cannot be configured to use the Single Message Delivery value. See Configure queue message delivery failure options.

    For more information about these fields, see Configuration Options.

  4. Save your changes:
  5. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
    Not all changes take effect immediately—some require a restart (see Use the Change Center).

Back to Top