NAME

mtx − Generic Magtape Exerciser

SYNTAX

/usr/field/mtx [ options ] −adev
/usr/field/mtx [ options ] −sdev
/usr/field/mtx [ options ] −ldev
/usr/field/mtx [ options ] −vdev

DESCRIPTION

The mtx exerciser will write, read, and validate random data on the specified magnetic tape device from beginning of tape (BOT) to end of tape (EOT). There are four record length modes in which to run this exerciser:

•Short (512 bytes)

•Long (10240 bytes)

•Variable (512-20480 bytes)

•All three of the above in sequence. 

The exerciser will run until <CTRLC> or a kill -15 pid is sent to the process. 

A logfile is made in /usr/field for you to examine and then remove. If there are errors in the logfile, check the /usr/adm/syserr/syserr.<hostname> file, where the driver and kernel error messages are saved. 

ARGUMENTS

You must specify one of the following function flags and its argument to the mtx exerciser.

−adevPerform short, long, and variable-length record tests on the dev, a raw device name and unit number.  For example, −armt0h. 

−sdevPerform short (512-byte) record length test.  The dev argument is a raw device name and unit number.  For example, −srmt0h. 

−ldevPerform long (10240-byte) record length test.  The dev argument is a raw device name and unit number.  For example −lrmt0h. 

−vdevPerform variable record lenth test (records vary from 512 bytes to 20480 bytes).  The dev argument is a raw device name and unit number.  For example, −vrmt0h. 

OPTIONS

The mtx options are:

−hPrint help message for the mtx command.

−ofileSave diagnostic output in file. 

−tiRun time in minutes (i).  The default is to run until the process receives a <CTRLC> or kill -15 pid. 

−rjRecord length for long-record test.  May range from 1 - 20480; the default is 10240 bytes. 

−fkSize of file in records.  The default is −1, go to end-of-tape. 

EXAMPLES

This example runs short, long, and variable-length tests on rmt0h until the process receives a <CTRLC> or kill -15 pid. 

% /usr/field/mtx -armt0h

The following example runs a long-record length test on rmt0h for 240 minutes in the background.

% /usr/field/mtx -lrmt0h -t240 &

SEE ALSO

System Management Guide