PQ67396: WEBSPHERE SERVER REGIONS DO NOT TERMINATE WHEN STOP ISSUED TO APPLICATION SERVER UNLESS BBOO_SKIP_DESTROYJAVAENV=YES SPECIFIED

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description

PQ61089 (service level W401070) introduced the environment
variable BBOO_SKIP_DESTROYJAVAENV to bypass a call to Java
method destroyJavaEnv during server region termination which
was introduced by 
PQ59929 (service level W401046).  This
environment variable allowed the server regions to come down
and not hang when stop was issued to the application control
region.  The reason the server region appeared to hang is
there were Java threads we did not clean up during termination.
These threads are
SessionManagerServlet-InvalidationThread
com/ibm/servlet/engine/srt/http/HttpDateUpdater
com/ibm/ejs/util/am/AlarmManagerThread
.
SessionManagerServlet-InvalidationThread is removed by APARs
PQ62609/PQ63225.  This APAR (PQ67396) will clean up threads
HttpDateUpdater and AlarmManagerThread.  With these threads
cleaned up, APAR 
PQ66553 will be required to prevent an
abend0D6 from occurring in the server region during
termination after the control region has come down as a result
of the stop being issued.
.
Once this APAR is applied, you no longer require the
BBOO_SKIP_DESTROYJAVAENV environment variable.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: When the WebSphere Application Server   *
*                      is shut down, the control region comes  *
*                      down normally, but not the server       *
*                      regions.                                *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Websphere Application Server server regions do not terminate
when a stop is issued unless the environment variable
BBOO_SKIP_DESTROYJAVAENV=YES is specified for the
corresponding control region.

There is a Java user thread HttpDateUpdater that stays alive
at the server region termination time which prevents the JVM
from shutting down. The server region appears to hang.

HttpDateUpdater thread is the thread that gets the current
time. This time is then used by the utility class HttpDate to
parse/write the RFC1123 formatted date in the HTTP message
headers.
Problem conclusion
The WebSphere Application Server Web container code has been
changed to set the HttpDateUpdater thread as a Daemon thread
which does not prevent JVM from coming down.

This APAR only addresses the daemon thread HttpDateUpdater.
Server regions will stay up if there is any user thread still
running. Setting the environment variable
BBOO_SKIP_DESTROYJAVAENV to YES allows the server regions to
come down without waiting for the termination of all user
threads.

APAR PQ67396 is associated with SERVICE LEVEL W401406 of
WebSphere Application Server V4.0.1 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ67396
Reported component name WEBSPHERE OS/39
Reported component ID 5655A9800
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2002-10-18
Closed date 2002-12-10
Last modified date 2003-02-19

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
EJSJWCWC          

Fix information
Fixed component name WEBSPHERE OS/39
Fixed component ID 5655A9800

Applicable component levels
R401 PSY UQ72500    UP02/12/17 P F212

  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


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 401
Software edition:
Reference #: PQ67396
IBM Group: Software Group
Modified date: Feb 19, 2003