IBM Support

TWS and DWC data gathering scripts

Question/Answer


Question

How can comprehensive troubleshooting data for IBM Workload Scheduler (IWS) and its components be gathered and made available to IBM Support?

Answer

Download the zip file or Unix shell script attached below, extract the contents, execute the script on the machine with the TWS instance and upload to the support file server using one of four available methods.

Gathering the data:

UNIX Usage:


tws_inst_pull_info_v94.sh -twsuser <tws_user>

Optional flags:
[-twsdir <path>] [-date <yyyymmdd>] [-outdir <path> | -log_dir_base <path>] [-nodbdefs] [-nowas] [-db2support] [-debug] [-u]

NOTE: Launch the script as the TWSUser unless otherwise instructed by TWS support.
NOTE: The UNIX version requires only one flag and argument: -twsuser <user>


Windows:  Utilize tws_inst_pull_info.cmd that is delivered with the TWS instance.

UPLOAD to TWS Support using one of the following four methods:

1. EMAIL: If the file to send is less than 10 MB in size, send as an attachment to an email to tivoli_support@ecurep.ibm.com with the PMR number in the subject line.

For example:
Subject: PMR 12345,BBB,CCC

- or if the file to send is greater than 10 MB in size

2. IBM SR (Service Request): Access the SR Tool

http://www.ibm.com/support/servicerequest/

- or -

3. Enhanced Customer Data Repository (ECuRep): Access the Ecurep Secure Upload tool

https://www.secure.ecurep.ibm.com/app/upload

- or -

4. FTP: to ftp.ecurep.ibm.com:
Rename the file to send to the PMR number. For example:
# mv TWS_20100202_098433.tar.Z 12345.BBB.CCC.tar.Z
# ftp ftp.ecurep.ibm.com
username: anonymous
password: <email>
ftp> cd /toibm/tivoli
ftp> bin
ftp> put 12345.BBB.CCC.tar.Z
Where:
12345 = First five digits of the PMR number.
BBB = Branch value
CCC = Country code (US code is 000)

ADDITIONAL INFORMATION:


UNIX Sample Usage:
tws_inst_pull_info_v94.sh -twsuser m94
tws_inst_pull_info_v94.sh -twsuser maestro -outdir /tmp/maestro_tmp
tws_inst_pull_info_v94.sh -twsuser fta92 -twsdir ~fta92/TWA/TWS
tws_inst_pull_info_v94.sh -twsuser any -twsdir /opt/IBM/TWAUI/TDWC
tws_inst_pull_info_v94.sh -twsuser m86 -twsdir /home/m84 -db2support -nodbdefs
tws_inst_pull_info_v94.sh -twsuser m92_dwc

UNIX Required Flag:
-twsuser <tws_user>
Specify the userid for which TWS or TDWC was installed
*Note: The -twsuser value is tested against the value for EWas_user in /etc/TWA/*properties files.


UNIX Optional flags:

-twsdir <TWS_INSTANCE_HOME> | <TDWC_INSTANCE_HOME>
If the script does not successfully detect the TWS or TDWC installation home then you will be instructed to us the -twsdir flag. Specify the full path to the location to which a TWS or TDWC instance was installed. For versions later than 8.4 the last directory in the path should be either TWS or TDWC.
Examples:
-twsdir /home/m86/TWA/TWS
-twsdir /home/tdwc86/TDWC
-twsdir /opt/IBM/TWA/TWS
-twsdir /opt/IBM/TWAUI/TDWC

-date <yyyymmdd>
To capture TWS files and logs from yyyymmdd and the day prior. If not specified, files from today and yesterday will be gathered.
-outdir <path> | -log_dir_base <path>
Output writes to /tmp/tws_info by default. If another location is desired specify the full path to that location. The executing user must have write access to the parent of the directory specified. If the directory does not exist it will be created by the script. If the executing user does not have write access to the default output directory or the specified directory the script will return the failure information.
-nodbdefs
To prevent composer create actions. Use this if TWS object definitions are not needed.
-nowas
To prevent WebSphere files and logs from being gathered.
-db2support
To gather db2 trace information which includes db2diag.log contained in a file named db2support.zip
-debug
To give verbose output. Redirect the output using: > file.out 2>&1
-u
Usage.


tws_inst_pull_info_v94.shtws_inst_pull_info_v94.sh tws_inst_pull_info_v94_README.txttws_inst_pull_info_v94_README.txt

Product Alias/Synonym

Maestro
TWS
TWA

Document information

More support for: IBM Workload Scheduler

Component: Not Applicable

Software version: 9.1, 9.2, 9.3, 9.4

Operating system(s): AIX, HP-UX, Linux, Platform Independent, Solaris

Reference #: 1295038

Modified date: 21 February 2019