Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

SAF Imported Destinations: Configuration: General

Configuration Options     Related Tasks     Related Topics

Use this page to configure SAF imported destinations properties. SAF imported destinations are collections of SAF queues and topics that locally represent JMS queues or topics on a remote server or cluster. Each collection of imported destinations is associated with a remote SAF context. They can also share the same JNDI prefix, time-to-live default (message expiration time), and SAF error handling policy.

Configuration Options

Name Description
Name

The name of this SAF imported destination.

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

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

JNDI Prefix

Specifies the string that will prefix the local JNDI name of a remote destination.

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

MBean Attribute (Does not apply to application modules) :
SAFImportedDestinationsBean.JNDIPrefix

Remote SAF Context

Specifies the remote context used for the imported destinations.

Changing the remote context name affects both stored messages and incoming messages.

MBean Attribute (Does not apply to application modules) :
SAFImportedDestinationsBean.SAFRemoteContext

SAF Error Handling

Specifies the error handling configuration used for the imported destinations.

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

MBean Attribute (Does not apply to application modules) :
SAFImportedDestinationsBean.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) :
SAFImportedDestinationsBean.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) :
SAFImportedDestinationsBean.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 message producers use the hash code of a message Unit-of-Order to find a SAF agent.

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

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

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

Default Targeting Enabled

Specifies whether this JMS resource defaults to the parent module's targeting or uses the subdeployment targeting mechanism.

When set to true, this resource implicitly inherits the targeting of its parent module. When set to false, this resource gets targeted based its subdeployment's targets, if one is specified.

MBean Attribute (Does not apply to application modules) :
SAFImportedDestinationsBean.DefaultTargetingEnabled

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

Related Tasks

Related Topics


Back to Top