<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.0//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD><TITLE>
Hercules Version 3: System Messages: CU - CCKD Utilities</TITLE>
<LINK REL=STYLESHEET TYPE="text/css" HREF="hercules.css">
</HEAD>
<BODY BGCOLOR="#ffffcc" TEXT="#000000" LINK="#0000A0"
VLINK="#008040" ALINK="#000000">
<h1>Hercules Version 3: System Messages: CU - CCKD Utilities</h1>
<p>
Messages issued by the cckd utility commands (cckdcdsk, cckdcomp and
cckdswap) and cckd utility functions (cckd_chkdsk, cckd_comp and
cckd_swap) are described here. The utility functions are called by
both the <a href="cckddasd.html#utilities">utility</a> commands and
Hercules.
<h3>Messages</h3>
<p>
Messages are in the format
<br>
<b>HHCCU</b><i>nnn</i><b>t</b> <i>file</i> message text
<br>
where <i>nnn</i> is the message number, <i>t</i> is either <b>I</b>,
<b>W</b> or <b>E</b>, depending on the severity of the message.
<i>file</i> will either be the part of the file name following the last
slash (<b>/</b> or <b>\</b>) when called by a utility command, or
will be <i>xxxx</i>: file[<i>n</i>] where <i>xxxx</i> is the device
number and <i>n</i> is the shadow file number when called by Hercules.
<p>
The <i>file</i> portion of the message is omitted below for brevity.
<p><center><hr width="15%" noshade></center>
<p>
<dl class="messages">
<dt><code><a name="HHCCU101I">
HHCCU101I converting to <em>endian-format</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The file is in the wrong endian (byte order) format for the
host architecture. The file is being converted to the host
endian format <em>endian-format</em>.
<dt><b>Issued by</b>
<dd>cckdutil.c functions cckd_comp and cckd_chkdsk
</dl>
<dt><code><a name="HHCCU102I">
HHCCU102I compress successful, <em>n</em> bytes released
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The compress function successfully completed and free <em>n</em>
bytes from the file. If <em>n</em> is 0, then the level 2 tables
were repositioned to the beginning of the file in order.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU103I">
HHCCU103I file already compressed
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The compress function determined that the file is already compressed.
The file is not updated.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU104I">
HHCCU104I free space rebuilt
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Free space errors were detected and free space has been successfully rebuilt
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_chkdsk
</dl>
<dt><code><a name="HHCCU300I">
HHCCU300I <em>number</em> <em>space</em> images recovered
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Recovery phase 1 completed, recovering <em>number</em> <em>spaces</em> (<b>trk</b>s or <b>blkgrp</b>s)
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU301I">
HHCCU301I <em>space</em>[<em>id</em>] recovered offset <em>offset</em> len <em>length</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The space <em>space</em> (<b>trk</b> or <b>blkgrp</b>) was recovered at offset <em>offset</em>
and length <em>length</em>.
<em>id</em> is the trk or blkgrp number.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU500W">
HHCCU500W recovery not completed, file opened read-only
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Phase 3 recovery did not complete because the file is not opened for write
<dt><b>Action</b>
<dd>Omit the <b>-ro</b> option for cckdcdsk, or change the file
permissions to enable the file to be opened for read-write for Hercules
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU501W">
HHCCU501W recovery not completed, missing compression
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Phase 3 recovery did not complete because one or more trk or blkgrp images
were compressed using a compression (<b>zlib</b> or <b>bzip2</b>) that was
not built into Hercules
<dt><b>Action</b>
<dd>Processing terminates. The file has not been updated.
Build Hercules with the missing compression libraries.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU502W">
HHCCU502W free space not rebuilt, file opened read-only
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Free space errors were detected but the free space was not rebuilt
because the file is not opened for write
<dt><b>Action</b>
<dd>Omit the <b>-ro</b> option for cckdcdsk, or change the file
permissions to enable the file to be opened for read-write for Hercules
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU600W">
HHCCU600W forcing check level <em>level</em>[; <em>reason</em>]
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Errors have been detected in the compressed file that warrant the
escalation of the check level to <em>level</em>. An additional
explanation <em>reason</em> may be supplied.
<dt><b>Action</b>
<dd>At a minimum, free space will be rebuilt
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU601W">
HHCCU601W cdevhdr inconsistencies found code=<em>code</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The space statistics in the cckddasd device header (cdevhdr) contain
inconsistencies described by <em>code</em>. <em>code</em> is a
16-bit bit field and more than one bit may be on. See cckdutil.c for
the different bit settings.
<dt><b>Action</b>
<dd>At a minimum, free space will be rebuilt
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
%s offset 0x%" I32_FMT "x len %d is out of bounds
<dt><code><a name="HHCCU602W">
HHCCU602W <em>space</em> offset <em>offset</em> len <em>length</em> is out of bounds
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The space <em>space</em> (trk, blkgrp or l2) either precedes the
end of the L1 table (at the beginning of the file) or exceeds the
end of the file
<dt><b>Action</b>
<dd>The space will be recovered. If the space is an L2 table, then all
tracks or block groups associated with the table will also be recovered.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU603W">
HHCCU603W <em>space1</em> offset <em>offset1</em> len <em>length</em>
overlaps <em>space2</em> offset <em>offset2</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The space <em>space1</em> overlaps space <em>space2</em>.
<dt><b>Action</b>
<dd>The spaces will be recovered. If either space is an L2 table, then all
tracks or block groups associated with that table will also be recovered.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU604W">
HHCCU604W <em>space</em> l2 inconsistency: len <em>length</em>, size <em>size</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The space <em>space</em> (trk or blkgrp) has an inconsistent l2 entry.
Either the length <em>length</em> is too small or is too large or exceeds
the size <em>size</em>
<dt><b>Action</b>
<dd>The space will be recovered.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU610W">
HHCCU610W free space errors detected
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Free space is not consistent
<dt><b>Action</b>
<dd>Free space will be rebuilt
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU620W">
HHCCU620W <em>space</em>[<em>id</em>] hdr error offset <em>offset</em>: <em>xxxxxxxxxx</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>A header error was found for <em>space</em> (<b>trk</b> or <b>blkgrp</b>) during validation.
<em>id</em> is the trk or blkgrp number. The header is located at file offset <em>offset</em>.
The contents of the 5 byte header is <em>xxxxxxxxxx</em> in hex.
<p>
The first byte of the header should be either <b>00</b> (compress none),
<b>01</b> (compress zlib) or <b>02</b> (compress bzip2).<br>
For ckd, the next two bytes is the cylinder (in big-endian byte order) and the two
bytes after that is the head (also in big-endian byte order).<br>
For fba, the next four bytes is the block group number (in big-endian byte order).
<p>
The header contains an invalid value. Either the offset is incorrect or the header has
been overlaid.
<dt><b>Action</b>
<dd>The space will be recovered
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU621W">
HHCCU621W <em>space</em>[<em>id</em>] compressed using <em>compression</em>, not supported
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>During validation, the header for <em>space</em> (<b>trk</b> or <b>blkgrp</b>) indicates
that the space was compressed using <em>compression</em> (<b>zlib</b> or <b>bzip2</b>) but
support for that compression method was not built into Hercules.
<em>id</em> is the trk or blkgrp number.
<dt><b>Action</b>
<dd>Processing continues. However, no recovery will take place.<br>
Build Hercules with the specified compression library.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU622W">
HHCCU622W <em>space</em>[<em>id</em>] offset <em>offset</em> len <em>length</em> validation error
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The <em>space</em> (<b>trk</b> or <b>blkgrp</b>) at offset <em>offset</em> and length <em>length</em>
failed validation.
<em>id</em> is the trk or blkgrp number.
Either the space did not uncompress successfully or the uncompressed space
contains some kind of error.
This error is detected during check level 3 validation.
<dt><b>Action</b>
<dd>The space will be recovered
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_comp
</dl>
<dt><code><a name="HHCCU700E">
HHCCU700E open error: <em>error text</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Open failed for the file.
The text associated with the error number is displayed.
<dt><b>Action</b>
<dd>Processing for the file terminates.
<dt><b>Issued by</b>
<dd>cckdccdsk.c, cckdcomp.c
</dl>
<dt><code><a name="HHCCU701E">
HHCCU701E fstat error: <em>error text</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The file status system call failed.
The text associated with the error number is displayed.
<dt><b>Action</b>
<dd>Function processing terminates. Probable Hercules logic error.
Contact the hercules mailing list for assistance.
<dt><b>Issued by</b>
<dd>cckdutil.c functions cckd_swapend, cckd_comp and cckd_chkdsk
</dl>
<dt><code><a name="HHCCU702E">
HHCCU702E lseek error offset <em>offset</em>: <em>error text</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>File reposition to offset <em>offset</em> failed.
The text associated with the error number is displayed.
<dt><b>Action</b>
<dd>Function processing terminates. Probable Hercules logic error.
Contact the hercules mailing list for assistance.
<dt><b>Issued by</b>
<dd>cckdutil.c functions cckd_swapend, cckd_comp and cckd_chkdsk
</dl>
<dt><code><a name="HHCCU703E">
HHCCU703E read error rc=<em>retcode</em> offset <em>offset</em> len <em>length</em>: <em>error text</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>A read failed at offset <em>offset</em> for length <em>length</em>.
If <em>retcode</em> is not negative then the read was incomplete and the value
indicates how many bytes were read. Otherwise
the text associated with the error number is displayed.
<dt><b>Action</b>
<dd>Function processing terminates. Possible Hercules logic error.
Possible hardware error.
Contact the hercules mailing list for assistance.
<dt><b>Issued by</b>
<dd>cckdutil.c functions cckd_swapend, cckd_comp and cckd_chkdsk
</dl>
<dt><code><a name="HHCCU704E">
HHCCU704E write error rc=<em>retcode</em> offset <em>offset</em> len <em>length</em>: <em>error text</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>A write failed at offset <em>offset</em> for length <em>length</em>.
If <em>retcode</em> is not negative then the write was incomplete and the value
indicates how many bytes were written. Otherwise
the text associated with the error number is displayed.
<dt><b>Action</b>
<dd>Function processing terminates. Possible Hercules logic error.
Possible hardware error.
Contact the hercules mailing list for assistance.
<dt><b>Issued by</b>
<dd>cckdutil.c functions cckd_swapend, cckd_comp and cckd_chkdsk
</dl>
<dt><code><a name="HHCCU705E">
HHCCU705E malloc error, size <em>size</em>: <em>error text</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Malloc (allocate memory) failed for size <em>size</em>.
<dt><b>Action</b>
<dd>Function processing terminates.
Try reducing Hercules storage requirements (eg mainsize).
<dt><b>Issued by</b>
<dd>cckdutil.c functions cckd_swapend, cckd_comp and cckd_chkdsk
</dl>
<dt><code><a name="HHCCU706E">
HHCCU706E calloc error, size <em>size</em>: <em>error text</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Calloc (allocate cleared memory) failed for size <em>size</em>.
<dt><b>Action</b>
<dd>Function processing terminates.
Try reducing Hercules storage requirements (eg mainsize).
<dt><b>Issued by</b>
<dd>cckdutil.c functions cckd_swapend, cckd_comp and cckd_chkdsk
</dl>
<dt><code><a name="HHCCU707E">
HHCCU707E OPENED bit is on, use -f
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The file OPENED bit is on in the cckd header but <b>-f</b> was not specified
<dt><b>Action</b>
<dd>File processing terminates.
Make sure the file is not in use. If it is not, try the command again
specifying the <b>-f</b> option.
<dt><b>Issued by</b>
<dd>cckdcdsk.c, cckdcomp.c
</dl>
<dt><code><a name="HHCCU708E">
HHCCU708E chkdsk errors
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The utility called cckd_chkdsk for the file and it returned in error
<dt><b>Action</b>
<dd>File processing terminates.
Perform the actions suggested by the preceding cckd_chkdsk errors
<dt><b>Issued by</b>
<dd>cckdcomp.c
</dl>
<dt><code><a name="HHCCU900E">
HHCCU900E dasd lookup error type=<em>type</em> cyls=<em>cyls</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The device type <em>type</em> from the device header along with
the number of cylinders <em>cyls</em> did not match a table entry
in dasdtab.c. Note that <em>type</em> is the last two bytes of the
device type (eg <i>90</i> for a <i>3390</i> device type).
<dt><b>Action</b>
<dd>Function processing terminates.
Specify the correct file name or manually correct the device header.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_chkdsk
</dl>
<dt><code><a name="HHCCU901E">
HHCCU901E bad trksize: <em>size1</em>, expecting <em>size2</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The track size <em>size1</em> from the device header does match the
track size <em>size2</em> from the table entry in dasdtab.c
<dt><b>Action</b>
<dd>Function processing terminates.
Specify the correct file name or manually correct the device header.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_chkdsk
</dl>
<dt><code><a name="HHCCU902E">
HHCCU902E bad number of heads: <em>heads1</em>, expecting <em>heads2</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The number of heads <em>heads1</em> from the device header does match the
number of heads <em>heads2</em> from the table entry in dasdtab.c
<dt><b>Action</b>
<dd>Function processing terminates.
Specify the correct file name or manually correct the device header.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_chkdsk
</dl>
<dt><code><a name="HHCCU903E">
HHCCU903E bad `numl1tab': <em>nbr1</em>, expecting <em>nbr2</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The number of L1 table entries <em>nbr1</em> in the cckd device header
does not match the number calculated <em>nbr2</em>.
The number calculated is the number of cylinders times the number of heads
(ie the number of tracks) divided by 256, rounded up by 1 if there is a
remainder.
<dt><b>Action</b>
<dd>Function processing terminates.
Specify the correct file name or manually correct the device headers.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_chkdsk
</dl>
<dt><code><a name="HHCCU904E">
HHCCU904E file too small to contain L1 table: %<em>size1</em>, need <em>size2</em>
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The size of the file <em>size1</em> is not large enough to contain all L1 table entries;
the size required is <em>size2</em>. The minimum size of a cckd file is<br>
512 <b>+</b> 512 <b>+</b> ( 4 <b>*</b> number of L1 entries)
<dt><b>Action</b>
<dd>Function processing terminates.
Specify the correct file name.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_chkdsk
</dl>
<dt><code><a name="HHCCU905E">
HHCCU905E not enough file space for recovery
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>During phase 2 recovery, there is not enough space in the maximum file size
to contain the rebuilt L2 tables. This is an unusual situation and probably
indicates some kind of programming error.
<dt><b>Action</b>
<dd>Function processing terminates. The file has not been updated.
Contact the hercules mailing list for assistance.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_chkdsk
</dl>
<dt><code><a name="HHCCU910E">
HHCCU910E error during swap
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>Error occurred during cckd_swap().
See the preceding error messages.
<dt><b>Issued by</b>
<dd>cckdutil.c function cckd_chkdsk
</dl>
<dt><code><a name="HHCCU999E">
HHCCU999E not a compressed file
</a></code>
<dd><dl>
<dt><b>Meaning</b>
<dd>The first 8 bytes of the file did not match an expected identifier.
For a cckd file, the identifier must be either <b>CKD_C370</b> or
<b>CKD_S370</b>.
For a cfba file, the identifier must be either <b>FBA_C370</b> or
<b>FBA_S370</b>.
<dt><b>Action</b>
<dd>Function processing terminates.
Specify the correct file name.
<dt><b>Issued by</b>
<dd>cckdutil.c functions cckd_swapend, cckd_comp and cckd_chkdsk
</dl>
</dl>
<p><center><hr width="15%" noshade></center>
<p>
If you have a question about Hercules, see the
<a href="hercfaq.html">Hercules Frequently-Asked Questions</a> page.
<p><center><hr width="15%" noshade>
<a href="hercmsg.html"><img src="images/back.gif" border=0 alt="back"></a>
</center>
<p class="lastupd">Last updated $Date$ $Revision$</p>
</BODY>
</HTML>
distrib
>
Fedora
>
17
>
i386
>
media
>
updates
>
by-pkgid
>
8c430bbfe7ce899abe0113d8716ceba1
>
files
>
80
