Alias [Settings]

An alias destination makes a destination available by another name and, optionally, overrides the parameters of the destination.

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

Service integration > Buses > [Content Pane] bus_name > [Destination resources] Destinations > [Content Pane] destination_name.

Configuration tab

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 administrative 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 administrative 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 administrative purposes.

Required No
Data type Text area

Target identifier

The name of the destination for which this is an alias.

Note: The targetIdentifier field is read-only and cannot be modified; if you want to change the target of an alias, you must 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.
Note: The targetBus field is read-only and cannot be modified; if you want to change the target of an alias, you must 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 may also be discarded if a connection used to send them becomes unavailable and as a result of constrained system resources.

Express nonpersistent
Messages are discarded when a messaging engine stops or fails. Messages may 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 may 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 may also be discarded if a connection used to send them becomes unavailable and as a result of constrained system resources.

Express nonpersistent
Messages are discarded when a messaging engine stops or fails. Messages may 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 may 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.

This property is intended for use with mediations on reply messages.

For more information about the use of this property, see Configuring a destination reverse routing path.

.
Required No
Data type Text

Reply destination bus

The bus on which the reply destination exists.

This property is intended for use with mediations on reply messages.

For more information about the use of this property, see Configuring 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, in the format, bus:name or :name.

If you want 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 you 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.

Required No
Data type Check box

Additional properties

Context properties
Context information passed to the mediation.



Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 10:47:11 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-iseries&topic=SIBDestinationAlias_DetailForm
File name: SIBDestinationAlias_DetailForm.html