Command and parameters

Describes the command syntax and parameters of the data capture utility.

Command syntax

Run the data capture utility with the following command:

wa_pull_info -?

wa_pull_info 
-user userid
[-component DWC|TWS]
[-date yyyy-mm-dd]
[-output output_path]
[-workdir working_directory]

This is the syntax for UNIX® operating systems; on Windows™ use wa_pull_info.exe

Parameters

-user

The product user that you specify when you install the component. This user must exist in the registry file located on the master domain manager in the following path:

On Windows operating systems: C:\Windows
On UNIX operating systems: /etc/TWS

or on the Dynamic Workload Console in the following path:

On Windows operating systems: C:\Windows\TWA
On UNIX operating systems: /etc/TWA

This parameter is mandatory.

-component

The component whose data you want to capture. Supported values are DWC and TWS. The default value is TWS. This parameter is optional.

-date

Used as the base date for collected data logs. If not specified, the script uses the current date by default and the day before the current date. Run the data capture utility as soon as a problem occurs, to collect the data specific to the date and time of the problem. Thus, if the problem occurs on the current date, this option is not required. If the problem occurred earlier, then the date on which the problem occurred must be specified in the yyyy-mm-dd format. Either the current date or the specified date is used to identify which files and logs are extracted. This parameter is optional.

-output

The base directory location where the collected data is stored. Ensure you have write access to the specified directory. This parameter is optional. The default value is as follows:

On Windows operating systems: \tmp\wadatagather\output
On UNIX operating systems: /tmp/wadatagather/output

Ensure you do not enter a path that contains the stdlist folder located in TWA_DATA_DIR.

-workdir

The working directory used by the command for storing data while running. When the command stops running, the working directory is deleted. Ensure you have write access to the specified directory and enough space is available. This parameter is optional. The default value is as follows:

On Windows operating systems: \tmp\wadatagather\workdir
On UNIX operating systems: /tmp/wadatagather/workdir

Ensure you do not enter a path that contains the stdlist folder located in TWA_DATA_DIR.

-?

Displays the usage of the command.

Comments

Regardless of the parameters you specify, the command always returns at least the following information:

datagather_summary.log: A summary of the data retrieved by the command.
sistem_info: A folder containing several files which store system info.
registry_info: A folder containing IBM® Workload Scheduler registry files, if available.

Examples

Consider the following examples:

<tws_inst_path>/TWS/bin/wa_pull_info -component TWS -user <tws_user>


<dwc_inst_path>/DWC/tools/wa_pull_info -component DWC -user <dwc_user>