PQ94457: FEDERATION OF APP SERVER INTO DEPLOYMENT MANAGER CELL CREATES A N JAVA.LANG.OUTOFMEMORY ERROR REQUIRING HEAP SIZE TO INCREASE.

 A fix is available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
Customer is getting a java.lang.outofmemory when he tries to
federate the Websphere Application Server into the Deployment
Manager cell.
Customer gets the following error:
 ADMU0111E: Program exiting with error: java.lang.OutOfMemoryErr
 ADMU0211I: Error details may be seen in the file:
            /wasv5config/p1cell/AppServerNode3/logs/addNode.log
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V5.0 for z/OS                                *
****************************************************************
* PROBLEM DESCRIPTION: When running addNode.sh with            *
*                      the -includeapps option, an             *
*                      OutofMemoryError may occur.             *
*                      ADMU0111E: Program exiting with error:  *
*                      java.lang.OutOfMemoryError              *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
When running addNode.sh with the -includeapps option,
an OutOfMemoryError  may occur.  This is caused by the size
and/or number of applications in the Base application server
being federated. The error is:

ADMU0111E: Program exiting with error:
java.lang.OutOfMemoryError
Problem conclusion
The addNode.sh operation used the default JVM Heapsize for its
operations.   In some cases, this may not be large enough to
complete the operation successfully.   The addNode.sh was
updated to now use a larger JVM heapsize(-Xms64m -Xmx256m)
similiar to other scripts.
If a larger JVM heapsize is required, a documentation update
is added to describe how to increase the JVM heapsize.

APAR PQ94457 requires a  change to the WebSphere Application
Server Information Center. To access the latest online
documentation, go to the product library page at:

www.ibm.com/software/webservers/appserv/zos_os390/library/

The following note will be added to the V5.0 and V5.1 Informatio
Centers' article "addNode command"at the end of the description
of the -includeapps parameter:

Note:  When the -includeapps parameter is specified,
an OutOfMemoryError might occur if the Java Virtual Machine
heap size isn't large enough. When this error occurs, the
following error message is issued:

ADMU0111E: Program exiting with error:
java.lang.OutOfMemoryError

This error can occur when large applications are processed, or
when there are a large number of applications in the
Base Application Server.

To recover from this error and successfully federate the
Base Application Server, you must:
1.  Issue the cleanupNode.sh command on your deployment manager
      server. See "cleanupNode command" for more information
      about this command.
2.  Increase the JVM heap size for the addNode script. When you
      issue the addNode.sh command, the JVM heap size is set
      to -Xms64m -Xmx256m.  To increase these values, edit
      the JVM_EXTRA_CMD_ARGS variable in the
      <config_root>/bin/setupCmdLine.sh file of the
      Base Application Server being federated. For example, you
      might specify the following (all on one line):

   JVM_EXTRA_CMD_ARGS= -Djava.security.properties=$WAS_HOME/
        java/jre/lib/security/java.security -Xms64m -Xmx512m

    Make sure the Unix System Services process issuing the
    addNode.sh has adequate size to support the heapsize
    values being used.  Otherwise, an OutOfMemoryError may
    occur when the address space size is exhausted.

3. Reissue the addNode.sh command.

APAR PQ94457 is associated with SERVICE LEVEL W502018 of
WebSphere Application Server V5.0 for z/OS.
Temporary fix Comments
APAR information
APAR number PQ94457
Reported component name WEBSPHERE FOR Z
Reported component ID 5655I3500
Reported release 500
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention NoSpecatt
Submitted date 2004-09-20
Closed date 2004-11-12
Last modified date 2004-12-02

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:
PQ97859

Modules/Macros
BBOUBINF          

Publications Referenced

Fix information
Fixed component name WEBSPHERE FOR Z
Fixed component ID 5655I3500

Applicable component levels
R500 PSY UQ95030    UP04/11/18 P F411

  Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.


Document Information


Current web document: swg1PQ94457.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 500
Software edition:
Reference #: PQ94457
IBM Group: Software Group
Modified date: Dec 2, 2004