Trace (-T)

Use the Trace execution command (-T) to turn off tracing or to specify a particular card or a range of input or output data objects or both input and output data objects to trace. When the -T command is used without other options specified, no trace log is produced. You can also produce a trace summary and specify the storage medium to use for the trace report. The default is to write the trace information to temporary storage queue DTXTRCE. You can override the default by specifying the storage medium to be used and the name. See Specifying Storage Medium for details.

-T[I|ICcard_num|Ifrom[:to]]
	[O|OCcard_num][S][@storage_codeName]

Option

Description

I Produce detailed trace information for all output cards
ICcard_num Produce detailed trace information for a single input card. For example, the command -TIC3 only produces detailed trace information for input card 3.
Ifrom:to Produce detailed trace information for a range of input objects. For example, to produce trace information for objects 1000 to 1320, the option could be specified as -TI1000:1320. The upper limit of the object range is optional such that to trace from input object 1000 to the end of the file, the option could be specified as -TI1000.
O Produces detailed trace information for all output cards
OCcard_num Produce detailed trace information for a single output card. For example, the command -TOC2 produces detailed trace information only for output card 2.
S Produce summary trace information for input and output cards as specified, providing a message for each card. For example, the message for a particular card may be Input 1 was valid, but 34 bytes of unknown data found or Output 2 built successfully.
storage_code One of the following codes that represent the type of storage medium used for the trace report. The default storage medium is transient data queue CSML.

T = Specify a temporary storage queue.
D = Specify a transient data queue.
R = Specify VSAM relative-record dataset.
K = Specify VSAM key-sequenced dataset.
E = Specify VSAM entry-sequenced dataset.

name The name for the trace report. name must not be preceded by any spaces.