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

TRACE RIO/RSCH/SIO/SIOF/SSCH
►►
TRace
Authorization
Purpose
Operands
RIO
RSCH
SIO
SIOF
SSCH
range
SIM
NOSIM
Privilege Class: G
NOCCW
CCW
Use TRACE RIO, TRACE RSCH, TRACE SIO, TRACE SIOF, or TRACE SSCH to
trace RIO, RSCH, SIO, SIOF, or SSCH instructions for all I/O devices, or for a
range of devices.
Note: Tracing is limited to those instructions that do not produce an operation or
privileged-operation exception.
range
is a hexadecimal range of device numbers.
A range may be expressed as:
v A single device number
options
v A device number followed by a period, followed by a number that represents
the number of consecutive device addresses to be traced
v A pair of device numbers separated by a period (.), or a hyphen (-).
Wrap-around ranges are not allowed.
TRACE RIO/RSCH/SIO/SIOF/SSCH
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.
NOCCW
specifies that CCWs are not displayed. If you specify neither CCW or NOCCW,
NOCCW is assumed.
CCW
specifies that CCWs be displayed with the SIO, SIOF, SSCH, RIO, and RSCH
instructions that successfully start I/O.
options
For an explanation of the options, see “TRACE: Options” on page 1604.
►◄
Chapter 2. CP Commands 1645