SCSI Command Utility March 4th, 2000

What's New as of March 4th, 2000

Changes For This Release

The following changes were made to scu for this release:

Addition of "show version" command.

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

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.
On command timeouts, the actual timeout used is now displayed.
Fixed signal handler so scu exits on signals in pipe mode.
New shorthand command "pwd" for Print Working Device. This is the same as the "show nexus" command.

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

Within Compaq, the updated scu kits are located @ URL:

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

Send mail to admin of this page: Robin.Miller@compaq.com

To Robin's home page.

Last modified: March 4th, 2000

Examples:

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>