DataStage (DS) information and files to collect
DataStage (DS) information and files to collect
AIX, Solarix, Linux, or HP-UX
Windows
DataStage Operations Console (Information Server 8.7 and above only)
DataStage Operational Metadata (Information Server 11.3 and above only)
AIX, Solarix, Linux, or HP-UX
Files and Data to collect
|
Description
|
Server Machine
| |
<USER_HOME>/ds_logs/*.*
|
Not always present.
|
DataStage SERVER Machine
| |
<CRED_USER_HOME>/ds_logs/*.*
|
All files contained in the ds_logs directory.
|
<IS_HOME>/Server/DSEngine/dsenv
| |
<IS_HOME>/Server/DSEngine/uvconfig | |
<IS_HOME>/Server/DSEngine/.odbc.ini or the file pointed by the environment variable ODBCINI | ODBC.ini file |
<IS_HOME>/Server/DSEngine/errlog | |
<IS_HOME>/Server/DSEngine/DSAuditTrace.log | |
<IS_HOME>/Server/PXEngine/etc/jobmon_ports | |
<IS_HOME>/Server/PXEngine/java/JobMonApp.log.nnn | All historical logs |
<IS_HOME>/Server/PXEngine/java/JobMonApp.log | Current log |
<IS_HOME>/Server/PXEngine/etc/operator.apt* | |
<IS_HOME>/Server/DSEngine/orbtrc.<DATE>.txt
<IS_HOME>/Server/DSEngine/orbmsg.<DATE>.txt |
Not always present
|
<IS_HOME>/Server/DSEngine/bin/orbtrc.<DATE>.txt
<IS_HOME>/Server/DSEngine/bin/orbmsg.<DATE>.txt |
Not always present
|
<IS_HOME>/Server/Projects/_Project_Name_/&COMO&/*.*
|
Only present if tracing is enabled in the Administration client
|
<IS_HOME>/Server/Projects/_Project_Name_/heapdump.* <IS_HOME>/Server/Projects/_Project_Name_/javacore.* <IS_HOME>/Server/Projects/_Project_Name_/Snap.* <IS_HOME>/Server/Projects/_Project_Name_/orbtrc.<DATE>.txt <IS_HOME>/Server/Projects/_Project_Name_/orbmsg.<DATE>.txt | Heapdump, java core, and orb log files in the project |
Files and Data to collect
|
Description
|
Client Machine
| |
<USER_HOME>\ds_logs\*.*
|
DataStage logs from the client user folders
|
<IS_HOME>\Clients\Classic\orbtrc.<DATE>.txt
|
Not always present
|
<IS_HOME>\Clients\Classic\orbmsg.<DATE>.txt
|
Not always present
|
<IS_HOME>\Clients\Classic\javacore* | Not always present |
<IS_HOME>\Clients\Classic\Snap*.trc | Not always present |
Client Machine, Information Server 8.5 and above
| |
<USER_HOME>\Application Data\IBM\Information Server\DataStage Client\ <ClientTagID>\ErrorReports\*.zip | The ClientTagID is located in the <IS_HOME>\Version.xml file, for example:<InstallType client="true" clientTagId="652e77e8-ea1e-4850-a8b2-11e6a33dd884" currentVersion="8.5.0.0" document="false" domain="true" engine="true" repository="true"/> |
Server machine
| |
<USER_HOME>\ds_logs\*.*
|
Not always present.
|
DataStage SERVER Machine
| |
<CRED_USER_HOME>\ds_logs\*.*
|
Credential-mapped user logs
|
<IS_HOME>\Server\DSEngine\uvconfig | |
<IS_HOME>\Server\DSEngine\.odbc.ini | |
<IS_HOME>\Server\DSEngine\javacore*<IS_HOME>\Server\DSEngine\heapdump* | Java Core and heap dump files, created by OutOfMemoryErrors: there may be several, collect the most recent ones |
<IS_HOME>\Server\PXEngine\etc\jobmon_ports | |
<IS_HOME>\Server\PXEngine\java\JobMonApp.log.nnn | All historical logs |
<IS_HOME>\Server\PXEngine\java\JobMonApp.log | Current log |
<IS_HOME>\Server\etc\operator.apt* | |
<IS_HOME>\Server\DSEngine\orbtrc.<DATE>.txt
<IS_HOME>\Server\DSEngine\orbmsg.<DATE>.txt |
Not always present
|
<IS_HOME>\Server\DSEngine\bin\orbtrc.<DATE>.txt
<IS_HOME>\Server\DSEngine\bin\orbmsg.<DATE>.txt |
Not always present
|
<IS_HOME>\Server\projects\_Project_Name_\&COMO&\*.*
|
Only present if tracing is enabled in the Administration client
|
<IS_HOME>\Server\Projects\_Project_Name_\heapdump.* <IS_HOME>\Server\Projects\_Project_Name_\javacore.* <IS_HOME>\Server\Projects\_Project_Name_\Snap.* <IS_HOME>\Server\Projects\_Project_Name_\orbtrc.<DATE>.txt <IS_HOME>\Server\Projects\_Project_Name_\orbmsg.<DATE>.txt | Heapdump, java core, and orb log files in the project |
Files and Data to collect
|
Description
|
<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/Server/<IS_HOME>/ASBNode/asbagent_startup.out<IS_HOME>/ASBNode/asbagent_startup.err<IS_HOME>/ASBNode/bin/Agent.out<IS_HOME> <WAS_IS_PROFILE> <WAS_IS_PROFILE> <WAS_IS_PROFILE> |
Log and configuration files used by DataStage Operations Console
|
<IS_HOME>/Server/ |
Collect all files inside the most recent folder. Folder name is in YYYYMMDDHH format, for example '2011092813'
|
Files and Data to collect
|
Description
|
<IS_HOME>/Server/ |
Log files used by DataStage Operational Metadata
|
<IS_HOME>/Server/ |
XML files used by DataStage Operational Metadata
|
Collecting DataStage specific information
DataStage can create logging and tracing information at multiple layers and in different components:
DataStage Client-Server Tracing
This traces calls made from the DataStage clients (such as Designer) to the DSServer engine helper programs. Tracing can be turned on at the project level. When tracing is turned on, all clients that attach to that project produce a large trace file. Also, each time a client attaches to DataStage, a warning message displays indicating that tracing is turned on. Click OK to proceed.
Command
|
|
Files and Data to collect |
<IS_HOME>\Server\projects\_Project_Name_\&COMO&\*.* |
DataStage Client-JuggerNet Proxy Tracing
Use the JuggerNet Proxy Tracing to detect Codemesh problems. JuggerNet Proxy Tracing is set on a per-client basis.
Command
|
Set the following environment variables:
XMOG_TRACE_LEVEL=TraceVerbose XMOG_TRACE_FILE=C:\xmogtrace.txt |
Files and Data to collect |
C:\xmogtrace.txt
|
DataStage Client-Spy Tracing
The Spy trace shows calls made from the Java layer of the client. It is turned on for individual clients.
Command
|
The logs are written to <USER_HOME>\ds_logs\dstage_wrapper_spy_NN.log where NN is a number from 1 to 20.
|
Files and Data to collect |
<USER_HOME>\ds_logs\dstage_wrapper_spy_NN.log where NN is a number from 1 to 20
|
Increase Log Detail
Increase the detail included in the client side log files.
Command
|
Create a file named newrepos.debug.properties that contains the following environment variables:
|
Files and Data to collect |
<USER_HOME>\ds_logs\*.*
|
DataStage Trace File Location
For InfoSphere Information Server 8.1 through 9.1.x, trace files may be generated in the current folder when some DataStage tools are run. If present, these trace files should be included in the data gathered for IBM Support.
Command
|
The following commands may generate log files and atrifacts to collect:
DSXImportService dsjobs ISTools |
Files and Data to collect |
orbtrc.<DATE>.txt from the current folder
|
orbmsg.<DATE>.txt from the current folder
|