IBM Support

Collecting data for: Tivoli System Automation Application Manager

Product documentation


Would you like a tool that automates the collection of troubleshooting data for TSAAM, instead of manually trying to find, group, and collect what IBM Support needs to remotely diagnose your problem ?


This is NOT the data collector for "Tivoli System Automation for Multiplatforms".

Use the following URL if you need the data collector for TSAMP:

This is the MustGather document for the IBM Tivoli System Automation Application Manager (TSAAM) product, including the Base Operations Console. The attached "getamdata" utility knows how to find and collect the data files that IBM Support need in order to diagnose problems with the TSAAM product and related middleware.

Table of contents:

General introduction to getamdata

The "getamdata" utility will gather detailed information about your TSAAM environment, including middleware products (WAS and DB2).

It can collect a variety of useful logs and FFDC data related to the TSAAM automation engine, the WebSphere Application Server, and the DB2 server. Configuration data for all three products can also be collected. Installation logs and properties can be collected for TSAAM.

The utility will tar & compress all output into a single tarball and provide final filename details after it has completed executing.

It is important to run the utility before any manual (user) recovery efforts are attempted. This will ensure an accurate snapshot of the current states which can then be correlated with the logs and traces collected.

Electronically opening a PMR (SR) eliminates waiting on the phone to provide general information to the HelpDesk center. Providing the output data from the getamdata utility at the time you electronically open a PMR will ensure the data is immediately available to a Support engineer, thus allowing quicker initial diagnoses.

Instructions for using the Data Gathering Tool (getamdata)

Ensure you always FTP the tar package using binary mode. Un-tar on the system where it is to be used, preferably in its own sub-directory.

Usage :

Please Note: This utility must be run as "root", Running as any other user will likely result in data that Support cannot use to help you.

For maximum data collection, run the utility using the following syntax :
./getamdata -all

To have the PMR number included in the output tarfile name, run the utility similar to the following syntax :
./getamdata -all -pmr 12345,035,724

If you want to see more detailed information about the commands being run, then add the –verbose flag, for example :
./getamdata -all -verbose

If you want to use a different output directory instead of /tmp (default), add the –outdir <dir> flag, for example :
./getamdata -all –outdir /var/log

To collect just the eez logs/FFDC and eez configuration, then run the utility as follows :
./getamdata -eez

To exclude a particular item from the collection, there are -skip* options available. For example, to collect all data "except" for install data, run the utility using the following syntax :
./getamdata -all -skipinstall

For more usage help, run the utility with the -h or -? flag, for example :
./getamdata -h

Results :

After running the utility, the result will be a single tar ball located and named as follows :
/tmp/<MMDDYY-HHMMSS>-<node_name>_am-data.tar.gz (Linux)
/tmp/<MMDDYY-HHMMSS>-<node_name>_am-data.tar.Z (AIX, Solaris)

Either prefix the tar file with the PMR number, or tar the compressed file into a parent tarball named using the PMR number so that it gets routed correctly when you FTP it to IBM, for example:
cd /tmp
tar cvf ppppp.bbb.ccc .tar *_am-data.tar.Z

Sending getamdata output/data to IBM Support

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

At any time, you can re-run the getamdata utility with just the –ftphelp flag and it will only display instructions on how to name the file and how to FTP to IBM :
./getamdata -ftphelp

Upload the compresses tarball via your browser:

Please include some details about the data where appropriate, for example a timeline of events (when the problem occurred and when actions were performed, both before and after the observed problem).

If using SR, please update the PMR to indicate that data has been sent and include some details about the data where appropriate, in particular timeline.

Downloading the getamdata tarball package

IBM's recommended browser is Firefox. It is therefore recommended that you use Firefox to download the attached tar file. Chrome has also been tested with success.

Experience has shown that Internet Explorer (IE) can corrupt the tar file during its download process, though this may depend on the version of IE being used ... sorry, no IE version details available.

Ensure you always FTP the tar package using binary mode. Un-tar on the system where it is to be used, preferably in its own sub-directory.

Click on the following icon link to download the latest version (v2.1) of the "getamdata" utility :

Original publication date


Document information

More support for: Tivoli System Automation Application Manager

Software version: 3.1, 3.2, 3.2.1, 3.2.2, 4.1

Operating system(s): AIX, Linux, Solaris

Reference #: 7017972

Modified date: 06 January 2015