WAS v8.5 > Administer applications and their environment > Welcome to administering Work area > Manage the UserWorkArea partition

Manage the UserWorkArea partition

For an application to take advantage of work areas, the work area service must be enabled for both clients and servers. On a server the service is disabled by default. On the client, the service is enabled by default.

For an application to take advantage of the default partition, the UserWorkArea partition, this partition must be enabled by enabling the work area service for both clients and servers. The work area service on a server is disabled by default and the work area service on a client is enabled by default. Note that rather than using this default work area partition, a user can create their own work area partition using the Work area partition service. Applications can set maximum sizes on each work area that is sent or received. By default, the maximum size of a work area that is sent by a client and received, then possibly resent, by a server is 32,768 bytes. Maximum size that we can specify is determined by the maximum value expressible in the Java Integer data type, 2,147,483,647. The smallest maximum size that we can specify is 1. Using a maximum size of 1 byte effectively means that no requests associated with the work area can leave the system or enter another system. A value of 0 means that no limit is imposed. A value of -1 means the default value is to be honored. Default is also used if an invalid value or a malformed property is specified. We can change this size as described in this topic.

  1. Enable or disable the use of the UserWorkArea partition on a server: The work area service is disabled by default on servers but enabled by default on the client

    1. Start the dmgr console.
    2. Select Servers > Server Types > WebSphere application servers > server_name > Business Process Services > Work area service.
    3. Select or clear the Startup check box. This specifies whether or not the server should automatically start the work area service when the server starts.
    4. Save the new configuration and restart the server to apply the new configuration.

  2. Enable or disable the UserWorkArea partition on a client: Set the com.ibm.websphere.workarea.enabled property to TRUE or FALSE before starting the client. For example, to disable the work area service, when invoking the launchClient script found in the install_root/bin directory, add the following system property to the launchClient invocation:

      -CCDcom.ibm.websphere.workarea.enabled=false
    Alternatively, this property can be set in a property file used by the launchClient script. Refer to the Running a Java EE client application with launchClient article for additional information.
  3. Manage the size of the work areas that this server can send and the number of work areas that this server can accept.

    1. Start the dmgr console.
    2. Select Servers > Server Types > WebSphere application servers > server_name > Business Process Services > Web container.

      • To change the send size or receive size on the work area service (namely the "UserWorkArea" partition):

        • Select Work area service.

      • To change the send size or receive size on a user defined partition:

        • Select Work area partition service.
        • Select a partition.

    3. Enter a new value in the Maximum send size field to modify the size of the work area that this server can send, or enter a new value in the Maximum receive size field to modify the size of the work area that this server can accept.
    4. Save the new configuration and restart the server to apply the new configuration.

  4. Change the size of the work area that can be sent by a client. This step only applies to the UserWorkArea partition on the client. To set the maximum send or receive size on a user defined partition, set these values when creating the partition on the client. For more information on creating a partition on a client, see the client section in the Configuring work area partitions topic. To change the size of the work area that can be sent by a client, set the com.ibm.websphere.workarea.maxSendSize property to the desired number of bytes before starting the client. We can set the maximum send size as follows:

    • Set the maximum send size when invoking the launchClient invocation script found in the $WAS_HOME/bin directory. For example, to set the maximum size to 10,000 bytes, add the following system properties to the launchClient invocation as needed: -CCDcom.ibm.websphere.workarea.maxSendSize=10000

    • Set the maximum send size propery, com.ibm.websphere.workarea.maxSendSize, in a property file used by the launchClient script. Refer to the Running a Java EE client application with launchClient article for additional information.

    Because the UserWorkArea partition is defined as unidirectional, for example, context only propagates on outbound calls and not on the return of those calls, the maximum receive size is ignored.


Subtopics


Related concepts:

Overview of work area service
Work area partition service


Related


Develop applications that use work areas
Configure work area partitions
Run a Java EE client application with launchClient


Reference:

Work area service settings


+

Search Tips   |   Advanced Search