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

TRSOURCE ID (Definition Operands)
DISPlay
displays the status for each trace ID or trace set specified on this command. If
you specify DISPLAY, it must be the last operand on the command line.
The I/O Trace
The I/O trace lets you trace all I/O activity on a user-specified real device, a list of
real devices, or range of real devices. The times, channel programs, SCSWs, and
data transferred for each I/O operation to the specified devices are made available
for data analysis. If concurrent sense data is received then this information is made
available as well.
Note: Any or none of the following I/O parameters may be specified in any order
on a TRSOURCE command.
DEVice rdev1[-rdev2] [rdev3[-rdev4]]...
USER { userid }
{ ALL }
{ SYSTEM }
IOData { nnnn }
{ 0 }
DEVice rdev1...
specifies the device number or ranges of device numbers whose I/O activity is
to be traced. The number of devices or ranges that can be traced with one
trace ID of type IO is limited to 255. DEVICE is the only mandatory parameter
before enabling of trace IDs of type IO. There are no defined defaults for the
DEVICE parameter and any respecification of DEVICE for a previously defined
trace results in new devices being appended to the definition. A device can be a
member of only one enabled trace ID. Attempts to enable the same device from
two or more different trace IDs results in an error message.
USER userid
USER ALL
USER SYSTEM
specifies which user’s I/O should be traced. I/O done by the system on behalf
of the user is traced. Tracing can only be done for one user per trace ID and
any respecification of the user parameter replaces the existing definition. The
user ID SYSTEM is a valid user ID for I/O traces. Only one user’s I/O or all I/O
is traced. The default value, ALL, specifies that all I/O to the specified device is
traced for all user IDs.
IOData nnnn
specifies how many bytes, if possible, of the transferred data should be traced.
The valid range for nnnn is 0 to 3800 decimal and the default is 0 bytes.
The GT Trace
1684 z/VM: CP Commands and Utilities Reference
Traces of type GT allow a guest virtual machine to record events. Guests can
record in block or event mode. All user IDs specified for a trace ID must support the
same mode of recording.