Enable CLI and TPT Trace Logs | Teradata Data Mover - About Enabling CLI and TPT Trace Logs for TPT Jobs - Teradata Data Mover

Teradata® Data Mover User Guide - 20.01

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Teradata Data Mover
Release Number
20.01
Published
November 2023
Language
English (United States)
Last Update
2023-12-05
dita:mapPath
hlv1700545853003.ditamap
dita:ditavalPath
mpm1591127278842.ditaval
dita:id
don1467241476387
Product Category
Analytical Ecosystem

Data Mover provides the ability to enable CLI tracing or TPT tracing at job level. Enabling CLI or TPT trace logging is not recommended unless needed; once enabled, all jobs begin generating extra trace logs.

Define the following elements in the job XML after the query_band element:
<enable_trace_log>
     <cli_trace_log>
       	<netrace>21</netrace>
       	<netrace_buf_len>0</netrace_buf_len>
       </cli_trace_log>
       <tpt_trace_log>
       	<tptapi_debug>1</tptapi_debug>
       </tpt_trace_log>
</enable_trace_log>

Usage Notes

  • When cli_trace_log elements are provided, CLI trace logs are enabled regardless of being a TPT job.
  • Values greater than or equal to 0 for netrace and netrace_buf_len elements trigger CLI logs to generate. Must be valid netrace and netrace_buf_len values for CLI, Data Mover does not validate these values.
  • When tptapi_debug is provided, the TPT trace log is enabled for TPT jobs; this setting does not affect non-TPT jobs. Must be a valid tptapi_debug value for Teradata PT API, Data Mover does not validate this value.
  • Values greater than or equal to 0 for the tptapi_debug element triggers TPTAPI trace logs for TPT jobs.
  • Values less than 0 for these elements does not trigger trace logs to generate.
  • Both CLI and TPT trace logs are generated in the temp task directory and remain there if the job log level is 99 or the job fails; otherwise, the logs and task directory are removed after the job completes.