
	What's New as of August 23, 1998
	--------------------------------

	Attached are the changes made over the past year or so:

     o	"show paths all" enhancement to list all adapters.

     o	Support of SCSI-3 Data Compression mode page.

     o	Support for new SCSI-3 Request Sense asc/ascq messages.

     o	Shorthand "br" for Bus Reset, "bdr" for Bus Device Reset.

     o	Fixed "seek lba" command... was always seeking "lba 0"!

     o	Fixed problem not saving mode pages on "set/change page" cmds.

     o	The environment variable SCU_PROMPT, can be defined to set
	scu's interactive prompt (useful for us cluster folks).

	$ export SCU_PROMPT="scu@tcr3b"
	$ ./scu
	scu@tcr3b> 

	or on NT try:

	# export NTS_PROMPT="NuTS:
	# nts
	NuTS> 

     o	Support for Send Diagnostic Translate Address Page command.

     o	Support for "download" w/offsets using id's 6 or 7 (SCSI-3).

     o	Support for SCSI-3 Persistent Reserve In/Out (HSZ70/80 has these).

     o	Support for Report LUNs command (HSZ70/HSG80 support this).

     o	Support for Medium Changer devices. (no volume tag support)

     o	'scu' also runs on Windows NT and QNX (but this is a secret :-).


     NT Release Notes:
     -----------------

     o	I finally discovered how to send SCSI commands directly to adapters,
	so now if you don't have a class drive, just "sbtl" to the desired
	nexus and start talking to the device.  This is how I tested medium
	changer commands.

     o	On NT, a "set ide on" enables IDE devices in 'nts'.  Just be aware
	that not all ATAPI commands are compatable with SCSI, but basic ones
	like Inquiry, Read Capacity, and many others are.

================================================================================


scu> show paths all

Path Inquiry Information:

    Bus  Initiator  HBA Vendor ID    Version  Targets  LUNs
    ---  ---------  -------------    -------  -------  ----
     0       7      NCR 53C810  02     2.5       8      8   
     1       6      DEC  N01  A11      4.7       16     8   
     2       6      DEC  N01  A11      4.7       16     8   

scu> show paths all cap

Path Inquiry Information:

    Bus  Initiator  HBA Vendor ID    Version  Targets  LUNs  Capabilities
    ---  ---------  -------------    -------  -------  ----  ------------
     0       7      NCR 53C810  02     2.5       8      8    sdtr tagable
     1       6      DEC  N01  A11      4.7       16     8    wide16 sdtr tagable htm
     2       6      DEC  N01  A11      4.7       16     8    wide16 sdtr tagable htm

scu> 
scu> sbtl 2 4 0
Device: TZ89, Bus: 2, Target: 4, Lun: 0, Type: Sequential Access
scu> show pages supported

Mode Pages Supported by Device [2/4/0] (TZ89):

Read-Write Error Recovery Page (0x01), Page Length 10 (0x0a), Savable No
     Disconnect-Reconnect Page (0x02), Page Length 14 (0x0e), Savable No
             Control Mode Page (0x0a), Page Length  6 (0x06), Savable No
         Data Compression Page (0x0f), Page Length 14 (0x0e), Savable No
     Device Configuration Page (0x10), Page Length 14 (0x0e), Savable No
  Medium Partition Page 1 Page (0x11), Page Length  6 (0x06), Savable No

scu> show page compress

Data Compression Parameters (Page 0xF - Current Values):

Mode Parameter Header:

                  Mode Data Length: 27
                       Medium Type: 0x85
                        Tape Speed: 0 (Using Default Speed)
                     Buffered Mode: 0x1 (Buffering Enabled)
                   Write Protected: Yes
           Block Descriptor Length: 8

Mode Parameter Block Descriptor:

                      Density Code: 0x1a (81630 BPI (MFM, CS))
          Number of Logical Blocks: 0
              Logical Block Length: 0

Page Header / Data:
                         Page Code: 0xf
                Parameters Savable: No
                       Page Length: 14
          Data Compression Capable: Yes
           Data Compression Enable: Yes
 Report Exception on Decompression: 0
             Compression Algorithm: 0x10 (IBM IDRC data compaction)
           Decompression Algorithm: 0x10 (IBM IDRC data compaction)

scu> 
scu> help preserve

Type a topic or subtopic keyword to get help text
Type "?" for a list of subtopics
Type RETURN to back up to the previous topic level


preserve 

    This command issues SCSI-3 persistent reservation commands.

      Format:

        scu> preserve { action } [ aptpl ] [ key value ] [ type ptype ] \
                                 [ scope stype ] [ skey value ]

          Where persistent reservation 'action' is one of:

          { clear | register | release | reserve | preempt | preclear }


  Subtopics available:

  aptpl               key                 type                scope
  skey                

preserve subtopic: 
Topic: 

scu> 
	[ sorry, no examples... johnm tested these commands for me. ]

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

    Since there's different formats for the LUN information returned, the 8
bytes are dumped in hex, since 'scu' doesn't have access to SIM type info:

      scu> show luns

      Reported LUN's Supported by Device [2/0/84] (HSG80):

           Logical Unit Entry #0: 00 54 00 00 00 00 00 00 
           Logical Unit Entry #1: 00 02 00 00 00 00 00 00 

      scu> 

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

    Format:

      scu> show elements [ starting e-address ] [ ending e-address ]       \
                         [ number value ] [ type element-type ] [ voltag ] \
                         [ drive value ] [ port value ]                    \
                         [ slot value ] [ transport value ]                \
                         [ { full | summary } ]

    Valid element-type's are:
      data-transfer or DT
      import-export or IE
      storage or ST
      transport or MT

    Notes:
      o  Where e-address is an element address.  Valid addesses can be
         obtained by displaying the Element Address Assignment mode page.
      o  If element-type is omitted, then all element types are shown.
      o  If the changer is in an unknown state, you should perform an
         "initialize element" status to update the status.
      o  The drive, port, slot, and transport parameters will display
         only information for a single unit, unless "number" is used.
      o  The default report format is "summary".

    Example:

      scu> show elements

                     Element  Transport  Exception  Element
                     Address   Status      State     Type
                     -------  ---------  ---------  -------
        Transport 0:     0      Empty     Normal    Medium Transport
             Slot 0:    11      Full      Normal    Storage 
             Slot 1:    12      Full      Normal    Storage 
             Slot 2:    13      Empty     Normal    Storage 
             Slot 3:    14      Empty     Normal    Storage 
             Slot 4:    15      Empty     Normal    Storage 
             Slot 5:    16      Empty     Normal    Storage 
             Slot 6:    17      Empty     Normal    Storage 
             Slot 7:    18      Empty     Normal    Storage 
             Slot 8:    19      Empty     Normal    Storage 
             Slot 9:    20      Empty     Normal    Storage 
            Slot 10:    21      Empty     Normal    Storage 
            Slot 11:    22      Empty     Normal    Storage 
            Slot 12:    23      Empty     Normal    Storage 
            Slot 13:    24      Empty     Normal    Storage 
            Slot 14:    25      Empty     Normal    Storage 
            Slot 15:    26      Empty     Normal    Storage 
             Port 0:    10      Empty     Normal    Import Export
            Drive 0:     1      Empty     Normal    Data Transfer

      scu>

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

  This command is used with medium changers to move medium within the
  jukebox (a.k.a. media robot, autochanger, or mini-library).

    Format:

      scu> move medium source e-address destination e-address   \
                       [ medium-ransport e-address ] [ invert ] \
                       [ drive value ] [ port value ]           \
                       [ slot value ] [ transport value ]


    Where:
      e-address = Element address to move from and to.

    Aliases:
      The alias 'src' is accepted for the 'source' keyword.
      The alias 'dst' is accepted for the 'destination1' keyword.
      The alias 'mte' is accepted for the 'medium-transport' keyword.
      The alias 'door' is accepted for the 'port' keyword.

    Notes:
      o  Valid addresses for the Medium Transport (MT), Storage (ST), Import
         Export (IE), and Data Transfer (DT) elements can be obtained from
         the Element Address Assignment mode page.
      o  When specifying drive, port, slot, and/or transport parameters,
         the source and destination elements are assigned in the order
         specified.

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

scu> sbtl 2 0 0
Device: TL800, Bus: 2, Target: 0, Lun: 0, Type: Medium Changer
scu> show pages supported

Mode Pages Supported by Device [2/0/0] (TL800):

Element Address Assignment Page (0x1d), Page Length 18 (0x12), Savable Yes
        Transport Geometry Page (0x1e), Page Length  2 (0x02), Savable No
       Device Capabilities Page (0x1f), Page Length 14 (0x0e), Savable No
           Vendor Specific Page (0x23), Page Length  2 (0x02), Savable Yes
           Vendor Specific Page (0x24), Page Length 10 (0x0a), Savable No

scu> show pages

Mode Parameter Header:

                  Mode Data Length: 59
                       Medium Type: 0 (Default Medium Type)
         Device Specific Parameter: 0
           Block Descriptor Length: 0

Element Address Assignment Parameters (Page 0x1D - Current Values):

Page Header / Data:
                         Page Code: 0x1d
                Parameters Savable: Yes
                       Page Length: 18
         Transport Element Address: 0
      Number of Transport Elements: 1
     First Storage Element Address: 1
        Number of Storage Elements: 10
       First Import Export Address: 0
  Number of Import Export Elements: 0
       First Data Transfer Address: 240
  Number of Data Transfer Elements: 1

Transport Geometry Parameters (Page 0x1E - Current Values):

Page Header / Data:
                         Page Code: 0x1e
                Parameters Savable: No
                       Page Length: 2
           Supports Media Rotation: No
       Transport Set Member Number: 0

Device Capabilities Parameters (Page 0x1F - Current Values):

Page Header / Data:
                         Page Code: 0x1f
                Parameters Savable: No
                       Page Length: 14
         Store Media in MT Element: No (MT = Medium Transport)
         Store Media in ST Element: Yes (ST = Storage)
         Store Media in IE Element: No (IE = Import Export)
         Store Media in DT Element: Yes (DT = Data Transfer)
           Move Medium from MT->MT: No
           Move Medium from MT->ST: No
           Move Medium from MT->IE: No
           Move Medium from MT->DT: No
           Move Medium from ST->MT: No
           Move Medium from ST->ST: Yes
           Move Medium from ST->IE: No
           Move Medium from ST->DT: Yes
           Move Medium from IE->MT: No
           Move Medium from IE->ST: No
           Move Medium from IE->IE: No
           Move Medium from IE->DT: No
           Move Medium from DT->MT: No
           Move Medium from DT->ST: Yes
           Move Medium from DT->IE: No
           Move Medium from DT->DT: Yes
   Exchange Medium between MT<->MT: No
   Exchange Medium between MT<->ST: No
   Exchange Medium between MT<->IE: No
   Exchange Medium between MT<->DT: No
   Exchange Medium between ST<->MT: No
   Exchange Medium between ST<->ST: No
   Exchange Medium between ST<->IE: No
   Exchange Medium between ST<->DT: No
   Exchange Medium between IE<->MT: No
   Exchange Medium between IE<->ST: No
   Exchange Medium between IE<->IE: No
   Exchange Medium between IE<->DT: No
   Exchange Medium between DT<->MT: No
   Exchange Medium between DT<->ST: No
   Exchange Medium between DT<->IE: No
   Exchange Medium between DT<->DT: No

Vendor Specific Parameters (Page 0x23 - Current Values):

Page Header / Data:
                         Page Code: 0x23
                Parameters Savable: Yes
                       Page Length: 2
                            Byte 2: 0
                            Byte 3: 0

Vendor Specific Parameters (Page 0x24 - Current Values):

Page Header / Data:
                         Page Code: 0x24
                Parameters Savable: No
                       Page Length: 10
                            Byte 2: 0x2a
                            Byte 3: 0
                            Byte 4: 0
                            Byte 5: 0
                            Byte 6: 0
                            Byte 7: 0
                            Byte 8: 0
                            Byte 9: 0
                           Byte 10: 0
                           Byte 11: 0

scu> show elements

               Element  Transport  Exception  Element
               Address   Status      State     Type
               -------  ---------  ---------  -------
  Transport 0:     0      Empty     Normal    Medium Transport
       Slot 0:     1      Empty     Normal    Storage 
       Slot 1:     2      Full      Normal    Storage 
       Slot 2:     3      Empty     Normal    Storage 
       Slot 3:     4      Empty     Normal    Storage 
       Slot 4:     5      Empty     Normal    Storage 
       Slot 5:     6      Empty     Normal    Storage 
       Slot 6:     7      Empty     Normal    Storage 
       Slot 7:     8      Empty     Normal    Storage 
       Slot 8:     9      Empty     Normal    Storage 
       Slot 9:    10      Empty     Normal    Storage 
      Drive 0:   240      Empty     Normal    Data Transfer

scu> move media slot 1 drive 0
scu> show element drive 0 full

Element Status Header:

             First Element Address: 240
      Number of Elements Available: 1
    Byte Count of Report Available: 24

Element Status Page:

                 Element Type Code: 4 (Data Transfer)
              Alternate Volume Tag: 0
                Primary Volume Tag: 0
         Element Descriptor Length: 16
   Descriptor Byte Count Available: 16

Data Transfer Element Descriptors:

                   Element Address: 240
                  Transport Status: Full
                   Exception State: Normal
Access by Medium Transport Allowed: Yes
                SCSI Bus Target ID: 4
          SCSI Logical Unit Number: 0
        Element on Autochanger Bus: Yes
             Storage Element Valid: Yes
                    Media Inverted: No
            Source Storage Address: 2

scu> sw /dev/cam
Switching to device entry /dev/cam (UAGT)...
scu> sbtl 2 4 0
Device: TZ89, Bus: 2, Target: 4, Lun: 0, Type: Sequential Access
scu> tur
scu: 'test unit ready' failed on device 'TZ89' at nexus [2/4/0]
scu: Sense Key = 0x2 = NOT READY - Logical unit is NOT ready,
     Sense Code/Qualifier = (0x4, 0x1) = Logical unit is in process of becoming ready
scu> tur
scu> quit

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

scu> help translate

Type a topic or subtopic keyword to get help text
Type "?" for a list of subtopics
Type RETURN to back up to the previous topic level


translate 

    The command translates direct access addresses from the supplied
    format to the translate format.
  
      Format:
  
        scu> translate address supplied-format to translate-format [ report-format ]
  
      Notes:
        o  The Send/Receive Diagnostic commands with page code 0x40
           is used to translate addresses.  Since these are optional
           SCSI commands, drives NOT supporting them will report:
  
      scu> trans address block lba 9999 to sector
      scu: 'send diagnostic' failed on device 'RRD42' at nexus [0/4/0]
      scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
           Sense Code/Qualifier = (0x24, 0) = Invalid field in CDB
      scu> 
  
           The "show diagnostics pages" command can be used to determine
           if the Translate Address Page is supported.
  
      Examples:
  
        scu> sbtl 1 1 0
        Device: RZ26L, Bus: 1, Target: 1, Lun: 0, Type: Direct Access
        scu> show diagnostic pages
  
        Diagnostic Pages Supported by Device [1/1/0] (RZ26L):
  
                     Supported Diagnostics Page (Code = 0x00)
                         Translate Address Page (Code = 0x40)
  
        scu> translate address block lba 9999 to bfi
  
        Translate Address Diagnostic (Page 0x40):
  
                                 Page Code: 0x40
                               Page Length: 10
                           Supplied Format: Logical Block
                          Translate Format: Bytes From Index
                 Alternate Track of Medium: No
                Alternate Sector of Medium: No
                   Reserved Area of Medium: No
                           Cylinder Number: 38
                               Head Number: 4
                          Bytes From Index: 2254
  
        scu> translate address block lba 9999 to bfi summary
                Logical Block 9999 -> Cylinder 38, Head 4, Bfi 2254
        scu> 
        scu> translate address bfi cylinder 38 head 4 index 2254 to physical
        scu: 'send diagnostic' failed on device 'RZ26L' at nexus [1/1/0]
        scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
             Sense Code/Qualifier = (0x26, 0x2) = Parameter value invalid
        scu> 
        scu> sbtl 0 0 0
        Device: RZ26B, Bus: 0, Target: 0, Lun: 0, Type: Direct Access
        scu> translate address block lba 9999 to bfi
        scu: 'send diagnostic' failed on device 'RZ26B' at nexus [0/0/0]
        scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
             Sense Code/Qualifier = (0x26, 0) = Invalid field in parameter list
        scu> translate address block lba 9999 to physical
  
        Translate Address Diagnostic (Page 0x40):
  
                                 Page Code: 0x40
                               Page Length: 10
                           Supplied Format: Logical Block
                          Translate Format: Physical Sector
                 Alternate Track of Medium: No
                Alternate Sector of Medium: No
                   Reserved Area of Medium: No
                           Cylinder Number: 9
                               Head Number: 4
                             Sector Number: 47
  
        scu> translate address physical cylinder 9 head 4 sector 47 to block
  
        Translate Address Diagnostic (Page 0x40):
  
                                 Page Code: 0x40
                               Page Length: 10
                           Supplied Format: Physical Sector
                          Translate Format: Logical Block
                 Alternate Track of Medium: No
                Alternate Sector of Medium: No
                   Reserved Area of Medium: No
                     Logical Block Address: 9999
  
        scu> 
  

  Subtopics available:

  supplied-format     translate-format    troubleshooting     

translate subtopic: 
Topic: 

scu> 
