# Hercules Version 3: System Messages: DU - DASD Utilities Common Functions

This page describes the messages for the Hercules S/370, ESA/390, and z/Architecture emulator DASD utility programs that are common to more than one utility.

### Messages

`HHCDU001I Updating cyl cylinder head head`
  Meaning
    The track at cylinder number `cylinder` and head number `head` is being rewritten after being modified. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function read_track
`HHCDU002E filename write track error: stat=status`
  Meaning
    An attempt to rewrite a track from the DASD image named `filename` failed. The status returned was `status`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function read_track
`HHCDU003I Reading cyl cylinder head head`
  Meaning
    The track at cylinder number `cylinder` and head number `head` is being read. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function read_track
`HHCDU004E filename read track error: stat=status`
  Meaning
    An attempt to read a track from the DASD image named `filename` failed. The status returned was `status`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function read_track
`HHCDU005I Searching extent 0 begin (begcyl,beghead) end (endcyl,endhead)`
  Meaning
    The first extent of the dataset is being searched for a key. The extent starts at the track at cylinder `begcyl`, head `beghead`, and ends at the track at cylinder `endcyl`, head `endhead`. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function search_key_equal
`HHCDU006I Searching extent extent begin (begcyl,beghead) end (endcyl,endhead)`
  Meaning
    An extent, `extent`, of the dataset is being searched for a key. The extent starts at the track at cylinder `begcyl`, head `beghead`, and ends at the track at cylinder `endcyl`, head `endhead`. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function search_key_equal
`HHCDU007E Track track not found in extent table`
  Meaning
    An attempt was made to convert a track number to an absolute address, but the track specified, `track`, is beyond the end of the dataset.
  Action
    Correct the error and retry the operation. The dataset, the VTOC, or the DASD image may be corrupt.
  Issued by
    dasdutil.c, function convert_tt
`HHCDU008E Cannot obtain storage for device descriptor buffer: error`
  Meaning
    An attempt to obtain storage for the buffer used to hold a CKD DASD image's description failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function open_ckd_image
`HHCDU009E Cannot open filename: error`
  Meaning
    The CKD image file named `filename` could not be opened. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function open_ckd_image
`HHCDU010E filename read error: error`
  Meaning
    An error was encountered while reading the CKD header record from the file named `filename`. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function open_ckd_image
`HHCDU011E filename CKD header invalid`
  Meaning
    The file `filename` is not a valid CKD DASD image file. Either the first record is not the length of a CKD header record, or the marker in the header record is not correct.
  Action
    Supply the name of a valid CKD DASD image file and retry the operation.
  Issued by
    dasdutil.c, function open_ckd_image
`HHCDU012E DASD table entry not found for devtype type`
  Meaning
    The device type in the CKD header record does not correspond to any known DASD device. The CKD DASD image file may be corrupt, or else the device is not supported by Hercules.
  Action
    Supply the name of a supported CKD DASD image file and retry the operation.
  Issued by
    dasdutil.c, function open_ckd_image
`HHCDU013E CKD initialization failed for filename`
  Meaning
    The device-specific initialization routine for the file named `filename` failed. Another message describes the specific failure.
  Action
    See the specific message for the action needed.
  Issued by
    dasdutil.c, function open_ckd_image
`HHCDU014I filename heads=heads trklen=trklen`
  Meaning
    The device represented by the CKD DASD image file named `filename` has `heads` heads and tracks of `trklen` bytes length. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function open_ckd_image
`HHCDU015I Updating cyl cylinder head head`
  Meaning
    During processing of a request to close the CKD image file, the track at cylinder number `cylinder` and head number `head` is being rewritten, since it has been modified. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function close_ckd_image
`HHCDU016E filename write track error: stat=status`
  Meaning
    During processing of a request to close the CKD image file, an attempt to rewrite a track from the DASD image named `filename` failed. The status returned was `status`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function close_ckd_image
`HHCDU017E Cannot obtain storage for device descriptor buffer: error`
  Meaning
    An attempt to obtain storage for the buffer used to hold a FBA DASD image's description failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function open_fba_image
`HHCDU018E DASD table entry not found for devtype type`
  Meaning
    The default FBA device type does not correspond to any known DASD device. This is likely an internal programming error.
  Action
    Report the bug to the Hercules development team.
  Issued by
    dasdutil.c, function open_fba_image
`HHCDU019E FBA initialization failed for filename`
  Meaning
    The device-specific initialization routine for the file named `filename` failed. Another message describes the specific failure.
  Action
    See the specific message for the action needed.
  Issued by
    dasdutil.c, function open_fba_image
`HHCDU020I filename sectors=sectors size=size`
  Meaning
    The device represented by the FBA DASD image file named `filename` has `sectors` sectors of `size` bytes length. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function open_fba_image
`HHCDU021E VOL1 record not found`
  Meaning
    The volume being processed does not have a volume label. It is probably blank and unformatted.
  Action
    Format the volume, or specify a formatted volume and retry the operation.
  Issued by
    dasdutil.c, function build_extent_array
`HHCDU022I VOLSER=serial VTOC=cchhr`
  Meaning
    The volume being processed has the volume serial `serial`, and its VTOC format 4 DSCB is at absolute location `cchhr`. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function build_extent_array
`HHCDU023I VTOC start begcchh end endcchh`
  Meaning
    The VTOC of the volume being processed begins at cylinder and head `begcchh` and ends at cylinder and head `endcchh`. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function build_extent_array
`HHCDU024E Dataset dsn not found in VTOC`
  Meaning
    The requested dataset, `dsn`, was not found in the VTOC and does not exist on this volume.
  Action
    Specify the correct dataset name, or select the volume on which it appears.
  Issued by
    dasdutil.c, function build_extent_array
`HHCDU025I DSNAME=dsn F1DSCB CCHHR=cchhr`
  Meaning
    The format 1 DSCB for the requested dataset, `dsn`, is at absolute location `cchhr`. This message is only issued if verbose message reporting has been selected.
  Issued by
    dasdutil.c, function build_extent_array
`HHCDU026E F1DSCB record not found`
  Meaning
    The requested dataset is listed in the VTOC, but its format 1 DSCB record was not found when an attempt was made to read it. The VTOC may be corrupt.
  Action
    Recreate the dataset and retry the operation.
  Issued by
    dasdutil.c, function build_extent_array
`HHCDU027E F3DSCB record not found`
  Meaning
    The requested dataset is reported to contain more than three extents in the format 1 DSCB, but its format 3 DSCB record was not found when an attempt was made to read it. The VTOC may be corrupt.
  Action
    Recreate the dataset and retry the operation.
  Issued by
    dasdutil.c, function build_extent_array
`HHCDU028E filename open error: error`
  Meaning
    An attempt to create the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU029E filename device header write error: error`
  Meaning
    An attempt to write the device header to the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU030E filename compressed device header write error: error`
  Meaning
    An attempt to write the compressed device header to the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU031E Cannot obtain l1tab buffer: error`
  Meaning
    An attempt to obtain storage for the primary lookup table buffer failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU032E filename primary lookup table write error: error`
  Meaning
    An attempt to write the primary lookup table to the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU033E filename secondary lookup table write error: error`
  Meaning
    An attempt to write the secondary lookup table to the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU034E filename dasdcopy ftruncate error: error`
  Meaning
    An attempt to truncate the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU035E filename cylinder cyl head head write error: error`
  Meaning
    An attempt to write the track at cylinder `cyl`, head `head` to the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU036E filename compressed device header lseek error: error`
  Meaning
    An attempt to reposition to the beginning of the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU037E filename compressed device header write error: error`
  Meaning
    An attempt to rewrite the compressed device header record of the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU038E filename secondary lookup table lseek error: error`
  Meaning
    An attempt to reposition to the secondary lookup table of the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU039E filename secondary lookup table write error: error`
  Meaning
    An attempt to rewrite the secondary lookup table of the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU040E filename close error: error`
  Meaning
    An attempt to close the CKD DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU041I count cylinders successfully written to file filename`
  Meaning
    The CKD DASD image file named `filename` has been successfully created. It contains `count` cylinders.
  Issued by
    dasdutil.c, function create_ckd_file
`HHCDU042E Cylinder count count is outside range min-max`
  Meaning
    The requested number of cylinders, `count`, is outside the valid range from `min` to `max`.
  Action
    Specify a valid number of cylinders and retry the operation.
  Issued by
    dasdutil.c, function create_ckd
`HHCDU043E Cannot obtain track buffer: error`
  Meaning
    An attempt to obtain storage for the track buffer failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_ckd
`HHCDU044I Creating type volume serial: cylinders cyls, tracks trks/cyl, length bytes/track`
  Meaning
    A new volume is being created of device type `type` and volume serial number `serial`. It has `cylinders` cylinders, `tracks` tracks per cylinder, and `length` bytes per track.
  Issued by
    dasdutil.c, function create_ckd
`HHCDU045E Sector count count is outside range min-max`
  Meaning
    The requested number of sectors, `count`, is outside the valid range from `min` to `max`.
  Action
    Specify a valid number of cylinders and retry the operation.
  Issued by
    dasdutil.c, function create_fba
`HHCDU046E Cannot obtain sector buffer: error`
  Meaning
    An attempt to obtain storage for the sector buffer failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_fba
`HHCDU047I Creating type volume serial: sectors sectors, length bytes/sector`
  Meaning
    A new volume is being created of device type `type` and volume serial number `serial`. It has `sectors` sectors and `length` bytes per sector.
  Issued by
    dasdutil.c, function create_fba
`HHCDU048E filename open error: error`
  Meaning
    An attempt to create the FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_fba
`HHCDU049E filename dasdcopy ftruncate error: error`
  Meaning
    An attempt to truncate the FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_fba
`HHCDU050E filename sector sector write error: error`
  Meaning
    An attempt to write sector number `sector` to the FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_fba
`HHCDU051E filename close error: error`
  Meaning
    An attempt to close the FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_fba
`HHCDU052I count sectors successfully written to file filename`
  Meaning
    The FBA DASD image file named `filename` has been successfully created. It contains `count` sectors.
  Issued by
    dasdutil.c, function create_fba
`HHCDU053E File size too large: size [l1tab]`
  Meaning
    The requested file size, `size`, would result in a primary lookup table that is too large. The DASD image cannot be created as a compressed image.
  Action
    Either specify fewer sectors, or create the DASD image uncompressed.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU054E filename open error: error`
  Meaning
    An attempt to create the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU055I Creating type compressed volume serial: sectors sectors, length bytes/sector`
  Meaning
    A new compressed FBA volume is being created of device type `type` and volume serial number `serial`. It has `sectors` sectors and `length` bytes per sector.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU056E filename devhdr write error: error`
  Meaning
    An attempt to write the device header to the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU057E filename cdevhdr write error: error`
  Meaning
    An attempt to write the compressed device header to the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU058E filename l1tab write error: error`
  Meaning
    An attempt to write the primary lookup table to the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU059E filename l2tab write error: error`
  Meaning
    An attempt to write the secondary lookup table to the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU060E filename block header write error: error`
  Meaning
    An attempt to write a compressed block header to the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU061E filename block write error: error`
  Meaning
    An attempt to write a compressed block to the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU062E filename block write error: error`
  Meaning
    An attempt to write an uncompressed block to the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU063E filename cdevhdr lseek error: error`
  Meaning
    An attempt to reposition to the beginning of the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU064E filename cdevhdr rewrite error: error`
  Meaning
    An attempt to rewrite the compressed device header record of the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU065E filename l2tab lseek error: error`
  Meaning
    An attempt to reposition to the secondary lookup table of the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU066E filename l2tab rewrite error: error`
  Meaning
    An attempt to rewrite the secondary lookup table of the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU067E filename close error: error`
  Meaning
    An attempt to close the compressed FBA DASD image file named `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    dasdutil.c, function create_compressed_fba
`HHCDU068I count sectors successfully written to file filename`
  Meaning
    The compressed FBA DASD image file named `filename` has been successfully created. It contains `count` sectors.
  Issued by
    dasdutil.c, function create_compressed_fba

If you have a question about Hercules, see the Hercules Frequently-Asked Questions page.

Last updated $Date$ $Revision$