tapeutil Error Messages


tapeutil Error Messages

If the tapeutil command has been issued and an error condition is detected, an error message displays.
The error sense data has the format shown in below Figure 68.

        Read/Write test terminated, total bytes written 0
        Operation failed with errno 5: I/O error
        Residual count: 204800
        Error Sense Data, Length 80
        0 1  2 3  4 5  6 7  8 9  10   12   14   A B  C D  E F
        7000 0200 0000 0016 0000 0000 0402 0BOO 0000 8200 0000
        0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000

Figure 68. Example of tapeutil Error Sense Data 

To use the error message to solve the problem:

  1.  Locate the AIX errno number (in this example, errno 5) and refer to (below) Figure 69 for a description of the problem.

    Note: Below Figure 69 shows only the errno values that pertain to tape devices.  The complete list of ermo values can be found in the AIX /usr/include/sys/errno.h header file.

  2.  Locate the Error Sense Data area of the message:


Figure 69. Translation of Device Driver Error Code to AIX errno 

AIX
errno
Device Driver
Error Code
Description
1 EPERM ° General: The process does not have adequate
permission to perform the desired function.
5 EIO ° Open: An I/O error occurred that indicates a
failure to operate the device.
° Write: The physical end of medium was detected,
or it is a general error state indicating a failure
to write to device.
° IOCTL: An I/O error occurred during the operation.
° Close: An I/O error occurred during the operation.
6 ENXIO ° General: The device has not been configured and
is not receiving requests.
° Write: A write operation was attempted after the
device had reached end of medium.
9 EBADF ° General: A bad file descriptor was passed.
° Write: A write operation was attempted on a
device that was opened for read only.
11 EAGAIN ° Read: The device is already opened.
12 ENOMEM ° General: Insufficient memory available for some
internal memory operation.
° Read: The number of bytes requested in a read
of a vanable block record was less than the size
of the block.
This is referred to as an over-length condition.
14 EFAULT ° General: A memory failure occurred due to an
invalid pointer or address.
16 EBUSY ° General: An excessive busy state was
encountered.
° Open: The device is reserved by another initiator
or an excessive busy state was encountered.
22 EINVAL ° Open: The operation requested had invalid
parameters or an invalid combination of parameters.
° Write: The operation requested had invalid
parameters or an invalid combination of
parameters, or the number of bytes requested in
the write was not a multiple of the block size for
a fixed block transfer, or the number of bytes
requested in the write was greater than the
maximum block size allowed by the device for
variable block transfers.
28 ENOSPC ° Write: A write operation failed because it had
reached the early warning mark while running in
label processing mode. This return code is only
returned once at the moment early warning is reached.
46 ENOTREADY ° General: The device is not reaciy for operation
or a tape is not in the drive.
° Open: If not opened with the O_NONBLOCK or
O_NDELAY, the drive is not ready for operation,
or there is no tape in the drive. If the nonblocking
flags are used, the drive is not ready for operation.
47 EWRPROTECT ° Open: An open operation with the O_RDWR or
O_WRONLY flag was attempted on a
write-protected tape.
° Write: A write operation was attempted on a
write-protected tape.
° IOCTL: An operation that would modify the media
was attempted on a write-protected tape or a
device that was opened for O_RDONLY.
78 ETIMEDOUT ° General: A command has timed out.
110 EMEDIA ° General: An unrecoverable media error was
detected.
3030 00 ° No Message: This is the default message
indicating that the device does not have an error
to report.
3430 40 ° Operator Intervention Required: An operator
action is required at the device. For example, a
magazine is full and needs to be replaced or
emptied. Check the device error log for possible
repair action.
3431 41 ° Device Degraded: The device is performing in a
degraded state, but can be used. A FID is
displayed with the error message. Check the
device error log for possible repair action.
3432 42 ° Device Hardware Failure: The device can not be
used. A FID is displayed with the error message.
Check the device error log for possible repair
action.
3433 43 ° Service Circuits Failed, Operations not
Affected: This error does not affect the
performance of the device. The failure only affects
circuits used for nonoperational testing. A FID is
displayed with the error message. Check the
device error log for possible repair action.
3535 55 ° Clean Device: Load a cleaning cartridge in the
device. The drive returns the cleaning cartridge
following the cleaning procedure.
3537 57 ° Device Has Been Cleaned: The drive has been
cleaned by a cleaning cartridge.
3630 60 ° Bad Media, Read Only Permitted: MIM message.
3631 61 ° Rewrite Media if Possible: MIM message.
3634 64 ° Bad Media, Cannot Read or Write: MIM message.
3732 72 ° Replace Cleaner Cartridge: MIM message.


Back to  Jump to TOP-of-PAGE

Please see the LEGAL  -  Trademark notice.
Feel free - send a Email-NOTE  for any BUG on this page found - Thank you.