27.12.2012 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

TRACE I/O<br />

►►<br />

►<br />

TRace<br />

INTerrupt<br />

Authorization<br />

Purpose<br />

Oper<strong>and</strong>s<br />

I/O<br />

IO<br />

range<br />

options<br />

Instruction<br />

Privilege Class: G<br />

NOCCW<br />

CCW<br />

IODATA 8<br />

IODATA<br />

Use the TRACE I/O comm<strong>and</strong> to control virtual machine tracing of I/O events.<br />

range<br />

identifies a range of devices. The range may be expressed as a single device<br />

number or pair of device numbers separated by a hyphen. (-), or a starting<br />

device number followed by a period (.) <strong>and</strong> followed by a number representing<br />

the number of consecutive device addresses to be traced. Wrap-around ranges<br />

are not allowed.<br />

Instruction<br />

specifies tracing of I/O instructions for a TRACE I/O comm<strong>and</strong>. If neither<br />

INSTRUCTION nor CCW nor INTERRUPT is specified, INSTRUCTION <strong>and</strong><br />

INTERRUPT are assumed.<br />

NOCCW<br />

specifies that CCWs are not to be displayed. NOCCW is assumed if CCW is<br />

not specified.<br />

CCW<br />

specifies that CCWs are to be displayed with RIO, SIO, SIOF, SSCH, <strong>and</strong><br />

RSCH instructions that successfully start I/O.<br />

IODATA nnnn<br />

For CCWs h<strong>and</strong>led by the Virtual Channel Simulator, IODATA specifies the<br />

number of data bytes to be displayed for each CCW. nnnn can be up to 3800. If<br />

nnnn is greater than 8, TRACE I/O will display nnnn bytes of data following the<br />

CCW <strong>and</strong> prefixed with a hexadecimal offset:<br />

nnnn<br />

cp trace io 500 inst int ccw iodata 64<br />

... (other SSCH / IO INT trace output) ...<br />

VDEV 0500 CCW 72200080 00E58968 STS 00<br />

DATA +000 D0010600 F0F0F1F7 F3F2F0F0 F5C9C2D4<br />

DATA +010 E5D4F0F0 F0F0F0F0 F0F0F0F0 F0F00200<br />

DATA +020 D0020000 F0F0F1F7 F3F1F0F0 F5C9C2D4<br />

DATA +030 E5D4F0F0 F0F0F0F0 F0F0F0F0 F0F00200 STS 0C<br />

SIM<br />

specifies normal simulation of instructions. If neither SIM nor NOSIM is<br />

specified, SIM is assumed.<br />

SIM<br />

NOSIM<br />

TRACE I/O<br />

►<br />

►◄<br />

Chapter 2. <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> 1639

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!