Hercules V4.00.0 - User Reference Guide

if parms = ""

then do

say who " arguments . . . : no arguments given"

ret = 0

end

else do

say who " arguments . . . :" parms

ret = parms

end

Say who " Hercules version :" value('version',,'SYSTEM')

Say who " RC environment . :" value('HERCULES_RC',,'ENVIRONMENT')

address hercules 'uptime'

say who " ended"

exit ret

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.