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)