cdi_set_359x_eod(8)
cdi_set_359x_eod(8)
NAME
cdi_set_359x_eod - sets or clears IBM 3590, 3592 and TS1120 tape
drive's 'Disable Crossing EOD' bit
SYNOPSIS
cdi_set_359x_eod -f device [ -r ] [ -t { s | t | g | n | m | i } ]
DESCRIPTION
The cdi_set_359x_eod program uses mode sense and mode select commands
to set a vendor-specific bit in IBM 3590, 3592 and TS1120 tape drives.
These drives normally allow a program to read past the typical end of
data marks on a tape which may allow a program to recover possibly
overwritten data. However, this behavior confuses NetWorker's scanner
utility, on some platforms causing a locked-up tape device which may
require rebooting or power cycling to restore to normal operation.
If you are going to be using scanner on an IBM 3590, 3592 or TS1120
tape drive you should first run cdi_set_359x_eod to tell the tape drive
that it should not allow reading past the end of data.
To restore the default state of the tape drives, you can run
cdi_set_359x_eod with the -r flag which will reset (clear) the 'Disable
Crossing EOD' bit. Normal NetWorker operations do not seem to be
affected by this bit either being set or cleared, so it is not really
necessary to reset the bit after using scanner on a particular tape
drive.
OPERANDS
-f device
Specifies the device to perform the mode sense and mode select
commands on. cdi_set_359x_eod will check the device's inquiry
data to make sure that it is an IBM 3590, 3592 or TS1120 tape
drive. If it is not, the command will exit with a message that
includes the inquiry data retrieved from the specified device.
OPTIONS
-r Tells cdi_set_359x_eod to reset the 'Disable Crossing EOD' bit
back to the default (cleared) state.
-t Use the -t option to specify the method of tape functions to use
to issue the SCSI mode sense and mode select commands. If the
-t option is not specified, the default method is to use the OS
tape driver SCSI passthrough functions. Please refer to the
libcdi (8) manpage for the complete list of access methods cur-
rently supported by the cdi_mode_sense program.
EXAMPLES
% cdi_set_359x_eod -f /dev/rmt/47cbn
359x Mode Page 0x25 Disable Crossing EOD bit succesfully SET.
% cdi_set_359x_eod -f /dev/rmt/47cbn -r
359x Mode Page 0x25 Disable Crossing EOD bit successfully Reset to default
value.
% cdi_set_359x_eod -f /dev/rmt/11cbn
The drive you are working with (EXABYTE Mammoth2) is not an IBM 3590, 3592
or TS1120.
SEE ALSO
libcdi(8), cdi_mode_sense(8), cdi_mode_select(8)
NetWorker 8.0.1 Dec 02, 12 cdi_set_359x_eod(8)