Downloading and using the IBM Tape Diagnostic Tool

How to download the ITDT, access the related documentation, and use the tool for IBM® TS3500 Tape Library Shuttle Complex discovery.

Before you begin

The IBM Tape Diagnostic Tool (ITDT) is an independent tool that provides diagnostics on tape drives and libraries. IBM maintains the most current levels of the ITDT and related documentation on Fix Central. Information on using the ITDT is available in the PDF document IBM Tape Device Drivers Installation and User's Guide. Click the following link to access the PDF in a new browser window: http://www-01.ibm.com/support/docview.wss?rs=577&uid=ssg1S7002972.
Downloading the IBM Tape Diagnostic Tool
  1. Open the following URL in your web browser: http://www.ibm.com/support/fixcentral.
  2. Select System Storage from the Product Group menu.
  3. Select Tape systems from the System Storage menu.
  4. Select Tape device drivers and software from the Tape systems menu.
  5. Select IBM Tape Diagnostic Tool ITDT from the Tape drivers and software menu.
  6. Select your operating system from the Platform menu.
  7. Click Continue
  8. Narrow the search of available downloads according to your criteria. (This step can be skipped.)
  9. Click Continue to view the list of available downloads.
  10. Select the version that you want to download.
  11. Follow the instructions on the Fix Central download page to download the new version.
Using the ITDT for TS3500 shuttle discovery

The ITDT HDP Discover function scans the host for attached TS3500 devices and uses their data to discover the HDP system. If it is successful, it delivers two maps that represent the logical and physical HDP environment.

After the configuration of the TS3500 Shuttle Complex, you need to verify that the ITDT HDP Discover function works correctly on the TSLM server. The following example command is used to verify the ITDT HDP Discover function, where /dev/IBMchanger0, /dev/IBMchanger1, /dev/IBMchanger2 and /dev/IBMchanger3 are the device file names of the libraries that are connected by the shuttle complex:
itdt hdp discover -d /dev/IBMchanger0 -d /dev/IBMchanger1 -d /dev/IBMchanger2  -d /dev/IBMchanger3
The following trace log files are created after you run the ITDT:
  • ibmscs.log
  • ibmscs.info
  • ibmscs.data
The trace log files are located under /var/log on Linux and under /var/adm/ras on AIX®. The owner of those files is a root user. Use the following command to change the access permissions so that TSLM can write log records to them:
chmod 777 ibmscs.*