8.61 EXIT (Terminate the emulator)

8.61.1 Function

The EXIT command (see also the QUIT command) initiates the Hercules shutdown. It terminates all
threads, detaches all channels and devices and releases the configuration. Finally it terminates the
emulator. If the guest OS has enabled “Signal Shutdown” then a signal shutdown request is sent to the
guest OS and termination will begin after the guest OS has shutdown.

The EXIT command acts different depending on how Hercules was built. If Hercules was not compiled
with the option 'OPTION_SHUTDOWN_CONFIRMATION' then the command acts as described above.

If Hercules however was built with option 'OPTION_SHUTDOWN_CONFIRMATION' then the following
special processing for terminating the emulator takes place.

If EXIT is entered and the command level is not set to 'developer', 'debug' or 'all' then EXIT will first check
that all online CPUs are stopped. If any CPU is not in the stopped state message HHC00069I is displayed
indicating the number of CPUs still running.

Message HHC02266A follows that prompts for confirmation by entering a second EXIT command within a
certain time period (default 10 seconds) to start termination of the emulator. If the time period has expired
then the process starts over. This is to prevent an inadvertent shutdown of Hercules while still a guest OS
is running.

The time period for the second EXIT command can be set to another value by using the 'QUITMOUT'
console command or system parameter.

If all processors are stopped or the command level is set to "developer", "debug" or "all" then quit stops
Hercules immediately. 'EXIT FORCE' will also terminate the emulator immediately without any further
checks.

8.61.2 Syntax

Descriptive

[]

Diagram

Êʬ¬¬ ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ



8.61.3 Parameter

FORCE

Terminate the emulator immediately.

8.61.4 Examples

Example 1:

Initiate the Hercules shutdown.

HHC00013I Herc command: 'exit'

HHC00069I Guest is not quiesced; there are 8 CPUs active

HHC02266A Reenter command 'exit' again within 10 seconds to execute

HHC00013I Herc command: 'exit'

HHC01420I Begin Hercules shutdown

HHC01421I Releasing configuration

.

several lines not displayed

.

HHC01422I Configuration release complete

HHC01423I Calling termination routines

.

several lines not displayed

.

HHC02103I Logger: logger thread terminating

HHC01412I Hercules terminated

Figure 125: EXIT command

Example 2:

Initiate an immediate Hercules shutdown.

HHC00013I Herc command: 'exit force'

HHC01420I Begin Hercules shutdown

HHC01421I Releasing configuration

.

several lines not displayed

.

HHC01422I Configuration release complete

HHC01423I Calling termination routines

.

several lines not displayed

.

HHC02103I Logger: logger thread terminating

HHC01412I Hercules terminated

Figure 126: EXIT FORCE command

Previous Page Next Page