Data Mover provides the ability to enable CLI 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 them being ARC or TPT jobs.
- 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 TPTAPIDEBUG 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 TPTAPI, Data Mover does not validate this value.
- Values greater than or equal to 0 for the TPTAPIDEBUG element triggers TPTAPI trace logs for TPT jobs.
- Values less than 0 for these elements does not trigger trace logs to generate.
- Using the tag additional_arc_parameters with the cli_trace_log tag generates both CLI trace logs and extra ARC logs, based on what has been provided in the additional_arc_parameters element.
- 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.