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

Listing the contents for a log page

/quadstorvtl/bin/logctl -l -v <vtl name> -d <drive number> -p <page code>

In case of a standalone virtual drive or to query a medium changer the drive number does not apply

For example

To query tape alert log page information for the medium changer of vtl 'VTL1'

/quadstorvtl/bin/logctl -l -v VTL1 -p 0x2E

Similarly to query tape alert log page information for the first drive of vtl 'VTL1'

/quadstorvtl/bin/logctl -l -v VTL1 -d 1 -p 0x2E

Not all log pages are implemented. The following log pages are currently implemented for a tape drive

WRITE ERROR COUNTERS (02h)

READ ERROR COUNTERS (03h)

VOLUME STATISTICS (17h)

TAPE ALERT (2Eh)

TAPE CAPACITY (31h)

PEFORMANCE CHARACTERISTICS (37h)

While TAPE CAPACITY log page contents can be listed, they cannot be modifed using logctl. VOLUME STATISTICS log page cannot be listed nor modified using logctl

And for a medium changer

TAPE ALERT (2Eh)

Adding a log parameter

/quadstorvtl/bin/logctl -a -v <vtl name> -d <drive number> -p <page code> -i <parameter code> -s <parameter length> -f <parameter format> -V <parameter value>

If the log page specified does not exist it will be created

For the formate specified a bitmask of 0x3 is applied to determine if the parameter value passed is binary or ascii. A format value 0x01 after the bitmask applied is considered as ascii and all other values as binary

For example to add parameter to a new page 0x4F

/quadstorvtl/bin/logctl -a -v VTL1 -d 1 -p 0x3F -i 0x0000 -s 8 -f 0x01 -V 'LOG TEST'

/quadstorvtl/bin/logctl -a -v VTL1 -d 1 -p 0x3F -i 0x0001 -s 8 -f 0x00 -V '00 01 02 03'

/quadstorvtl/bin/logctl -l -v VTL1 -d 1 -p 0x3F

ID.      Fmt.     Len.     Value
0000     01       08       LOG TEST
0001     00       08       00 01 02 03 00 00 00 00

Now we query the drive for the log page data using sg_raw

sg_raw -r 64 /dev/st0 4D 00 3F 00 00 00 00 00 40 00
SCSI Status: Good 
Received 28 bytes of data:
00     3f 00 00 18 00 00 01 08  4c 4f 47 20 54 45 53 54    ?.......LOG TEST
10     00 01 00 08 00 00 00 00  03 02 01 00                ............

Deleting a log parameter

/quadstorvtl/bin/logctl -x -v <vtl name> -d <drive number> -p <page code> -i <parameter code>

For example

/quadstorvtl/bin/logctl -x -v VTL1 -d 1 -p 0x3F -i 0x0001
/quadstorvtl/bin/logctl -l -v VTL1 -d 1 -p 0x3F
ID.      Fmt.     Len.     Value
0000     01       08       LOG TEST