TRACE RIO/RSCH/SIO/SIOF/SSCH
Authorization
Privilege Class: G
Purpose
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.
Operands
- range
- is a hexadecimal range of device numbers. A range may be expressed as:
- A single device number
- A device number followed by a period, followed by a number that represents the number of consecutive device addresses to be traced
- A pair of device numbers separated by a period (
.
), or a hyphen (-).
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.
- 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.
Usage Notes
- RIO, RSCH, SIO, SIOF, and SSCH instructions that cause an operation or privileged operation exception are not displayed.
- For usage information, see TRACE Usage Notes.
Responses
For response information, see TRACE: Command Responses.