USYSATTN(8)

💅 USYSATTN(8) — like, the system attention & fault indicator manual, bestie

okay so real talk, this is the page for usysattn and usysfault from the PowerLinux Service Tools section 8 of the manual — yes, section 8, the big-girl system administration section, we love her 👑

---

✨ NAME ✨

usysattn, usysfault — the twin utilities that operate your system attention and fault indicators 🚨💡

🌸 SYNOPSIS 🌸

/usr/sbin/usysattn [-P] [-l <location_code> [-s normal] [-t]] [-V] [-h]
/usr/sbin/usysfault [-P] [-l <location_code> [-s normal] [-t]] [-V] [-h]

literally the same flags for both, they're matching besties, it's giving coordinating outfits 🫶

💖 DESCRIPTION 💖

okay so picture this: usysattn is the utility you use to view and manipulate the system attention and fault indicators (LEDs) on IBM Power Systems servers. yes, actual lights. physical LEDs. on a server. iconic honestly 🔥

here's the little detail that matters: the first location code displayed by usysattn is the system attention indicator, and the rest of the location codes are fault indicators. so don't get it twisted — first one is the main character, the rest are the supporting cast 💅

these indicators turn on automatically when a serviceable event is received. the system is literally waving at you like "bestie. something's up. look at me." 🙈 and these identifiers are specified by location code.

when you run it with no arguments, usysattn will print a list of all the fault indicators on the system along with their current status (on or off) — a full vibe check on every light in the house ✨

the -l option lets you point at a specific indicator. if -l is the only argument, the status of that indicator gets printed. and if you pair -s normal with the -l argument, the indicator gets turned off 🫶

⚠️ NOTE, and this one is important, like please actually read it: make sure there are no outstanding service actions to be taken on this system before you turn off the system attention indicator. do NOT just go switching the light off because it's annoying you 😭 that light is not the problem, the light is the messenger. periodt.

---

🎀 OPTIONS 🎀

• -l location_code — specify the location code of the indicator you wanna mess with 📍
• -s normal — must be used with the -l option; it turns the specified indicator off. yes, the value is literally the word normal, don't ask, just type it 🌸
• -t — truncate the location code if necessary. and ooh this one's kind of clever: if an indicator is not available at the specified location, this option will continuously trim the last clause off of the location code in an attempt to find an indicator near the device. it's like it keeps shortening the address until somebody answers the door 🚪✨
• -P — limit the operations to only the platform indicators, excluding the enclosures. platform girlies only, no enclosures invited 💅
• -V — display the version of the command and exit. cute, quick, done 🦋
• -h — print the usage message and exit. the classic cry for help 🙈

---

🌈 SEE ALSO 🌈

lp_diag(8), usysident(8) — go read those too, they're in the group chat 👑

---

💀 reminder bestie: that NOTE in the description? the one about outstanding service actions? that's the whole plot. do the service work first, then turn off the attention indicator. iykyk.

okay that's the whole page, no cap, every flag accounted for 🧚💜

— brought to you by the Linux gang, Mar 2019 vintage, PowerLinux Service Tools era, USYSATTN(8) signing off ⭐🎀