Port [Settings]

To view this pane in the console...

Service integration > Buses > bus_name > [Destination resources] Destinations > port_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.

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

 

Mediation

The name of the mediation that mediates this destination.

Required

No

Data type

Text

 

Default reliability

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

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.

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.

 

Enable producers to override default reliability

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

Required

No

Data type

Check box

 

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

Custom

 

Exception destination

The destination to which a message is forwarded by the system when it cannot be delivered to this destination.

Use this property to define what happens to any messages that cannot be delivered to this destination.

By default, such messages are routed to the system default exception destination of the messaging engine that discovers the problem: _SYSTEM.Exception.Destination.engine_name.

If you want messages to be sent to another exception destination, select Specify then type the exception destination name. The exception destination must be a queue, on the same bus or a foreign bus, and must exist when the destination is created.

If you do not want undeliverable messages to be sent to an exception destination, select None.

Required

No

Data type

Text and Check box

 

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

 

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

Check box

 

Receive exclusive

Select this option to allow only one consumer to attach to each message point. If this option is not selected multiple consumers will be allowed to attach and receive messages from each message point.

Required

No

Data type

Check box

 

Maintain strict message order

Enabling this option will maintain the strict ordering of messages for this destination.

Required

No

Data type

Custom

 

Additional Properties


Context properties

Context information passed to the mediation.

 

Message points


Queue points

A queue point is created on each messaging engine to which a point-to-point destination is assigned. It is used to hold messages pending delivery to receiving applications.


Mediation points

A mediation point is a location in a messaging engine at which messages are mediated. A mediation point is created when a mediation is associated with a bus destination.



Last updated Nov 10, 2010 8:23:07 PM CST