CHSHUT(8)

💅 CHSHUT — like, the chshut page from section 8 of the System Manager's Manual, bestie 🎀

okay so picture this: you're on Linux on System z and you need to tell the machine what to do when it goes down. that's the whole gig. iconic, honestly.

---

✨ NAME ✨

chshut — change the shutdown actions for Linux on System z 🦋

---

🌸 SYNOPSIS 🌸

chshut TRIGGER ACTION [VM Command]

---

💖 DESCRIPTION 💖

Use chshut to configure the Linux on System z shutdown actions. that's the vibe. that's the assignment. ✨

The tool handles up to three parameters. so, like, three is the max, don't come at it with four. 🙈

The first parameter specifies the shutdown trigger. and a shutdown trigger? it's an event that will stop Linux. the following shutdown triggers are supported: "halt", "poff", and "reboot". there are two other shutdown triggers, "panic" and "restart", but those two are controlled by the dumpconf(8) service script — so not your girl's department, iykyk. 💅

The second parameter specifies the shutdown action that you want to run if the specified trigger occurs. valid action arguments are "ipl", "reipl", "stop", and "vmcmd". pick your fighter. 👑

If you have chosen "vmcmd" as action, a third parameter is required for the CP command you want to execute under z/VM. no third param, no party. 🎉

Note: VM CP commands, device addresses, and guest names must be uppercase. not shouting, just CP rules. LOWERCASE WILL NOT SLAP. 🫶

---

💅 OPTIONS 💅

• -h, --help — print help information, then exit. your little "what does this do again" safety net 🧚
• -v, --version — print version information, then exit. main character version-check energy ⭐

---

🔥 EXAMPLES 🔥

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

# chshut poff vmcmd LOGOFF

If the system is halted it should start again:

# chshut halt ipl

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

# chshut poff vmcmd "MSG MASTER Going down" vmcmd "LOGOFF"

---

🦋 NOTES 🦋

For most Linux distributions, "halt" is mapped by default to "power off". which means — plot twist — in this case you have to use the shutdown trigger "poff" instead of "halt". yes, really. no cap. 😭

---

🌈 SEE ALSO 🌈

dumpconf(8) lsshut(8) — go read those too, they're giving lore 📚

---

and that's the page!! shipped from s390-tools, dated Sept 2011, page CHSHUT(8) — oldie but a goodie, and she still ate 💜🎀✨