.TH CHSHUT 8 "July 2010" "s390-tools"

.SH NAME
chshut \- change the shutdown actions for Linux on System z

.SH SYNOPSIS
\fBchshut\fR [halt | poff | reboot] [ipl | reipl | stop | vmcmd] [VM Command]

.SH DESCRIPTION
\fBchshut\fR is a tool that can be used to configure the Linux on System z
shutdown actions.

The tool handles up to three parameters. The first specifies
the shutdown trigger. A shutdown trigger is an event that will stop Linux.
The following shutdown triggers are supported: "halt", "power off" and
"reboot". There exists a fourth shutdown trigger "panic" which is controlled
by the
.BR dumpconf (8)
service script.

The second  argument specifies the shutdown action that you want to execute
in case of the specified trigger. Valid action arguments are "ipl", "reipl",
"stop" and "vmcmd".

In case you have chosen "vmcmd" as action a third parameter is used for the
CP command you want to execute under z/VM.

.B Note:
VM CP commands, device addresses, and guest names must be uppercase.

.SH OPTIONS
.TP
\fB-h\fR or \fB--help\fR
Print help information, then exit.

.TP
\fB-v\fR or \fB--version\fR
Print version information, then exit.

.SH EXAMPLES
Log off the z/VM guest if the Linux
.BR poweroff (8)
command was executed successfully:

\fB# chshut poff vmcmd LOGOFF\fR

If the system is halted it should start again:

\fB# chshut halt ipl\fR

If the Linux
.BR poweroff (8)
command is executed, send a message to guest MASTER and automatically log off
the guest:

\fB# chshut poff vmcmd "MSG MASTER Going down" vmcmd "LOGOFF"\fR

.SH NOTES

For most Linux distributions, "halt" is mapped by default to "power off".
In this case you have to use the shutdown trigger "poff" instead of "halt".

.SH SEE ALSO
.BR dumpconf (8)
.BR lsshut (8)