Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

SAF Destinations: General

Configuration Options     Related Tasks     Related Topics

Use this page to configure a SAF queue or topic destination. SAF queues and topics are used for asynchronous and disconnected peer communications. Messages delivered to a SAF queue or topic are temporarily stored for future delivery, and are forwarded to a JMS queue or topic on a remote server or cluster when it is reachable.

Configuration Options

Name Description
Name

The name of this entity, represented in XML as an attribute.

Many of the elements within the JMS module are named entities. All of the named entities encased by a type in the XML file must be unique. This is the identifier used to delineate a particular entity within the JMS module.

This attribute cannot be modified externally from the module (for example, with a deployment plan) because it may be used inside the module referentially.

MBean Attribute (Does not apply to application modules) :
NamedEntityBean.Name

Changes take effect after you redeploy the module or restart the server.

Remote JNDI Name

The remote JNDI name of the remote destination.

MBean Attribute (Does not apply to application modules) :
SAFDestinationBean.RemoteJNDIName

Local JNDI Name

The local JNDI name of the remote destination.

MBean Attribute (Does not apply to application modules) :
SAFDestinationBean.LocalJNDIName

Non-Persistent QOS

Specifies the quality-of-service for non-persistent messages.

  • Exactly-Once indicates that messages will be forwarded to the remote side once and only once except for any occurrence of server crashes.

  • At-Least-Once indicates that messages will be forwarded to the remote side at least once. No message will be lost except for any occurrence of server crashes. However, messages may appear in the remote endpoint more than once.

  • At-Most-Once indicates that messages will be forwarded to the remote side atmost once. No message will appear in the remote endpoint more than once. However, messages may get lost.

Any change to this parameter affects only incoming messages; stored messages are not affected.

MBean Attribute (Does not apply to application modules) :
SAFDestinationBean.NonPersistentQos

Persistent QOS

Specifies the quality-of-service for persistent messages.

  • Exactly-Once indicates that messages will be forwarded to the remote side once and only once

  • At-Least-Once indicates that messages will be forwarded to the remote side at least once. Messages may appear in the remote endpoint more than once.

  • At-Most-Once indicates that messages will be forwarded to the remote side atmost once. No message will appear in the remote endpoint more than once. However, messages may get lost.

Any change to this parameter affects only incoming messages; stored messages are not affected.

MBean Attribute (Does not apply to application modules) :
SAFDestinationBean.PersistentQos

SAF Error Handling

Specifies the error handling configuration used by this SAF destination.

Any change to this parameter affects only incoming messages; stored messages are not affected.

MBean Attribute (Does not apply to application modules) :
SAFDestinationBean.SAFErrorHandling

Changes take effect after you redeploy the module or restart the server.

Enable SAF Default Time-to-Live

Controls whether the Time-to-Live (expiration time) value set on imported JMS messages will be overridden by the value specified in the SAF Default Time-to-Live field.

Any change to this parameter affects only incoming messages; stored messages are not affected.

MBean Attribute (Does not apply to application modules) :
SAFDestinationBean.UseSAFTimeToLiveDefault

SAF Default Time-to-Live

Specifies the default Time-to-Live value (expiration time), in milliseconds, for imported JMS messages. The expiration time set on JMS messages will override this value unless the SAF Default Time-to-Live Enabled field is switched on, which then overrides the expiration time in JMS messages on imported destinations.

Any change to this value affects only incoming messages; stored messages are not affected.

MBean Attribute (Does not apply to application modules) :
SAFDestinationBean.TimeToLiveDefault

Minimum value: -1

Message Unit-of-Order Routing

Specifies the type of routing used to find a SAF agent when using the message Unit-of-Order feature.

  • Hash indicates that producers use the hash code of a message Unit-of-Order to find a SAF agent.

  • PathService indicates that producers use the Path Service to find a SAF agent.

MBean Attribute (Does not apply to application modules) :
SAFDestinationBean.UnitOfOrderRouting

Changes take effect after you redeploy the module or restart the server.

Related Tasks

Related Topics


Back to Top