8.176.4 Examples

Example 1:

Set instruction tracing range with begin and end address and query the range afterwards.

HHC00013I Herc command: 't 100000-101000'

HHC02229I Instruction tracing off range 100000-101000

HHC00013I Herc command: 't?'

HHC02229I Instruction tracing off range 100000-101000

Figure 312: T command (address range)

Example 2:

Set instruction tracing range with start address and length and query the range afterwards.

HHC00013I Herc command: 't 1000000.1000'

HHC02229I Instruction tracing off range 1000000.1000

HHC00013I Herc command: 't?'

HHC02229I Instruction tracing off range 1000000-1001000

Figure 313: T command (address with length)

Example 3:

Set instruction tracing for all addresses and query the range afterwards.

HHC00013I Herc command: 't 0'

HHC02229I Instruction tracing off

HHC00013I Herc command: 't?'

HHC02229I Instruction tracing off

Figure 314: T command (all addresses)

8.177 T+ (Instruction trace on)

8.177.1 Function

This command turns on instruction tracing. A range can be specified as for the “T” command. Instruction
tracing is totally separate from the instruction stepping and breaking range.

After turning instruction tracing on, every instruction is listed with detailed trace information. The trace
information includes the executing CPU, the PSW, the executed instruction in hexadecimal and in dis-
assembled form as well as register hexadecimal displays of all involved register types.

This function is similar to the instruction stepping. The difference between these two function is that with
instruction stepping the execution of every instruction has to be initiated by hitting ENTER on the Hercu-
les console, whereas instruction tracing – once started – traces the instructions without interruption.

Please note that this function will create an enormous amount of output in the Hercules log. Running it on
a relatively current machine (3 GHz HT Processor) for 10 seconds creates more than 10 MB of trace
data.

8.177.2 Syntax

Descriptive

T+ [addr-addr addr.length

Diagram

Êʬ¬¬ T+ ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬ addr-addr ¬¬¬¬«

¬¬¬¬
¬¬¬¬«

addr.length ¬¬¬«

¬¬

8.177.3 Parameter

addr-addr

Specifies an address range with start and end address (from begin address to end
address).

addr:addr

Specifies an address range with start and end address (from begin address to end
address).

addr.length

Specifies an address range with start and length (from begin address with the spe-
cified length).

0

No range is specified or an existing range is reset. The tracing is active for all
addresses.