The SCSI utility is used for normal maintenance of SCSI peripherals.
This utility can also be used to do device specific setup, diagnostics,
and querying of various device information.
Format:
% scu [ -options... ] [ command [ keywords... ] ]
Where options are:
-e Use exclusive open.
-f device-name The device name path.
-n Don't execute startup script.
-N Disable device directory scanning.
-p Enables pipe operation mode.
-s startup-file Specify startup script file name.
-S Enable device directory scanning.
If the device name is not specified on the command line, the environment
variable SCU_DEVICE can be used to define the device name. If a startup
script file is not specified on the command line, the environment variable
SCU_SCRIPT is checked and used, and if neither are specified, the program
looks for ".scurc" first in the current directory & then in $HOME/.scurc.
The device directory scanning option is enabled by default on Linux, but
disabled by default on Tru64 Unix systems. The environement variable
SCU_DEVICE_SCANNING can be set to "Yes" or "No" to also set this option.
Note: This directory scanning only occurs during a "show edt" command.
If a command is not entered on the command line, the program will prompt
for commands until you terminate the program. Commands can be abbreviated
to the least unambiguous number of characters.
Topics available:
scu allow change Conventions
download dump eject erase
exchange exit evaluate format
help initialize mbad move
mt position onerror pause
play prevent preserve read
reassign release repeat reserve
reset resume rezero scan
seek set slun sbtl
spid stid shell show
sleep source start stop
switch system test time
translate tur usleep unload
verify write xza zero
allow Command
This command allows media removal from the selected device.
Format:
scu> allow
change Command
This command changes mode pages for a device. The program prompts you
with those page fields which are marked changeable. If the mode-page
keyword is omitted, then all pages supported by the device will be
requested for changing. After fields of each page have been entered,
the new page parameters are set via a mode select command.
Format:
{ [ code hex-code ] }
scu> change pages { [ mode-page ] } [ pcf page-control ]
Notes:
o Only fields which are marked changeable in the changeable mode
page, are prompted for.
o The default page control field is "current" values.
o Changing page values always affects the current page values.
o The default is to save page values if the page saveable bit
in the page header is set and the program savable flag is set.
Use the "set default savable" command to alter this latter flag.
o Some pages, such as those that affect the physical media, do
not actually get saved until the media is formatted.
code Option
For mode pages which are unknown to the program, a hex page code can be
specified for the page to change. In this mode, mode page fields are
displayed and changed by hex byte values. This format can also be used
to override the known formatted page change functions.
Format:
scu> change page code hex-code [ pcf page-control ]
Example:
scu> change page code 0x21
Changing & Saving Vendor Specific Parameters (Page 0x21 - Current Values):
(byte 2) [R:0-0xff D:0xff]:
(byte 3) [R:0-0xff D:0xff]:
(byte 4) [R:0-0xff D:0xff]:
(byte 5) [R:0-0xff D:0xff]:
(byte 6) [R:0-0xff D:0xff]:
(byte 7) [R:0-0xff D:0xff]:
(byte 8) [R:0-0xff D:0xff]:
(byte 9) [R:0-0xff D:0xff]:
(byte 10) [R:0-0xff D:0xff]:
(byte 11) [R:0-0xff D:0xff]:
scu>
mode-page Option
Describes the mode page to operate on. The pages supported are:
'scu' Keyword Page Code Description
------------- --------- -----------
error-recovery 0x01 Error recovery page.
disconnect | reconnect 0x02 Disconnect/reconnect page.
format-device 0x03 Format device mode page.
geometry | rigid 0x04 Disk geometry page.
flexible 0x05 Flexible disk page.
optical-memory 0x06 Optical memory page.
verify-recovery 0x07 Verify error recovery page.
cache-control 0x08 Cache control page.
peripheral-device 0x09 Peripheral device page.
control-mode 0x0A Control Mode Page.
medium-types | mtypes 0x0B Medium types supported page.
notch-partition 0x0C Notch and partition page.
cdrom 0x0D CD-ROM device page.
power-condition 0x0D Power condition page.
audio-control 0x0E Audio control page.
compression 0x0F Data compression page.
device-configuration 0x10 Device configuration page.
medium-partition1 0x11 Medium parition page 1.
tapealert 0x1C TapeAlert control page.
element-address 0x1D Element address assignment.
transport-geometry 0x1E Transport geometry parameters.
device-capabilities 0x1F Device capabilities page.
dec-control 0x25 DEC special control page.
cdcap 0x2A CD-ROM capabilities page.
library 0x2E Library configuration page.
Notes:
o The format-device page was previously named the direct-access page,
so either keyword is accepted.
o The dec-control page was previously name the dec-specific page,
so either keyword is accepted.
Example:
scu> change page error
Changing & Saving Read-Write Error Recovery Parameters (Page 0x1 - Current Values):
Disable Correction (DCR) [R:0-1 D:0]:
Disable Transfer on Error (DTE) [R:0-1 D:0]:
Post Recoverable Error (PER) [R:0-1 D:1]:
Enable Early Recovery (EER) [R:0-1 D:0]:
Transfer Block (TB) [R:0-1 D:1]:
Automatic Read Allocation (ARRE) [R:0-1 D:0]:
Automatic Write Allocation (AWRE) [R:0-1 D:0]:
Read Retry Count [R:0-255 D:33]: 25
Write Retry Count [R:0-255 D:3]: 10
scu>
pcf Option
The page control field describes which mode pages to obtain from the
device. The defined page control fields are:
Format:
scu> change pages pcf { current | changeable | default | saved }
Notes:
o The default page control field is "current" values.
Example:
scu> set default savable off
scu> change page error pcf saved
Changing Read-Write Error Recovery Parameters (Page 0x1 - Saved Values):
Disable Correction (DCR) [R:0-1 D:0]:
Post Recoverable Error (PER) [R:0-1 D:1]:
Enable Early Recovery (EER) [R:0-1 D:0]:
Read Continuous (RC) [R:0-1 D:0]:
Transfer Block (TB) [R:0-1 D:1]:
Read Retry Count [R:0-255 D:27]: 25
scu>
Conventions
This section describes the conventions used throughout this help text.
Additional topics are available to provide further information on the
conventions used.
The following conventions are used throughout the help text are:
[ keywords ... ] Keywords are optional.
{ key1 | key2 ... } Select one of the keywords listed.
keyword (alias) Use keyword or the specified alias.
[ address-format ] Optionally accepts an address format.
[ nexus-information ] Optionally accepts nexus information.
[ test-parameters ] Optionally accepts test parameters.
D:value or "string" The value or string shown is the default.
R:minimum-maximum Enter a value within the range specified.
address-format Option
The address format is an optional parameter available with most CD-ROM
audio commands which specified the address format of information returned
by the drive for various show audio commands. The address formats are:
Format Description of Format
------ ---------------------
lba Logical Block Address.
msf Minute, Second, and Frame.
Format:
scu> command [ address { lba | msf } ]
nexus-information Option
The nexus information allows users to specify values to override the
bus/target/lun values normally taken from the selected SCSI device.
The nexus keywords are:
bus (pid) R:0-63 The SCSI bus number (path ID).
target (tid) R:0-15 The SCSI target number (target ID).
lun R:0-7 The SCSI logical unit number.
test-parameters Option
This section describes the valid test parameters for various commands.
Format:
scu> command [ media-limits ] [ test-control ]
expressions Option
An expression is accepted for test parameters which accept numeric values.
The special characters accepted as part of this expression are:
Special Characters:
b = blocks (512 bytes) k = kilobytes (1024 bytes)
g = gigabytes (1073741824 bytes) m = megabytes (1048576 bytes)
p = page size (usually 4096 bytes) w = word size (2, 4, or 8 bytes)
d = device block size
g = gigabytes (1073741824 bytes)
t = terabytes (1099511627776 bytes)
inf or INF = infinity (18446744073709551615 bytes)
Arithmetic Characters:
+ = addition - = subtraction
* or x = multiplication / = division
% = remainder
Bitwise Characters:
~ = complement of value >> = shift bits right
<< = shift bits left & = bitwise "and" operation
| = bitwise "or" operation ^ = bitwise exclusive "or"
Notes:
o If value is omitted, the value defaults to one.
o Both upper and lower case characters are accepted.
o Spaces and tabs are ignored between operands.
o Expressions are evaluated from right to left without precedence.
o Parentheses grouping is not supported.
The "evaluate" command is supplied to display values from a given
expression. This may be useful before using these expressions for
test parameter values.
Examples:
% scu
scu> set verbose off
scu> evaluate k
Dec: 1024 Hex: 0x400 Blks: 2.00 Kb: 1.00 Mb: 0.00 Gb: 0.00
scu> evaluate k<<2
Dec: 4096 Hex: 0x1000 Blks: 8.00 Kb: 4.00 Mb: 0.00 Gb: 0.00
scu> evaluate k>>1
Dec: 512 Hex: 0x200 Blks: 1.00 Kb: 0.50 Mb: 0.00 Gb: 0.00
scu> evaluate ~0
Dec: -1 Hex: 0xffffffff Blks: 8388608.00 Kb: 4194304.00 Mb: 4096.00 Gb: 4.00
scu> evaluate 511&0xf
Dec: 15 Hex: 0xf Blks: 0.03 Kb: 0.01 Mb: 0.00 Gb: 0.00
scu> evaluate b*w
Dec: 2048 Hex: 0x800 Blks: 4.00 Kb: 2.00 Mb: 0.00 Gb: 0.00
scu>
media-limits Option
This sections describes the command which control the device media
tested.
Format:
{ lba n } { length n }
scu> command [ { starting n } ] [ { ending n } ] [ size n ]
{ limit n }
{ records n }
Aliases:
The alias 'bs' (block size) is accepted for the 'size' keyword.
The alias 'count' is accepted for the 'records' keyword.
The alias 'lbn' is accepted for the 'lba' keyword.
test-control Option
These parameters control various aspects of the test operation. The
test control parameters supported are listed below:
Format:
{ align offset }
{ compare { on | off } }
{ dbbr { on | off } }
{ errors limit }
scu> command [ { passes limit } ]
{ pattern value }
{ pfile file-name }
{ popts ... }
{ recovery { on | off } }
Aliases:
The alias 'reassign'" is accepted for the 'dbbr' keyword.
pfile Option
This options allows you to specify a pattern file which gets read and
used for the selected test.
Format:
scu> command pfile file-name
Example:
% scu -f /dev/rrz0c
scu> set stats on
scu> set watch off
scu> write media starting 0 bs 64k limit 5m pfile pattern_6
Writing 10240 blocks (0 - 10239) on /dev/rrz0c (RZ28) with pattern 0xa26138a1...
Total Statistics:
Device Name/Type: RZ28 (Direct Access)
Nexus Information: Bus 0, Target 0, Lun 0
Data Pattern File Used: pattern_6 (2048 bytes)
Total Records Processed: 80 @ 65536 bytes/record (64.000 Kbytes)
Total Bytes Transferred: 5242880 (5120.000 Kbytes, 5.000 Mbytes)
Average Transfer Rates: 1818340 bytes/sec, 1775.723 Kbytes/sec
Total Passes Completed: 1/1
Total Errors Detected: 0/1
Total Elapsed Time: 00m02.88s
Total System Time: 00m00.06s
Total User Time: 00m01.00s
Starting time: Sun Oct 29 08:46:55 1995
Ending time: Sun Oct 29 08:46:57 1995
scu>
popts Option
This keyword provides additional control over various pattern options.
Format:
scu> command popts [ incrementing ] [ iot ] [ lbdata ]
Notes:
o The "iot" option selects DJ Brown's IOT test pattern. This
option encodes the logical block address with a fixed patten,
throughout each word in a data block.
o The "incrementing" option selects a pattern which incremented
from (0 - 255).
o The "lbdata" option is used with random access devices, and
enables reading and/or writing of the logical block number in
the first 4 bytes of each data block.
download Command
This command may be used with any device that supports the downloading
of firmware software using the Write Buffer SCSI command.
Format:
scu> download filename [ save ] [ parameters ]
Notes:
o If the "save" parameter is omitted, a Download microcode (mode 4)
command is issued. Specifying "save" performs a Download microcode
and save operation (mode 5). Not all devices accept both modes.
NOTE: Digital disks will only accept mode 5, you must specify the
"mode value" keyword to override this on direct-access devices.
o If you specified a device via "sbtl" or "set nexus", then attempt to
download drive firmware, the mounted file system check will fail.
This is done purposely to prevent accidental downloading to disks
with mounted file systems.
o Some devices such as many disks, require additional time after the
download operation to program the flash memory (save the firmware)
to recalibrate, or perform other necessary setup before the device
can be accessed. In most cases, waiting 1 to 3 minutes is advised
before accessing the device. Most devices will *not* respond to a
selection immediately after a download operation.
o If a disk device determines that a recalibration is necessary, the
drive may be unavailable for up to 10 minutes. During this sequence,
you can normally issue a Test Unit Ready "tur" command to determine
if the calibration has completed. If the calibration sequence is
interrupted, e.g. by a bus reset, device reset, or by power cycling,
the recalibration will be restarted when the drive is powered up.
o Do NOT power cycle devices during the download operation, or you may
interrupt the flashy-flash step while saving the firmware which will
render your drive useless.
Errors:
If file systems are mounted on a disk to be downloaded, the following
error message is displayed and downloading is aborted:
scu> download NEW_CODE save
scu: File system '/dev/rz14a' is mounted on '/mnt2',
EBUSY (16) - Mount device busy
Examples:
scu> download TZ85_V3_DEC.TZ_IMAGE save
Downloading & Saving Firmware File 'TZ85_V3_DEC.TZ_IMAGE' of 262144 bytes...
scu>
parameters Option
Various parameters can be specified to control the download operation.
Most devices do not require these optional parameters, but since each
vendor may implement the download command differently, these parameters
provide the capability to override program defaults.
Format:
{ id buffer-id }
{ mode value }
scu> download filename [ save ] [ { offset offset-value } ]
{ segment [ size ] }
Notes:
o The default buffer id is 0.
o The default offset value is 0.
o The default segment size is 8k bytes. If this parameter is not
specified, the default is to download the entire image at once.
o Refer to the vendor's SCSI programming manual for information on
buffer ID's and buffer modes supported.
Examples:
scu> download ???.fup save
Downloading & Saving Firmware File '???.fup' of 131076 bytes...
scu>
scu> download ???.fup save segment
Downloading File '???.fup' of 131076 bytes in 8192 byte segments...
Download completed successfully, now saving the microcode...
Delaying for 120 seconds while firmware is saved, please be patient...
scu>
scu> download ???.fup save segment 32k
Downloading File '???.fup' of 131076 bytes in 32768 byte segments...
Download completed successfully, now saving the microcode...
Delaying for 120 seconds while firmware is saved, please be patient...
scu>
save Option
The save parameter directs the device to to save the new operating
software in non-volatile memory if the command is successfully
completed. The downloaded code will then be effective after each
power cycle and reset.
If the save parameter is not specified, the downloaded software is only
placed in the control memory of the device. After a power-cycle or
reset, the device operation will revert to a vendor-specific condition.
dump Command
This command allows you to dump information from the selected device.
Format:
scu> dump media [ test-parameters ]
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
media Option
This command provides a method to dump data read from the selected
device. By default a hex dump is provided, but this can be overridden
set specifying your own dump filter (external programs).
Format:
scu> dump media [ test-parameters ]
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
Example:
scu> write media bs 64k limit 5m popts lbdata
Writing 10240 blocks (0 - 10239) on /dev/rrz0c (RZ28) with pattern 0x39c39c39...
scu> dump media lba 1000
Reading 1 block (1000 - 1000) on /dev/rrz0c (RZ28)...
Record Number 1 (Starting Block 1000)
00000000 00 00 03 e8 39 9c c3 39 39 9c c3 39 39 9c c3 39 39 9c c3 39
00000020 39 9c c3 39 39 9c c3 39 39 9c c3 39 39 9c c3 39 39 9c c3 39
.
.
.
00000460 39 9c c3 39 39 9c c3 39 39 9c c3 39 39 9c c3 39 39 9c c3 39
00000480 39 9c c3 39 39 9c c3 39 39 9c c3 39 39 9c c3 39 39 9c c3 39
00000500 39 9c c3 39 39 9c c3 39 39 9c c3 39
scu>
eject Command
This command is used with CD-ROM's to stop play and eject the caddy.
Format:
scu> eject [ immed ]
erase Command
This command performs various erase operations to the selected device.
Format:
scu> erase media [ test-parameters ]
media Option
This command erases the device media using for Optical device types. You
must specify transfer parameters which specifies the media area to be
erased.
Format:
scu> erase media [ test-parameters ] [ options ... ]
Please refer to the "Conventions" help section for a list of the valid
test parameters.
Notes:
After the media is erased, attempting to read this erased area
results in a no-data condition "BLANK CHECK" as shown below.
Examples:
scu> erase media
scu: No defaults, please specify test parameters for transfer...
scu> erase media lba 100
Erasing 1 block on [1/0/0] (RWZ52), please be patient...
Erasing block 100...
scu> erase media starting 0 bs 32m
Erasing 576999 blocks on [1/0/0] (RWZ52), please be patient...
Erasing blocks [ 0 through 65535 ]...
Erasing blocks [ 65536 through 131071 ]...
.
.
.
Erasing blocks [ 458752 through 524287 ]...
Erasing blocks [ 524288 through 576998 ]...
scu>
scu> read media lba 100 compare off
Reading 1 block on [1/0/0] (RWZ52)...
Reading block 100...
scu: Sense Key = 8 = BLANK CHECK - No-data condition occured,
Sense Code/Qualifier = (0x93, 0)
scu>
options Option
Allows you to specify options which alter erase operation.
Format:
scu> erase media options { era }
Where Option is:
era = Erase all. When this option is used, the media is erased
from the starting block through the end of the media.
Example:
scu> time erase media starting 0 options era
Erasing 1163337 blocks on [1/0/0] (RWZ52), please be patient...
Erasing blocks [ 0 through 1163336 ]...
Elapsed time: 10m39.36s, System time: 00m00.01s, User time: 00m00.00s
scu>
exchange Command
This command is used with medium changers to exchange elements within the
jukebox (a.k.a. autochanger or mini-library).
Format:
scu> exchange medium source e-address destination1 e-address \
destination2 e-address [ medium-transport e-address ] \
[ invert1 ] [ invert2 ] \
[ drive value ] [ port value ] \
[ slot value ] [ transport value ] \
[ tags string ] [ atags string ] [ ptags string ]
Where:
e-address = Element address to move from and to.
Aliases:
The alias 'src' is accepted for the 'source' keyword.
The alias 'dst1' is accepted for the 'destination1' keyword.
The alias 'dst2' is accepted for the 'destination2' keyword.
The alias 'mte' is accepted for the 'medium-transport' keyword.
The alias 'flip1' is accepted for the 'invert1' keyword.
The alias 'flip2' is accepted for the 'invert2' keyword.
The alias 'shelf' is accepted for the 'slot' keyword.
The alias 'picker' is accepted for the 'transport' keyword.
The alias 'door', 'mailbox', or 'mailslot' is valid for port.
Notes:
Valid values 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.
exit Command
This command is used to exit the program. "quit" is an alias for exit.
The program can also be terminated in interactive mode, by entering the
end of file character (usually CTRL/D).
Format:
scu> exit
evaluate Command
This command evaluates the given expression and displays values in decimal
hexadecimal, blocks, kilobytes, megabytes, and gigabytes. The expression
accepted is the same as the one described for test parameter values. The
output displayed depends on the setting of the verbose display flag.
Format:
scu> evaluate expression
Examples:
scu> set verbose on
scu> evaluate 0xffff
Expression Values:
Decimal: 65535
Hexadecimal: 0xffff
512 byte Blocks: 128.00
Kilobytes: 64.00
Megabytes: 0.06
Gigabytes: 0.00
scu> evaluate 64k*512
Expression Values:
Decimal: 33554432
Hexadecimal: 0x2000000
512 byte Blocks: 65536.00
Kilobytes: 32768.00
Megabytes: 32.00
Gigabytes: 0.03
scu>
scu> set verbose off
scu> eval 0xffff
Dec: 65535 Hex: 0xffff Blks: 128.00 Kb: 64.00 Mb: 0.06 Gb: 0.00
scu> eval 64k*1b
Dec: 33554432 Hex: 0x2000000 Blks: 65536.00 Kb: 32768.00 Mb: 32.00 Gb: 0.03
scu>
format Command
This command is used to format both hard and flexible disk media.
Since this command modifies the disk media, the full command name must
be entered to be recognized.
Format:
scu> format [ defects defect-list ] [ interleave value ] \
[ density density-type ] [ flags value ] \
[ dlist defect-format ] [ options ... ] \
[ pattern value ] [ working time-value ]
Notes:
o If you specified a device via "sbtl" or "set nexus", then attempt
to format the disk, the mounted file system check will fail.
This is done purposely to prevent accidental formatting of disks
with mounted file systems.
o The flags keyword sets the format options in the format header.
o The current Linux SCSI sub-system only returns 16 bytes of request
sense data, so the format progress bytes cannot be obtained. For
this reason, you should NOT do a "format opt immed" command. It's
rumoured that the kernel 2.3 release will correct this problem.
Errors:
If file systems are mounted on the disk to be formatted, the following
error message is displayed and then formatting is aborted:
scu> format
scu: File system '/dev/rz14a' is mounted on '/mnt2',
EBUSY (16) - Mount device busy
scu>
Examples:
scu> time format defects primary options dcrt
Formatting device /dev/rrz8c (RZ25M), please be patient...
Working ... Thu Sep 28 09:54:47 1995
Working ... Thu Sep 28 09:56:47 1995
Working ... Thu Sep 28 09:58:47 1995
Working ... Thu Sep 28 10:00:47 1995
Working ... Thu Sep 28 10:02:47 1995
Elapsed time: 08m26.78s, System time: 00m00.00s, User time: 00m00.00s
scu>
defects Option
Specifies the defect list(s) to use during formatting of hard disks
(floppy diskettes do not have defect lists at the present time). If
this parameter is omitted, then the default is to format with all
known defects (primary and grown lists).
Format:
scu> format defects { all | primary | none }
Aliases:
all (known), primary (vendor)
Notes:
Specifying "none" results in the format data, complete list, and
defect list format fields being set to zero. These parameters are
vendor specific which means the target implementation determines
the degree of defect management to be performed.
Selection of the defect types sets the following Format options:
Defect Type FmtData CmpList
----------- ------- -------
all 1 0
primary 1 1
none 0 0
Setting of these bits in conjunction with the defect list format
can have different meaning depending on vendor implementation.
density Option
Specifies the density type for flexible disk media. The supported density
types are:
RX50, LD (low), DD (double), HD or HD5 (high), ED (extra), or other
Format:
scu> format density { RX50 | LD | DD | HD/HD5 | ED | other }
The default parameters associated with each density are:
RX50 Density Parameters:
heads = 1, sector/track = 10,
data_sector = 512, cylinders = 80,
step_pulse_cyl = 0, transfer_rate = 250
Low Density (LD) Parameters:
heads = 2, sector/track = 9,
data_sector = 512, cylinders = 40,
step_pulse_cyl = 0, transfer_rate = 250
Double Density (DD) Parameters:
heads = 2, sector/track = 9,
data_sector = 512, cylinders = 80,
step_pulse_cyl = 0, transfer_rate = 250
High Density (HD 3.5") Parameters:
heads = 2, sector/track = 18,
data_sector = 512, cylinders = 80,
step_pulse_cyl = 0, transfer_rate = 500
High Density (HD 5.25") Parameters:
heads = 2, sector/track = 15,
data_sector = 512, cylinders = 80,
step_pulse_cyl = 0, transfer_rate = 500
Extra Density (ED) Parameters:
heads = 2, sector/track = 36,
data_sector = 512, cylinders = 80,
step_pulse_cyl = 0, transfer_rate = 1000
If "other" is specified, you will be prompted for the flexible disk
page parameters to set prior to formatting the diskette.
dlist Option
Specifies the defect list format to send with the Format command.
In the case of DVD-RAM and CD-RW formats, this selects the proper
format descriptor for those devcies.
Format:
scu> format dlist { block | bfi | sector | dvd-ram | cd-rw }
Defect List Formats:
block = 0x0 = Logical block format.
dvd-ram = 0x1 = DVD-RAM defect format.
bfi = 0x4 = Bytes from index format.
sector = 0x5 = Physical sector format.
vendor = 0x6 = Vendor specific format.
cd-rw = 0x7 = CD-RW defect format type.
Notes:
o Normally the defect list format defaults to block format (0x0),
but no defect lists are sent to the target. For DVD-RAM or CD-RW,
you must specify the proper defect list format or you'll receive
an illegal request. Note: CD-RW is not fully supported.
o For DVD-RAM, only a full format is currently supported.
Example:
scu> format dlist dvd-ram
interleave Option
Specifies the interleave value to use during the format operation.
Format:
scu> format interleave value
Notes:
Please refer to drive manual to determine valid interleave values.
options Option
Allows you to specify format options which alter format operations.
Format:
scu> format options { dpry | dcrt | stpf | dsp | immed | tryout }
Where Options Are:
dpry = Disable Primary Defect List during format to identify
defective areas on the media.
dcrt = Disable Certification.
stpf = Stop Format on error conditions.
dsp = Disable Saving Parameter. Prohibits saving mode pages.
immed = Complete command after verifying format parameters.
The drive then procedes the format operation.
tryout = Examine whether the Format can be performed without
error, based on the available information. (SCSI-3)
Notes:
o Multiple options are permitted and values are or'ed accordingly.
o Please refer to drive manual to determine format options supported.
o If the immediate option is specified, the normal working message
is displayed with a percentage complete indication. This working
message is displayed every 2 minutes or until the format is done.
If this sequence is interrupted by a Ctrl/C, the drive formatting
continues, and can only be aborted by a bus or device reset.
Example:
scu> show nexus
Device: RZ28, Bus: 0, Target: 0, Lun: 0, Type: Direct Access
scu> time format defects primary options immed
Formatting device /dev/rrz0c (RZ28), please be patient...
Working ... (0% complete) ... Thu Sep 28 11:50:07 1995
Working ... (6% complete) ... Thu Sep 28 11:52:07 1995
.
.
Working ... (92% complete) ... Thu Sep 28 12:20:08 1995
Working ... (100% complete) ... Thu Sep 28 12:21:58 1995
Elapsed time: 31m50.38s, System time: 00m00.03s, User time: 00m00.00s
scu>
pattern Option
Specifies an initialization pattern to use during formatting blocks.
Format:
scu> format pattern value
Notes:
o The pattern length is determined by the pattern value specified.
If the pattern value >= 65535, then 2 bytes are sent, otherwise
4 pattern bytes are sent following the format defect header.
o Some drives will overwrite the initialization pattern with the
certification pattern (use "options dcrt" to disable this).
Example:
scu> time format pattern 0xaabb options dcrt
Formatting device /dev/rrz0h (RZ28), please be patient...
Elapsed time: 20m54.68s, System time: 00m00.01s, User time: 00m00.00s
scu>
working Option
This parameter controls thr frequency of the working messsage which
is displayed during the format operation. The default is 2 minutes,
and setting the value to 0 disables the working message altogether.
Format:
scu> format working time-value
help Command
This command displays help on topics. "?" is an alias.
Format:
scu> help [ topic ]
If you issue the help command without specifying a topic, then a list
of all available commands will be displayed.
initialize Command
This command is used with media changers to initialize element status.
Format:
scu> initialize elements
mbad Command
This command is used to make hard and/or soft errors on disk devices.
The SCSI Read and Write Long commands are used to accomplish this task.
Basically, a Read Long reads a disk sector with its' ECC bits. We then
flip a number of bits, depending on requested error type (hard or soft),
then re-write the sector using a Write Long. The sector is then read, to
ensure the expected error gets reported. This is a diagnostic feature.
Format:
scu> mbad lba n [ { hard | soft } ] [ flip bits ] \
[ length bytes ] [ nowrite ]
Notes:
o The default is to create a soft (recoverable) error.
o The number of bits to flip to create a hard or soft error are
obtained from an external file named "mbad.dat". If a matching
device entry is not located, then default values are used. The
"mbad.dat" file must exist in the current or /sbin directory to
be found, and the environment variable MBAD_FILE, can be defined
to override these defaults.
o The alias "size" is also accepted for the "length" keyword.
This parameter controls the initial Read Long sector size, but if
incorrect, is automatically adjusted and retried by the program.
o The "nowrite" option inhibits the Write Long operation.
o Since the hard or soft errors created by this command are fake,
simply re-writing the sector corrects the ECC and makes it good.
Examples:
scu> mbad lba 4110479 size 518
WARNING: Completed READ LONG using sector size of 558 bytes...
Making SOFT Error @ Logical Block 4110479 on device /dev/rrz0c (RZ28)...
scu>
scu> mbad lba 4110479 flip 128
Making SOFT Error @ Logical Block 4110479 on device /dev/rrz0c (RZ28)...
WARNING: Reading lba 4110479 did NOT report the expected SOFT Error!
scu: Sense Key = 0x3 = MEDIUM ERROR - Nonrecoverable medium error,
Sense Code/Qualifier = (0x11, 0) = Unrecovered read error
scu>
scu> write media lba 4110479
Writing 1 block (4110479 - 4110479) on /dev/rrz0c (RZ28) with pattern 0x39c39c39...
Writing block 4110479...
scu> mbad lba 4110479
Making SOFT Error @ Logical Block 4110479 on device /dev/rrz0c (RZ28)...
scu>
move Command
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-transport e-address ] [ invert ] \
[ drive value ] [ port value ] \
[ slot value ] [ transport value ] \
[ tags string ] [ atags string ] [ ptags string ]
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 'destination' keyword.
The alias 'mte' is accepted for the 'medium-transport' keyword.
The alias 'flip' is accepted for the 'invert' keyword.
The alias 'shelf' is accepted for the 'slot' keyword.
The alias 'picker' is accepted for the 'transport' keyword.
The alias 'door', 'mailbox', or 'mailslot' is valid for port.
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.
Example:
scu> move media ptag PAK300 drive 0
scu> show element ptag PAK300
Element Transport Exception Element Volume
Address Status State Type Tags
------- --------- --------- ------- ------
Drive 0: 240 Full Normal DT PAK300
scu>
mt Command
This command issues one of the supported 'mt' commands. Only those 'mt'
commands which do not require additional driver information have been
implemented.
Format:
scu> mt command [ count ]
For commands which accept a command count, if 'count' is omitted, the
count defaults to 1. Unless errors occur, the 'mt' commands execute
silently. Otherwise, the sense data (if any) returned from the failing
command is displayed.
bsf Option
This command is used to backward space file marks.
Format:
scu> mt bsf [ count ]
bsr Option
This command backward space file records.
Format:
scu> mt bsr [ count ]
erase Option
This command is used to erase the tape.
Format:
scu> mt erase
Notes:
Some tape drives will reject this command unless the tape is
positioned at beginning of media.
fsf Option
This command is used to forward space file marks.
Format:
scu> mt fsf [ count ]
fsr Option
This command is used to forward space file records.
Format:
scu> mt fsr [ count ]
load Option
This command is used to load the tape.
Format:
scu> mt load
Notes:
This command is the same as the 'mt online' command, except the
immediate bit is enabled so the command completes after the load
is initiated.
locate Option
This command is used to position tape medium to a specified block address.
Format:
scu> mt locate lba value
Alias:
The alias 'seek' is accepted for the 'locate' command.
locateds Option
This command is used to position tape medium to a specified device specific
block address.
Format:
scu> mt locateds lba value
Notes:
This command is identical to the 'locate' command except the block
identifier type (BT) bit will be set to 1. A BT bit of one indicates the
lba value field shall be interpreted as a vendor-specific value.
Alias:
The alias 'seekds' is accepted for the 'locateds' command.
offline Option
This command us used to take a tape offline (unload operation).
Format:
scu> mt offline
Alias:
The alias 'rewoffl' is accepted for the 'offline' command.
online Option
This command is used to bring a tape online (load operation).
Format:
scu> mt online
rdpos Option
This command is used to read the current medium block position.
Format:
scu> mt rdpos { short | long | devspec }
Options:
short - Use the short format of the READ POSITION command.
This provides the tape position in the form of a block
address which is an absolute SCSI logical block address.
It also provides information about the status of the tape
drive's buffer cache. See the SCSI documentation for details.
long - Use the long format of the READ POSITION command.
This provides the tape position in the form of file number
and SCSI logical block address.
devspec - Use the short format of the READ POSITION command
and ask the device to return the device specific address
instead of the SCSI logical block address.
The long and device specific formats of the READ POSITION command
are not supported by all devices. If the command is not supported
the device will return status of ILLEGAL REQUEST, INVALID FIELD IN CDB.
Notes:
o The keyword "tell" is accepted as an alias for "rdpos".
o If the command options are omitted, "short" is the default.
Example:
scu> mt seod
scu> mt rdpos
Read Position Information Short Format:
First Block: 801
Last Block: 801
Number of Blocks: 0
Number of Bytes: 0
scu> mt rew
scu> mt tell
Read Position Information Short Format:
Beginning of Partition
First Block: 0
Last Block: 0
Number of Blocks: 0
Number of Bytes: 0
scu>
rewind Option
This command is used to rewind the tape.
Format:
scu> mt rewind
retension Option
This command is used to retension the tape. Retension means moving the
tape one complete pass between EOT and BOT.
Format:
scu> mt retension
seod Option
This command is used to space to end of data (end of recorded media).
Format:
scu> mt seod
unload Option
This command us used to unload the tape.
Format:
scu> mt unload
Notes:
This command is the same as the 'mt offline' command, except the
immediate bit is enabled so the command completes after the unload
is initiated.
weof Option
This command is used to write tape file marks.
Format:
scu> mt weof [ count ]
Alias:
The alias 'eof' is accepted for the 'weof' command.
position Command
This command is used with medium changers to position to an element within
the jukebox (a.k.a. autochanger or mini-library). No media is moved.
Format:
scu> position element destination e-address \
[ medium-transport e-address ] \
[ drive value ] [ port value ] \
[ slot value ] [ transport value ] \
[ tags string ] [ atags string ] [ ptags string ]
Where:
e-address = Element address to position in front of.
Aliases:
The alias 'dst' is accepted for the 'destination' keyword.
The alias 'mte' is accepted for the 'medium-transport' keyword.
The alias 'shelf' is accepted for the 'slot' keyword.
The alias 'picker' is accepted for the 'transport' keyword.
The alias 'door', 'mailbox', or 'mailslot' is valid for port.
Notes:
Valid values 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.
Example:
scu> position element ptag PAK309
onerror Command
This command controls actions taken when errors occur. This is useful
for writing scripts which purposely generate errors, or to provide an
action to take on errors.
Format:
scu> onerror { continue | stop } command-action
Notes:
o The onerror setting is honored during "repeat" commands.
o The default action is to stop command execution on errors.
o If errors occur during command-action execution, the onerror
action reverts to stopping the command or exiting a script.
Example:
scu> onerror continue "show nexus ; show sense full"
scu> stop immed ; tur ; start
scu: 'test unit ready' failed, EIO (5) - I/O error
scu: Sense Key = 0x2 = NOT READY - Logical unit is NOT ready,
Sense Code/Qualifier = (0x4, 0x2) = Logical unit not ready, initializing command required
Device: RZ28, Bus: 0, Target: 0, Lun: 0, Type: Direct Access
Request Sense Information:
Error Code: 0x70 (Current Error)
Valid Bit: 0
Segment Number: 0
Sense Key: 0x2 (NOT READY - Logical unit is NOT ready)
Illegal Length: 0
End Of Media: 0
File Mark: 0
Information Field: 0
Additional Sense Length: 0xa
Command Specific Information: 0
Additional Sense Code/Qualifier: (0x4, 0x2) = Logical unit not ready, initializing command required
Field Replaceable Unit Code: 0
Sense Specific Bytes: 00 00 00
scu>
pause Command
This command is used to pause the playing of a CD-ROM audio disc.
Format:
scu> pause
play Command
This command is used to play audio tracks on a CD-ROM audio disc.
If keywords are omitted, then all audio tracks are played by default.
Format:
scu> play [ keywords ... ]
track Option
Plays the specified audio track number.
Format:
scu> play track n
range Option
Plays a range of audio tracks. It the starting track number is omitted,
the default is first audio track in the disc. If the ending track number
is omitted, the default is the last track on the audio disc.
Format:
scu> play [ [ starting_track [ n ] ] [ ending_track [ n ] ] ]
lba Option
Plays audio using the logical block addressing (LBA) format. Audio play
starts at the logical block address specified and continues through the
length (in blocks) specified.
Format:
scu> play audio lba n length n
msf Option
Plays audio using the minute/second/frame (MSF) addressing format. Audio
play starts at the MSF address specified and continues through the ending
MSF address specified.
Format:
scu> play msf starting minute-units second-units frame-units \
ending minute-units second-units frame-units
Aliases:
The aliases 'mu', 'su', & 'fu' can be used for minute-units,
second-units, and frame-units respectively.
prevent Command
This command prevents media removal from the selected device.
Format:
scu> prevent
preserve Command
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 }
aptpl Option
This option sets the Activate Persist Through Power Loss (APTPL) bit
in the persistent reservation out parameter list.
key Option
This option specified an 8-byte token for the Reservation Key field.
type Option
The option specifies the persistent reservation types:
Keyword (alias) Hex Code Description
--------------- -------- -----------
shared-read (sr) 0x00 Allow read sharing with other
initiators to the specified extent.
write-exclusive (wexc) 0x01 Inhibit read operations from all
initiators to the specified extent.
read-exclusive (rexc) 0x02 Inhibit writes operations from
all initiators to specified extent.
exclusive 0x03 Don't allow access from any other
initiator to the specified extent.
shared 0x04 Shared reads and writes permitted.
write-exclusive-ro (wero) 0x05 Write exclusive registrants only.
exclusive-ro (earo) 0x06 Exclusive access registrants only.
Notes:
If this keyword is omitted, the reservation type defaults to
exclusive access (equivalent of "reserve" command).
scope Option
The option specifies the reservation scope:
Keyword Hex Code Description
------- -------- -----------
LU 0x00 Reservation applies to the full logical unit.
extent 0x01 Reservation applies to the specified extent.
element 0x02 Reservation applies to the specified element.
The default for "scope" is LU (full logical unit).
"extent" requires: { lba starting-block length extent-length }
"element" requires: { address element-address }
skey Option
This option specifies an 8-byte token for the Service Action Reservation
Key field.
pwd Command
This command prints the working device, a.k.a. "show nexus". It comes
in handy when you are talking to multiple devices at the same time.
Format:
scu> pwd
Example:
scu> pwd
Device: TL800, Bus: 1, Target: 0, Lun: 0, Type: Medium Changer
scu>
read Command
This command performs various read operations from the selected device.
Format:
scu> read media [ test-parameters ]
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
media Option
This command reads the device media and performs a data comparison of
the data read. You must specify transfer parameters which specifies the
media area to be read, and the amount of data.
Format:
scu> read media [ test-parameters ] \
[ output file-name | append file-name ] \
[ flags value ] [ options ... ]
Alias:
o The alias '>' is accepted for the 'output' keyword.
o The alias '>>' is accpeted for the 'append' keyword.
o When using '>' and '>>' spaces are required around them
for proper parsing, for example " > audio.dat".
Notes:
o The flags keyword is used to specify command specific values.
This should be used to specify non-standard command options.
o The 'output' and 'append' options are used to write data read
to a file. This is especially useful when reading audio data.
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
Examples:
scu> read media
scu: No defaults, please specify test parameters for transfer...
scu> read media lba 100
Reading 1 block on /dev/rrz10c (RX23) using pattern 0x39c39c39...
scu> read media lba 100 pattern 0x12345678
Reading 1 block on /dev/rrz10c (RX23) using pattern 0x12345678...
scu: Data compare error at byte position 0
scu: Data expected = 0x78, data found = 0x39
scu> read media ending 100 compare off bs 10k
Reading 101 blocks on /dev/rrz10c (RX23)...
Reading blocks [ 0 through 19 ]...
Reading blocks [ 20 through 39 ]...
Reading blocks [ 40 through 59 ]...
Reading blocks [ 60 through 79 ]...
Reading blocks [ 80 through 99 ]...
scu>
options Option
Allows you to specify options which alter read operations.
Format:
scu> read media options { dpo | fua }
Where Options Are:
dpo = Disable page out. Indicates data should not be placed
in the cache or queued at the lowest priority.
fua = Force unit attention. Indicates the cache data should
be by-passed, and the media be accessed for the request.
Notes:
o Multiple options are permitted and values are or'ed accordingly.
o Please refer to the drive manual to determine options supported.
reassign Command
This command reassigns a defective block on a disk device. Since this
command modifies the disk media, the full command name must be entered
to be recognized.
Format:
scu> reassign lba n
release Command
This command releases a reserved SCSI device or releases a frozen SIM
queue (which occurs after an error).
Format:
scu> release { device | simqueue } [ nexus-information ]
device Option
This command releases a reserved SCSI device by issuing a release unit
command. If the rid keyword is specified, then the extent bit is set
and the reservation identification is sent in the release command.
Format:
scu> release device [ rid reservation-identification ]
simqueue Option
This command is used to issue a Release SIMQ CCB to thaw a frozen SIM
queue. Ordinarily, this command is not necessary since the SIM queue
is automatically released after errors occur. If the nexus information
is omitted, the SIM queue for the selected SCSI device will be released.
Format:
scu> release simqueue [ nexus-information ]
Example:
scu> release simqueue bus 1 target 6 lun 0
repeat Command
This command allows a repeat count to be performed on commands following.
Format:
scu> repeat value commands-to-issue
Notes:
Multiple commands can be entered by seperating them with semicolon.
Example:
scu> repeat 2 tur ; show capacity
Disk Capacity Information:
Maximum Capacity: 409792
Block Length: 512
Disk Capacity Information:
Maximum Capacity: 409792
Block Length: 512
scu>
reserve Command
This command is used to reserve a device or medium changer elements.
Format:
scu> reserve { device ... | elements ... }
device Option
This command reserves a SCSI device by issuing a reserve unit command.
By default, the entire logical unit is reserved for the exclusive use
of the initiator. For direct-access type devices supporting extents,
the reservation id, type, lba, and length may be specified.
Format:
scu> reserve device [ rid id [ rtype type ] [ lba n ] [ blocks n ] ]
Notes:
o This command only sends one reseveration extent at a time.
Use repeated reserve commands if multiple extents are desired.
o If the number of blocks is zero, the extent shall begin at the
specified logical block address and continue through the last
logical block address on the logical unit.
Example:
scu> reserve device rid 10 rtype shared lba 0x1000
rtype Option
This keyword selects the reservation type for the extent list. The
reservation types supported are:
Keyword Hex Code Description
------- -------- -----------
shared-read 0x00 Allow read sharing with other
initiators to the specified extent.
write-exclusive 0x01 Inhibit read operations from all
initiators to the specified extent.
read-exclusive 0x02 Inhibit writes operations from
all initiators to specified extent.
exclusive 0x03 Don't allow access from any other
initiator to the specified extent.
Notes:
If this keyword is omitted, the reservation type defaults to
shared-read access.
Format:
scu> reserve device rtype exclusive-access
elements Option
This command reserves medium changer elements.
Format:
scu> reserve elements [ starting e-address ] [ ending e-address ] \
[ number value ] [ type element-type ] \
[ drive value ] [ port value ] \
[ slot value ] [ transport value ] \
[ tags string ] [ atags string ] [ ptags string ] \
[ rid id ]
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 addresses can be
obtained by displaying the Element Address Assignment mode page.
o When specifiying drives, ports, slots, transports, or tags, only
one element will be reserved.
Example:
scu> reserve element type ST
reset Command
This command is used to reset the SCSI bus or the selected SCSI device.
Format:
scu> reset { bus | device } [ nexus-information ]
Notes:
Currently, the 'reset' commands only works on Tru64 Unix.
bus Option
Issues a CAM Bus Reset CCB. If the nexus information is omitted, the bus
associated with the selected SCSI device is reset.
Format:
scu> reset bus [ nexus-information ]
Restrictions Option
Since the Reset Bus command can cause loss of data to some devices,
this command is restricted to super user (root) access.
device Option
Issues a CAM Bus Device Reset CCB. If the nexus information is omitted,
then the selected device is reset.
Format:
scu> reset device [ nexus-information ]
Restrictions Option
Since the Reset Device command can cause loss of data to some devices,
this command requires write access to the selected device. If nexus
information is specified, then this command is restricted to super user
(root) access.
resume Command
This command is used with CD-ROM's to resume play after being paused.
Format:
scu> resume
rezero Command
This command requests that the target set the logical unit to a specific
state. This state is vendor specific.
Format:
scu> rezero
scan Command
This command is used to scan device media or the Equipment Device
Table (EDT).
Format:
scu> scan { edt [ [nexus-information] [ report-format ] ] }
{ media [ test-parameters ] }
edt Option
This command allows scanning of the SCSI bus which results in the
Equipment Device Table (EDT) being updated with devices found. If all
nexus information is omitted, then all SCSI buses are scanned, otherwise
the selected device is used to initialize the nexus information.
Format:
scu> scan edt [nexus-information]
Notes:
Scanning of SCSI buses is supported on Tru64 Unix and Windows/NT.
Please refer to the "Conventions" section for nexus-information help.
Examples:
scu> scan edt
Scanning all available buses, please be patient...
scu> scan edt pid 1
Scanning bus 1, please be patient...
scu> scan edt tid 4
Scanning bus 0, target 4, lun 0, please be patient...
scu>
media Option
This command scans the device media. This involves writing the media
with a data pattern and then reading and verifying the data written.
You must specify transfer parameters to define the media area to be
scanned.
Format:
scu> scan media [ test-parameters ]
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
Examples:
scu> scan media
scu: No defaults, please specify test parameters for transfer...
scu> scan media length 100 recovery off
Scanning 100 blocks on /dev/rrz10c (RX23) with pattern 0x39c39c39...
scu> scan media lba 200 limit 25k align '1p-1'
Scanning 50 blocks on /dev/rrz10c (RX23) with pattern 0x39c39c39...
scu> scan media starting 0 bs 32k records 10
Scanning 640 blocks on /dev/rrz10c (RX23) with pattern 0x39c39c39...
Scanning blocks [ 0 through 63 ]...
Scanning blocks [ 64 through 127 ]...
.
.
.
Scanning blocks [ 512 through 575 ]...
Scanning blocks [ 576 through 639 ]...
scu>
seek Command
This command is used with random access devices to seek to a specified
logical block address.
Format:
scu> seek lba value
set Command
This command is used to set parameters for a device or the program.
Format:
{ audio keywords ... }
{ cam keywords ... }
{ debug { on | off } }
{ default parameters ... }
{ device keywords ... }
{ dump keywords ... }
{ element keywords ... }
{ log file-name-path }
{ nexus nexus-information }
scu> set { pages [ mode-page [ pcf page-control ] ] }
{ pager "paging-filter" }
{ paging { on | off } }
{ position lba }
{ reassign keywords ... }
{ recovery { on | off } }
{ sense { brief | full } }
{ statistics { on | off } }
{ tape keywords ... }
{ timing { on | off } }
{ verbose { on | off } }
{ watch {on | off } }
{ width value }
Aliases:
The alias 'cdrom' is accepted for the 'audio' keyword', since
this command now controls both audio and CD-ROM parameters.
audio Option
Set parameters for a CD-ROM audio device.
Format:
{ address { lba | msf } }
scu> set audio { density { code hex-code | density-code } }
{ length block-length }
{ volume [ channel-{ 0 | 1 } ] level n }
Notes:
o Some CD-ROM's do not permit altering the density and/or
block length fields. For example, the DEC RRD42 (Sony
CDU-541) CD-ROM does not allow this, while the DEC RRD43/
RRD44 (Toshiba) CD-ROM's do allow this.
Aliases:
The alias 'cdrom' is accepted for the 'audio' keyword', since
this command now controls both audio and CD-ROM parameters.
address Option
Sets the default address format associated with CD-ROM audio commands.
The address formats are:
Format Description of Format
------ ---------------------
lba Logical Block Address.
msf Minute, Second, and Frame.
Format:
scu> set audio address { lba | msf }
Notes:
o Since this command modifies the device parameters, write
access to the device is required to issue this command.
density Option
Allows the density and/or block length to be changed. In the case
of the Toshiba XM-3401TA (RRD43/RRD44) CD-ROM's, setting the correct
density allows audio data to be read via the 'read media' command.
[ Hmmm... now that I can read this data what should I do with it? ]
Format:
scu> set cdrom density { code hex-code | density-string }
Where 'density-string' is one of the following:
String Density Code Block Length
------ ------------ ------------
default 0x0 512
xa-support 0x81 2048
cd-da 0x82 2352
mode1-xa 0x83 2048
Notes:
o The hex codes > 0x80 are vendor unique (Toshiba here).
o You must set the density to 'cd-da' to read audio data.
o Reading of audio data can only be done with 'read media'
at this time, since 'scu' honors the device block size.
o If you set the density to 'cd-da', you will NOT be able
to access the CD-ROM with the normal CAM disk driver.
[ The disk driver doesn't change the density code, so
attempts to set the block size to 512 will fail. ]
o To be safe, set the density code to 'default' when you
are done reading audio data.
Examples:
scu> set cdrom density cd-da
scu> show mode
Mode Parameters (Page 0 - current values):
Mode Parameter Header:
Mode Data Length: 11
Medium Type: 0 (Default Medium Type)
Device Specific Parameter: 0
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0x82 (CD-DA SCSI Transfer Mode)
Number of Logical Blocks: 0
Logical Block Length: 2352
scu> set watch off
scu> read media starting 0 length 100 compare off > audio.dat
Reading 100 blocks on [1/1/0] (CD-ROM)...
scu> set cdrom density default
scu> show mode
Mode Parameters (Current Values):
Mode Parameter Header:
Mode Data Length: 11
Medium Type: 0 (Default Medium Type)
Device Specific Parameter: 0
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0 (Default Density Code)
Number of Logical Blocks: 0
Logical Block Length: 512
scu>
length Option
Sets the CD-ROM block length to the specified value. If changing
both the density code and the block length, this keyword should
follow the density parameters, so both the density and length get
set (via a mode select) at the same time. Many combinations must
be set together, or else you'll get an "ILLEGAL REQUEST" error.
Format:
scu> set cdrom length block-size
Example:
scu> set cdrom length 2048
scu> show mode
Mode Parameters (Current Values):
Mode Parameter Header:
Mode Data Length: 11
Medium Type: 0 (Default Medium Type)
Device Specific Parameter: 0
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0 (Default Density Code)
Number of Logical Blocks: 0
Logical Block Length: 2048
scu>
scu> set cdrom density mode1-xa length 512
scu> show mode
Mode Parameters (Current Values):
Mode Parameter Header:
Mode Data Length: 11
Medium Type: 0 (Default Medium Type)
Device Specific Parameter: 0
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0x83 (Mode-1 and XA Form-1 Support)
Number of Logical Blocks: 0
Logical Block Length: 512
scu>
volume Option
Sets the audio volume control levels. You can change either the right
or left channels individually, or both channels at the same time.
Format:
scu> set audio volume [ channel-{ 0 | 1 } ] level n
Aliases:
You can use the alias "ch0" for "channel-0" or "ch1" for "channel-1".
cam Option
Allows you to set various parameters associated with the CAM sub-system.
Format:
{ debug { on | off } }
{ flags ccb-flags }
scu> set cam { options ccb-options }
{ retries { on | off } }
{ timeout value }
debug Option
Allows you to enable additional CAM debug information which lower level
Special I/O functions use.
Format:
scu> set cam debug { on | off }
flags Option
Allows you to specify CAM flags to be sent on CAM SCSI I/O CCB's.
Format:
scu> set cam flags hex-flags
Notes:
Setting these flags only affect 'scu' running on Tru64 Unix.
Where hex-flags permitted are:
CAM CCB Flag Name Hex Value Description
----------------- --------- -----------
CAM_DIS_DISCONNECT 0x00008000 Disable disconnect.
CAM_INITIATE_SYNC 0x00004000 Attempt Sync data xfer, and SDTR.
CAM_DIS_SYNC 0x00002000 Disable sync, go to async.
CAM_SIM_QHEAD 0x00001000 Place CCB at the head of SIM Q.
CAM_SIM_QFREEZE 0x00000800 Return the SIM Q to frozen state.
CAM_SIM_QFRZDIS 0x00000400 Disable SIM Q freeze on errors.
CAM_ENG_SYNC 0x00000200 Flush resid bytes before cmplt.
CAM_DIS_AUTOSENSE 0x00000020 Disable autosense feature.
The default CAM CCB flags used by the program is CAM_SIM_QFRZDIS.
Example:
scu> set cam flags 0x4000|0x400
options Option
Allows you to specify CAM options to send on CAM SCSI I/O CCB's.
Format:
scu> set cam options { ... }
Where the supported options are:
Option Name CAM CCB Flag Name Hex Value Description
----------- ----------------- --------- -----------
nodisc CAM_DIS_DISCONNECT 0x00008000 Disable disconnect.
sync CAM_INITIATE_SYNC 0x00004000 Attempt Sync data xfer, and SDTR.
nosync CAM_DIS_SYNC 0x00002000 Disable sync, go to async.
qhead CAM_SIM_QHEAD 0x00001000 Place CCB at the head of SIM Q.
qfreeze CAM_SIM_QFREEZE 0x00000800 Return the SIM Q to frozen state.
noqfreeze CAM_SIM_QFRZDIS 0x00000400 Disable SIM Q freeze on errors.
engsync CAM_ENG_SYNC 0x00000200 Flush resid bytes before cmplt.
noautosense CAM_DIS_AUTOSENSE 0x00000020 Disable autosense feature.
The default CAM CCB flags used by the program is CAM_SIM_QFRZDIS.
Aliases:
The alias "sdtr" is permitted for "sync" keyword.
The alias "noqfrz" is permitted for "noqfreeze" keyword.
The alias "nosense" is permitted for "noautosense" keyword.
Notes:
Multiple options are permitted and values are or'ed accordingly.
Example:
scu> set cam options nosync noqfreeze
retries Option
This command allows the special I/O error recovery to be enabled or
disabled. By default, device busy, reservation conflict, selection
timeout, and unit attentions are automatically retried when this flag
is enabled. These retries may be undesirable during certain testing,
e.g., checking for proper UNIT ATTENTION sense key after changing the
device media, or checking to see if another host reserved a device.
Format:
scu> set cam retries { on | off }
Notes:
o Automatic retries are enabled by default.
o For each of the retryable errors, described above, the special
I/O code delays for 2 seconds before retrying the command, and
retries up to a maximum of 30 times. Therefore, if automatic
retries are enabled and the error persists, an error is reported
after 1 minute.
Example:
scu> switch /dev/rmt0h
Switching to device entry /dev/rmt0h (TZK10)...
scu> set cam retries off
scu> tur
scu: 'test unit ready' failed, EIO (5) - I/O error
scu: Sense Key = 0x6 = UNIT ATTENTION - Medium changed or target reset,
Sense Code/Qualifier = (0x28, 0) = \
Not ready to ready transition (medium may have changed)
scu> tur
scu>
timeout Option
This command allows you to set a global timeout value used with all
SCSI CDB's issued. When this timeout value is zero (the default),
then the default timeout associated with the command being issued is
used (see cam_special_data.c for these timeout values).
Format:
scu> set cam timeout value
Notes:
o The timeout value specified is the number of seconds.
o You should only need to use this command if the default
command timeout is too short. This is evident, by the
CAM status being set to CAM_REQ_ABORTED, indicating the
command was aborted by the host (timer expired).
debug Option
This command allows the program debug flag to be enabled or disabled.
When enabled, the program displays command bytes and data sent and/or
received. If timing commands, the status of each command is reported.
Debugging is disabled by default.
Format:
scu> set debug { on | off }
Example:
scu> set debug on
scu> show capacity
SCSI Cmd = 'read capacity', CDB length = 10, CDB bytes: 25 0 0 0 0 0 0 0 0 0
Dumping SCSI Pass Through at 0x80b9638:
File Descriptor: 4
pack_length: 0
reply_len: 44
pack_id: 5935
result: 0
timeout: 18000 (180 seconds)
CDB Length: 10
CDB Bytes: 25 0 0 0 0 0 0 0 0 0
Dumping SCSI Pass Through at 0x80b9678:
File Descriptor: 4
pack_length: 44
reply_len: 44
pack_id: 5935
result: 0
sense_buffer: 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
'read capacity' completed, CAM status = 0x1 (CCB request completed w/out error)
Data received for 'read capacity' command:
0xbffffb50 02 1e b1 af 00 00 02 00
Completing 'read capacity' command with status 0 (Success).
Disk Capacity Information:
Maximum Capacity: 35566000 (17366.211 megabytes)
Block Length: 512
scu>
default Option
Allows you to change various program defaults.
Format:
scu> set default { savable | test-parameters }
savable Option
Allows you to specify whether the mode page parameters are saved or not.
By default, if the mode page is savable, then mode parameters being set
by the "set" or "change" page will be saved.
Format:
scu> set default savable { on | off }
test-parameters Option
Allows you to setup the I/O test parameter defaults. The test parameters
which can be set are:
Parameter Type Default Description
--------- ---- ------- -----------
align value 0 Data buffer alignment offset.
compare flag On Compare data during read operations.
dbbr flag 0 Dynamic bad block reassignment.
dbd flag 0 Disable mode sense block descriptors.
errors value 1 Test error limit.
limit value 0 Test data limit.
mode value 0 Read/write buffer mode value.
passes value 1 Number of passes to perform.
pattern value 0x39c39c39 Data pattern to use (1st pass).
recovery flag On Test error recovery (mode page).
segment value 8Kb Download firmware segment size.
size (bs) value 512 Block size per I/O request.
verify value -1 Verify media data limit (-1 = use max).
For type "flag", the parameter can be "1/0", "on/off", or "true/false".
Aliases:
The alias 'reassign' is accepted for the 'dbbr' keyword.
device Option
This command allows you to set various device parameters.
Format:
{ block-length value }
scu> set device { capacity value }
{ density-code value }
{ specific value }
Notes:
o Setting device parameters is accomplished via a Mode Select
command so write access to the device is necessary.
o The current setting of the mode page savable flag is used.
o Setting device parameters is not permitted to disks with
mounted file systems.
o With some devices, it may be necessary to re-format media
when changing the block length (vendor specific).
o The device capacity can be artificially reduced by changing
the capacity. Use care when saving this value, since you may
need the original capacity for resetting.
dump Option
This command allows you dump attributes to be modified.
Format:
{ buffer { on | off } }
{ filter "string" }
scu> set dump { limit value }
{ modulo value }
buffer Option
Allows the dump buffer flag to be enabled or disabled. When enabled,
the program dumps the data buffer during compare errors. By default,
this flag is enabled. The amount of data dump is controlled by the
"set dump limit n" command.
Format:
scu> set dump buffer { on | off }
filter Option
This command permits and external filter to be specified to dump data.
Format:
scu> set dump filter "string"
Example:
scu> set dump filter "od -Qvx | more"
limit Option
This command limits the number of bytes dumped during debugging. This
limit is used in conjunction with the dump buffer control flag. It limits
the number of data bytes displayed when buffer dumping is enabled and/or
the CAM debug flag CAMD_CMD_EXP is enabled during command execution. The
default value is 512 bytes.
Format:
scu> set dump limit value
modulo Option
This command controls rounding the number of fields displayed per line
to the modulo count specified. The number of fields is normally based
on the screen display width (or 80 columns if not directed to a terminal).
If the value specified exceeds the number of display fields calculated,
then it is ignored. By default, this value is 4.
Format:
scu> set dump modulo value
Notes:
The dump modulo is only used during the "dump media" command.
Example:
scu> set dump modulo 16
scu> dump media count 1
Reading 1 block (0 - 0) on /dev/rrz0c (RZ28)...
Record Number 1 (Starting Block 0)
00000000 dd cc bb aa dd cc bb aa dd cc bb aa dd cc bb aa
00000016 dd cc bb aa dd cc bb aa dd cc bb aa dd cc bb aa
00000032 dd cc bb aa dd cc bb aa dd cc bb aa dd cc bb aa
.
.
.
00000464 dd cc bb aa dd cc bb aa dd cc bb aa dd cc bb aa
00000480 dd cc bb aa dd cc bb aa dd cc bb aa dd cc bb aa
00000496 dd cc bb aa dd cc bb aa dd cc bb aa dd cc bb aa
scu>
element Option
This command is used to assert, replace, or undefine a volume tag.
Format:
scu> set element [ action { assert | replace | undefine } ] \
[ drive value ] [ port value ] \
[ slot value ] [ transport value ] \
[ tag string ] [ atag string ] [ ptag string ]
Notes:
o The drive, port, slot, and transport keyword define which
element to operate on.
o The tag, atag, and ptag describe the primary or alternate tag.
o The tag and ptag keywords are equivalent for this commnad.
log Option
This command is used to open a log file for capturing text displayed by
the program. When logging is active, text output is written to both the
log file and the terminal. This command provides a simple mechanism to
log an interactive session, similar to capability provided by 'script'.
Format:
scu> set log file-name-path
Notes:
This command is also used to close an existing log file by specifying
a null file name string. Both standard output and standard error
text is captured in the log file. The text displayed by the "help"
command is not saved in the log file.
nexus Option
This command sets up the device nexus information (bus/target/lun) when
a SCSI device entry is not specified during program startup. Normally,
this information is automatically obtained and setup from the associated
device driver using the DEVIOCGET I/O control command.
Format:
scu> set nexus nexus-information
Example:
scu> set nexus bus 1 target 6 lun 0
Aliases:
The alias "pid" (path ID) is permitted for "bus" keyword.
The alias "tid" (target ID) is permitted for "target" keyword.
Notes:
o Also see the "sbtl bus target lun" shorthand command.
o If the "lun" keyword is omitted, this field defaults to "0".
o The shorthand commands "spid n", "stid n", and "slun 0" can also
be used to set or change the bus, target, or lun (respectively).
o For commands requiring a nexus, if the nexus information is not
setup, the command is aborted with the following error message:
scu: All or part of device nexus information (b/t/l) is NOT setup yet!
o After setting the nexus information, an attempt is made to get
the EDT entry associated with this nexus. If an EDT entry does
not exist for this nexus, the following error message is displayed:
scu: [1/0/0] CAM CCB function 'XPT_GDEV_TYPE' failed,
CAM status = CAM_DEV_NOT_THERE (0x8) - Device not installed/there
scu: 'get device type' failed, EIO (5) - I/O error
o For commands targeted for a particular SCSI device type, if the
device type is not setup, then the command is aborted with the
following error message:
scu: DEVICE_TYPE device (DEVICE_NAME) does NOT support this command.
The "set device" command can also be used to setup the device
type or to override the existing device type.
pages Option
This command allows you to set various mode page fields. The field
names accepted for a particular page are displayed by the "show layout"
command.
Format:
{ [ code hex-code ] }
scu> set pages { [ mode-page ] } [ field-name ] [ pcf page-control ]
Note:
o Setting multiple page fields is support (see below).
o The default page control field is "current" values.
o Setting page values always affects the current page values.
o The default is to save page values if the page saveable bit
in the page header is set and the program savable flag is set.
Use the "set default savable" command to alter this latter flag.
o Some pages, such as those that affect the physical media, do
not actually get saved until the media is formatted.
Example:
scu> show layout error
Read-Write Error Recovery Page Layout (Page 0x1)
Field Description & Offset/Bit Information Set Name
------------------------------------------ --------
Disable Correction (DCR) (byte 2, bit 0) -> dcr
Disable Transfer on Error (DTE) (byte 2, bit 1) -> dte
Post Recoverable Error (PER) (byte 2, bit 2) -> per
Enable Early Recovery (EER) (byte 2, bit 3) -> eer
Read Continuous (RC) (byte 2, bit 4) -> rc
Transfer Block (TB) (byte 2, bit 5) -> tb
Reserved (byte 2, bits 6:7) ->
Read Retry Count (byte 3) -> read_retry_count
Reserved (byte 4) ->
Reserved (byte 5) ->
Reserved (byte 6) ->
Reserved (byte 7) ->
scu> show page error
Read-Write Error Recovery Parameters (Page 0x1 - Current Values):
Mode Parameter Header:
Mode Data Length: 19
Medium Type: 0 (Default Medium Type)
Device Specific Parameter: 0
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0x83 (Mode-1 and XA Form-1 Support)
Number of Logical Blocks: 0
Logical Block Length: 512
Page Header / Data:
Page Code: 0x1
Parameters Savable: No
Page Length: 6
Disable Correction (DCR): No
Disable Transfer on Error (DTE): No
Post Recoverable Error (PER): No
Enable Early Recovery (EER): No
Read Continuous (RC): No
Transfer Block (TB): No
Read Retry Count: 5
scu> set default savable off
scu> set page error per on tb on
Setting Read-Write Error Recovery Parameters (Page 0x1 - Current Values):
scu> show page error
Read-Write Error Recovery Parameters (Page 0x1 - Current Values):
Mode Parameter Header:
Mode Data Length: 19
Medium Type: 0 (Default Medium Type)
Device Specific Parameter: 0
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0x83 (Mode-1 and XA Form-1 Support)
Number of Logical Blocks: 0
Logical Block Length: 512
Page Header / Data:
Page Code: 0x1
Parameters Savable: No
Page Length: 6
Disable Correction (DCR): No
Disable Transfer on Error (DTE): No
Post Recoverable Error (PER): Yes
Enable Early Recovery (EER): No
Read Continuous (RC): No
Transfer Block (TB): Yes
Read Retry Count: 5
scu>
code Option
For mode pages which are unknown to the program, a hex page code can be
specified for the page to display. The page conntrol field selected is
used to set the new page values.
Format:
scu> set page code hex-code [ pcf page-control ]
Example:
scu> set page code 0x21 pcf default
Setting Unknown Page Parameters (Page 21)
scu>
mode-page Option
Describes the mode page to operate on. The pages supported are:
'scu' Keyword Page Code Description
------------- --------- -----------
error-recovery 0x01 Error recovery page.
disconnect | reconnect 0x02 Disconnect/reconnect page.
format-device 0x03 Format device mode page.
geometry | rigid 0x04 Disk geometry page.
flexible 0x05 Flexible disk page.
optical-memory 0x06 Optical memory page.
verify-recovery 0x07 Verify error recovery page.
cache-control 0x08 Cache control page.
peripheral-device 0x09 Peripheral device page.
control-mode 0x0A Control Mode Page.
medium-types | mtypes 0x0B Medium types supported page.
notch-partition 0x0C Notch and partition page.
cdrom 0x0D CD-ROM device page.
power-condition 0x0D Power condition page.
audio-control 0x0E Audio control page.
compression 0x0F Data compression page.
device-configuration 0x10 Device configuration page.
medium-partition1 0x11 Medium parition page 1.
tapealert 0x1C TapeAlert control page.
element-address 0x1D Element address assignment.
transport-geometry 0x1E Transport geometry parameters.
device-capabilities 0x1F Device capabilities page.
dec-control 0x25 DEC special control Page.
cdcap 0x2A CD-ROM capabilities page.
library 0x2E Library configuration page.
Notes:
o The format-device page was previously named the direct-access page,
so either keyword is accepted.
o The dec-control page was previously named the dec-specific page,
so either keyword is accepted.
pcf Option
The page control field determines the type of parameters to be selected.
The defined page control fields are:
Format:
scu> set pages pcf { current | changeable | default | saved }
position Option
This command is used with random access devices to seek to a specified
logical block address.
Format:
scu> set position lba value
Notes:
This command is deprecated, see "seek lba n" command.
pager Option
The pager specifies the external program(s) to perform screen paging.
If you do not specify a pager, then the default pager is "more -d".
Format:
scu> set pager "paging-filter"
paging Option
This command controls paging when outputting to a terminal device. By
default, paging is enabled when standard output is a terminal device.
Format:
scu> set paging { on | off }
reassign Option
This command allows you to change reassign block parameters.
Format:
scu> set reassign { preserve { on | off } }
{ recoverable { on | off } }
preserve Option
This flag is used to control whether data is preserved when reassigning
defective blocks. The default is to attempt to preserve the data via
reading the defective block, and then rewriting the data after the block
is reassigned.
Format:
scu> set reassign preserve { on | off }
recoverable Option
This flag is used to control whether all recoverable errors are reassigned
automatically during tests to map out marginal blocks. The default is to
only automatically reassign recoverable errors with the following additional
sense code/qualifiers:
asc / ascq Description
---------- -----------
0x17, 0x07 Recovered data without ECC - recommend reassignment
0x18, 0x05 Recovered data - recommend reassignment
0x11, 0x0b Unrecovered read error - recommend reassignment
Format:
scu> set reassign recoverable { on | off }
Notes:
o This flag affects defective block reassignment when dynamic bad
block reassignment (dbbr) is enabled during tests.
o This flag also affects defective blocks reported during the reassign
command which get added to the reassign defect list and retried.
o This flag does not affect blocks specified with the "reassign lba"
command.
recovery Option
This command allows you to enable or disable the error control parameters
for the selected device. Ordinarily, the current parameters are used,
which are setup from either the saved or the default error control pages
when the drive is powered on. The normal default is for error correction
to be enabled. Disabling error correction is useful during device testing.
Format:
scu> set recovery { on | off } [ retries value ]
Notes:
o When disabling error recovery, the previous error control bits
are saved and the disable correction (DCR), disable transfer on
error (DTE), post recoverable error (PER), and transfer block on
error (TB) bits are set, while all other but are cleared. The
read and write retry counts are also set to zero.
o When enabling error recovery, either the previously saved error
control bits are used or the error control bits from the default
error page.
o Only the current error page parameters are affected.
o Some devices, such as the TZK10 or TZK11 QIC tapes, do not allow
the retry count to be set to zero. The retry counts must be set
between 1-24 for read retries, and 1-16 for write retries. Use
the optional "retries value" keyword to specify the retry count.
o If you get an illegal request when issuing this command, you'll
probably need to refer to the apprioriate vendor drive manual.
Examples:
scu> show nexus
Device: TZK10, Bus: 0, Target: 5, Lun: 0, Type: Sequential Access
scu> set recovery off
scu: 'mode select (6)' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x26, 0) = Invalid field in parameter list
scu> set recovery off retries 1
scu> show page error
Read-Write Error Recovery Parameters (Page 0x1 - Current Values):
Mode Parameter Header:
Mode Data Length: 23
Medium Type: 0x3
Tape Speed: 0 (Using Default Speed)
Buffered Mode: 0x1 (Buffering Enabled)
Write Protected: No
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0xf (10000 BPI, QIC-120 (GCR, C))
Number of Logical Blocks: 0
Logical Block Length: 512
Page Header / Data:
Page Code: 0x1
Parameters Savable: Yes
Page Length: 10
Disable Correction (DCR): Yes
Disable Transfer on Error (DTE): No
Post Recoverable Error (PER): Yes
Enable Early Recovery (EER): Yes
Transfer Block (TB): Yes
Read Retry Count: 1
Write Retry Count: 1
scu> set recovery on
scu> show page error
Read-Write Error Recovery Parameters (Page 0x1 - Current Values):
Mode Parameter Header:
Mode Data Length: 23
Medium Type: 0x3
Tape Speed: 0 (Using Default Speed)
Buffered Mode: 0x1 (Buffering Enabled)
Write Protected: No
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0xf (10000 BPI, QIC-120 (GCR, C))
Number of Logical Blocks: 0
Logical Block Length: 512
Page Header / Data:
Page Code: 0x1
Parameters Savable: Yes
Page Length: 10
Disable Correction (DCR): No
Disable Transfer on Error (DTE): No
Post Recoverable Error (PER): No
Enable Early Recovery (EER): Yes
Transfer Block (TB): Yes
Read Retry Count: 24
Write Retry Count: 16
scu>
sense Option
This command allows you to set the default request sense display format.
By default, sense data is reported in a brief format which includes the
decoded sense key and additional sense code/qualifier. When full format
is enabled, all the request sense data gets displayed.
Format:
scu> set sense { brief | full }
Notes:
o The default is brief display format.
o The alias "error" is accepted for the "sense" keyword.
o Full format always gets displayed when debug is enabled.
Examples:
scu> set nexus pid 0 tid 4 lun 0
Device: RRD43, Bus: 0, Target: 4, Lun: 0, Type: Read-Only Direct Access
scu> set sense brief
scu> tur
scu: 'test unit ready' failed, EIO (5) - I/O error
scu: Sense Key = 0x2 = NOT READY - Logical unit is NOT ready,
Sense Code/Qualifier = (0x3a, 0) = Medium not present
scu> set sense full
scu> tur
scu: 'test unit ready' failed, EIO (5) - I/O error
Request Sense Information:
Error Code: 0x70 (Current Error)
Valid Bit: 0
Segment Number: 0
Sense Key: 0x2 (NOT READY - Logical unit is NOT ready)
Illegal Length: 0
End Of Media: 0
File Mark: 0
Information Field: 0
Additional Sense Length: 0xa
Command Specific Information: 0
Additional Sense Code/Qualifier: (0x3a, 0) = Medium not present
Field Replaceable Unit Code: 0
Sense Specific Bytes: 00 00 00
scu>
statistics Option
This command controls reporting of test statistics on read and write
media test commands. By default, statistics are not displayed.
Format:
scu> set statistics { on | off }
Notes:
The alias 'stats' is accepted for the 'statistics' keyword.
Example:
scu> set watch off
scu> set statistics on
scu> write media bs 1m limit 100m
Writing 204800 blocks (0 - 204799) on /dev/rrz0c (RZ28) with pattern 0x39c39c39...
Total Statistics:
Device Name/Type: RZ28 (Direct Access)
Nexus Information: Bus=0, Target=0, Lun=0
Total Records Processed: 100 @ 1048576 bytes/record (1024.000 Kbytes)
Total Bytes Transferred: 104857600 (102400.000 Kbytes, 100.000 Mbytes)
Average Transfer Rates: 4529486 bytes/sec, 4423.326 Kbytes/sec
Total Passes Completed: 1/1
Total Errors Detected: 0/10
Total Elapsed Time: 00m23.15s
Total System Time: 00m00.48s
Total User Time: 00m00.20s
Starting time: Fri Oct 27 17:21:22 1995
Ending time: Fri Oct 27 17:21:46 1995
scu>
tape Option
Sets parameters for sequential access devices (magnetic tapes).
Format:
{ blocking { fixed [ size ] | variable } }
scu> set tape { buffered mode }
{ density { code value | type } }
Errors:
If the tape drive does not support changing the specified parameter,
you will receive the following error message:
scu> set tape density QIC-1G
scu: 'mode select' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x26, 0) = Invalid field in parameter list
scu>
blocking Option
This parameter allows you to switch the blocking mode between fixed
and variable length records for tape devices which support both modes.
For example, QIC tape devices like the TZK10 allow both blocking modes.
Format:
scu> set tape blocking { fixed [ size ] | variable }
Notes:
When setting "fixed" blocking mode, if the "size" value is omitted,
the default is either 512 bytes or the last specified block size.
Example:
scu> set tape blocking fixed
scu> show mode
Mode Parameters (Current Values):
Mode Parameter Header:
Mode Data Length: 99
Medium Type: 0x3
Tape Speed: 0 (Using Default Speed)
Buffered Mode: 0x1 (Buffering Enabled)
Write Protected: No
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0xf (10000 BPI, QIC-120 (GCR, C))
Number of Logical Blocks: 0
Logical Block Length: 512
scu>
buffered Option
This parameter allows the buffered mode to be changed. This parameter
controls whether the tape controller uses its' data buffer during reads
and writes. When buffered mode is disabled (0), no data buffering is
performed and write requests are not completed until the data is written
to the physical media. When buffering mode is enabled, write requests
complete as soon as the requested data is transferred to the drive's data
buffer.
scu> set tape buffered mode
Notes:
o Normally, buffered mode is enabled to provide better performance.
o The "mode" parameter is a value in the range between 0 - 7. Most
tapes drives only support modes 0 (disabled) or 1 (enabled).
Example:
scu> set tape buffered 0
scu> show mode
Mode Parameters (Current Values):
Mode Parameter Header:
Mode Data Length: 99
Medium Type: 0x3
Tape Speed: 0 (Using Default Speed)
Buffered Mode: 0 (Buffering Disabled)
Write Protected: No
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0xf (10000 BPI, QIC-120 (GCR, C))
Number of Logical Blocks: 0
Logical Block Length: 0
scu>
density Option
This parameter allows you to change the tape density before writing the
tape, for those tape drives which support multiple densities.
Format:
scu> set tape density { code value | type }
The known tape density codes and the value they equate to are listed
below. The Density Type keyword is accepted for the "type" parameter.
Density Type Description Density Code
------------ -------------------------- ------------
default Default Density 0x00
800-BPI 800 BPI (NRZI, R) 0x01
1600-BPI 1600 BPI (PE, R) 0x02
6250-BPI 6250 BPI (GCR, R) 0x03
8000-BPI 8000 BPI (GCR, C) 0x04
QIC-24 8000 BPI, QIC-24 (GCR, C) 0x05
3200-BPI 3200 BPI (PE, R) 0x06
6400-BPI 6400 BPI (IMFM, C) 0x07
8000-BPI 8000 BPI (GCR, CS) 0x08
38000-BPI 37871 BPI (GCR, C) 0x09
6666-BPI 6667 BPI (MFM, C) 0x0A
1600-BPI 1600 BPI (PE, C) 0x0B
12690-BPI 12690 BPI (GCR, C) 0x0C
QIC-120-ECC 10000 BPI, QIC-120 with ECC 0x0D
QIC-150-ECC 10000 BPI, QIC-150 with ECC 0x0E
QIC-120 10000 BPI, QIC-120 (GCR, C) 0x0F
QIC-150 10000 BPI, QIC-150 (GCR, C) 0x10
QIC-320 16000 BPI, QIC-320 (GCR, C) 0x11
QIC-1350 51667 BPI, QIC-1350 (RLL, C) 0x12
61000-BPI 61000 BPI, 4mm Tape (DDS, CS) 0x13
54000-BPI 54000 BPI, 8mm Tape (RLL, CS) 0x14
45434-BPI 45434 BPI, 8mm Tape (RLL, CS) 0x15
10000-BPI 10000 BPI (MFM, C) 0x16
42500-BPI 42500 BPI (MFM, CS) 0x17
42500-BPI 42500 BPI (MFM, CS) 0x18
62500-BPI 62500 BPI (MFM, CS) 0x19
81630-BPI 81630 BPI (MFM, CS) 0x1A
85700-BPI 85700 BPI (MFM, CS) 0x1B
QIC-385M 42000 BPI, QIC-385M (MFM, C) 0x1C
QIC-410M 38400 BPI, QIC-410M (GCR, C) 0x1D
QIC-1G 36000 BPI, QIC-1G (GCR, C) 0x1E
QIC-2100C 67733 BPI, QIC-2100C (RLL, C) 0x1F
QIC-6G 67733 BPI, QIC-6G (RLL, C) 0x20
QIC-20G 67733 BPI, QIC-20G (RLL, C) 0x21
QIC-2G 40640 BPI, QIC-2G (GCR, C) 0x22
QIC-875M 67733 BPI, QIC-875M (RLL, C) 0x23
DDS-2 61000 BPI, DDS-2 (???, CS) 0x24
DDS-3 97000 BPI, DDS-3 (???, CS) 0x25
DDS-4 97000 BPI, DDS-4 (???, CS) 0x26
77611-BPI 77611 BPI (RLL, CS) 0x27
37871-BPI 37871 BPI (GCR, C) 0x28
116000-BPI 116000 BPI (RLL, CS) 0x30
167000-BPI 167000 BPI 0x31
98250-BPI 98250 BPI 0x41
Notes:
o Normally, changing tape density must be done while positioned
at beginning of tape (BOT) since most drives are restricted to
a single tape density.
o With most QIC tape devices, the actual density code is not known
until a tape movement command is issued to the drive. This can
be accomlished by reading, writing, or spacing a tape record.
o The "code" parameter accepts any value in the range of 0 - 255.
Errors:
If the current media in the tape drive does not support the density
code you specified, you will receive the following error message when
attempting to write data to the media:
scu> write media records 1
Writing 1024 bytes on [0/5/0] (TZK10) with pattern 0x39c39c39...
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x30, 0) = Incompatible medium installed
scu>
Example:
scu> mt rewind
scu> set tape density QIC-120
scu> set tape blocking variable
scu> set tape density QIC-120
scu> set tape blocking variable
scu> show mode
Mode Parameters (Current Values):
Mode Parameter Header:
Mode Data Length: 99
Medium Type: 0x3
Tape Speed: 0 (Using Default Speed)
Buffered Mode: 0x1 (Buffering Enabled)
Write Protected: No
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0 (Default Density)
Number of Logical Blocks: 0
Logical Block Length: 0
scu> write media records 1
Writing 512 bytes on /dev/rmt0h (TZK10) with pattern 0x39c39c39...
scu> show mode
Mode Parameters (Current Values):
Mode Parameter Header:
Mode Data Length: 99
Medium Type: 0x3
Tape Speed: 0 (Using Default Speed)
Buffered Mode: 0x1 (Buffering Enabled)
Write Protected: No
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0xf (10000 BPI, QIC-120 (GCR, C))
Number of Logical Blocks: 0
Logical Block Length: 0
scu>
timing Option
This command controls timing of commands executed. The time displayed
is for the entire command line (not individual commands).
Format:
scu> set timing { on | off }
Notes:
o Since timing is limited to system time resolution, it is possible
for some commands to be executed with zero elapsed time. In this
case, timing information is _not_ displayed.
Example:
scu> set timing on
scu> verify media limit 25m
Verifying 51200 blocks (0 - 51199) on /dev/rrz9c (RZ26L), please be patient...
Verifying blocks [ 0 through 51199 ]...
Elapsed time: 00m21.70s, System time: 00m00.00s, User time: 00m00.00s
scu>
verbose Option
This command controls the verbosity of output displayed by the program.
By default, verbose display is enabled.
Format:
scu> set verbose { on | off }
Example:
scu> set watch off
scu> scan media starting 50 ending 250 bs 32k
Scanning 201 blocks on /dev/rrz14c (RZ55) with pattern 0x39c39c39...
scu> set verbose off
scu> scan media starting 50 ending 250 bs 32k
scu>
vwatch Option
This command controls watching verify progress during various tests.
The flag is enabled by default. If you specify a small block size, it
maybe desirable to disable this flag since it'll affect performance.
Format:
scu> set vwatch { on | off }
Example:
scu> verify media lba 100 length 100 bs 10k
Verifying 100 blocks on /dev/rrz14c (RZ55), please be patient...
Verifying blocks [ 100 through 119 ]...
Verifying blocks [ 120 through 139 ]...
Verifying blocks [ 140 through 159 ]...
Verifying blocks [ 160 through 179 ]...
Verifying blocks [ 180 through 199 ]...
scu> set vwatch off
scu> verify media lba 100 length 100 bs 10k
Verifying 100 blocks on /dev/rrz14c (RZ55), please be patient...
scu>
watch Option
This command controls watching I/O progress during various tests. By
default, this flag is disabled. Please be aware, that enabling this
flag drastically increases test times due to the output displayed.
Format:
scu> set watch { on | off }
Example:
scu> read media starting 0 bs 64k limit 25m compare off
Reading 51200 blocks (0 - 51199) on /dev/rrz0c (RZ26B)...
scu> set watch on
scu> read media starting 0 bs 64k limit 25m compare off
Reading 51200 blocks (0 - 51199) on /dev/rrz0c (RZ26B)...
Reading blocks [ 0 through 127 ]...
Reading blocks [ 128 through 255 ]...
Reading blocks [ 256 through 383 ]...
...
Reading blocks [ 51072 through 51199 ]...
scu>
width Option
This command controls the default display width. The default display
width is normamly 80 characters or the terminal width when attached to
a terminal. This command is useful from within scripts to set the
display width wider.
Format:
scu> set width value
Example:
scu> set width 100
slun Command
This is a shorthand command used to set the nexus lun value. This is
the equivalent of "set nexus lun n" (lun = logical unit number).
Format:
scu> slun lun-value
sbtl Command
This is a shorthand command used to set or show the device nexus information.
If no parameters are specified, then the current nexus values are displayed,
otherwise the bus, target, and lun are taken to switch to a new device. This
command is analogous to the "set nexus" command.
Format:
scu> sbtl [ bus ] [ target ] [ lun ]
Example:
scu> sbtl 0 1
Device: RZ28D, Bus: 0, Target: 1, Lun: 0, Type: Direct Access
scu>
spid Command
This is a shorthand command used to set the nexus pid (path ID) value.
This is the equivalent of "set nexus pid n" (pid = SCSI bus).
Format:
scu> spid pid-value
Aliases:
The alias "sbus" is permitted for the "spid" command.
stid Command
This is a shorthand command used to set the nexus tid (target ID) value.
This is the equivalent of "set nexus tid n" (tid = SCSI target ID).
Format:
scu> stid tid-value
Aliases:
The alias "starget" is permitted for the "stid" command.
shell Command
This command allow you to temporarily escape to your system shell. Upon
exiting this shell, you'll return the 'scu' program. This command is
useful if you have several shell commands you'd like to enter, where
the "system" command only allows one command at a time.
Format:
scu> shell
Examples:
scu> shell
$ who
rmiller :0 Jan 06 08:36
rmiller ttyp3 Jan 06 08:36 (im2fast)
rmiller ttyp6 Jan 06 08:36 (im2fast)
rmiller ttyp2 Jan 06 08:36 (im2fast)
rmiller ttyp5 Jan 06 08:36 (im2fast)
$ mail
No mail.
$ exit
scu>
show Command
This command is used to display parameters for a device or the program.
Format:
{ audio keywords... }
{ cam { status value } }
{ capacity }
{ defects defect-list defect-format }
{ device [ nexus-information ] }
{ diagnostic pages }
{ edt [ [ nexus-information ] [ report-format ] ] }
{ elements [ parameters... ] }
{ inquiry [ pages [ parameters... ] ] }
{ keys }
scu> show { layout page }
{ log pages [ parameters... ] }
{ luns }
{ memory [ parameters... ] }
{ mode-parameters }
{ nexus }
{ pages [ parameters... ] }
{ path-inquiry [ nexus-information ] }
{ reservations }
{ scsi { ascq value | key value | status value } }
{ sense { brief | full } }
{ statistics }
audio Option
Displays information for a CD-ROM audio device.
Format:
{ channel }
{ catalog }
{ isrc }
scu> show audio { header lba n } [ address-format ]
{ position }
{ status }
{ toc [ toc-parameters ] }
{ volume }
channel Option
Displays all Sub-Q channel information.
Format:
scu> show audio channel [ address-format ]
Example:
scu> show audio channel
Current Position Information:
Track Number: 1
Index Number: 0
Absolute Logical Block Address: 4607972
Relative Logical Block Address: 28
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
Media Catalog Number Information:
Media Catalog Valid: Yes
Media Catalog Number: 0 75 99 3 48 2 90 0 0 0 0 0 0 0 0
ISRC Information:
Track Number: 1
Track Code Valid: No
scu>
catalog Option
Displays the media catalog number (if any).
Format:
scu> show audio catalog [ address-format ]
Example:
scu> show audio catalog
CD-ROM Sub-Channel Header:
Audio Status: Audio Play Operation Paused
Data Length: 20
Media Catalog Number Information:
Media Catalog Valid: Yes
Media Catalog Number: 0 75 99 3 48 2 90 0 0 0 0 0 0 0 0
scu>
isrc Option
Displays the ISRC information (if any).
ISRC = International Standard Recording Code.
Format:
scu> show audio isrc [ address-format ]
Example:
scu> show audio isrc
CD-ROM Sub-Channel Header:
Audio Status: Audio Play Operation Paused
Data Length: 20
ISRC Information:
Track Number: 1
Track Code Valid: No
scu>
header Option
Displays the logical block address associated with the current position.
Format:
scu> show audio header lba n [ address-format ]
position Option
Displays the current play position information.
Format:
scu> show audio position [ address-format ]
Example:
scu> show audio position
CD-ROM Sub-Channel Header:
Audio Status: Audio Play Operation Paused
Data Length: 12
Current Position Information:
Track Number: 1
Index Number: 0
Absolute Logical Block Address: 4607972
Relative Logical Block Address: 28
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
scu>
status Option
Displays the current playback status information.
Format:
scu> show audio status [ address-format ]
Note:
This command displays the same information as the "show audio position"
command, and exists for backward compatability with the RRD42 playback
status command which was vendor unique.
Example:
scu> show audio status
CD-ROM Sub-Channel Header:
Audio Status: Audio Play Operation In Progess
Data Length: 12
Current Position Information:
Track Number: 3
Index Number: 1
Absolute Logical Block Address: 346744
Relative Logical Block Address: 93712
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Encodes Current Position Data
scu>
toc Option
Displays the table of contents (TOC) for the current audio disc in the
drive. You can display just the TOC header, a single TOC entry, or the
entire table of contents in either a full or summary report format. If
keywords are omitted, the entire TOC is displayed in summary format.
Format:
scu> show audio toc [ { entry n | header } ] \
[ address-format ] [ report-format ]
Examples Option
The following examples show the difference between lba and msf address
formats. The lba format is useful if you are changing the block size,
and are looking for the new starting logical block address and length
using this new block size (especially useful when reading audio data).
scu> set cdrom block 2048
scu> show capacity
Disk Capacity Information:
Maximum Capacity: 348060 (679.805 megabytes)
Block Length: 2048
scu> show audio toc
Table of Contents Summary:
Track 1: Audio Track, Time: 04:21, LBA: 0, Length: 78301
Track 2: Audio Track, Time: 03:48, LBA: 78300, Length: 68521
Track 3: Audio Track, Time: 04:56, LBA: 146820, Length: 88761
Track 4: Audio Track, Time: 04:26, LBA: 235580, Length: 79633
Track 5: Audio Track, Time: 04:43, LBA: 315212, Length: 85081
Track 6: Audio Track, Time: 06:25, LBA: 400292, Length: 115289
Track 7: Audio Track, Time: 05:56, LBA: 515580, Length: 106781
Track 8: Audio Track, Time: 06:40, LBA: 622360, Length: 120173
Track 9: Audio Track, Time: 04:31, LBA: 742532, Length: 81401
Track 10: Audio Track, Time: 05:36, LBA: 823932, Length: 100749
Track 11: Audio Track, Time: 03:58, LBA: 924680, Length: 71181
Track 12: Audio Track, Time: 03:57, LBA: 995860, Length: 71193
Track 13: Audio Track, Time: 03:45, LBA: 1067052, Length: 67449
Track 14: Audio Track, Time: 04:25, LBA: 1134500, Length: 79673
Track 15: Audio Track, Time: 02:59, LBA: 1214172, Length: 53581
Track 16: Audio Track, Time: 06:55, LBA: 1267752, Length: 124489
There are 16 audio tracks and 0 data tracks, with a total time of 77:21.
scu> show audio toc address lba
Table of Contents Summary:
Track 1: Audio Track, Starting LBA: 0, Length: 19576
Track 2: Audio Track, Starting LBA: 19575, Length: 17131
Track 3: Audio Track, Starting LBA: 36705, Length: 22191
Track 4: Audio Track, Starting LBA: 58895, Length: 19909
Track 5: Audio Track, Starting LBA: 78803, Length: 21271
Track 6: Audio Track, Starting LBA: 100073, Length: 28823
Track 7: Audio Track, Starting LBA: 128895, Length: 26696
Track 8: Audio Track, Starting LBA: 155590, Length: 30044
Track 9: Audio Track, Starting LBA: 185633, Length: 20351
Track 10: Audio Track, Starting LBA: 205983, Length: 25188
Track 11: Audio Track, Starting LBA: 231170, Length: 17796
Track 12: Audio Track, Starting LBA: 248965, Length: 17799
Track 13: Audio Track, Starting LBA: 266763, Length: 16863
Track 14: Audio Track, Starting LBA: 283625, Length: 19919
Track 15: Audio Track, Starting LBA: 303543, Length: 13396
Track 16: Audio Track, Starting LBA: 316938, Length: 31123
There are 16 audio tracks and 0 data tracks, total of 348060 blocks.
scu> set cdrom block 512
scu>
volume Option
Display the CD-ROM audio control page which contains the volume level.
Format:
scu> show audio volume
Note:
This command displays the same information as the "show page audio"
command, and exists for backward compatability with the RRD42 playback
status command which was vendor unique.
Example:
scu> set nexus pid 0 tid 4 lun 0
Device: RRD43, Bus: 0, Target: 4, Lun: 0, Type: Read-Only Direct Access
scu> show audio volume
Audio Control Parameters (Page 0xE - Current Values):
Mode Parameter Header:
Mode Data Length: 27
Medium Type: 0 (Default Medium Type)
Device Specific Parameter: 0
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0x83 (Mode-1 and XA Form-1 Support)
Number of Logical Blocks: 0
Logical Block Length: 512
Page Header / Data:
Page Code: 0xe
Parameters Savable: No
Page Length: 14
Stop On Track Crossing: No
Immediate Status: Yes
Format of LBAs per second: 0
Audio playback rate valid: No
LBAs per second of playback: 0
Channel 0 Output Selection: 1 (Connect Channel 0 to this port)
Channel 0 Volume Level: 255 (100%)
Channel 1 Output Selection: 2 (Connect Channel 1 to this port)
Channel 1 Volume Level: 255 (100%)
Channel 2 Output Selection: 0 (Output Port Muted)
Channel 2 Volume Level: 0
Channel 3 Output Selection: 0 (Output Port Muted)
Channel 3 Volume Level: 0
scu>
entry Option
Displays a single entry from the table of contents (TOC) in full format.
Format:
scu> show audio toc entry n
Notes:
The entry 'n' must be within the range of tracks in the TOC.
Example:
scu> show audio toc entry 3
Track Entry Information:
Track Number: 3
Absolute Logical Block Address: 252900
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
scu>
header Option
Displays the information returned in the table of contents (TOC) header.
The TOC header contains the starting and ending track numbers.
Format:
scu> show audio toc header
Example:
scu> show audio toc header
Table Of Contents Information:
Data Length: 66
Starting Track Number: 1
Ending Track Number: 7
scu>
report-format Option
Sets the report format used for displaying the table of contents (TOC).
The valid report formats are:
full or summary
Examples Option
scu> show audio toc
Table of Contents Summary:
Track 1: Audio Track, Time: 08:09, LBA: 0, Length: 146609
Track 2: Audio Track, Time: 05:54, LBA: 146608, Length: 106293
Track 3: Audio Track, Time: 06:19, LBA: 252900, Length: 113689
Track 4: Audio Track, Time: 05:03, LBA: 366588, Length: 91021
Track 5: Audio Track, Time: 04:50, LBA: 457608, Length: 86873
Track 6: Audio Track, Time: 03:19, LBA: 544480, Length: 59701
Track 7: Audio Track, Time: 04:06, LBA: 604180, Length: 73809
There are 7 audio tracks and 0 data tracks, with a total time of 37:40.
scu> show audio toc full
Table Of Contents Information:
Data Length: 66
Starting Track Number: 1
Ending Track Number: 7
Track Number: 1
Absolute Logical Block Address: 0
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
Track Number: 2
Absolute Logical Block Address: 146608
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
Track Number: 3
Absolute Logical Block Address: 252900
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
Track Number: 4
Absolute Logical Block Address: 366588
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
Track Number: 5
Absolute Logical Block Address: 457608
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
Track Number: 6
Absolute Logical Block Address: 544480
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
Track Number: 7
Absolute Logical Block Address: 604180
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
Track Number: 170
Absolute Logical Block Address: 677988
Track Control Attributes: Audio Track
Audio Without Pre-Emphasis
Digital Copy Prohibited
Two Channel Audio
Address Type Information: Sub-Channel Q Information Not Supplied
scu>
cam Option
This command displays CAM information.
Format:
scu> show cam { status value }
status Option
This command displays the message associated with the CAM status value.
Device nexus information is not necessary for displaying status messages.
Format:
scu> show cam status value
Examples:
% scu show cam status 0xa
CAM status = 0xa = CAM_SEL_TIMEOUT - Target selection timeout
%
% scu show cam status 0x13
CAM status = 0x13 = CAM_UNEXP_BUSFREE - Unexpected BUS free
%
capacity Option
Displays the disk capacity in blocks.
Format:
scu> show capacity
Examples:
scu> show capacity
Disk Capacity Information:
Maximum Capacity: 204864
Block Length: 512
defects Option
Displays the disk defect list(s).
Format:
scu> show defects [ [ defect-list [ defect-format ] ] ]
Examples:
scu> show defects
Defect List Header:
Format 0x05 MDL GDL SECTOR
Defect list length 104 number of defects 13
Cylinder 42 Head 3 Sector 30
Cylinder 111 Head 12 Sector 27
Cylinder 220 Head 1 Sector 16
Cylinder 441 Head 0 Sector 27
Cylinder 514 Head 9 Sector 29
Cylinder 515 Head 9 Sector 29
Cylinder 563 Head 0 Sector 22
Cylinder 873 Head 3 Sector 35
Cylinder 873 Head 13 Sector 24
Cylinder 874 Head 13 Sector 24
Cylinder 1005 Head 14 Sector 3
Cylinder 1 Head 2 Sector 28
Cylinder 1 Head 5 Sector 22
scu> show defects grown
Defect List Header:
Format 0x05 GDL SECTOR
Defect list length 16 number of defects 2
Cylinder 1 Head 2 Sector 28
Cylinder 1 Head 5 Sector 22
scu>
defect-list Option
Specifies the defect list(s) to display. If this parameter is omitted,
then the default is to display all defects (primary and grown lists).
Format:
scu> show defects { all | primary | grown }
Aliases:
all (known), primary (vendor)
defect-format Option
Specifies the defect format to display. If the defect format is omitted,
the default is "sector" format.
Format:
scu> show defects defect-list { block | bfi | sector }
Notes:
Some disk drives do not support all the different defect formats.
You must refer to the specific drive manual to determine which
formats are actually supported if the defect format chosen fails.
Examples:
scu> show defects grown block
Defect List Header:
Format 0x00 GDL BLOCK
Defect list length 8 number of defects 2
Block 100
Block 202
scu>
scu> show defects grown bfi
Defect List Header:
Format 0x04 GDL BYTES
Defect list length 16 number of defects 2
Cylinder 1 Head 2 Byte 16044
Cylinder 1 Head 5 Byte 12606
scu>
scu> show defects grown sector
Defect List Header:
Format 0x05 GDL SECTOR
Defect list length 16 number of defects 2
Cylinder 1 Head 2 Sector 28
Cylinder 1 Head 5 Sector 22
scu>
device Option
Displays the information returned by the CAM Get Device Type CCB.
If nexus information is omitted, the command is issued to the selected
device.
Format:
scu> show device [ nexus-information ]
Notes:
Only the first 36 bytes of inquiry data is displayed, since that
is all that is stored by CAM in the EDT (Equipment Device Table).
Example:
scu> show device
Inquiry Information:
SCSI Bus ID: 1
SCSI Target ID: 1
SCSI Target LUN: 0
Peripheral Device Type: 0 (Direct Access)
Peripheral Qualifier: 0 (Peripheral Device Connected)
Device Type Modifier: 0
Removable Media: No
ANSI Version: 2 (Complies to ANSI X3.131-1994, SCSI-2)
ECMA Version: 0
ISO Version: 0
Response Data Format: 2 (SCSI-2)
Terminate I/O Process: 0
Asynchronous Notification: 0
Additional Length: 91
Soft Reset Support: No
Command Queuing Support: Yes
Target Transfer Disable: Yes
Linked Command Support: No
Synchronous Data Transfers: Yes
Support for 16 Bit Transfers: No
Support for 32 Bit Transfers: No
Relative Addressing Support: No
Vendor Identification: DEC
Product Identification: RZ26L (C) DEC
Firmware Revision Level: 440C
scu>
diagnostic Option
This command displays diagnostic information about a device.
Format:
scu> show diagnostic pages
pages Option
This command displays the diagnostic pages support by a device.
Format:
scu> show diagnostic pages
Errors:
Since send diagnostic pages is an optional command, not all
devices support it. If unsupported by the selected device,
you'll see the following error:
scu> show nexus
Device: RRD43, Bus: 0, Target: 4, Lun: 0, Type: Read-Only Direct Access
scu> show diagnostic pages
scu: 'SCMD_SEND_DIAGNOSTIC' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x26, 0) = Invalid field in parameter list
scu>
Example:
scu> sho diagnostics pages
Diagnostic Pages Supported by Device /dev/rrz0c (RZ28):
Supported Diagnostics Page (Code = 0x00)
Translate Address Page (Code = 0x40)
scu>
edt Option
This command displays the CAM Equipment Device Table (EDT) entries.
If nexus information is omitted, then all EDT entries are displayed.
Format:
{ all }
{ capabilities }
scu> show edt [ [nexus-information] [ { serial } ] [ report-format ] ]
{ status }
Notes:
o Specifying the nexus restricts the report to that nexus.
o The "capabilities" & "serial" options only affect summary reports.
Linux Example:
scu> show edt
Equipment Device Table (EDT) Information:
Bus/Target/Lun Device Type ANSI Vendor ID Product ID Revision N/W
-------------- ----------- ------ --------- ---------------- -------- ---
/dev/sda /dev/sga
0 0 0 Direct SCSI-2 COMPAQ DDRS-39130W S99C W
/dev/nst0 /dev/sgb
0 3 0 Sequential SCSI-2 HP C1557A U709 N
/dev/sgc
0 3 1 Changer SCSI-2 HP C1557A U709 N
/dev/sdb /dev/sgd
1 1 0 Direct SCSI-2 DEC RZ29B (C) DEC 0016 N
/dev/sdc /dev/sge
1 2 0 Direct SCSI-2 DEC RZ29B (C) DEC 0016 N
/dev/cdrom1 /dev/scd0 /dev/sgf
1 5 0 CD-ROM SCSI-2 DEC RRD46 (C) DEC 1337 N
scu>
Tru64 Unix Example:
# export SCU_DEVICE_SCANNING=Yes
# scu show edt
CAM Equipment Device Table (EDT) Information:
Bus/Target/Lun Device Type ANSI Vendor ID Product ID Revision N/W
-------------- ----------- ------ --------- ---------------- -------- ---
/dev/rrz0c (tags 32)
0 0 0 Direct SCSI-2 DEC RZ1CF-CF (C) DEC 1614 W
/dev/rrz1c (tags 32)
0 1 0 Direct SCSI-2 COMPAQ BB01811C9C 3B05 W
/dev/rrz2c (tags 32)
0 2 0 Direct SCSI-2 COMPAQ BB01811C9C 3B05 W
/dev/rrz4c
0 4 0 CD-ROM SCSI-2 DEC RRD47 (C) DEC 1206 N
/dev/mc8a
1 0 0 Changer SCSI-2 DEC TL800 (C) DEC 0506 W
/dev/nrmt1h
1 4 0 Sequential SCSI-2 DEC TZ89 (C) DEC 2150 W
/dev/nrmt0h /dev/nrmt2h
1 5 0 Sequential SCSI-2 DEC TZ89 (C) DEC 2150 W
#
all Option
The parameter allows displaying all EDT entries. Normally, devices not
present or not connected, are not displayed by default.
Format:
scu> show edt all [nexus-information]
Example:
scu> show edt all
CAM Equipment Device Table (EDT) Information:
Bus/Target/Lun Device Type ANSI Vendor ID Product ID Revision N/W
-------------- ----------- ------ --------- ---------------- -------- ---
0 0 0 Direct SCSI-2 DEC RZ28M (C) DEC 0466 N
0 0 1 !Present SCSI-2 DEC RZ28M (C) DEC 0466 N
0 0 2 !Present SCSI-2 DEC RZ28M (C) DEC 0466 N
0 0 3 !Present SCSI-2 DEC RZ28M (C) DEC 0466 N
0 0 4 !Present SCSI-2 DEC RZ28M (C) DEC 0466 N
0 0 5 !Present SCSI-2 DEC RZ28M (C) DEC 0466 N
0 0 6 !Present SCSI-2 DEC RZ28M (C) DEC 0466 N
0 0 7 !Present SCSI-2 DEC RZ28M (C) DEC 0466 N
... ... ...
scu>
capabilities Option
This parameter allows extending the summary report, to display the device
capabilities (various Inquiry flags).
Format:
scu> show edt capabilities [nexus-information]
Linux Example:
scu> show edt capabilities
Equipment Device Table (EDT) Information:
Bus/Target/Lun Device Type ANSI Vendor ID Product ID Revision Capabilities
-------------- ----------- ------ --------- ---------------- -------- ------------
/dev/sda /dev/sga
0 0 0 Direct SCSI-2 COMPAQ DDRS-39130W S99C cmdque linked sync wbus16
/dev/nst0 /dev/sgb
0 3 0 Sequential SCSI-2 HP C1557A U709 rmb linked sync
/dev/sgc /dev/sgc
0 3 1 Changer SCSI-2 HP C1557A U709 rmb linked sync
/dev/sdb /dev/sgd
1 1 0 Direct SCSI-2 DEC RZ29B (C) DEC 0016 cmdque transdis linked sync
/dev/sdc /dev/sge
1 2 0 Direct SCSI-2 DEC RZ29B (C) DEC 0016 cmdque transdis linked sync
/dev/cdrom1 /dev/scd0 /dev/sgf
1 5 0 CD-ROM SCSI-2 DEC RRD46 (C) DEC 1337 rmb linked sync reladdr
scu>
serial Option
This parameter allows extending the summary report, to display the device
serial number (if any).
Format:
scu> show edt serial [nexus-information]
Notes:
o The serial number is obtained via the Inquiry Vital Product Serial
Number page, thus if the device does not support that optional SCSI
command, the text is displayed instead.
Linux Example:
scu> show edt serial
Equipment Device Table (EDT) Information:
Bus/Target/Lun Device Type ANSI Vendor ID Product ID Revision Serial Number
-------------- ----------- ------ --------- ---------------- -------- -------------
/dev/sda /dev/sga
0 0 0 Direct SCSI-2 COMPAQ DDRS-39130W S99C REGD4227
/dev/nst0 /dev/sgb
0 3 0 Sequential SCSI-2 HP C1557A U709 GB00197580
/dev/sgc /dev/sgc
0 3 1 Changer SCSI-2 HP C1557A U709
/dev/sdb /dev/sgd
1 1 0 Direct SCSI-2 DEC RZ29B (C) DEC 0016 00121814
/dev/sdc /dev/sge
1 2 0 Direct SCSI-2 DEC RZ29B (C) DEC 0016 00733254
/dev/cdrom1 /dev/scd0 /dev/sgf
1 5 0 CD-ROM SCSI-2 DEC RRD46 (C) DEC 1337
scu> show edt serial pid 0 tid 0 lun 0
Equipment Device Table (EDT) Information:
Bus/Target/Lun Device Type ANSI Vendor ID Product ID Revision Serial Number
-------------- ----------- ------ --------- ---------------- -------- -------------
/dev/sda /dev/sga
0 0 0 Direct SCSI-2 COMPAQ DDRS-39130W S99C REGD4227
scu>
status Option
This parameter allows extending the summary report, to display the device
status information.
Format:
scu> show edt status [nexus-information]
Notes:
o The device status is obtained via a SCSI Test Unit Ready command.
TruCluster Example:
# scu show edt status
Equipment Device Table (EDT) Information:
Bus/Target/Lun Device Type ANSI Vendor ID Product ID Revision Status
-------------- ----------- ------ --------- ---------------- -------- ------
/dev/rdisk/dsk0c (tags 74)
0 0 0 Direct SCSI-2 DEC RZ28 (C) DEC D41C N
/dev/rdisk/dsk1c (tags 74)
0 1 0 Direct SCSI-2 DEC RZ28 (C) DEC D41C N
/dev/rdisk/dsk2c (tags 74)
0 2 0 Direct SCSI-2 DEC RZ28 (C) DEC D41C N
/dev/rdisk/cdrom0c
0 6 0 CD-ROM SCSI-2 DEC RRD43 (C) DEC 1084 N
/dev/rdisk/dsk3c (tags 74)
1 0 0 Direct SCSI-2 DEC HSZ40 V32Z W
/dev/rdisk/dsk4c (tags 74)
1 0 1 Direct SCSI-2 DEC HSZ40 V32Z W
.
.
.
/dev/changer/mc0
2 0 0 Changer SCSI-2 DEC TL800 (C) DEC 0420 W
/dev/ntape/tape0c
2 4 0 Sequential SCSI-2 DEC TZ89 (C) DEC 1837 W
#
report-format Option
The report format controls the verbosity of the report generated.
Omitting the report format defaults to a summary report.
Format:
scu> show edt { full | summary }
Notes:
o A summary report generates a single line of output for each
nexus found. A full report causes the inquiry data associated
with each nexus to be displayed.
o Only the first 36 bytes of inquiry data is displayed, since
that is the amount stored by CAM in the EDT.
full Option
This report format displays all the Inquiry data (1st 36 bytes) saved
in the Equipment Device Table (EDT).
Example:
scu> show edt bus 1 lun 0 full
Equipment Device Table (EDT) Information:
Inquiry Information:
SCSI Bus ID: 1
SCSI Target ID: 0
SCSI Target LUN: 0
Peripheral Device Type: 0 (Direct Access)
Peripheral Qualifier: 0 (Peripheral Device Connected)
Device Type Modifier: 0
Removable Media: No
ANSI Version: 2 (Complies to ANSI X3.131-1994, SCSI-2)
ECMA Version: 0
ISO Version: 0
Response Data Format: 2 (SCSI-2)
Terminate I/O Process: 0
Asynchronous Notification: 0
Additional Length: 91
Soft Reset Support: No
Command Queuing Support: Yes
Target Transfer Disable: Yes
Linked Command Support: No
Synchronous Data Transfers: Yes
Support for 16 Bit Transfers: No
Support for 32 Bit Transfers: No
Relative Addressing Support: No
Vendor Identification: DEC
Product Identification: RZ28 (C) DEC
Firmware Revision Level: D41C
.
.
.
Inquiry Information:
SCSI Bus ID: 1
SCSI Target ID: 2
SCSI Target LUN: 0
Peripheral Device Type: 0 (Direct Access)
Peripheral Qualifier: 0 (Peripheral Device Connected)
Device Type Modifier: 0
Removable Media: No
ANSI Version: 2 (Complies to ANSI X3.131-1994, SCSI-2)
ECMA Version: 0
ISO Version: 0
Response Data Format: 2 (SCSI-2)
Terminate I/O Process: 0
Asynchronous Notification: 0
Additional Length: 31
Soft Reset Support: No
Command Queuing Support: Yes
Target Transfer Disable: Yes
Linked Command Support: Yes
Synchronous Data Transfers: Yes
Support for 16 Bit Transfers: No
Support for 32 Bit Transfers: No
Relative Addressing Support: No
Vendor Identification: DEC
Product Identification: RZ28D (C) DEC
Firmware Revision Level: 0006
scu>
elements Option
This command displays media changer element status.
Format:
scu> show elements [ address element-address ] \
[ starting e-address ] [ ending e-address ] \
[ number value ] [ type element-type ] \
[ drive value ] [ port value ] \
[ slot value ] [ transport value ] \
[ state { abnormal | normal } ] \
[ status { empty | full } ] \
[ tags string ] [ atags string ] [ ptags string ] \
[ notags ] [ voltags ] \
[ { 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 addresses 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" command 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 If supported, the default is to display volume tags.
o The default report format is "summary".
Example:
scu> show elements
Element Transport Exception Element Volume
Address Status State Type Tags
------- --------- --------- ------- ------
Transport 0: 0 Empty Normal MT
Slot 0: 1 Empty Normal ST
Slot 1: 2 Empty Normal ST
Slot 2: 3 Empty Normal ST
Slot 3: 4 Empty Normal ST
Slot 4: 5 Empty Normal ST
Slot 5: 6 Empty Normal ST
Slot 6: 7 Empty Normal ST
Slot 7: 8 Empty Normal ST
Slot 8: 9 Empty Normal ST
Slot 9: 10 Full Normal ST PAK309
Drive 0: 240 Full Normal DT PAK300
scu> show elements ptags PAK*
Element Transport Exception Element Volume
Address Status State Type Tags
------- --------- --------- ------- ------
Slot 9: 10 Full Normal ST PAK309
Drive 0: 240 Full Normal DT PAK300
scu>
inquiry Option
This command requests and displays the device inquiry information. It
is similar to the "show device" command, except it displays additional
vendor specific inquiry data (following the standard 36 bytes of data).
The vendor specific data is displayed in hex bytes, as well as printable
ASCII to the left of the hex display.
Format:
scu> show inquiry [ pages [ inquiry-page ] [ supported ] ]
Notes:
The Target Transfer Disable bit (TransDis) is a SCSI-3 enhancement
which indicates the drive supports CONTINUE I/O PROCESS and TARGET
TRANSFER DISABLE messages.
Examples:
scu> show inquiry
Inquiry Information:
Peripheral Device Type: 0 (Direct Access)
Peripheral Qualifier: 0 (Peripheral Device Connected)
Device Type Modifier: 0
Removable Media: No
ANSI Version: 2 (Complies to ANSI X3.131-1994, SCSI-2)
ECMA Version: 0
ISO Version: 0
Response Data Format: 2 (SCSI-2)
Terminate I/O Process: 0
Asynchronous Notification: 0
Additional Length: 91
Soft Reset Support: No
Command Queuing Support: Yes
Target Transfer Disable: Yes
Linked Command Support: No
Synchronous Data Transfers: Yes
Support for 16 Bit Transfers: No
Support for 32 Bit Transfers: No
Relative Addressing Support: No
Vendor Identification: DEC
Product Identification: RZ26L (C) DEC
Firmware Revision Level: 440C
Vendor Specific Data: 30 30 30 30 34 34 37 38 35 33 "0000447853"
36 37 00 00 00 00 00 00 13 21 "67 !"
03 00 00 00 00 00 00 00 00 00 " "
00 00 00 00 00 00 00 00 00 00 " "
00 00 00 00 00 00 00 00 00 00 " "
00 00 00 00 00 00 00 00 00 00 " "
scu>
pages Option
This command displays all or the selected inquiry page. The inquiry
pages currently supported are:
'scu' Keyword Page Code Description
------------- --------- -----------
serial 0x80 Unit serial number page.
implemented 0x81 Implemented operating defs.
ascii | operating 0x82 ASCII operating definitions.
deviceid | wwid 0x83 Device identification page.
tapeinquiry 0xCC Compaq tape inquiry page.
controller 0xD0 Compaq controller info page.
hda 0xD1 Compaq HDA components page.
pcba 0xD2 Compaq PCBA components page.
Format:
{ [ code hex-code ] }
scu> show inquiry pages { [ inquiry-page ] }
{ [ supported ] }
Notes:
o If additional keywords are omitted, all pages are displayed.
o In the serial number page, the HDA number is what was previously
displayed as the drive serial number of extended inquiry data.
o Vendor unique pages are displayed in hex bytes and ASCII to
the right since this vendor specific.
Examples:
scu> show inquiry page serial
Unit Serial Number Page:
Peripheral Device Type: Direct Access
Peripheral Qualifier: Peripheral Device Connected
Page Code: 0x80
Page Length: 52
Product Serial Number: PCB=420243489990(ZG43489990 ?); HDA=0000000044785367
scu> show inquiry pages
ASCII Information Page:
Page Code: 0x1
Page Length: 8
ASCII Data Length: 5
ASCII Information: HOST
ASCII Information Page:
Page Code: 0x2
Page Length: 8
ASCII Data Length: 5
ASCII Information: HDA
ASCII Information Page:
Page Code: 0x3
Page Length: 8
ASCII Data Length: 5
ASCII Information: PCB
Unit Serial Number Page:
Page Code: 0x80
Page Length: 52
Product Serial Number: PCB=420243489990(ZG43489990 ?); HDA=0000000044785367
Implemented Operating Definitions Page:
Page Code: 0x81
Page Length: 4
Current Operating Definition: SCSI-2
Default Operating Definition: SCSI-2 (Savable)
Supported Operating Definitions: SCSI-2 (Savable)
CCS (Savable)
ASCII Implemented Operating Definitions Page:
Page Code: 0x82
Page Length: 20
ASCII Description Data Length: 19
Operating Definition Description: SCSI-2; SCSI-1/CCS
Vendor Specific Page:
Page Code: 0xc0
Page Length: 36
Vendor Specific Data: 58 34 34 30 43 20 20 20 20 20 "X440C "
20 20 20 20 20 20 31 39 2d 41 " 19-A"
50 52 2d 31 39 39 34 20 30 39 "PR-1994 09"
3a 34 37 3a 34 36 ":47:46"
Vendor Specific Page:
Page Code: 0xc1
Page Length: 16
Vendor Specific Data: 20 20 20 20 20 20 20 20 20 20 " "
20 20 20 20 20 20 " "
scu>
supported Option
This command displays the inquiry vital product data pages which are
supported.
Format:
scu> show inquiry pages supported
Example:
scu> show inquiry pages supported
Vital Product Data Pages Supported by Device /dev/rrz9c (RZ26L):
Supported Vital Product Data Page (Code = 0x00)
ASCII Information Page (Code = 0x01)
ASCII Information Page (Code = 0x02)
ASCII Information Page (Code = 0x03)
Unit Serial Number Page (Code = 0x80)
Implemented Operating Definitions Page (Code = 0x81)
ASCII Implemented Operating Definitions Page (Code = 0x82)
Vendor Specific Page (Code = 0xc0)
Vendor Specific Page (Code = 0xc1)
scu>
keys Option
This command displays the persistent reservation keys that have been
registered with the device. Note, this a SCSI-3 command.
Format:
scu> show keys
layout Option
This command is used to display the internal mode page layout. This
structure describes how page fields are displayed as well as the field
names required for the "set page" command.
Format:
scu> show layout mode-page
Example:
scu> show layout error
Read-Write Error Recovery Page Layout (Page 0x1)
Field Description & Offset/Bit Information Set Name
------------------------------------------ --------
Disable Correction (DCR) (byte 2, bit 0) -> dcr
Disable Transfer on Error (DTE) (byte 2, bit 1) -> dte
Post Recoverable Error (PER) (byte 2, bit 2) -> per
Enable Early Recovery (EER) (byte 2, bit 3) -> eer
Read Continuous (RC) (byte 2, bit 4) -> rc
Transfer Block (TB) (byte 2, bit 5) -> tb
Reserved (byte 2, bits 6:7) ->
Read Retry Count (byte 3) -> read_retry_count
Reserved (byte 4) ->
Reserved (byte 5) ->
Reserved (byte 6) ->
Reserved (byte 7) ->
scu>
mode-page Option
Describes the mode page layout to display. The pages supported are:
'scu' Keyword Page Code Description
------------- --------- -----------
error-recovery 0x01 Error recovery page.
disconnect | reconnect 0x02 Disconnect/reconnect page.
format-device 0x03 Format device mode page.
geometry | rigid 0x04 Disk geometry page.
flexible 0x05 Flexible disk page.
optical-memory 0x06 Optical memory page.
verify-recovery 0x07 Verify error recovery page.
cache-control 0x08 Cache control page.
peripheral-device 0x09 Peripheral device page.
control-mode 0x0A Control Mode Page.
medium-types | mtypes 0x0B Medium types supported page.
notch-partition 0x0C Notch and partition page.
cdrom 0x0D CD-ROM device page.
power-condition 0x0D Power condition page.
audio-control 0x0E Audio control page.
compression 0x0F Data compression page.
device-configuration 0x10 Device configuration page.
medium-partition1 0x11 Medium parition page 1.
tapealert 0x1C TapeAlert control page.
element-address 0x1D Element address assignment.
transport-geometry 0x1E Transport geometry parameters.
device-capabilities 0x1F Device capabilities page.
dec-control 0x25 DEC special control Page.
cdcap 0x2A CD-ROM capabilities page.
library 0x2E Library configuration page.
log Option
This command displays all standard or selected log page parameters.
The log page names cuurently supported are:
Keyword Page Code Description
------- --------- -----------
all 0x00 All log pages (+ vendor).
overrun | underrun 0x01 Overrun/underrun counters.
write 0x02 Write error counter.
read 0x03 Read error counter.
readrev | reverse 0x04 Read reverse error counter.
verify 0x05 Verify error counter.
nonmedium 0x06 non-medium error counter.
lastn | events 0x07 Last 'n' error events.
tapealert 0x2E TapeAlert parameters.
wellness 0x33 Compaq's device wellness.
status 0x3E Compaq's device status.
Format:
{ [ code hex-code ] }
{ [ log-page ] }
{ [ supported ] }
scu> show log pages { [ parameter value ] } [ pcf page-control ] [ full | summary ]
{ [ starting value ] }
{ [ ending value ] }
{ [ number value ] }
Notes:
o If additional keywords are omitted, all standard log pages are
displayed. Standard is those pages defined in the SCSI-2 spec.
o By default, a summary report is displayed. The "full" keyword
must be used to display page and parameter headers.
o You are permitted to specify both starting and ending ranges.
Errors:
Since Log Sense is an optional command, not all devices support it.
If unsupported by the device, you'll see the following error:
scu> show log pages
scu: 'log sense' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x20, 0) = Invalid command operation code
Example:
scu> show log pages
Buffer Overrun/Underrun Counter Parameters (Page 0x1 - Current Cumulative Values):
Parameter 0x0, Counter Value: 2 (Underruns during tape write operations)
Parameter 0x1, Counter Value: 0 (Overruns during tape read operations)
Write Error Counter Parameters (Page 0x2 - Current Cumulative Values):
Parameter 0x2, Counter Value: 7 (Total rewrites or rereads)
Read Error Counter Parameters (Page 0x3 - Current Cumulative Values):
Parameter 0x1, Counter Value: 0 (Errors corrected with possible delays)
Parameter 0x4, Counter Value: 0 (Total times correction algorithm processed)
scu> show log page overrun full
Buffer Overrun/Underrun Counter Parameters (Page 0x1 - Current Cumulative Values):
Page Code: 0x1
Page Length: 12
Parameter Code: 0
List Parameter Data Format (LP): 0 (Data Counter)
Threshold Met Criteria (TMC): 0 (Notify of every update of cumulative value)
Enable Threshold Criteria (ETC): No (Threshold comparison disabled)
Target Save Disable (TSD): 0 (Saved frequently)
Disable Save (DS): 1 (Parameter is NOT Savable)
Disable Update (DU): No (Data counting is enabled)
Parameter Length: 2
Counter Value: 2 (Underruns during tape write operations)
Parameter Code: 0x1
List Parameter Data Format (LP): 0 (Data Counter)
Threshold Met Criteria (TMC): 0 (Notify of every update of cumulative value)
Enable Threshold Criteria (ETC): No (Threshold comparison disabled)
Target Save Disable (TSD): 0 (Saved frequently)
Disable Save (DS): 1 (Parameter is NOT Savable)
Disable Update (DU): No (Data counting is enabled)
Parameter Length: 2
Counter Value: 0 (Overruns during tape read operations)
scu>
pcf Option
The page control field determines the type of parameters to be selected.
The defined page control fields are:
Format:
scu> show log pages pcf { code hex-value | current | default | threshold }
Where:
hex-value = A valid hex value between the range 0-3.
current = Selects current cumulative log parameters.
default = Selects default cumulative log parameters.
threshold = Selects current threshold log parameters.
Examples:
scu> show log page verify pcf threshold
Verify Error Counter Parameters (Page 0x5 - Current Threshold Values):
Parameter 0x0, Counter Value: 0 (Errors corrected without substantial delay)
Parameter 0x1, Counter Value: 0 (Errors corrected with possible delays)
Parameter 0x2, Counter Value: 0 (Total rewrites or rereads)
Parameter 0x3, Counter Value: 0 (Total errors corrected)
Parameter 0x4, Counter Value: 0 (Total times correction algorithm processed)
Parameter 0x5, Counter Value: 0 (Total bytes processed)
Parameter 0x6, Counter Value: 0 (Total uncorrected errors)
scu>
supported Option
This command displays all log pages supported.
Format:
scu> show log pages supported
Example:
scu> show log pages supported
Log Data Pages Supported by Device /dev/rrz1c (RZ26L):
Supported Log Data Page (Code = 0x00)
Write Error Counter Page (Code = 0x02)
Read Error Counter Page (Code = 0x03)
Verify Error Counter Page (Code = 0x05)
Non-medium error counter Page (Code = 0x06)
Last 'n' Error Events Page (Code = 0x07)
Vendor Specific Page (Code = 0x37)
Vendor Specific Page (Code = 0x38)
Vendor Specific Page (Code = 0x39)
Vendor Specific Page (Code = 0x3a)
Vendor Specific Page (Code = 0x3b)
Vendor Specific Page (Code = 0x3c)
Vendor Specific Page (Code = 0x3d)
Vendor Specific Page (Code = 0x3e)
scu>
luns Option
This command reports the Logical Unit Numbers (LUN's) supported by
controllers which control multiple devices via LUN's.
Format:
scu> show luns
Note:
The SCSI-3 Report LUNs command is only supported by HSG80/HSZ80
RAID controllers right now.
Example:
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>
memory Option
This command allows you to show the size of various controller buffers.
In it's simplist form, this command attempts to obtain and display the
controller data buffer size. This operation uses the SCSI Read Buffer
commands
Format:
scu> show { memory [ parameters ] }
Errors:
If the device does not support a Read Buffer commands and/or the
the default parameters, you'll see an error like the following:
scu> show memory
scu: 'SCMD_READ_BUFFER' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x24, 0) = Invalid field in CDB
scu>
Example:
scu> show memory
The Controller Memory Size is 61376 (0xefc0) bytes.
scu>
parameters Option
Various parameters can be specified to specify which controller buffer
information to access. Most devices do not require these parameters,
but some newer devices may require different modes and/or buffer ID's.
Format:
{ id buffer-id }
scu> show memory [ { mode buffer-mode } ]
Notes:
o The default buffer ID is 0.
o The default buffer mode is 0 (selects Combined header and data).
o Refer to the vendor's SCSI programming manual for information on
buffer ID's and buffer modes supported.
Examples:
scu> show memory mode 3
The Memory Size for Mode 3, ID 0 is 493804 (0x788ec) bytes.
scu> show memory mode 3 id 2
The Memory Size for Mode 3, ID 2 is 124 (0x7c) bytes.
scu> show memory mode 3 id 3
The Memory Size for Mode 3, ID 3 is 262144 (0x40000) bytes.
scu>
mode-parameters Option
This command displays the mode parameter header and block descriptor.
Basically, this is a short hand form of the "show pages" commands which
only displays the mode headers. Please be aware, that this command is
not supported by all devices (requests page 0 w/mode headers length).
Format:
scu> show mode-parameters
Example:
scu> show mode
Mode Parameters (Current Values):
Mode Parameter Header:
Mode Data Length: 99
Medium Type: 0x3
Tape Speed: 0 (Using Default Speed)
Buffered Mode: 0x1 (Buffering Enabled)
Write Protected: Yes
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0x11 (16000 BPI, QIC-320 (GCR, C))
Number of Logical Blocks: 0
Logical Block Length: 0
scu>
nexus Option
This command displays the current nexus information and device type for
the selected device. Normally, this information is automatically setup
from the associated device driver using the DEVIOCGET I/O control cmd.
Format:
scu> show nexus
Example:
scu> show nexus
Device Nexus: Bus: 1, Target: 3, Lun: 0, Device Type: Direct Access
pages Option
This command displays the mode page(s) for the selected device.
Format:
{ [ code hex-code ] }
scu> show pages { [ mode-page ] } [ pcf page-control ]
{ [ supported ] }
Notes:
o If the mode page is omitted, all mode pages are displayed.
o The default page control field is "current" values.
o The special pcf keyword "all", selects an unformatted
hex byte display off all pcf's for all pages or the
specified mode page.
Example:
scu> show pages
Mode Parameter Header:
Mode Data Length: 170
Medium Type: 0 (Default Medium Type)
Device Specific Parameter: 0x10 (Target Supports DPO & FUA bits)
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0
Number of Logical Blocks: 4110480
Logical Block Length: 512
Read-Write Error Recovery Parameters (Page 0x1 - Current Values):
Page Header / Data:
Page Code: 0x1
Parameters Savable: Yes
Page Length: 10
Disable Correction (DCR): No
Disable Transfer on Error (DTE): No
Post Recoverable Error (PER): Yes
Enable Early Recovery (EER): No
Read Continuous (RC): No
Transfer Block (TB): Yes
Automatic Read Allocation (ARRE): No
Automatic Write Allocation (AWRE): No
Read Retry Count: 33
Correction Span: 48 bits
Head Offset Count: 0
Data Strobe Offset Count: 0
Write Retry Count: 3
Recovery Time Limit: 65535ms
Disconnect-Reconnect Parameters (Page 0x2 - Current Values):
Page Header / Data:
Page Code: 0x2
Parameters Savable: Yes
Page Length: 14
Buffer Full Ratio: 128/256 (50%)
Buffer Empty Ratio: 128/256 (50%)
Bus Inactivity Limit: 10 (1000 microseconds)
Disconnect Time Limit: 0 (No Limit)
Connect Time Limit: 0 (No Limit)
Maximum Burst Size: 0 (No Limit)
Data Transfer Disc Control (DTDC): 0 (Disconnect control not used)
Disconnect Immediate (DIMM): No
Enable Modify Data Pointer (EMDP): No
Format Device Parameters (Page 0x3 - Current Values):
Page Header / Data:
Page Code: 0x3
Parameters Savable: Yes
Page Length: 22
Tracks per Zone: 11
Alternate Sectors per Zone: 9
Alternate Tracks per Zone: 0
Alternate Tracks per Volume: 22
Sectors per Track: 86
Data Bytes per Physical Sector: 512
Interleave: 1
Track Skew Factor: 8 sectors
Cylinder Skew Factor: 16 sectors
Surface (SURF): Off
Removable Media (RMB): No
Hard Sector Formatting (HSEC): Yes
Soft Sector Formatting (SSEC): No
Rigid Disk Geometry Parameters (Page 0x4 - Current Values):
Page Header / Data:
Page Code: 0x4
Parameters Savable: Yes
Page Length: 22
Number of Cylinders: 3045
Number of Heads: 16
Starting Write Precomp Cylinder: 0
Reduced Write Current Cylinder: 0
Drive Step Rate: 0 (Targets' default)
Landing Zone Cylinder: 0 (Targets' default)
Rotational Position Locking: 0 (Disabled or not supported)
Rotational Offset: 0 (Not used)
Medium Rotation Rate: 7200 rpm
Verify Error Recovery Parameters (Page 0x7 - Current Values):
Page Header / Data:
Page Code: 0x7
Parameters Savable: Yes
Page Length: 10
Disable Correction (DCR): No
Disable Transfer on Error (DTE): No
Post Recoverable Error (PER): No
Enable Early Recovery (EER): No
Verify Retry Count: 33
Verify Correction Span: 48 bits
Verify Recovery Time Limit: 65535ms
Cache Control Parameters (Page 0x8 - Current Values):
Page Header / Data:
Page Code: 0x8
Parameters Savable: Yes
Page Length: 18
Read Cache Disable (RCD): No
Multiplication Factor (MF): Off
Write Cache Enable (WCE): No
Cache Segment Size Enable (SIZE): Off
Discontinuity (DISC): Off
Caching Analysis Permitted (CAP): Disabled
Abort Pre-Fetch (ABPF): Off
Initiator Control Enable (IC): Off
Write Retention Priority: 0 (Not distiguished)
Demand Read Retention Priority: 0 (Not distiguished)
Disable Prefetch Transfer Length: 65535 blocks
Minimum Prefetch: 0 blocks
Maximum Prefetch: 410 blocks
Maximum Prefetch Ceiling: 455 blocks
Vendor Specific Cache Bits (VS): 0
Disable Read-Ahead (DRA): No
Logical Block Cache Segment Size: Off (Cache size interpreted as bytes)
Force Sequential Write (FSW): Yes (Blocks written in sequential order)
Number of Cache Segments: 2
Cache Segment Size: 0 bytes
Non-Cache Segment Size: 0 bytes
Control Mode Parameters (Page 0xA - Current Values):
Page Header / Data:
Page Code: 0xa
Parameters Savable: Yes
Page Length: 6
Report Log Excep Condition (RLEC): No
Global Log Target Disable (GLTSD): No
Disable Tag Queuing (DQue): No
Queue Error Management (QErr): No
Queue Algorithm Modifier: 0 (Restricted re-ordering)
Error AEN Permission (EAENP): No
Unit Attention AEN Perm (UAAENP): No
Ready AEN Permission (RAENP): No
Ext Contingent Allegiance (EECA): Disabled
Ready AEN Holdoff Period: 0ms
Notch and Partition Parameters (Page 0xC - Current Values):
Page Header / Data:
Page Code: 0xc
Parameters Savable: Yes
Page Length: 22
Notched Drive: Yes
Logical or Physical Notch: 0 (Boundaries based on physical parameters)
Maximum Number of Notches: 26
Active Notch: 0
Starting Boundary: 0 (Cylinder 0, Head 0)
Ending Boundary: 0xdb60a (Cylinder 3510, Head 10)
Pages Notched Bitmap: 00 00 00 00 00 00 10 00
Power Condition Parameters (Page 0xD - Current Values):
Page Header / Data:
Page Code: 0xd
Parameters Savable: Yes
Page Length: 10
Standby: No
Idle: No
Idle Condition Timer: 0
Standby Condition Timer: 0
Vendor Specific Parameters (Page 0x0 - Current Values):
Page Header / Data:
Page Code: 0
Parameters Savable: Yes
Page Length: 2
(byte 2): 0x20
(byte 3): 0
scu>
code Option
For mode pages which are unknown to the program, a hex page code can be
specified for the page to display. In this mode, mode page fields are
displayed in hex. This format can also be used to override the known
formatted page show functions.
Format:
scu> show page code hex-code [ pcf page-control-field ]
Example:
scu> show page code 21
Unknown Page Parameters (Page 0x21 - current values):
Mode Parameter Header:
Mode Data Length: 23
Medium Type: 0x3 (Reversible or Erasable medium)
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0x3
Number of Logical Blocks: 1
Logical Block Length: 0
Page Header / Data:
Page Code: 0x21
Parameters Savable: Yes
Page Length: 10
(byte 2): 0x3
(byte 3): 0x8
(byte 4): 0
(byte 5): 0
(byte 6): 0x3
(byte 7): 0xe8
(byte 8): 0x2
(byte 9): 0x96
(byte 10): 0x5
(byte 11): 0
scu>
mode-page Option
Describes the mode page to operate on. The pages supported are:
'scu' Keyword Page Code Description
------------- --------- -----------
error-recovery 0x01 Error recovery page.
disconnect | reconnect 0x02 Disconnect/reconnect page.
format-device 0x03 Format device mode page.
geometry | rigid 0x04 Disk geometry page.
flexible 0x05 Flexible disk page.
optical-memory 0x06 Optical memory page.
verify-recovery 0x07 Verify error recovery page.
cache-control 0x08 Cache control page.
peripheral-device 0x09 Peripheral device page.
control-mode 0x0A Control Mode Page.
medium-types | mtypes 0x0B Medium types supported page.
notch-partition 0x0C Notch and partition page.
cdrom 0x0D CD-ROM device page.
power-condition 0x0D Power condition page.
audio-control 0x0E Audio control page.
compression 0x0F Data compression page.
device-configuration 0x10 Device configuration page.
medium-partition1 0x11 Medium parition page 1.
tapealert 0x1C TapeAlert control page.
element-address 0x1D Element address assignment.
transport-geometry 0x1E Transport geometry parameters.
device-capabilities 0x1F Device capabilities page.
dec-control 0x25 DEC special control Page.
cdcap 0x2A CD-ROM capabilities page.
library 0x2E Library configuration page.
Notes:
o The format-device page was previously named the direct-access page,
so either keyword is accepted.
o The dec-control page was previously name the dec-specific page,
so either keyword is accepted.
Format:
scu> show pages [ mode-page [ pcf page-control-field ] ]
Example:
scu> show page error
Read/Write Error Recovery Parameters (Page 1 - current values):
Mode Parameter Header:
Mode Data Length: 19
Medium Type: Default Medium Type
Device Specific Parameter: 0
Block Descriptor Length: 8
Mode Parameter Block Descriptor:
Density Code: 0
Number of Logical Blocks: 0
Logical Block Length: 512
Page Header / Data:
Page Code: 0x1
Parameters Savable: No
Page Length: 6
Disable Correction (DCR): Yes
Disable Transfer on Error (DTE): No
Post Recoverable Error (PER): Yes
Enable Early Correction (EEC): No
Read Continuous (RC): No
Transfer Block (TB): Yes
Automatic Read Allocation (ARRE): No
Automatic Write Allocation (AWRE): No
Retry Count: 1
Correction Span: 0
Head Offset Count: 0
Data Strobe Offset Count: 0
Recovery Time Limit: 255
scu>
pcf Option
The page control field determines the type of parameters to be selected.
The defined page control fields are:
Format:
scu> show pages pcf { current | changeable | default | saved }
Notes:
o When displaying the changeable page parameters, field values are
displayed in hexadecimal radix to easily distinguish the changeable
parameters (1 = changeable, 0 = cannot change).
o The default page control field is "current" values.
o The special pcf keyword "all", selects an unformatted
hex byte display off all pcf's for all pages or the
specified mode page.
Examples:
scu> show page error pcf all
Mode Page Parameters for Device /dev/rrz4c (RRD43):
Read-Write Error Recovery Page (0x01):
Headers: 13 00 00 08 83 00 00 00 00 00 02 00
Current: 01 06 24 05 00 00 00 00
Changeable: 01 06 3f ff 00 00 00 00
Default: 01 06 00 05 00 00 00 00
Saved: (not supported)
scu>
scu> show page error pcf changeable
Read-Write Error Recovery Parameters (Page 0x1 - Changeable Values):
Mode Parameter Header:
Mode Data Length: 0x13
Medium Type: 0
Device Specific Parameter: 0
Block Descriptor Length: 0x8
Mode Parameter Block Descriptor:
Density Code: 0x83 (Mode-1 and XA Form-1 Support)
Number of Logical Blocks: 0
Logical Block Length: 0x200
Page Header / Data:
Page Code: 0x1
Parameters Savable: No
Page Length: 0x6
Disable Correction (DCR): 0x1
Disable Transfer on Error (DTE): 0x1
Post Recoverable Error (PER): 0x1
Enable Early Recovery (EER): 0x1
Read Continuous (RC): 0x1
Transfer Block (TB): 0x1
Read Retry Count: 0xff
scu>
supported Option
The command displays information regarding the mode pages supported
by the currently selected device.
Format:
scu> show pages supported [ pcf page-control-field ]
Example:
scu> show pages supported
Mode Pages Supported by Device /dev/rrz4c (RZ26):
Read/Write Error Recovery Page (0x01), Page Length 10 (0x0a), Savable Yes
Disconnect/Reconnect Page (0x02), Page Length 14 (0x0e), Savable Yes
Direct Access Format Page (0x03), Page Length 22 (0x16), Savable No
Rigid Disk Geometry Page (0x04), Page Length 22 (0x16), Savable Yes
Verify Error Recovery Page (0x07), Page Length 10 (0x0a), Savable Yes
Cache Control Page (0x08), Page Length 10 (0x0a), Savable Yes
Peripheral Device Page (0x09), Page Length 6 (0x06), Savable No
Control Mode Page (0x0a), Page Length 6 (0x06), Savable Yes
Medium Types Page (0x0b), Page Length 6 (0x06), Savable No
Digital Specific Page (0x25), Page Length 23 (0x17), Savable Yes
Vendor Specific Page (0x38), Page Length 14 (0x0e), Savable No
Vendor Specific Page (0000), Page Length 2 (0x02), Savable Yes
path-inquiry Option
This command displays the CAM Path Inquiry information. If the nexus
information is omitted, then the path inquiry information associated
with the selected device is displayed.
Format:
scu> show path-inquiry [ all [ capabilities ] ] [nexus-information]
Notes:
o The format of data displayed by this command is O/S dependent.
o The current Linux SCSI sub-system returns limited adapter info.
You'll likely find more information by reading from /proc/scsi.
Examples:
tru64% scu show path
Path Inquiry Information:
Version Number For The SIM/HBA: 4.12
SCSI HBA Capabilities Flags: 0x12
0x10 = Supports SDTR message.
0x2 = Supports tag queue message.
Target Mode Support Flags: 0
Miscellaneous HBA Feature Flags: 0
The HBA Engine Count: 0
Targets Supported by HBA: 8
LUNs Supported by HBA: 8
Vendor Unique Capabilities: 0 0 0 0 0 0 0 0 0 0 0 0
Size of SIM Private Data Area: 56
Async Callback Capabilities: 0xf3 Reasons for generating async event:
0x80 = New devices found during rescan.
0x40 = SIM module de-registered.
0x20 = SIM module registered.
0x10 = Sent bus device reset to target.
0x2 = Unsolicited reselection.
0x1 = Unsolicited SCSI bus reset.
Highest HBA Path ID Assigned: 0
SCSI Device ID of Initiator: 6
The Vendor ID of the SIM: DEC OSG BSD/V1
The Vendor ID of the HBA: DEC WSE BSD/V1
The OSD Usage Pointer: 0
tru64%
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
linux% scu show path
Adapter Information:
Adapter Host ID: 0
Adapter Name/Information: ncr53c8xx - revision 3.1h
linux%
linux% cat /proc/scsi/ncr53c8xx/0
General information:
Chip NCR53C876, device id 0xf, revision id 0x14
IO port address 0x2000, IRQ number 5
Using memory mapped IO at virtual address 0xd480ef00
Synchronous period factor 12, max commands per lun 32
Profiling information:
num_trans = 26684969
num_kbytes = 434749645
num_disc = 26706675
num_break = 6298
num_int = 20481
num_fly = 26684957
ms_setup = 1001160
ms_data = 57387190
ms_disc = 70979830
ms_post = 889330
linux%
all Option
This format provides a summary of all the HBA's in the system, as well
as optional capabilities
Format:
scu> show path-inquiry all [ capabilities ]
Notes:
o The format of data displayed by this command is O/S dependent.
Examples:
tru64% scu show paths all cap
Path Inquiry Information:
Bus Initiator HBA Vendor ID Version Targets LUNs Capabilities
--- --------- ------------- ------- ------- ---- ------------
0 7 DEC WSE BSD/V1 4.5 16 8 sdtr tagable htm
1 7 DEC WSE BSD/V1 4.5 16 8 sdtr tagable htm
tru64%
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
linux% scu show paths all
Adapter Information:
Host Adapter Name/Information
---- ------------------------
0 ncr53c8xx - revision 3.1h
1 ncr53c8xx - revision 3.1h
linux%
reservations Option
This command displays the current persistent reservations. (SCSI-3 command)
Format:
scu> show reservations
scsi Option
This command displays the SCSI message associated with bus status,
sense key, and sense code/qualifier. These commands are useful when
you have a hex value, from say an analyzer or an error message, and
wish to see what the value translates to. Device nexus information
is not necessary for displaying status messages.
Format:
scu> show scsi { ascq value | key value | status value }
ascq Option
This command displays the message associated with the two byte sense
code/qualifier value specified. The value expected contains the
sense code in the upper byte, and the qualifier in the lower byte.
Format:
scu> show scsi ascq value
Examples:
% scu show scsi ascq 0x0401
Sense Code/Qualifier = (0x4, 0x1) = Logical unit is in process of becoming ready
%
% scu show scsi ascq 0x2800
Sense Code/Qualifier = (0x28, 0) = Not ready to ready transition (medium may have changed)
%
key Option
This command displays the message associated with the sense key value
specified.
Format:
scu> show scsi key value
Example:
% scu show scsi key 6
Sense Key = 0x6 = UNIT ATTENTION - Medium changed or target reset
%
status Option
This command displays the message associated with the SCSI status
value specified.
Format:
scu> show scsi status value
Example:
% scu show scsi status 0x28
SCSI Status = 0x28 = SCSI_STAT_QUEUE_FULL = Command tag queue is full
%
sense Option
This command displays the sense information for the last command which
failed. This sense data remains valid until another command fails.
Format:
scu> show sense { brief | full }
Alias:
The alias "error" is accepted for "sense" since that is really
what's being displayed (request sense data is result of an error).
Notes:
The default is to display full (all) request sense data.
Example:
% scu -f /dev/rrz4c
scu> prevent
scu> eject
scu: 'eject caddy/media' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x53, 0x2) = Medium removal prevented
scu> show sense
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: 0x8
Command Information Field: 0
Additional Sense Code/Qualifier: (0x53, 0x2) = Medium removal prevented
Field Replaceable Unit Code: 0
scu>
statistics Option
This command displays test statistics for read and write media tests,
after a test has completed.
Format:
scu> show statistics
Notes:
The alias 'stats' is accepted for the 'statistics' keyword.
Example:
% scu -f /dev/rrz0c
scu> set stats off
scu> scan media bs 64k limit 5m popts incr lbdata
Scanning 10240 blocks (0 - 10239) on /dev/rrz0c (RZ28) with pattern 0x03020100...
scu> show stats
Total Statistics:
Device Name/Type: RZ28 (Direct Access)
Nexus Information: Bus 0, Target 0, Lun 0
Total Records Processed: 160 @ 65536 bytes/record (64.000 Kbytes)
Total Bytes Transferred: 10485760 (10240.000 Kbytes, 10.000 Mbytes)
Average Transfer Rates: 1401215 bytes/sec, 1368.374 Kbytes/sec
Total Passes Completed: 1/1
Total Errors Detected: 0/1
Total Elapsed Time: 00m07.48s
Total System Time: 00m00.11s
Total User Time: 00m04.95s
Starting time: Sun Oct 29 08:24:12 1995
Ending time: Sun Oct 29 08:24:19 1995
scu>
sleep Command
This command allows you to specify an amount of time to sleep, which
may be useful with timing related problems. This minimum resolution
of sleeps is one second, use the 'usleep' command for shorter times.
Format:
scu> sleep time-string
Where 'time-string' is in the following format:
Time Input:
d = days (86400 seconds), h = hours (3600 seconds)
m = minutes (60 seconds), s = seconds (the default)
Arithmetic characters are permitted, and implicit addition is
performed on strings of the form '1d5h10m30s'.
source Command
This command allows you to source input from an external command file.
If any errors occur during command parsing and/or execution, then the
command file is closed at that point.
Format:
scu> source input-file
Alias:
You can specify the string "@" for the "source" command. The
space following the "@" is required for proper parsing.
Notes:
Lines starting with the '#' character are treated as comment lines.
A default file name extension of '.scu' is appended to the input name
if an extension is not specified. If the file is not located using
this extension, then 'scu' attempts to locate the original input file.
start Command
This command starts a unit which is currently stopped.
Format:
scu> start [ immed ]
stop Command
This command stops a unit. This normally involves spinning the disk down
and parking the heads ot the landing cylinder.
Format:
scu> stop [ immed ]
switch Command
This command switchs to another device or to a previous device. If the
device name is omitted, this command acts as a toggle and simply switches
to the previous device (if one exists). Otherwise, the device specified
is validated and if successful, it becomes the active device.
Format:
scu> switch [ device-name ]
Notes:
If an entry already exists for the device being specified, then
a substring can be specified to match either the device entry or
the device name to switch to.
Examples:
scu> switch /dev/rrz14c
Switching to device entry /dev/rrz14c (RZ55)...
scu> switch
Switching to device entry /dev/rrz10c (RX23)...
scu>
system Command
This command executes the specified system command (sends to shell).
Format:
scu> system command-line
Notes:
o The alias "!" (bang) is accepted for the "system" command.
o The command "!!" re-executes the last system command entered.
o Also reference the "shell" command.
Examples:
scu> system pwd
/usr/users/rmiller
scu> !!
/usr/users/rmiller
scu>
test Command
This command performs tests on a controller. This involves issuing send
and receive diagnostic commands or write and read buffer commands (for
memory test) to the selected device. The default is to perform the self
test which is supported by most controllers.
Format:
scu> test [ memory | selftest ]
memory Option
This command verifies the controller memory by using the SCSI Read and
Write Buffer commands. Since most controllers only accept the Combined
Header and Data Mode with a buffer id and buffer offset of zero, these
are the defaults, but may be overridden. By default, the full memory
size returned in the Read Buffer header, is written/read/verified, but
this too may be overridden by specifying a smaller data limit or size.
Format:
scu> test memory [ test-parameters ] [ parameters ]
Notes:
o Please be aware, that these optional SCSI commands are *not*
supported by all devices.
o If multiple passes are specified, the program cycles through
its' table of predefined data patterns.
Errors:
If the device does not support a Read Buffer commands and/or the
the default parameters, you'll see an error like the following:
scu> test memory
Performing Controller Memory Diagnostics...
Testing Controller Memory of 245760 bytes (Mode 0, Offset 0)
Testing 245760 bytes on [1/2/0] (TZK11) using pattern 0x39c39c39...
scu: 'SCMD_WRITE_BUFFER' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x24, 0) = Invalid field in CDB
Example:
% scu -f /dev/rrz11c
scu> test memory
Performing Controller Memory Diagnostics...
Testing Controller Memory of 61376 bytes (Mode 0, Offset 0)
Testing 61376 bytes on /dev/rrz11c (RZ56) using pattern 0x39c39c39...
scu> test memory pattern 0x12345678 size 50k
Performing Controller Memory Diagnostics...
Testing Controller Memory of 61376 bytes (Mode 0, Offset 0)
Testing 51200 bytes on /dev/rrz11c (RZ56) using pattern 0x12345678...
scu> test memory passes 5
Performing Controller Memory Diagnostics...
Testing Controller Memory of 61376 bytes (Mode 0, Offset 0)
Testing 61376 bytes on /dev/rrz11c (RZ56) using pattern 0x39c39c39...
Testing 61376 bytes on /dev/rrz11c (RZ56) using pattern 0x00ff00ff...
Testing 61376 bytes on /dev/rrz11c (RZ56) using pattern 0x0f0f0f0f...
Testing 61376 bytes on /dev/rrz11c (RZ56) using pattern 0xc6dec6de...
Testing 61376 bytes on /dev/rrz11c (RZ56) using pattern 0x6db6db6d...
scu>
parameters Option
Various parameters can be specified to control the test memory operation.
Most devices do not require these optional parameters, but newer devices
may require different parameters to access the controller data buffer.
Format:
{ id buffer-id }
scu> test memory [ test-parameters] [ { mode buffer-mode } ]
{ offset offset-value }
Notes:
o The default buffer id is restricted to 0, since this id normally
selects the controller data buffer.
o The default buffer mode is 0 (selects Combined header and data).
o The default offset value is 0. The program automatically adjusts
the memory data bytes being tested when this parameter is non-zero.
o Since writing to the controller data buffer, destroyes data which
may be valid for active I/O requests, this command is not permitted
to disk devices with mounted file systems.
o Refer to the vendor's SCSI programming manual for information on
buffer ID's and buffer modes supported.
Examples:
scu> show memory
The Controller Memory Size is 245760 (0x3c000) bytes.
scu> test memory mode 2
Performing Controller Memory Diagnostics...
Testing Controller Memory of 245760 bytes (Mode 2, Offset 0)
Testing 245760 bytes on [1/2/0] (TZK11) using pattern 0x39c39c39...
scu>
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
scu> show nexus
Device Nexus: Bus: 1, Target: 0, Lun: 0, Device Type: Optical
scu> show memory
scu: 'SCMD_READ_BUFFER' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x24, 0) = Invalid field in CDB
scu> show memory mode 3
The Memory Size for Mode 3, ID 0 is 493804 (0x788ec) bytes.
scu> test memory mode 2 offset 10k
Performing Controller Memory Diagnostics...
Testing Controller Memory of 493804 bytes (Mode 2, Offset 10240)
Testing 483564 bytes on [1/0/0] (RWZ52) using pattern 0x39c39c39...
scu> test memory mode 2
Performing Controller Memory Diagnostics...
Testing Controller Memory of 493804 bytes (Mode 2, Offset 0)
Testing 493804 bytes on [1/0/0] (RWZ52) using pattern 0x39c39c39...
scu>
time Command
This command allow you to time individual command sequence(s). If debug
is enabled, the status code also gets displayed.
Format:
scu> time command_sequence
Example:
scu> time show nexus ; tur ; show inquiry ; show capacity
Device: RZ25L, Bus: 0, Target: 0, Lun: 0, Type: Direct Access
Inquiry Information:
Peripheral Device Type: 0 (Direct Access)
Peripheral Qualifier: 0 (Peripheral Device Connected)
Device Type Modifier: 0
Removable Media: No
ANSI Version: 2 (Complies to ANSI X3.131-1994, SCSI-2)
ECMA Version: 0
ISO Version: 0
Response Data Format: 2 (SCSI-2)
Terminate I/O Process: 0
Asynchronous Notification: 0
Additional Length: 31
Soft Reset Support: No
Command Queuing Support: Yes
Target Transfer Disable: No
Linked Command Support: No
Synchronous Data Transfers: Yes
Support for 16 Bit Transfers: No
Support for 32 Bit Transfers: No
Relative Addressing Support: No
Vendor Identification: DEC
Product Identification: RZ25L (C) DEC
Firmware Revision Level: 0006
Disk Capacity Information:
Maximum Capacity: 1046206 (510.843 megabytes)
Block Length: 512
Elapsed time: 00m00.05s, System time: 00m00.00s, User time: 00m00.00s
scu>
translate Command
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>
supplied-format Option
The supplied format controls the convert from parameters.
Supplied Format:
{ bfi cylinder number head number index number }
{ block lba logical-block-address }
{ physical cylinder number head number sector number }
Where:
bfi = Bytes From Index format.
block = Logical Block format.
physical = Physical sector format.
The alias 'track' is also accepted for 'head'.
translate-format Option
The translate format controls the converted to parameters.
Translate Format:
{ bfi (index) | block (lba) | physical (sector) }
Where (...) is an alias that is also accepted.
troubleshooting Option
Normally if the drive under test supports the Translate Address Page,
yet reports an error, it's likely the translation is not supported.
In the example below, you'll see (byte 5), the supplied format field,
of the Send Diagnostic data is illegal.
Example:
scu> set deb on
scu> translate address physical cylinder 38 head 4 sector 3 to bfi
SCSI Cmd = 'send diagnostic', CDB length = 6, CDB bytes: 1d 10 0 0 e 0
Data sent for 'send diagnostic' command:
0x140058000 40 00 00 0a 05 04 00 00 26 04 00 00 00 03
'send diagnostic' failed, CAM status = 0xc4 (CCB request completed with an error)
Request Sense Information:
Device Name/Type: RZ26L (Direct Access)
Nexus Information: Bus 1, Target 1, Lun 0
Erroring Command: send diagnostic
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: 0xa
Command Specific Information: 0
Additional Sense Code/Qualifier: (0x26, 0x2) = Parameter value invalid
Field Replaceable Unit Code: 0
Bit Pointer to Field in Error: 0
Error Field Command/Data (C/D): 0 (Illegal parameter in Data Sent)
Byte Pointer to Field in Error: 0x4 (byte 5)
Completing 'send diagnostic' command with status 5 (EIO).
scu>
tur Command
This command issues a Test Unit Ready command to determine the readiness
of a device. On failures, the sense data is automatically reported,
otherwise the command operates silently.
Format:
scu> tur
Example:
scu> tur
scu: 'test unit ready' failed, EIO (5) - I/O error
scu: Sense Key = 0x2 = NOT READY - Logical unit is NOT ready,
Sense Code/Qualifier = (0x3a, 0) = Medium not present
scu>
usleep Command
This command allows to to specify the number of micro-seconds to
delay, which may be useful for timing related problems.
Format:
scu> usleep micro-seconds
Example:
scu> usleep 5000000
The above command will delay for 1/2 second (1000000 micro-seconds
in a second). No shorthand method available for time values at
this time (maybe in the future).
unload Command
This command is used with medium changers to unload media currently
loaded in the specified drive. It will unload the media to the
element it was previous loaded from.
Format:
scu> unload medium drive value [ transport value ]
verify Command
This command performs verify operations on the selected device.
Format:
scu> verify media [ test-parameters ]
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
media Option
This command verifies the data written on the device media. This
normally involves reading and performing an ECC check of the data. If
the test parameters are omitted, the entire device media is verified.
Format:
scu> verify media [ test-parameters ] [ options ... ]
Notes:
o On failures, the failing logical block number is reported and then
verification continues following the failing block.
o By default, verification is performed using the current parameters
in the Read/Write or Verify Error Recovery mode pages. The drive
recovery can be disabled using the "set recovery off" command.
Errors:
If the device does not support the verify data command, the following
error message is displayed:
scu> verify media starting 1000 length 1024
Verifying 1024 blocks on /dev/rrz10c (RX23), please be patient...
Verifying blocks [ 1000 through 2023 ] ...
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x20, 0) = Invalid command operation code
When an error occurs, the sense key is examined. The two expected
sense keys are Recovered Error (0x01) or Medium Error (0x03). When
these errors are detected, the following error message is displayed
and verification continues following the failing block.
scu: Verify error at logical block number 464392 (0x71608).
scu: Sense Key = 0x1 = RECOVERED ERROR - Recovery action performed,
Sense Code/Qualifier = (0x17, 0) = Recovered data with no error correction applied
If any other sense key error occurs, then the full sense data is
displayed and the verification process is aborted.
Examples:
scu> verify media lba 464388
Verifying 1 blocks on /dev/rrz14c (RZ55), please be patient...
Verifying blocks [ 464388 through 464388 ] ...
scu>
scu> verify media starting 640000
Verifying 9040 blocks on /dev/rrz14c (RZ55), please be patient...
Verifying blocks [ 640000 through 649039 ] ...
scu>
scu> verify media starting 1000 length 250
Verifying 250 blocks on /dev/rrz14c (RZ55), please be patient...
Verifying blocks [ 1000 through 1249 ] ...
scu>
scu> verify media starting 1000 ending 2000
Verifying 1001 blocks on /dev/rrz14c (RZ55), please be patient...
Verifying blocks [ 1000 through 2000 ] ...
scu>
options Option
Allows you to specify options which alter verify operations.
Format:
scu> verify media options { dpo | blkvfy }
Where Options Are:
dpo = Disable page out. Indicates data should not be placed
in the cache or queued at the lowest priority.
blkvfy = Blank verify. On optical devices, indicates the drive
verifies that sectors are erased.
Notes:
o Multiple options are permitted and values are or'ed accordingly.
o Please refer to the drive manual to determine options supported.
Example:
scu> time verify media options blkvfy
Verifying 1163337 blocks (0 - 1163336) on [1/0/0] (RWZ52), please be patient...
Elapsed time: 10m36.05s, System time: 00m00.15s, User time: 00m00.06s
scu>
write Command
This command performs various write operations to the selected device.
Format:
scu> write { media } [ test-parameters ]
{ same }
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
media Option
This command writes the device media using various data patterns. You
must specify transfer parameters which specifies the media area to be
written.
Format:
scu> write media [ test-parameters ] [ flags value ] \
[ verify ] [ options ... ]
Notes:
o The verify keyword performs a write w/verify SCSI command on
random access devices.
o The flags keyword is used to specify command specific values.
This should be used to specify non-standard command options.
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
Examples:
scu> write media
scu: No defaults, please specify test parameters for transfer...
scu> write media lba 100
Writing 1 block on /dev/rrz10c (RX23) with pattern 0x39c39c39...
scu> write media starting 100 ending 250
Writing 151 blocks on /dev/rrz10c (RX23) with pattern 0x39c39c39...
scu> write media starting 2800 limit 1m bs 10k
Writing 80 blocks on /dev/rrz10c (RX23) with pattern 0x39c39c39...
Writing blocks [ 2800 through 2819 ]...
Writing blocks [ 2820 through 2839 ]...
Writing blocks [ 2840 through 2859 ]...
Writing blocks [ 2860 through 2879 ]...
scu> write media lba 2879 passes 5
Writing 1 block on /dev/rrz10c (RX23) with pattern 0x39c39c39...
Writing 1 block on /dev/rrz10c (RX23) with pattern 0xc6dec6de...
Writing 1 block on /dev/rrz10c (RX23) with pattern 0x6db6db6d...
Writing 1 block on /dev/rrz10c (RX23) with pattern 0x00000000...
Writing 1 block on /dev/rrz10c (RX23) with pattern 0xffffffff...
scu>
options Option
Allows you to specify options which alter write operations.
Format:
scu> write media options { dpo | fua | ebp | bytchk }
Where Options Are:
dpo = Disable page out. Indicates data should not be placed
in the cache or queued at the lowest priority.
fua = Force unit attention. Indicates the cache data should
be by-passed, and the media be accessed for the request.
ebp = Erase by-pass. For optical devices, this inhibits the
automatic erase which normally occurs with each write.
bytchk = Perform byte check. When selecting write w/verify,
this requests a byte-by-byte compare of the data written
on the medium and the data transferred.
Notes:
o Multiple options are permitted and values are or'ed accordingly.
o Please refer to drive manual to determine options supported.
same Option
This command writes the same data to the device media using the specified
data pattern. This command is useful if large areas of the media need to
be written, prepared for certification, or otherwise initialized without
the initiator having to transfer all the data. Only one data block is
transferred per request, and that same data is written to the medium
multiple times.
Format:
scu> write same [ test-parameters ] [ flags value ] [ options ... ]
Notes:
o The block size keyword "bs" controls the number of blocks written
per request. For best performance, use a block size of 65535.
o The flags keyword are used to specify command specific values.
Please refer to the "help conventions test-parameters" section for a
list of the valid test parameters.
Examples:
scu> write same starting 4100000 bs 1m
Writing 10480 blocks (4100000 - 4110479) on /dev/rrz0b (RZ28) with pattern 0x39c39c39...
Writing blocks [ 4100000 through 4102047 ]...
Writing blocks [ 4102048 through 4104095 ]...
Writing blocks [ 4104096 through 4106143 ]...
Writing blocks [ 4106144 through 4108191 ]...
Writing blocks [ 4108192 through 4110239 ]...
Writing blocks [ 4110240 through 4110479 ]...
scu>
options Option
Allows you to specify options which alter write same operations.
Format:
scu> write same options { lbdata | pbdata }
Where Options Are:
lbdata = Logical block data. Requests that the target replace
the first 4 bytes of data being written with the logical
block address of the block currently being written.
pbdata = Physical block data. Requests that the target replace
the first 8 bytes of data being written with the physical
address (cylinder/head/sector) of the block being written.
Please refer to drive manual to determine the options supported.
xza Command
This command performs various operations specific to the KZMSA adapter.
Format:
scu> xza show keyword
show Option
This command is used to show various counters within the XZA adapter.
Format:
{ show counters }
scu> xza { show errors soft }
{ show errors hard }
Note:
These commands are only supported on Tru64 Unix.
zero Command
This command is used to zero device or program parameters.
Format:
scu> zero { log pages }
{ sense }
log Option
This command is used to zero the device log parameters, which is useful
prior to starting a test.
Format:
scu> zero log pages { pcf page-control-field }
Notes:
If the page control field is omitted, cumulative values (0x01) are
zeroed by default.
Errors:
Since Log Select is an optional command, not all devices support it.
If unsupported by the device, you'll see the following error:
scu> zero log pages
scu: 'log select' failed, EIO (5) - I/O error
scu: Sense Key = 0x5 = ILLEGAL REQUEST - Illegal request or CDB parameter,
Sense Code/Qualifier = (0x20, 0) = Invalid command operation code
Example:
scu> show nexus
Device: TZK10, Bus: 0, Target: 5, Lun: 0, Type: Sequential Access
scu> show log page overrun full
Buffer Overrun/Underrun Counter Parameters (Page 0x1 - Current Cumulative Values):
Page Code: 0x1
Page Length: 12
Parameter Code: 0
List Parameter Data Format (LP): 0 (Data Counter)
Threshold Met Criteria (TMC): 0 (Notify of every update of cumulative value)
Enable Threshold Criteria (ETC): No (Threshold comparison disabled)
Target Save Disable (TSD): 0 (Saved frequently)
Disable Save (DS): 1 (Parameter is NOT Savable)
Disable Update (DU): No (Data counting is enabled)
Parameter Length: 2
Underrun Counter: 0
Parameter Code: 0x1
List Parameter Data Format (LP): 0 (Data Counter)
Threshold Met Criteria (TMC): 0 (Notify of every update of cumulative value)
Enable Threshold Criteria (ETC): No (Threshold comparison disabled)
Target Save Disable (TSD): 0 (Saved frequently)
Disable Save (DS): 1 (Parameter is NOT Savable)
Disable Update (DU): No (Data counting is enabled)
Parameter Length: 2
Overrun Counter: 4
scu> zero log pages
scu> show log page overrun full
Buffer Overrun/Underrun Counter Parameters (Page 0x1 - Current Cumulative Values):
Page Code: 0x1
Page Length: 12
Parameter Code: 0
List Parameter Data Format (LP): 0 (Data Counter)
Threshold Met Criteria (TMC): 0 (Notify of every update of cumulative value)
Enable Threshold Criteria (ETC): No (Threshold comparison disabled)
Target Save Disable (TSD): 0 (Saved frequently)
Disable Save (DS): 1 (Parameter is NOT Savable)
Disable Update (DU): No (Data counting is enabled)
Parameter Length: 2
Underrun Counter: 0
Parameter Code: 0x1
List Parameter Data Format (LP): 0 (Data Counter)
Threshold Met Criteria (TMC): 0 (Notify of every update of cumulative value)
Enable Threshold Criteria (ETC): No (Threshold comparison disabled)
Target Save Disable (TSD): 0 (Saved frequently)
Disable Save (DS): 1 (Parameter is NOT Savable)
Disable Update (DU): No (Data counting is enabled)
Parameter Length: 2
Overrun Counter: 0
scu> quit
pcf Option
The page control field determines the type of parameters to be selected.
The defined page control fields are:
Format:
scu> zero log pages pcf { code hex-value | current | default | threshold }
Where:
hex-value = A valid hex value between the range 0-3.
current = Selects current cumulative log parameters.
default = Selects default cumulative log parameters.
threshold = Selects current threshold log parameters.
Examples:
scu> zero log pages
sense Option
This command is used to zero the saved request sense data. The program saves
the sense data from the last failing command for subsequent "show sense" cmds.
If you wish to force another request sense command, you must first zero the
existing sense data.
Format:
scu> zero sense
Notes:
o Most devices discard their sense data after a request sense cmd.
o Request sense is returned automatically with each command issued.
o The auto-sense can be disabled via "set cam flags 0x400|0x20".
Example:
scu> set cam flags 0x400|0x20
scu> eject
scu> tur
scu: 'test unit ready' failed, EIO (5) - I/O error
scu> zero sense
scu> show sense
Request Sense Information:
Error Code: 0x70 (Current Error)
Valid Bit: 0
Segment Number: 0
Sense Key: 0x2 (NOT READY - Logical unit is NOT ready)
Illegal Length: 0
End Of Media: 0
File Mark: 0
Information Field: 0
Additional Sense Length: 0xa
Command Specific Information: 0
Additional Sense Code/Qualifier: (0x3a, 0) = Medium not present
Field Replaceable Unit Code: 0
Sense Specific Bytes: 00 00 00
Send mail to admin of this page: rmiller@zk3.dec.com
To Robin's home page.
Last modified: October 30th, 1999