com.ibm.ws.activity
Interface WebSphereServiceManager

All Superinterfaces:
ServiceManager
All Known Subinterfaces:
HighlyAvailableServiceManager
public interface WebSphereServiceManager
extends ServiceManager

The WebSphereServiceManager extends the javax.activity.coordination.ServiceManager interface, providing optional methods that the Activity service may use to optimize service and performance for HLSs.

Method Summary
 java.util.Properties getProperties()
          This method is used by the Activity service to access optional information that may be used by the Activity service to provide functional or perfomance optimizations for the HLS that implements this interface.
 
Methods inherited from interface com.ibm.ws.javax.activity.coordination.ServiceManager
activityImported, getActivityType, getCompletionSignalSetName, getPropertyGroupManager, getPropertyGroupNames, getServiceInformation, getSignalSet, getSubordinateSignalSet, recoverActions, recoverSignalSets
 

Method Detail

getProperties

public java.util.Properties getProperties()
This method is used by the Activity service to access optional information that may be used by the Activity service to provide functional or perfomance optimizations for the HLS that implements this interface.

Defined properties will initially be:

  • "SignalChildBegin" = "true" or "false" (default is true). If the HLS does not want childBegin signals, it can improve performance by setting this value to "false"
  • "SignalTxnBegin" = "true" or "false" (default is false). If the HLS wishes to use the DescendantTransactionBegin signal set, it must set this value to "true"
  • "NotifyImported" = "true" or "false" (default is true). If the HLS wishes its ServiceManager.activityImported() method to NOT be called it should set this value to "false"
  • "beforeCompletion" = "true" or "false" (default is true). If the HLS does NOT wish the SynchronizationSignalSet "beforeCompletion" signal to be distributed during successfule completion, it should set this value to "false".
  • "maximumRetries" = an integer value (default is "1"). Specifies the number of times a request to a remote Activity service object is to be retried in the event of a communication error. A negative number (eg -1) will cause the request to be retied indefinitely.
  • "retryInterval" = an integer value (default is "1"). Specifies the time interval (in seconds) between each retry to contact a remote Activity service object after a communication failure.
  • "markChildrenFailed" = "true" or "false" (default is "true"). If the HLS does not wish the CompletionStatus of child activities to be set to FailOnly in the event that a parent scope ends in failure, it should set this property to "false".
  • "noForceCoordinator" = "true" or "false" (default is "false"). If the HLS does not wish the Activity Service to force the creation of a coordinator for non-distributed activity contexts in order to obtain a completion outcome, it should set this property to "true".

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.