Administration Console Online Help

    Previous Next  Open TOC in new window 
Content starts here

Configure advanced JMS template parameters

Before you begin


After you create a template, 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 JMS template:

  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 template 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 destinations using this template. Any message landing on a destination 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 destinations using this template 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 SAF Export Policy, specify whether a user can send messages to destinations using this template using the Store-and-Forward service.
    4. In Messaging Performance Preference, specify how long destinations using this template 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.

    5. 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 destinations that use this template. A UOW is a set of messages that are processed as a single unit. Pass-Through - by default, destinations using this template 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 destinations that use this template. 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, which will then follow the expiration policy defined for undeliverable messages.

      Note: A template's error destination for UOW messages cannot be configured to use the Single Message Delivery value. See Configure JMS template message delivery failure parameters.

    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