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

TRACE TPI
►►
TRace
Authorization
Purpose
TPI
Operands
Usage Notes
Responses
range
SIM
NOSIM
Privilege Class: G
options
Use TRACE TPI to trace test pending interruption instructions.
Note: TRACE TPI is accepted if your virtual machine is an ESA or XC virtual
machine; tracing is limited to those instructions that do not produce an
operation or privileged-operation exception.
range
is a range of device numbers. If you specify a device range, only those TPI
instructions that store an interruption is traced. If you do not specify a range, all
TPI instructions are traced. The device range applies to the device name, and
not the subchannel address.
The range may be a single device number, a device number followed by a
period and followed by a number that represents the number of consecutive
device addresses to be traced, or pair of device numbers separated by a period
(.) or a hyphen (-). Wrap-around ranges are not allowed.
NOSIM and a device range are not compatible options.
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.
This operand is not valid when TPI specifies a device range.
options
For an explanation of the options, see “TRACE: Options” on page 1604.
1. For usage information, see “Usage Notes” on page 1601.
TRACE TPI
For response information, see “TRACE: Command Responses” on page 1610.
►◄
Chapter 2. CP Commands 1657