TRACE RIO/RSCH/SIO/SIOF/SSCH

Read syntax diagramSkip visual syntax diagram TRace RIORSCHSIOSIOFSSCHrangeSIMNOSIMNOCCWCCWoptions

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

  1. RIO, RSCH, SIO, SIOF, and SSCH instructions that cause an operation or privileged operation exception are not displayed.
  2. For usage information, see TRACE Usage Notes.

Responses

For response information, see TRACE: Command Responses.