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)