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
IC`card_num`	Produce detailed trace information for a single input card. For example, the command `-TIC3` only produces detailed trace information for input card 3.
I`from`:`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
OC`card_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.