+

Search Tips   |   Advanced Search

Destination defaults [Settings]

Properties to be applied when applications use destinations on this foreign bus when there is no explicit foreign destination definition.

To view this page in the console, click the following path:

  • Service integration -> Buses -> bus_name -> [Topology] Foreign bus connections -> foreign_bus_name -> [Additional Properties] Destination defaults.

    These properties apply when there is no explicit foreign destination or alias destination defined on the local bus to provide destination defaults.


    Configuration tab

    The Configuration tab shows configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.


    General Properties

    Default priority

    The default priority assigned to messages sent to this destination when a priority has not been set by the producer.

    Dynamic updates to this property are effective immediately.

    Information Value
    Required No
    Data type Integer
    Range 0 through 9

    Default reliability

    The reliability assigned to a message produced to this destination when an explicit reliability has not been set by the producer.

    This reliability setting is used if a message has not set a reliability or if the Enable producers to override default reliability is set to False.

    • If an application is producing messages to a destination and that application does NOT specify a reliability for the message, then the Default reliability setting is used.

    • If an application is producing messages to a destination and that application specifies a reliability, then the application reliability is ONLY applicable if the Enable producers to override default reliability property is set to True. Otherwise, the Default reliability setting is used.

    Dynamic updates to this property are effective immediately.

    Information Value
    Required No
    Data type drop-down list
    Range

    Best effort nonpersistent

    Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable or as a result of constrained system resources.

    Express nonpersistent

    Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable.

    Reliable nonpersistent

    Messages are discarded when a messaging engine stops or fails.

    Reliable persistent

    Messages might be discarded when a messaging engine fails.

    Assured persistent

    Messages are not discarded.

    Maximum reliability

    The maximum reliability of messages accepted by this destination.

    Producers cannot send messages to this destination with a reliability higher than the value specified for this property.

    This attribute is not used for a temporary destination.

    If the message exceeds the maximum reliability and the producer is local to the messaging engine, an exception is thrown.

    If the message exceeds the maximum reliability and the producer is not local to the messaging engine, the message is sent to the exception destination defined for the target destination.

    Dynamic updates to this property are effective immediately.

    Information Value
    Required No
    Data type drop-down list
    Range

    Best effort nonpersistent

    Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable or as a result of constrained system resources.

    Express nonpersistent

    Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable.

    Reliable nonpersistent

    Messages are discarded when a messaging engine stops or fails.

    Reliable persistent

    Messages might be discarded when a messaging engine fails.

    Assured persistent

    Messages are not discarded.

    Send allowed

    Clear this option (setting it to false) to stop producers from being able to send messages to destinations on this foreign bus.

    Dynamic updates to this property are effective immediately.

    Information Value
    Required No
    Data type Boolean

    Enable producers to override default reliability

    Select this option to enable producers to override the default reliability set on the destination.

    • If an application is producing messages to a destination and that application does NOT specify a reliability for the message, then the Default reliability setting is used.

    • If an application is producing messages to a destination and that application specifies a reliability, then the application reliability is ONLY applicable if the Enable producers to override default reliability property is set to True. Otherwise, the Default reliability setting is used.

    Dynamic updates to this property are effective immediately.

    Information Value
    Required No
    Data type Boolean

    Include an RFH2 message header when sending messages to WebSphere MQ.

    If selected, messages sent to WebSphere MQ includes an RFH2 header. The RFH2 header stores additional information to that which is stored in theWebSphere MQ message header.

    This property applies when a foreign bus connection represents a WebSphere MQ queue manager or queue-sharing group. When service integration converts a message from the service integration format to WebSphere MQ format, by default it includes an MQRHF2 header in the WebSphere MQ message. This header contains message attributes, such as JMS message attributes, that are not WebSphere MQ message attributes and therefore do not appear in the WebSphere MQ message descriptor (MQMD). Some WebSphere MQ applications cannot process messages that include an MQRFH2 header. If messages sent to this destination will be processed by WebSphere MQ applications that cannot tolerate an MQRFH2, clear this option.

    Dynamic updates to this property are effective immediately.

    Information Value
    Required No
    Data type Boolean


    Additional Properties

    Context properties

    Context information passed to the mediation.


    Related concepts

  • Temporary bus destinations

  • Exception destinations


    Related tasks

  • Configure destination defaults for a foreign bus connection

  • Create a foreign destination on a bus


    Related information:

  • Administrative console buttons

  • Administrative console preference settings Reference topic