8.140.4 Examples

Example 1:

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

HHC00013I Herc command: 's 100000-101000'

HHC02229I Instruction stepping off range 100000-101000

HHC00013I Herc command: 's?'

HHC02229I Instruction stepping off range 100000-101000

Figure 261: S command (address range)

Example 2:

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

HHC00013I Herc command: 's 100000.1000'

HHC02229I Instruction stepping off range 100000.1000

HHC00013I Herc command: 's?'

HHC02229I Instruction stepping off range 100000-101000

Figure 262: S command (address with length)

Example 3:

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

HHC00013I Herc command: 's 0'

HHC02229I Instruction stepping off

HHC00013I Herc command: 's?'

HHC02229I Instruction stepping off

Figure 263: S command (all addresses)

8.141 S+ (Instruction stepping on)

8.141.1 Function

This command turns on the instruction stepping. After turning instruction stepping on, each ENTER from
the console allows Hercules to execute exactly one instruction and lists detailed trace information.

The trace information includes the executing CPU, the PSW, the executed instruction in hexadecimal and
in disassembled form as well as register hexadecimal displays of all involved register types.

A range can be specified as for the “S” command, otherwise the existing range is used. If there is no
range (or range was specified as 0) then the range includes all addresses.

When an instruction within the range is about to be executed, the CPU is temporarily stopped and the
next instruction is displayed. You may then examine registers and/or storage etc. before you press Enter
to execute the instruction and stop at the next instruction. To turn off instruction stepping and continue
normal execution, enter the “G” command.

8.141.2 Syntax

Descriptive

addr-addr addr.length

Diagram

¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

addr-addr ¬¬¬¬«

¬¬¬¬
¬¬¬¬«

addr.length ¬¬¬«

¬¬

8.141.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. Instruction stepping is set for all
addresses.