Purpose: The ENABLE TRACE command will activate
module tracing for the specified product. This debugging facility can
produce a trace message for every module entered during product execution. The trace request
can be limited to a specified jobname and stepname.
The number of messages can also be limited by the lvl operand. When one
module calls another, the module level counter is incremented by one. During module
termination, the level counter is decremented. The TRACE command can use the
level counter to limit the output to a specified module call depth.
The DISABLE TRACE command will deactivate the trace request. A
TRACE command without ENABLE or DISABLE
preceding the command will list the current trace options.
Syntax:
ENABLE TRACE {product | *} [lvl] [jobname] [. stepname]
DISABLE TRACE {product | *}
TRACE {product | *}
Comments: This command should never be required under normal circumstances, and should only be used when requested by technical support.
ENABLE TRACE command can
be active for a product at any given time. If two ENABLE
TRACE commands are entered for a product, the second command takes precedence. lvl operand is not specified or set to
zero, a lot of output can be produced by the trace facility. You may wish to warn the system
operators before you enable module tracing.
Examples: If requested by the technical support staff, the following
console command would enable ACC module tracing for job
DON1 with a step name of S1. The level limit will only
trace modules to a call depth of two.
F DIF,ENABLE TRACE ACC 2 DON1.S1