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

TRACERED
Operands
Options
1874 z/VM: CP Commands and Utilities Reference
id specifies the primary input to TRACERED as a system trace file containing
CPTRACE or TRSOURCE data. The id operand is a spool ID, a decimal
number from 1 to 9999.
NAME
specifies the primary input to TRACERED from one or more files containing
trace data collected using SET CPTRACE or TRSOURCE commands. You may
identify files by file name, origin ID, and spool ID. Trace file names are assigned
by the TRSOURCE and TRSAVE commands. Within a set of traces, you may
select trace data for a particular virtual machine by specifying an origin user ID.
Further selectivity is allowed by selecting individual trace files by spool ID. The
fn operand specifies the file name assigned by the TRSAVE or TRSOURCE
command. The ORIG userid operand identifies, for guest type traces, files
containing an individual virtual machine’s trace data. This enables an individual
member of a VMGROUP trace to be specified on the TRACERED command
line. The id operand identifies an individual system trace file created with file
name fn, and it is specified as a spool ID, a decimal number from 1 to 9999.
A total of five system trace files, CMS files, or both can be merged including
only one CP TRACE data file. The output is merged by time-of-day and
formatted as it is written to a CMS file or the virtual printer as designated by this
command.
DEV vdev
specifies the primary input to TRACERED as a tape containing CP trace table
data at virtual device address vdev. See z/VM: CMS Commands and Utilities
Reference for a list of supported virtual tape devices.
TAPn
specifies the primary input to TRACERED as a tape containing CP trace table
data at symbolic tape address TAPn. See the z/VM: CMS Commands and
Utilities Reference for a list of supported TAPn values.
PRINT
designates that the output of the TRACERED command goes to your virtual
printer. This is the system default.
CMS
indicates that the output of the TRACERED command should be directed to a
CMS file of the file name, file type, and file mode you specify. If you do not
specify a file type, the default is CPTRACE. If you do not specify a file mode,
the default is A. If you specify this keyword, you will be put into XEDIT when the
command completes successfully.
GTRACE
specifies that the output will be in the form of an OS QSAM file. Only guest
virtual machine recorded trace events created by TRSOURCE in either BLOCK
mode or EVENT mode are output to this file.
FORMAT
specifies that each selected trace entry should appear in a long format. Three
lines per trace entry are formatted for CP trace table entries. The number of
lines of output for TRSOURCE recorded entries is determined by a formatting
routine based on the length of the trace record and the output LRECL value.
When the formatting routine is not supplied, the data is in hexadecimal form.
The difference between HEX and FORMAT processing is left to the exit routine