Foreign destination [Settings]
The name by which this foreign destination is known for admin purposes.
To view this pane in the console...
Service integration > Buses > bus_name > [Destination resources] Destinations > destination_name .
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
Identifier
The identifier by which this destination is known for admin purposes. Type the name of the destination as configured on the foreign bus. This must match exactly the name of the target destination that exists in the foreign bus.
Required
No Data type
Text
Bus
The name of the foreign bus on which this destination is defined. This must match exactly the name of a foreign bus admin object that is already defined on the bus on which this foreign destination is being created.
Required
No Data type
Text
UUID
The universal unique identifier assigned by the system to this destination for admin purposes.
Required
No Data type
Text
Type
Whether this bus destination is for a queue, topic space, or some other type of destination.
Required
No Data type
Text
Description
An optional description for the bus destination, for admin purposes.
Required
No Data type
Text area
Enable producers to override default reliability
Select this option to enable producers to override the default reliability that is 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.
Required
No Data type
Check box
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 SIBDestination.overrideOfQOSByProducerAllowed 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.
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.
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.
Default priority
The default priority assigned to messages sent to this destination when a priority has not been set by the producer.
Required
No Data type
Integer Range
0 through 9
Send allowed
Clear this option (setting it to false) to stop producers from being able to send messages to this destination.
Required
No Data type
Check box
Include an RFH2 message header when sending messages to WebSphere MQ
If selected, messages sent to WebSphere MQ include an RFH2 header. The RFH2 header stores additional information to that which is stored in theWebSphere MQ message header.
This property applies when the foreign bus that hosts the target destination is 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.
Required
No Data type
Check box
Additional Properties
Context properties- Context information passed to the mediation.
Related Items
Application resources topology- A expandable tree view of all applications and messaging resources that reference the current destination.
Last updated Nov 10, 2010 8:23:07 PM CST