Apache HTTP Server Version 2.4
Description: | Allows the server to respond to STOP and MODIFY z/OS console commands. |
---|---|
Status: | Extension |
Module Identifier: | zos_cmds_module |
Source File: | mod_zos_cmds.c |
This module provides support for stopping and modifying the server via the z/OS operator
commands STOP
and MODIFY
, respectively. The STOP
command is an alternative to running apachectl or the IBM HTTP Server proc with ACTION=STOP
.
The STOP command will cause the IBM HTTP Server to shutdown. The default shutdown behavior is
to immediately attempt to kill all child processes even if requests are being processed. The STOP
command can do a graceful shutdown instead if
is set.ZosConsoleOptions
UseGracefulStop
mod_zos_cmds will process the inputs below when passed via the MODIFY z/OS command.
restart
apachectl -t
before issuing a restart from the MODIFY command.
graceful
graceful-stop
stats
restats
resetstats
The stats MODIFY command will print information about the IBM HTTP Server's processing threads.
The stats table is reseted under these conditions: Server start, restart, restats request, or resetstats request.
Description: | Sets some special options for the zos_cmds module. |
---|---|
Syntax: | ZosConsoleOptions Options |
Context: | server config, virtual host, directory, .htaccess |
Override: | FileInfo |
Status: | Extension |
Module: | mod_zos_cmds |
The ZosConsoleOptions
directive sets some
special options. The Options string can be any of the
following:
DisableOldStartupMessage
This suppresses older legacy messages that the server prints out during server startup and shutdown. These legacy messages do not have a message ID.
DisableNewStartupMessage
This suppresses the newer server startup and shutdown messages. These messages contain a message ID and includes more additional information than the legacy messages.
ServerID=s
This option allows you to modify the server ID that is printed
out in the new server startup and shutdown messages. The default
value for the server ID is the server's hostname if a
ServerID
is not specified.
UseGracefulStop
Issuing a z/OS STOP command will cause the server to abruptly stop by default. This option allows the server to perform a graceful shutdown instead when a STOP command is received.