Tasks

Describes the tasks performed by the data capture utility.

Check that the user exists

The script verifies if the specified user exists in the TWSRegistry.dat file. If it does, the <TWS_HOME> directory used for data collection is extracted from the TWSRegistry.dat file. (UNIX™ only) If the specified user does not exist, the script verifies if the user exists in the /etc/passwd file. If no user exists, the script terminates.

Check the user permissions

The commands that are used during the data collection try to retain the original ownership of the files; when the script is run on Solaris platforms, the ownership of the files might change. If the script is run by a IBM Workload Scheduler user (for example, not the root user) the script collects the available instance data.

Note:

Some Windows™ security policies can affect which data is extracted.

Create the directories in which to store the collected data

The script first creates the <log_dir_base> directory, where <log_dir_base> is the value provided for the -log_dir_base option. Within the <log_dir_base> directory, the script creates the tws_info directory and its subdirectories TWS_yyyymmdd_hhmmss, where yyyy=year, mm=month, dd=day, hh=hour, mm=minute and ss=seconds.

Collect data

The script collects system and product-specific data, as described in Data collection.

Create the TAR file

UNIX: The script creates the TAR file TWS_yyyymmdd_hhmmss.tar and compresses it to TWS_yyyymmdd_hhmmss.tar.Z, or if the operating system is Linux_i386, TWS_yyyymmdd_hhmmss.tar.gz.
Windows: On Windows operating systems there is no built-in compression program, so the script does not create a compressed file. If you intend to send the data to IBM® Software Support you should use your own compression utility to create the compressed archive.