weblogic.j2ee.descriptor.wl
Interface SAFErrorHandlingBean

All Superinterfaces:

NamedEntityBean, SettableBean

public interface SAFErrorHandlingBean
extends NamedEntityBean

Store-and-Forward (SAF) Error Handling defines the action to be taken when the delivery of a JMS message fails to be forwarded to a remote destination.

Access limited to the following security roles:

Deployer

getPolicy

String getPolicy()

The error handling policy for this SAF error handling resource.

• Discard - By default, expired messages are simply removed from the system. The removal is not logged and the message is not redirected to another location.
• Log - Removes expired messages and writes an entry to the server log file indicating that the messages were removed from the system. You define the actual information that will be logged in the Log Format field.
• Redirect - Moves expired messages from their current location into the Error Destination defined for imported SAF destinations.
• Always-Forward - Ignores the SAF Default Time-to-Live value set on the imported destination and the expiration time set on the message, and so forwards the message to a remote destination even after it has expired.

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

Default Value:

weblogic.j2ee.descriptor.wl.constants.JMSConstants.DISCARD

setPolicy

void setPolicy(String policy)
               throws IllegalArgumentException

Sets the value of the Policy attrubute.

Throws:

IllegalArgumentException

See Also:

SAFErrorHandlingBean.getPolicy()

This method can NOT set a null value.

Default Value:

weblogic.j2ee.descriptor.wl.constants.JMSConstants.DISCARD

Valid Values:

weblogic.j2ee.descriptor.wl.constants.JMSConstants.DISCARD,weblogic.j2ee.descriptor.wl.constants.JMSConstants.LOGGING,weblogic.j2ee.descriptor.wl.constants.JMSConstants.ERRORDESTINATION,weblogic.j2ee.descriptor.wl.constants.JMSConstants.ALWAYSFORWARD

getLogFormat

String getLogFormat()

Specifies how information is logged when Policy is set to Log.

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

setLogFormat

void setLogFormat(String logFormat)
                  throws IllegalArgumentException

Sets the value of the LogFormat attribute.

Throws:

IllegalArgumentException

See Also:

SAFErrorHandlingBean.getLogFormat()

getSAFErrorDestination

SAFDestinationBean getSAFErrorDestination()

Specifies the error destination when Policy is set to Redirect.

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

setSAFErrorDestination

void setSAFErrorDestination(SAFDestinationBean errorDestination)
                            throws IllegalArgumentException

Sets the value of the SAFErrorDestination attribute.

Throws:

IllegalArgumentException