Last Updated: March 11th, 2000 by Robin T. Miller

	The following are the recent changes made to 'scu':

     o	Addition of "show version" command.

     o	For medium changers, there are three new options:
	- show element address element
	- show element state { abnormal | normal }
	- show element status { empty | full }

	These commands are especially important for large libraries.
	The "beast" I'm testing with has the following configuration:

    Library Element Summary:

        Medium Transport Elements: 4   Empty: 4   Full: 0   Address: 1
           Import/Export Elements: 2   Empty: 2   Full: 0   Address: 64
                 Storage Elements: 792 Empty: 720 Full: 72  Address: 256
           Data Transfer Elements: 9   Empty: 5   Full: 4   Address: 128
              Cleaning Cartridges: 0

     o	For full sense display, command information is displayed.
	This includes the CDB bytes, bytes requested/transferred,
	upto 64 bytes of data transferred, and the command  timeout.

     o	On command timeouts, the actual timeout used is now displayed.

     o	Fixed signal handler so 'scu' exits on signals in pipe mode.

     o	New shorthand command "pwd" for Print Working Device.  This
	is the same as the "show nexus" command.

     o	Added automatic retrying of "Not Ready" sense key, with an
	additional sense code/qualifier of (0x4, 0x1) = Logical unit
	is in process of becoming ready.  Some libraries, like the new
	AIT do a "soft load", so the "mt online" command would fail with
	this error.  Remember to use "set cam retries off" to disable
	'scu's automatic retry logic (if necessary).

	Updated versions of 'scu' are available via the following URL's:

		http://www.zk3.dec.com/~rmiller/scu.html
		http://www.zk3.dec.com/~rmiller/linux.html

	Note: Only the Tru64 and Linux Intel 'scu' are currently upto date.

	NOTE:  This work is provided by the Data Products Group, managed by
Charlie Newfell.  These changes are not currently part of the Tru64 release.

Cheers,
Robin
================================================================================

tru64% scu show version
    --> Date: March 4th, 2000, Version: V4.0x, Author: Robin T. Miller <--
tru64% 

 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

tru64% scu
scu> sbtl 1 0 0
Device: TL800, Bus: 1, Target: 0, Lun: 0, Type: Medium Changer
scu> show elements status empty

               Element  Transport  Exception  Element  Volume
               Address   Status      State     Type     Tags
               -------  ---------  ---------  -------  ------
  Transport 0:     0      Empty     Normal      MT     
       Slot 8:     9      Empty     Normal      ST     
      Drive 0:   240      Empty     Normal      DT     
                                       (Serial Number) CX742S3311          
      Drive 1:   241      Empty     Normal      DT     
                                       (Serial Number) JF71503116          

scu> show elements status full

               Element  Transport  Exception  Element  Volume
               Address   Status      State     Type     Tags
               -------  ---------  ---------  -------  ------
       Slot 0:     1      Full      Normal      ST     BPZ755
       Slot 1:     2      Full      Normal      ST     BPZ754
       Slot 2:     3      Full      Normal      ST     BPZ750
       Slot 3:     4      Full      Normal      ST     CLN900
       Slot 4:     5      Full      Normal      ST     BPZ751
       Slot 5:     6      Full      Normal      ST     BPZ756
       Slot 6:     7      Full      Normal      ST     BPZ752
       Slot 7:     8      Full      Normal      ST     CLN901
       Slot 9:    10      Full      Normal      ST     BPZ753

scu> show element address 241

               Element  Transport  Exception  Element  Volume
               Address   Status      State     Type     Tags
               -------  ---------  ---------  -------  ------
      Drive 1:   241      Empty     Normal      DT     
                                       (Serial Number) JF71503116          

scu> 
scu> exit
tru64% 

 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

tru64% scu
scu> sbtl 1 0 0
Device: TL800, Bus: 1, Target: 0, Lun: 0, Type: Medium Changer
scu> set sense full
scu> set width 80
scu> show element tag Robin

Device/Command Information:

                      Device Name/Type: TL800 (Medium Changer)
                     Nexus Information: Bus 1, Target 0, Lun 0
                      Erroring Command: send volume tag
              Command Descriptor Block: b6 00 00 00 00 04 00 00 00 28 00 00
             Requested Transfer Length: 40
                Actual Transfer Length: 0
                       Data Bytes Sent: 52 6f 62 69 6e 20 20 20 20 20 20 20
                                        20 20 20 20 20 20 20 20 20 20 20 20
                                        20 20 20 20 20 20 20 20 00 00 00 00
                                        00 00 00 00
                       Command Timeout: 300 seconds

Request Sense Information:

                            Error Code: 0x70 (Current Error)
                             Valid Bit: 0
                        Segment Number: 0
                             Sense Key: 0x5 (ILLEGAL REQUEST - Illegal request or CDB parameter)
                        Illegal Length: 0
                          End Of Media: 0
                             File Mark: 0
                     Information Field: 0
               Additional Sense Length: 20
          Command Specific Information: 0
       Additional Sense Code/Qualifier: (0x24, 0) = Invalid field in CDB
           Field Replaceable Unit Code: 0
         Bit Pointer to Field in Error: 0x4 (valid, bit 5)
        Error Field Command/Data (C/D): 0x1 (Illegal parameter in CDB bytes)
        Byte Pointer to Field in Error: 0x5 (byte 6)
                Additional Sense Bytes: 00 00 00 00 00 00 00 00 00 00

scu>

 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

tru64% scu sbtl 1 0 0 set sense full tur
scu: 'test unit ready' failed on device 'TL800' at nexus [1/0/0]
scu: [1/0/0] CAM CCB function 'XPT_SCSI_IO' failed,
     CAM status = CAM_CMD_TIMEOUT (0xb) - Command timed out
     The command timeout was set to 180 seconds
tru64%

 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

tru64% scu
scu> sbtl 1 0 0
Device: TL800, Bus: 1, Target: 0, Lun: 0, Type: Medium Changer
scu> sw /dev/rmt0h
Switching to device entry /dev/rmt0h (TZ89)...
scu> pwd
Device: TZ89, Bus: 1, Target: 5, Lun: 0, Type: Sequential Access
scu> sw
Switching to device entry [1/0/0] (TL800)...
scu> pwd
Device: TL800, Bus: 1, Target: 0, Lun: 0, Type: Medium Changer
scu>
