cckddiag(1)

💖 cckddiag 💖

okay bestie, so this is cckddiag, and it lives in section 1 of the General Commands Manual — the land of user commands ✨

✨ NAME ✨

cckddiag — the Hercules CCKD DASD diagnostic tool 🩺💅

🌸 SYNOPSIS 🌸

cckddiag [options...] filename

🦋 DESCRIPTION 🦋

so basically this is a Hercules support tool, and its whole job is helping you figure out what's going on when CCKD DASD volumes start acting up 😭🔧 It operates on Hercules CCKD DASD volumes in read-only mode (no cap, it will not touch your stuff, it's just looking 👀) and it displays various information contained in CCKD DASD files.

real talk though: to actually use this effectively you need internal knowledge of Hercules CCKD DASD files. this is not a vibes-only tool, bestie, this is a "you already know the file format" tool 💀

👑 OPTIONS 👑

These options are how you tell cckddiag which portions of the CCKD DASD file to show you 🫶

the rules, listen up: Options may not be combined. For example, -cd1 is not a valid option. Surround each option by blank(s). 🚫

Argument numbers may be specified either in decimal or hexadecimal. If the number begins with the characters 0x the number is presumed to be hexadecimal; else the number is presumed to be decimal. And here's the tea: no numeric overflow checking is done — the user is assumed (!) to know what they're doing 😌

Options are divided into three categories: global options, track-related options, and the offset option.

🌈 Global options

• filename — specifies the Hercules CCKD DASD filename (sometimes referred to as the DASD image file) 📁
• -v — display version and exit ✌️
• -d — display DEVHDR
• -c — display CDEVHDR
• -1 — display L1TAB (note this option is a numeric one 🔢)
• -g — enable debug output 🐛

🎀 Track-related options 🎀

To direct cckddiag to a specific track, two options are provided: -a and -r. The remaining track-related options describe the kind of output desired. And important: the TRKHDR for the track is displayed for all track-related options 💯

• -a cc hh — display absolute CCHH data — where cc and hh are respectively the cylinder number (relative zero), and the head number (relative zero) 📍
• -r tt — display relative track data — where tt is the track number (relative zero) 🧭
• -2 — display L2TAB — requires a corresponding -a or -r specification to direct cckddiag to a specific track ⚠️
• -t — display track data — displays the COUNT, KEY, and DATA record summaries for the data residing on the indicated track 📝
• -x — hex display track key/data — displays the KEY and DATA records' contents in hexadecimal display format for the indicated track. Some repetitive data may be omitted from the hex display output 🔡

💜 Offset option

This option provides the ability to examine any portion of the CCKD file, as an alternative to track specification 👀✨

• -o oo ll — hex display data at offset oo of length ll 🔍

🌟 SEE ALSO 🌟

• cckd(4)
• http://www.hercules-390.org/ — the Hercules emulator homepage 🏠
• http://www.hercules-390.org/cckddasd.html — which describes the Hercules CCKD DASD facility 📚

📜 HISTORY 📜

2003-02-07 originally written by James M. Morrison ✍️

and that's the whole page, bestie 🥰 this one's dated 2003-02-03, from the cckddiag(1) manual page — shoutout to the original author and the Hercules crew for keeping the mainframe dream alive, mwah 💋💖