z/VM: CP Commands and Utilities Reference - z/VM - IBM

TRACE mnemonic2
TRACE mnemonic2
►►
TRace
Authorization
Purpose
Operands
Usage Notes
Responses
mnemonic2
range
SIM
NOSIM
Privilege Class: G
Use TRACE mnemonic2 to trace specific I/O instructions within a device range.
mnemonic2
must be one of the following standard assembler opcode mnemonics:
CLRCH HDV HSCH STSCH TIO
CLRIO HIO MSCH TCH TSCH
CSCH
Tracing is limited to those instructions that do not produce an operation or
privileged operation exception.
range
is a range of devices. The range may be expressed as:
v a single device number (100)
1644 z/VM: CP Commands and Utilities Reference
options
v a pair of device numbers separated by a hyphen (100-103)
v device number followed by a period and the number of consecutive device
addresses to be traced (100.4).
Wrap-around ranges are not allowed.
SIM
specifies normal simulation of instructions. If neither SIM nor NOSIM is
specified, SIM is assumed.
NOSIM
specifies suppression of instruction simulation. Program interrupts for guest
PER events are also suppressed. By using NOSIM and the CMD option, you
can define a CP command or set of CP commands to be processed in place of
the suppressed instruction. The PSW is left pointing to the next sequential
instruction.
options
For an explanation of the options, see “TRACE: Options” on page 1604.
1. For usage information, see “Usage Notes” on page 1601.
For response information, see “TRACE: Command Responses” on page 1610.
►◄