1cckddiag(1)                 General Commands Manual                cckddiag(1)
2
3
4

NAME

6       cckddiag - Hercules CCKD DASD diagnostic tool
7
8

SYNOPSIS

10       cckddiag [options...] filename
11
12

DESCRIPTION

14       Hercules  support  tool  used  to  assist in the diagnosis of CCKD DASD
15       problems.  Operates on Hercules CCKD DASD volumes  in  read-only  mode,
16       and  displays various information contained in CCKD DASD files.  Effec‐
17       tive usage requires internal knowledge of Hercules CCKD DASD files.
18
19

OPTIONS

21       The following options are used to specify which portions  of  the  CCKD
22       DASD  file are to be displayed.  Options may not be combined; for exam‐
23       ple, -cd1 is not a valid option.  Surround each option by blank(s).
24
25       Argument numbers may be specified either in decimal or hexadecimal.  If
26       the  number  begins with the characters 0x the number is presumed to be
27       hexadecimal; else the number is presumed to  be  decimal.   No  numeric
28       overflow checking is done, the user is assumed (!) to know what they're
29       doing.
30
31       Options are divided  into  three  categories:  global  options,  track-
32       related options, and the offset option.
33
34

Global options

36   filename
37       specifies the Hercules CCKD DASD filename (sometimes referred to as the
38       DASD image file)
39
40   -v
41       display version and exit
42
43   -d
44       display DEVHDR
45
46   -c
47       display CDEVHDR
48
49   -1
50       display L1TAB  (note this option is a numeric one)
51
52   -g
53       enable debug output
54
55

57       To direct cckddiag to a specific track, two options  are  provided:  -a
58       and  -r.  The remaining track-related options describe the kind of out‐
59       put desired.  The TRKHDR for the track  is  displayed  for  all  track-
60       related options.
61
62   -a cc hh
63       display  absolute  CCHH  data  -  where  cc and hh are respectively the
64       cylinder number (relative zero), and the head number (relative zero).
65
66   -r tt
67       display relative track data - where tt is the  track  number  (relative
68       zero).
69
70   -2
71       display  L2TAB  -  requires  a  corresponding -a or -r specification to
72       direct cckddiag to a specific track.
73
74   -t
75       display track data - displays the COUNT, KEY, and DATA record summaries
76       for the data residing on the indicated track.
77
78   -x
79       hex  display  track  key/data - displays the KEY and DATA records' con‐
80       tents in hexadecimal display format  for  the  indicated  track.   Some
81       repetitive data may be omitted from the hex display output.
82
83

Offset option

85       This  option  provides  the  ability to examine any portion of the CCKD
86       file, as an alternative to track specification.
87
88   -o oo ll
89       hex display data at offset oo of length ll.
90
91

SEE ALSO

93       cckd(4)
94
95       http://www.hercules-390.org/ the Hercules emulator homepage.
96
97       http://www.hercules-390.org/cckddasd.html which describes
98              the Hercules CCKD DASD facility.
99
100

HISTORY

102       2003-02-07 originally written by James M. Morrison
103
104
105
106
107
108
109                                  2003-02-03                       cckddiag(1)
Impressum