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)

   -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.  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

                                            2003-02-03                                cckddiag(1)