This documentation only applies to QUADStor Tape Test Framework software (quadstor-ttf)

rwctl utility allows to simulate different error conditions during a tape read or write

Adding a read/write control entry

/quadstorvtl/bin/rwctl -a -v <vtl name> -d <drive number> -w 0|1 -i <lid start> -n <number of blocks> -r <response code> -s <sense key> -c <asc> -q <ascq>

Where:

lid start indicates the start logical block

number of blocks indicates the span of blocks

<response code>, <sense key> <asc> <ascq> indicate the sense data to return

-w 0 indicates the sense data is to be returned on a read and -w 1 indicates a write

For example

/quadstorvtl/bin/rwctl -a -v VTL1 -d 1 -w 0 -i 0 -n 100  -r 70 -s 02 -c 53 -q 04

The above command add a read/write error control information for the first drive of VTL1 for a read starting with logical block identifier 0 for 100 logical blocks as seen below

sg_raw -r 1024 /dev/sa0 08 00 00 04 00 00
SCSI Status: Check Condition 

Sense Information:
Fixed format, current;  Sense key: Not Ready
Additional sense: Medium thread or unthread failure
No data received

Deleting a read/write control entry

/quadstorvtl/bin/rwctl -x -v <vtl name> -d <drive number> -w 0|1 -i <lid start> -n <number of blocks> -r <response code> -s <sense key> -c <asc> -q <ascq>

For example

/quadstorvtl/bin/rwctl -x -v VTL1 -d 1 -w 0 -i 0 -n 100  -r 70 -s 02 -c 53 -q 04

Listing the current rwctl entries

/quadstorvtl/bin/rwctl -l -v <vtl name> -d <drive number>

For example

/quadstorvtl/bin/rwctl -l -v VTL1 -d 1

LID Start  Blocks   R/W    Res. Code Sense Key        ASC/ASCQ Description
0          100      Read   70        NOT READY        53/04    MEDIUM THREAD OR UNTHREAD FAILURE