wa_pull_info 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 
[-component DWC|TWS]
[-date yyyy-mm-dd]
[-isroot=true|false]
[-output output_path]
-user userid
[-workdir working_directory]

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

Parameters

-?

Displays the usage of the command.

-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.

-isroot

If you have performed a no-root installation, set this parameter to false: the tool uses the user specified with the -user parameter. The default value is true, which indicates you have installed the component using the root user. This parameter is required if you perform a no-root installation.

-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: C:\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.

-user

The product user that you specified when you installed the component. If you performed a no-root installation, set the -isroot parameter to false. 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, if you installed as root: /etc/TWA
On UNIX operating systems, if you installed as no-root: user home dir/.TWS/etc/TWA

or on the Dynamic Workload Console in the following path:

On Windows operating systems: C:\Windows\TWA
On UNIX operating systems, if you installed as root: /etc/TWA
On UNIX operating systems, if you installed as no-root: user home dir/.TWS/etc/TWA

or on the agent in the following path:

On Windows operating systems: C:\Windows
On UNIX operating systems, if you installed as root: /etc/TWS/TWSRegistry.dat
On UNIX operating systems, if you installed as no-root: user home dir/.TWS/etc/TWS/TWSRegistry.dat

This parameter is mandatory.

-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: C:\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.

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>