$ export SCU_PROMPT="scu@tcr3b" $ ./scu scu@tcr3b> or on NT try: # export NTS_PROMPT="NuTS: # nts NuTS>
Send mail to admin of this page: Robin.Miller@compaq.com
To Robin's home page.
Last modified: December 29th, 1999
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>