scu Help File


    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

Mail Send mail to admin of this page: rmiller@zk3.dec.com Home To Robin's home page.

Last modified: October 30th, 1999