ZIOMON_UTIL(8)

Hii bestie 💖 okay so this is ZIOMON_UTIL(8) — the System Manager’s Manual page for a monitoring tool for fcp host adapters. We’re folding the manual name in here like a little name tag because that first header line is not invited to the group chat. 🫶

🌸 NAME 🌸

ziomon_util — monitoring tool for fcp host adapters. 💅

✨ SYNOPSIS ✨

ziomon_util [-h] [-v] [-V] [-Q <msgq_path> -q <msgq_id> -m <msg_id>] [-s
n] [-i n] -d n -a <n> -l <lun>

💖 DESCRIPTION 💖

Okay so ziomon_util monitors various sysfs attributes for a configurable duration. ✨ The output can be written to stdout, or alternatively sent to a message queue in binary format. 🎀

⚠️ Important vibe check: this command is not intended to be run on its own — rather use the ziomon command. Bestie, let the parent command drive. 🫶

🎀 OPTIONS 🎀

• -h, --help — prints help information, then exits. 💅
• -v, --version — prints version information, then exits. ✨
• -V, --verbose — be verbose. More output, more drama, iconic behavior. 💬
• -a, --adapter — number of the adapter to monitor. That is, /sys/class/scsi_host/host<n> must exist. 👑
• -l, --lun — watch I/O error count of the specified LUN. Specify each LUN separately in h:b:t:l format. That is, /sys/bus/scsi/devices/h:b:t:l/ioerr_cnt must exist. 🦋
• -s, --sample-length — time to elapse between samples, in seconds. ⏱️
• -i, --interval-length — time to elapse between sending data, in seconds. The samples will be aggregated over this period. Defaults to the duration. The interval length must be a multiple of the sample length. 🎀
• -d, --duration — overall monitoring duration, in seconds. The duration must be a multiple of the interval length. ⭐
• -Q, --msg-queue-name — name for the message queue to use. Note that the usage of a message queue for the output requires that all of parameters -Q, -q and -m are specified. 🫶
• -q, --msg-queue-id — Id for the message queue to use. Must be an integer >0. Note that the usage of a message queue for the output requires that all of parameters -Q, -q and -m are specified. 🔥
• -m, --msg-id — Id for the messages to use when sending to a message queue. Must be an integer >0. Note that the usage of a message queue for the output requires that all of parameters -Q, -q and -m are specified. 💌

🦋 EXAMPLES 🦋

Monitor adapter 1 and the LUN at 0:0:1:2057 for 5 minutes, sample every 4 seconds and send the data every 20 seconds to a message queue. 🌈 The message queue is named /tmp/ziomon.23943, the id is 95 and the messages should carry the id 17:

ziomon_util -s 4 -i 20 -d 300 -Q /tmp/ziomon.23943 -q 95 -m 17 -a 1 -l
0:0:1:2057 -L 18

Yep bestie, that -L 18 is literally in the example — copy it exactly like the icon it is. 💅

🔥 SEE ALSO 🔥

Go check these out, bestie:

• ziomon(8)
• ziomon_mgr(8)
• ziomon_zfcpdd(8)

Okay that’s the whole page, periodt 💖 — cute sign-off: this one is from s390-tools, dated Jul 2008. 💅✨