What's New as of August 23rd, 1998

Changes For This Release

The following changes have been made to scu for this release:

NT Release Notes

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

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


Mail Send mail to admin of this page: [email protected] Home To Robin's home page.

Last modified: December 29th, 1999


Examples:


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> 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>