Work manager settings

Work manager settings

Use this page to modify work manager settings. Work managers contain a pool of threads bound into Java Naming and Directory Interface.
To view this console page, click Resources > Asynchronous beans > Work managers > workmanager_name.

Related concepts

Application profiling
Internationalization service
Java Authentication and Authorization Service

Related tasks

Configure work managers

Scope

Scope of the configured resource. This value indicates the location for the configuration file.

Name
Name by which the work manager is known for administrative purposes.

JNDI Name

Specify the JNDI name used to look up the work manager in the namespace.

Description

Specify the description of this work manager for administrative purposes.

Category

Specify a string used to to classify or group this work manager.

Work timeout
Number of milliseconds to wait before a scheduled work object is released. If not specified, the timeout is disabled.

Default 0

Work request queue size

Size of the work request queue. The work request queue is a buffer that holds scheduled work objects and may be any value 1 or greater. The thread pool pulls work from this queue. If you do not specify a value or the value is 0, the queue size is managed automatically. Large values can consume significant system resources.

Default 0

Work request queue full action

Specify the action taken when the thread pool is exhausted, and the work request queue is full. This action starts when you submit non-daemon work to the work manager.
If set to FAIL, the work manager API methods creates an exception instead of blocking.

Default BLOCK
Range FAIL

Service names

Specify a list of services to make available to this work manager.
Asynchronous beans can inherit J2EE context information by enabling one or more J2EE service contexts on the work manager resource in the WebSphere console or by setting the serviceNames attribute of the WorkManagerInfo configuration object. When specifying the serviceNames attribute each enabled service should be separated by a semicolon. For example: security;UserWorkArea;com.ibm.ws.i18n. When a J2EE service context is enabled, it propagates the context from the scheduling thread to the target thread. If not enabled, the target thread does not inherit the context of the scheduling thread and a default context is applied. Any related J2EE context that is already present on the thread is suspended before any new J2EE context is applied.
The context information of each selected service is propagated to each work or alarm that is created using this work manager. Selecting services that are not needed can negatively impact performance.

Application profile (deprecated) Use the console or the AppProfileService service name to enable the application profile tasks. Application profile context is not supported and not available for J2EE 1.4 applications. For J2EE 1.3 applications, the application profile context is deprecated and is only available when Application Profile Service 5.x Compatibility Mode is enabled and both the scheduling thread and target thread are J2EE 1.3 applications. When enabled, all application profile tasks that are available on the scheduling thread are available on the target thread. The scheduled work that runs in a J2EE 1.4 application does not get the application profiling task of the scheduling thread. This feature is optional.
Work area Use the console or the UserWorkArea service name to enable work area partitions. When enabled, the work area context for every work area partition that exists on the scheduling thread is available on the target thread. This feature is optional.
Security Use the console or the security service name to enable the JAAS subject. When this feature and administrative security are enabled, the JAAS subject that is present on the scheduling thread is applied to the target thread. If not enabled, the target thread is run anonymously without a JAAS subject on the thread. This feature is optional.
Internationalization Use the console or the com.ibm.ws.i18n service name to enable the internationalization context information. When the internationalization context and the Internationalization service is enabled, the internationalization context that exists on the scheduling thread is available on the target thread. This feature is optional.

Thread pool properties

Priority of the threads available in this work manager.

Number of alarm threads Specifies the desired maximum number of threads used for alarms. The default value is 2.
Minimum number of threads Specifies the minimum number of threads available in this work manager.
Maximum number of threads Specifies the maximum number of threads available in this work manager.
Thread priority Priority of the threads available in this work manager.
Growable Specifies whether the number of threads in this work manager can be increased.

Application profile (deprecated)	Use the console or the AppProfileService service name to enable the application profile tasks. Application profile context is not supported and not available for J2EE 1.4 applications. For J2EE 1.3 applications, the application profile context is deprecated and is only available when Application Profile Service 5.x Compatibility Mode is enabled and both the scheduling thread and target thread are J2EE 1.3 applications. When enabled, all application profile tasks that are available on the scheduling thread are available on the target thread. The scheduled work that runs in a J2EE 1.4 application does not get the application profiling task of the scheduling thread. This feature is optional.
Work area	Use the console or the UserWorkArea service name to enable work area partitions. When enabled, the work area context for every work area partition that exists on the scheduling thread is available on the target thread. This feature is optional.
Security	Use the console or the security service name to enable the JAAS subject. When this feature and administrative security are enabled, the JAAS subject that is present on the scheduling thread is applied to the target thread. If not enabled, the target thread is run anonymously without a JAAS subject on the thread. This feature is optional.
Internationalization	Use the console or the com.ibm.ws.i18n service name to enable the internationalization context information. When the internationalization context and the Internationalization service is enabled, the internationalization context that exists on the scheduling thread is available on the target thread. This feature is optional.

Number of alarm threads	Specifies the desired maximum number of threads used for alarms. The default value is 2.
Minimum number of threads	Specifies the minimum number of threads available in this work manager.
Maximum number of threads	Specifies the maximum number of threads available in this work manager.
Thread priority	Priority of the threads available in this work manager.
Growable	Specifies whether the number of threads in this work manager can be increased.