Manage the size of work areas

Manage the size of work areas

Overview

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. The maximum size that you can specify is determined by the maximum value expressible in the Java Integer data type, 2,147,483,647. The smallest maximum size that you 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 that the default value is to be honored. The default value is also used if an invalid value or a malformed property is specified. You can change this size as described in this topic.

Procedure

Change the size of the work area that can be sent or received by a server:

Start the console.

Select Servers > Application servers >server > Business Process Services .

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.

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.

Save the new configuration and restart the server to apply the new configuration.

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 Configure work area partitions. 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. You 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 that is used by the launchClient script. See "Running application clients" for additional information.

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

Work area service settings