Before you begin
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.
About this task
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
- 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
- Start the administrative console.
- Select .
- 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.
- Save the new configuration and restart the server to apply
the new configuration.
![[AIX Solaris HP-UX Linux Windows]](../../images/dist.gif)
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 that is used by the launchClient
script. Refer to the Running a Java EE client application with launchClient
article for additional information.
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 app_server_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 that is used by the launchClient
script. Refer to the Running a Java EE client application with launchClient
article for additional information.
- Manage the size of the work areas that this server can send and
the number of work areas that this server can accept.
- Start the administrative console.
- Select .
- 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, you must
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. 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. 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.