Last Updated: March 6th, 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.

	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>
