PI68001: ADD ABILITY FOR THE MVS STOP COMMAND TO DO A GRACEFUL SHUTDOWN OF THE SERVER

Fixes are available

APAR status

Closed as program error.

Error description

The MVS STOP command (using  mod_zos_cmds) causes the server to
immediately stop and any requests in progress are terminated,
and no further requests are served.  This need to be enhanced
to allow the server to do a graceful stop, so that the server
monitors threads handling requests. Once all the threads have
finalized and exited or the timeout specified by the
GracefulShutdownTimeout has been reached, the server will shut
down.

Local fix

Stop the server using this command:
S server_name,ACTION='graceful-stop'

Problem summary

****************************************************************
* USERS AFFECTED:  Users of IBM HTTP Server (powered by        *
*                  Apache) on z/OS.                            *
****************************************************************
* PROBLEM DESCRIPTION: The MVS STOP command causes the server  *
*                      to immediately stop and any requests    *
*                      in progress are terminated.             *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Issuing an MVS STOP command causes the server to abruptly stop
instead of gracefully shutting down. The option
'UseGracefulStop' was added to ZosConsoleOptions to enable a
graceful shutdown when a STOP command is received.

Problem conclusion

IBM HTTP Server (powered by Apache) on z/OS now supports
graceful shutdown. This behavior can be enabled by adding the
following directive to the server's configuration file in global
scope:

  ZosConsoleOptions UseGracefulStop

This fix is targeted for IBM HTTP Server fix packs:
 - 7.0.0.43
 - 8.0.0.13
 - 8.5.5.11
 - 9.0.0.2

Temporary fix

Comments

APAR Information

APAR number
PI68001
Reported component name
WAS IHS ZOS
Reported component ID
5655I3510
Reported release
850
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-08-23
Closed date
2016-08-27
Last modified date
2016-10-04

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

Fix information

Fixed component name
WAS IHS ZOS
Fixed component ID
5655I3510

Applicable component levels

R800 PSY
UP
R850 PSY
UP
R90P PSY
UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.5","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
04 May 2022

Tips

PI68001: ADD ABILITY FOR THE MVS STOP COMMAND TO DO A GRACEFUL SHUTDOWN OF THE SERVER

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Fix information

Fixed component name

Fixed component ID

Applicable component levels

R800 PSY

R850 PSY

R90P PSY

Document Information

Share your feedback

Need support?