Running the tsmdiag utility

You can diagnose problems with an IBM Spectrum Protect™ server by running the tsmdiag utility on the system where the IBM Spectrum Protect server is installed. After you collect the diagnostic data, you can send the information to IBM® Software Support.

Procedure

To run the tsmdiag utility, complete the following steps:

  1. AIX operating systemsLinux operating systemsChange the tsmdiag directory permissions by issuing the following command: 
    chmod -R 757 /opt/tivoli/tsm/server/bin/tsmdiag
  2. Issue the tsmdiag command from the following directory:
    • AIX operating systemsLinux operating systemsBy using a DB2® instance user ID, you must issue the tsmdiag command from the /opt/tivoli/tsm/server/bin/tsmdiag directory.
    • Windows operating systemsBy using an administrator user ID, you must issue the tsmdiag command from the \server\tsmdiag directory.
    For example, the following command collects a default set of diagnostic information files from an IBM Spectrum Protect server on a local host. This command is run by an administrator that is called admin with an administrator password admin01 on an IBM Spectrum Protect server. This server is running on TCP/IP port 1501 of a local host.
    tsmdiag -id admin -pa admin01 -tcpport 1501
  3. Obtain the results file from the following directory:
    • AIX operating systemsLinux operating systems/opt/tivoli/tsm/server/bin/tsmdiag/results/tsmdiag_results<year>-<month>-<day>-<hour>-<minute>-<second>.tar
    • Windows operating systemsC:\Program Files\tivoli\tsm\server\tsmdiag\results\tsmdiag_results<year>-<month>-<day>-<hour>-<minute>-<second>.zip
  4. Submit the results file with the problem report to IBM Software Support.

Example tsmdiag commands

The following command connects to an IBM Spectrum Protect server called MYSERVER on TCP/IP port 1501. When a DB2 administrator called admin runs the following command, a default set of diagnostic information files is collected. Diagnostic information about the performance of the server MYSERVER is also collected.
tsmdiag -id admin -pa admin01 -tcpport 1501 -servername MYSERVER -performance
The following command connects to an IBM Spectrum Protect server on the default TCP/IP port 1500. When an administrator called admin runs the following command, the command collects a default set of diagnostic information files. This command also provides results from the IBM Spectrum Protect server SHOW commands and some diagnostic information about the status of the IBM Spectrum Protect server.
tsmdiag -id admin -pa admin01 -hang