qeth_configure(8)

💖 qeth_configure(8) — the glow-up ✨

okay so bestie, welcome to qeth_configure from the s390-tools manual, section 8 (system manager's manual vibes). this little icon sets up your HiperSocket adapter or your IBM Open Systems Adapter (OSA) in QDIO mode — and yes, it does the whole persistent thing so you don't have to redo it every boot. we love a main character who remembers things. 💅

---

🌸 NAME 🌸

qeth_configure — configures or deconfigures a HiperSocket adapter or an IBM Open Systems Adapter (OSA) in QDIO mode. literally what it says on the tin, no cap.

---

✨ SYNOPSIS ✨

qeth_configure [options] read_channel write_channel data_channel online

---

🦋 DESCRIPTION 🦋

okay so here's the tea: qeth_configure exists to make it easy to persistently add and remove HiperSocket Adapters and Open System Adapters (OSAs) that are in QDIO mode. and it's not just bringing the adapter online or offline — it also creates or deletes the necessary udev rules for the adapter. so it's doing the visible work and the behind-the-scenes work. highkey iconic. 👑

---

🎀 PARAMETERS 🎀

• read_channel — the device number of the read channel of the adapter. takes the form x.y.ssss.
• write_channel — the device number of the write channel of the adapter. takes the form x.y.ssss.
• data_channel — the device number of the data channel of the adapter. takes the form x.y.ssss.

and bestie, here's what those pieces mean:

• x is always 0 until IBM creates something that uses that number. (so… don't hold your breath? 💀)
• y is the logical channel subsystem (lcss) number. most often this is 0, but it could be non-zero. she contains multitudes.
• ssss is the four digit subchannel address of the device, in hexidecimal, with leading zeros. and if you type it in upper/mixed case, it's automatically converted to lower case. she fixes your typos for you, queen.
• online — either a literal 1 to bring the adapter online or a literal 0 to take it offline. that's it. one or zero. binary slay. 🫶

---

💜 OPTIONAL PARAMETERS 💜

• -i — configure IP takeover
• -l — configure Layer 2 support
• -f — force creation of udev rules, do not check values in /sys. requires -t to be specfied (yes, that's the exact spelling from the original — she's a little quirky, we stan anyway).
• -t CARDTYPE — the type of card being configured. valid values are: qeth, hsi, or osn.
• -o "Values" — general/arbitrary QETH options, separated by spaces
• -n portnumber — QETH port number to use, 0 or 1. only needed for real, not virtual devices.
• -p portname — QETH Portname to use. only needed if sharing a real OSA with z/OS.

---

🍓 FILES 🍓

please see the documentation of chzdev. she's the one with the file lore, iykyk.

---

🌈 ENVIRONMENT 🌈

• DEBUG — if set to "yes" some minimal debugging information is output during execution. set her to "yes" and she'll tell you a little something something. 🔍

---

⭐ DIAGNOSTICS ⭐

messages and return codes are determined by the chzdev command. and if environment variable DEBUG is set to "yes," it shows the command line of the invoked chzdev, and a message for each command line option is issued on stdout. so yeah, she's chatty when you ask her to be. 💬

also not me clocking that the original has "yes," with the comma inside the quotes in this section but "yes" without it in ENVIRONMENT — fr fr keeping it exactly as written, no fixing, we don't edit the queen's text. 🙈

---

💀 BUGS 💀

gotta be some, i'm sure. if you find one, please open a bug report. (the original author said it, not me, but honestly? relatable. 😭)

---

🧚 a little sign-off 🧚

this gorgeous page comes to you from s390-tools, dated July 2013 — yes, she's been serving looks since 2013 and she's still here. periodt. 💖✨🎀