8.164 SSD (Signal shutdown)

8.164.1 Function

The SSD (signal shutdown) command signals an imminent hypervisor shutdown to the guest. Guests who
support this are supposed to perform a shutdown upon receiving this request.

An implicit ssd command is given on a hercules QUIT or EXIT command if the guest supports SSD. In
that case Hercules shutdown will be delayed until the guest has shutdown.

The SSD command acts different depending on how Hercules was built. If Hercules was not built with
option 'OPTION_SHUTDOWN_CONFIRMATION' (#UNDEF in file feature.h) then the command acts as
described above.

If Hercules however was built with option “OPTION_SHUTDOWN_CONFIRMATION” then a special pro-
cessing for SSD takes place.

If SSD is entered and the command level is not set to 'developer', 'debug' or 'all' then SSD first issues
message HHC02266A that prompts for confirmation by entering a second SSD command within a certain
time period (default 10 seconds) to signal the hypervisor shutdown. If the time period has expired then the
process starts over. This is to prevent an inadvertent shutdown of a running guest OS.

The time period for the second SSD command can be set to another value by using the 'QUITMOUT'
console command or configuration statement.

If the command level is set to 'developer', 'debug' or 'all' then SSD immediately signals the hypervisor
shutdown. 'SSD FORCE' also performs an immediate signal shutdown without any further checks.

8.164.2 Syntax

Descriptive

[]

Diagram

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



8.164.3 Parameter

FORCE

Perform the signal shutdown immediately.

8.164.4 Examples

Example 1:

Signal an imminent hypervisor shutdown to the guest operating system.

HHC00013I Herc command: 'ssd'

HHC02266A Confirm command by entering 'ssd' again within 10 seconds

HHC00013I Herc command: 'ssd'

Figure 297: SSD command

Example 2:

Signal an immediate imminent hypervisor shutdown to the guest operating system.

HHC00013I Herc command: 'ssd force'

Figure 298: SSD FORCE command

Previous Page Next Page