Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# 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 a 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`
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

- Configure SAF queues
- Configure SAF topics
- Configure connection factory unit-of-order parameters
- Configure path services

Related Topics

- Understanding the Store-and-Forward Service
- Understanding JMS Resource Configuration