NAME¶
cckddiag - Hercules CCKD DASD diagnostic tool
SYNOPSIS¶
cckddiag [options...]
filename
DESCRIPTION¶
Hercules support tool used to assist in the diagnosis of CCKD DASD problems.
Operates on Hercules CCKD DASD volumes in read-only mode, and displays various
information contained in CCKD DASD files. Effective usage requires internal
knowledge of Hercules CCKD DASD files.
OPTIONS¶
The following options are used to specify which portions of the CCKD DASD file
are to be displayed. 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. 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)
display version and exit
display DEVHDR
display CDEVHDR
display L1TAB (note this option is a numeric one)
enable debug output
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. 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).
display L2TAB - requires a corresponding -a or -r specification to direct
cckddiag to a specific track.
display track data - displays the COUNT, KEY, and DATA record summaries for the
data residing on the indicated track.
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