EJBAsync

This type is a class for model objects.

@since 8.0.0

Package: ejbcontainer

Classifier ID:  -1
Instance class name:  * Unspecified *
Instance class:  * Unspecified *

Reference attributes having this type:
  EJBContainer.asyncSettings



Attributes Summary
maxThreads : EInt The maximum number of threads available in the Work Manager used in support of asynchronous EJB method invocation.
workReqQSize : EInt Asynchronous EJB method invocations are supported by a WorkManager. This specifies the size of the buffer that the Work Manager's thread pool uses to pull requests from. The total number of in-flight asynchronous method requests will be the sum of maxThreads and the size of this queue. The default value is 0, which means the queue size is automatically managed by the Websphere runtime. Notes: Use with extreme caution. Specifying a large value can lead to instability and memory resource issues.
workReqQFullAction : EInt Work request queue full action. Possible values: 0 - block; 1 - fail. If 0 is specified and the thread pool is unable to immediately allocate a thread or a free slot in the buffer, the request will block indefinitely until a thread becomes available in the pool. If 1 is specified and the thread pool is unable to immediately allocate a thread or a free slot in the buffer, a WorkRejectedException with an error code of WorkRejectedException.WORKREQUEST_QUEUE_FULL will be thrown. The request can be retried until successful. The WorkRejectedException may be thrown any time where a thread cannot be immediately be allocated and may not reflect the size of the thread pool and buffer. The default is 0, which means block while the queue remains full.
customWorkManagerJNDIName : EString The JNDI name of the custom defined WorkManager used in support of asynchronous EJB method invocation.
futureTimeout : EInt This is the amount of time the server retains the results of each asynchronous method call. If an application doesn't retrieve the results within the specified period of time, the server purges that method call's results to prevent memory leakage. You can specify 0 to never purge the objects, however, this is not recommended. The default value is 86400 seconds (24 hours).
useCustomDefinedWM : EBoolean Indicates whether the WorkManager being used in support of asynchronous EJB method invocations is a custom defined WorkManager created by the user, or the default internal WorkManager created by the EJBContainer. A value of true means that a custom defined WorkManager is used. A value of false means that the internal, default WorkManager is used. The default value is false.



Attribute Details

maxThreads  -  The maximum number of threads available in the Work Manager used in support of asynchronous EJB method invocation.
    Data Type: EInt
    Default value:  5
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

workReqQSize  -  Asynchronous EJB method invocations are supported by a WorkManager. This specifies the size of the buffer that the Work Manager's thread pool uses to pull requests from. The total number of in-flight asynchronous method requests will be the sum of maxThreads and the size of this queue. The default value is 0, which means the queue size is automatically managed by the Websphere runtime. Notes: Use with extreme caution. Specifying a large value can lead to instability and memory resource issues.
    Data Type: EInt
    Default value:  0
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

workReqQFullAction  -  Work request queue full action. Possible values: 0 - block; 1 - fail. If 0 is specified and the thread pool is unable to immediately allocate a thread or a free slot in the buffer, the request will block indefinitely until a thread becomes available in the pool. If 1 is specified and the thread pool is unable to immediately allocate a thread or a free slot in the buffer, a WorkRejectedException with an error code of WorkRejectedException.WORKREQUEST_QUEUE_FULL will be thrown. The request can be retried until successful. The WorkRejectedException may be thrown any time where a thread cannot be immediately be allocated and may not reflect the size of the thread pool and buffer. The default is 0, which means block while the queue remains full.
    Data Type: EInt
    Default value:  0
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

customWorkManagerJNDIName  -  The JNDI name of the custom defined WorkManager used in support of asynchronous EJB method invocation.
    Data Type: EString
    Default value:  
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

futureTimeout  -  This is the amount of time the server retains the results of each asynchronous method call. If an application doesn't retrieve the results within the specified period of time, the server purges that method call's results to prevent memory leakage. You can specify 0 to never purge the objects, however, this is not recommended. The default value is 86400 seconds (24 hours).
    Data Type: EInt
    Default value:  86400
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

useCustomDefinedWM  -  Indicates whether the WorkManager being used in support of asynchronous EJB method invocations is a custom defined WorkManager created by the user, or the default internal WorkManager created by the EJBContainer. A value of true means that a custom defined WorkManager is used. A value of false means that the internal, default WorkManager is used. The default value is false.
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false



(C) COPYRIGHT International Business Machines Corp. 1996-2006