cckddiag(1) General Commands Manual cckddiag(1)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 exam-
ple, -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 out-
put 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)
Check Out this Related Man Page
CDDB::File(3pm) User Contributed Perl Documentation CDDB::File(3pm)NAME
CDDB::File - Parse a CDDB/freedb data file
SYNOPSIS
my $disc = CDDB::File->new("rock/f4109511");
print $disc->id, $disc->all_ids;
print $disc->artist, $disc->title;
print $disc->year, $disc->genre, $disc->extd;
print $disc->length, $disc->track_count;
print $disc->revision, $disc->submitted_via, $disc->processed_by;
foreach my $track ($disc->tracks) {
print $track->number, $track->title, $track->artist;
print $track->length, $track->extd;
}
DESCRIPTION
This module provides an interface for extracting data from CDDB-format data files, as used by freedb.
It does not read data from your CD, or submit information to freedb.
METHODS
new
my $disc = CDDB::File->new("rock/f4109511");
This will create a new object representing the data in the file name specified.
id / all_ids
my $discid = $disc->id;
my @discid = $disc->all_ids;
Due to how freedb works, one CD may have several IDs associated with it. 'id' will return the first of these (not necessarily related to
the filename from which this was read), whilst 'all_ids' will return all of them.
title / artist
The title and artist of this CD. For eponymous CDs these will be identical, even if the data file leaves the artist field blank.
year
The (4-digit) year of release.
genre
The genre of this CD. This is the genre as stored in the data file itself, which is not related to the 11 main freedb genres.
extd
The "extended data" for the CD. This is used for storing miscellaneous information which has no better storage place, and can be of any
length.
length
The run time of the CD in seconds.
track_count
The number of tracks on the CD.
revision
Each time information regarding the CD is updated this revision number is incremented. This returns the revision number of this version.
processed_by / submitted_via
The software which submitted this information to freedb and which processed it at the other end.
tracks
foreach my $track ($disc->tracks) {
print $track->number, $track->title, $track->artist;
print $track->length, $track->extd;
}
Returns a list of Track objects, each of which knows its number (numering from 1), title, length (in seconds), offset, and may also have
extended track data.
Tracks may also contain an 'artist' field. If this is not set the artist method will return the artist of the CD.
SEE ALSO
http://www.freedb.org/
AUTHOR
Tony Bowden
BUGS and QUERIES
Please direct all correspondence regarding this module to:
bug-CDDB-File@rt.cpan.org
COPYRIGHT
Copyright (C) 2001-2005 Tony Bowden. All rights reserved.
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License; either version 2 of the License,
or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.
perl v5.10.1 2005-10-04 CDDB::File(3pm)