IBM Support

Collecting Data for Tivoli Storage Manager for Mail

Technote (troubleshooting)


Collecting Data documents aid in problem determination and save time resolving Problem Management Records (PMRs).

Resolving the problem

Collecting troubleshooting data early, even before opening the PMR, helps IBM® Support quickly determine if:
Symptoms match known problems (rediscovery).
There is a non-defect problem that can be identified and resolved.
There is a defect that identifies a workaround to reduce severity.
Locating root cause can speed development of a code fix.

Collecting Data: Table of contents:

Gathering General Information

Information can be gathered using the IBM Support Assistant (ISA), a free cross-product tool. ISA Plugins are available that can assist in gathering the general information for Tivoli Storage Manager for Mail products. Alternately, you can manually collect the information:
Tivoli Data Protection for Domino
Tivoli Data Protection for Exchange

Entering general information into an electronically-opened PMR (ESR) eliminates waiting on the phone to provide general information to Level 1 support.

Manually Gathering Tivoli Data Protection for Domino Information

The default installation path is:

AIX: /usr/tivoli/tsm/client/domino/bin/
Linux and Solaris: /opt/tivoli/tsm/client/domino/bin/
Windows: c:\Program Files\Tivoli\TSM\Domino\

AIX, Solaris, a nd Linux:
  • Place the following script onto the machine and supply it with execute permissions. It will be necessary for the Domino instance owner to have write permissions to the /tmp directory to create an output file. Run the script as the Domino Instance Owner OS login ID. The script will gather general information regarding the Data Protection for Domino setup and create the file tdpdommustgather.out in the /tmp directory. Provide this output file to IBM support:

MS Windows:
Gather the following files where applicable:
  • dsm.opt used by the Data Protection for Domino
  • dsmerror.log
  • dsmsched.log
  • domdsm.log
  • dsierror.log
  • details of operating system levels
  • details of Domino Server levels
  • tdpdommustgather.out (created by the steps below)
In addition, please run the following commands:
  • echo "------domdsmc query adsm------" >> tdpdommustgather.out
  • domdsmc query adsm >> tdpdommustgather.out
  • echo "------domdsmc query domino------" >> tdpdommustgather.out
  • domdsmc query domino >> tdpdommustgather.out
  • echo "------domdsmc query preferences------" >> tdpdommustgather.out
  • domdsmc query preferences >> tdpdommustgather.out
  • echo "------set------" >> tdpdommustgather.out
  • set >> tdpdommustgather.out
  • reg query HKLM\software\ibm\adsm\currentversion /s >> tdpdommustgather.out

If the issue involves a Domino server crash or Tivoli Data Protection crash:
  • The NSD generated by Domino
  • The core file, where applicable
  • A screenshot of the crash, if possible
  • Details of available conditions that caused the crash

Manually Gathering Tivoli Data Protection for Exchange Information
    Note: If using Microsoft Exchange in a clustered environment, provide all of the requested data for each MSCS node in the cluster.

    Gather the following general data from the installation file path. The default installation path is:
    C:\Program Files\Tivoli\TSM\TDPExchange
    • dsm.opt used by Microsoft Exchange
    • dsmerror.log
    • dsierror.log (or the file specified by the ERRORLOGNAME option in the dsm.opt file)
    • dsmsched.log
    • The version and service pack of Windows
    • Tivoli Storage Manager Client specific version (ex:
    • Tivoli Data Protection for Exchange log. By default, this is the tdpexc.log in the Data Protection for Exchange install directory. It can also be specified by the /logfile option during command line processing.
    • Tivoli Data Protection for Exchange config file. By default this is the tdpexc.cfg in the Data Protection for Exchange install directory. It can also be specified by the /configfile option during command line processing.
    • The output of TDPEXCC QUERY TSM
    • The output of TDPEXCC QUERY EXCHANGE
    • The output of TDPEXCC QUERY TDP
    • Use the Exchange Management Console (PowerShell) and run the command:
    If this is a VSS Backup/Restore, also gather the additional data:
    • From the Client machine, gather the Windows Application event log (in txt or csv format)
    • From the DOS/Command prompt in the BAClient directory, run the following command:
      dsmc query systeminfo
      gather the dsminfo.txt and dsmminfo.txt files, which are generated in the BAClient directory.
    • From the Tivoli Storage Manager server, provide the output from the administrative commands:
    • To ensure that VSS is working properly, see Knowledgebase document:
    For scheduled backup operations, provide the command script that is used for the backup and the logs it writes to.
    • The logs can be identified by viewing the script and noting the values after /logfile along with any command line redirection.
    Submitting Information to IBM Support

    After a PMR is open, you can submit diagnostic troubleshooting data to IBM.

    If using ESR, update the PMR to indicate that data has been sent.

    Online Self-Help Resources
    • Review up-to-date product information at the Tivoli Storage Manager Product Support page.
    • Utilize the IBM Electronic Service Request tool to access the Tivoli Storage Manager Support team when requiring assistance from IBM.
    • Use the IBM Support Assistant (ISA), this free cross product tool assists you in increasing your capacity for self-help.
    • Install and use the IBM Support Toolbar. This is a stand-alone application that allows you to easily search for all types of software support content plus organizes the major areas of not only Software support, but the individual brand support sites into a concise application.

    Related Information

    Product Alias/Synonym


    Document information

    More support for: Tivoli Storage Manager for Mail

    Software version: Version Independent

    Operating system(s): AIX, Linux, Solaris, Windows

    Software edition: Edition Independent

    Reference #: 1259973

    Modified date: 22 September 2015

    Translate this page: