Alias destination [Settings]
Overview
An alias destination makes a destination available by another name and, optionally, overrides the parameters of the destination.
Service integration | Buses | bus_name | [Destination resources] Destinations | destination_name
General Properties
Identifier
The identifier by which this destination is known for admin purposes. The identifier and bus are used to identify this destination to applications.
Required
No Data type
Text
Bus
The name of the bus on which this destination is known to applications. The identifier and bus are used to identify this destination to applications.
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
Target identifier
The name of the destination for which this is an alias.
The targetIdentifier field is read-only and cannot be modified; if you want to change the target of an alias, delete the alias destination then re-create it.
Required
No Data type
Text
Target bus
The name of the bus on which the destination for which this is an alias exists. If you do not specify a bus name, the target destination is assumed to be on the same bus as the alias destination.
The targetBus field is read-only and cannot be modified; if you want to change the target of an alias, delete the alias destination then re-create it.
Required
No Data type
Text
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
drop-down list Range
- Inherit
- The alias destination uses (inherits) the value of the corresponding property on the target destination.
- True
- The alias destination uses the delivery option value specified by producers.
- False
- The alias destination uses the delivery option value specified by the Reliability property of the destination.
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.
Required
No Data type
drop-down list Range
- Inherit
- The alias destination uses (inherits) the value of the corresponding property on the target destination.
- 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
- Inherit
- The alias destination uses (inherits) the value of the corresponding property on the target destination.
- 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
-1 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
drop-down list Range
- Inherit
- The alias destination uses (inherits) the value of the corresponding property on the target destination.
- True
- The alias destination uses the delivery option value specified by producers.
- False
- The alias destination uses the delivery option value specified by the Reliability property of the destination.
Receive allowed
Clear this option (setting it to false) to prevent consumers from being able to receive messages from this destination.
Required
No Data type
drop-down list Range
- Inherit
- The alias destination uses (inherits) the value of the corresponding property on the target destination.
- True
- The alias destination uses the delivery option value specified by producers.
- False
- The alias destination uses the delivery option value specified by the Reliability property of the destination.
Reply destination
The name of a destination to be appended to any non-empty reverse routing path of messages sent to this destination. Is intended for use with mediations on reply messages.
See about the use of this property, see Configure a destination reverse routing path. .
Required
No Data type
Text
Reply destination bus
The bus on which the reply destination exists. Is intended for use with mediations on reply messages.
See about the use of this property, see Configure a destination reverse routing path.
Required
No Data type
Text
Default forward routing path
The value to which a message's forward routing path will be set if the message contains no forward routing path. This identifies a sequential list of intermediary bus destinations that messages must pass through to reach a target bus destination. The format of the field is a list of line-delimited bus destinations specified as bus:name. To forward messages to one or more bus destinations, type a list of bus destinations. Type each destination entry on a separate line, and in the form bus_name:destination_name or :destination_name Where
- bus_name
- Is the name of the service integration bus on which the destination is configured. If you do not specify a bus name, the destination is assumed to be on the same bus as the destination for which we are setting this property.
- destination_name
- is the name of a bus destination.
Required
No Data type
Text area
Delegate authorization check to target destination
Indicates whether the authorization check is performed on the alias or the target destination.
Indicates which destination access role is checked when a user accesses the alias destination. When this option is selected, the destination access role of the target destination is checked. When this option is not selected, the destination access role of the alias destination is checked. If you do not want to override the security of the target destination, select this option.
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 target bus 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
Use all target queue points
Whether to use all target queue points
This option is only visible when an alias destination is defined to point at a destination with multiple queue points. Indicates whether all the queue points of the target queue can be used, including any queue points created after the alias is configured. When selected, the Target queue points menu is disabled.
Required
Yes Data type
Check box
Unselected queue points
This is a list of the queue points that are not addressable by the alias definition. The list is generated from the complete list of queue points for this queue.
This option is only visible when an alias destination is defined to point at a destination with multiple queue points.
This list is enabled only when Use all target queue points is unchecked.
Required
No Data type
drop-down list
Selected queue points
This is a list of the queue points that are addressable by the alias definition. Messages produced to or consumed from this alias apply to only these queue points.
This option is only visible when an alias destination is defined to point at a destination with multiple queue points.
This list is enabled only when Use all target queue points is unchecked.
Required
No Data type
drop-down list
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