Use the rtdcli command line interface to run diagnostic tests on specific devices.
Syntax
rtdcli help
rtdcli run [-d device] [-t test] [-x]
rtdcli devices
rtdcli tests
Description
Prerquisites: This interface is available
only in the Installable Edition.
Important:
- To install or use Dynamic System Analysis, you must be logged in to the local system using a user ID that has administrator or root privileges. On a Linux system, you must log in using the root user name and privilege.
- On Linux systems, run Dynamic System Analysis from a journaling file system (such as ext3 or ReiserFS). You cannot run these commands from a virtual machine file system (VMFS).
To run this command on a system running Windows, change to the directory where Dynamic System Analysis was installed (for example, C:\Program Files\IBM\DSA). Use rtdcli.exe to run this command.
If no options are specified, this command display the command help.
To run this command on a system running Linux, Use rtdcli.sh.
Commands and options
- help
- Output usage help screen to stdout.
- run [-devicedevice] [-testtest] [-x]
- Runs
the specified diagnostic tests on the specified devices. You can specify one or more of the following options. If no options are specified, this command runs all nondestructive tests on all devices.
- -devicedevice
- Runs
diagnostics tests on the specified device.Tip:
- If a device name contain spaces, enclose the name in quotation marks (for example, -d "DVD-ROM 0").
- To get a list of valid devices, run the rtdcli devices command.
- -testtest
- Runs
only the specified diagnostics test.Tip:
- If a test name contain spaces, enclose the name in quotation marks.
- To get a list of valid devices, run the rtdcli tests command.
- -x
- Runs both nondestructive
and destructive diagnostic tests.If this option is not specified, only nondestructive diagnostic tests are run. The nondestructive diagnostic tests include:
- Optical drive tests, including verify media, read error, and drive self test
- Tape drive tests, including tape presence, tape alert, tape load, and tape self test
- devices
- Output devices and available tests to stdout
- tests
- Output list of installed tests to stdout
Examples
- Run a diagnostics test on a device
This example illustrates how to run the Verify Media Mounted test on the CDROM1 optical drive.
rtdcli.exe
run –d CDROM1 –t VerifyMedia
rtdcli.sh
run –d /dev/cd1 –t VerifyMedia