Enabling tracing for InfoSphere DataStage parallel jobs

You can enable tracing for InfoSphere® DataStage® parallel jobs to help you troubleshoot problems.

Procedure

  1. Enable the following administrator project level parameters for the project or the job and set them to true
    • APT_DUMP_SCORE
    • APT_PM_SHOWRSH
    • APT_PM_SHOW_PIDS
    • APT_RECORD_COUNTS
    • APT_SHOW_COMPONENT_CALLS
    • APT_STARTUP_STATUS
    • OSH_DUMP
    • OSH_ECHO
    • OSH_EXPLAIN APT_DISABLE_COMBINATION
  2. Add a user-defined environment variable that is called DS_PXDEBUG in the InfoSphere DataStage Administrator. The value must be undefined for the project. Leave that value blank or set it to 0 at the project level. Add this new environment variable to the job level and set the value to 1. The DS_PXDEBUG variable causes the job to report debugging information.

Results

Debug information is collected under a new project-level directory called Debugging. Subdirectories are created on a per-job basis, and are named after the job. Multi-instance jobs run with a non-empty invocation ID, and the directory is named with the job name and the invocation ID.

What to do next

Run the job. Send an export of the job with the detailed job log and the project path/Debugging/Jobname folder to support.