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

Usage Notes
1. The filename of the NAME operand designates a set of system trace files
created by one invocation of the CP TRSAVE command. Multiple system trace
files may exist with the same file name. If you specify a file name as NAME fn,
TRACERED processes all system trace files with that file name, beginning with
the oldest. If you specify NAME fn1 ,id1, TRACERED processes all system
trace files with that file name beginning with the spool ID id1. If you specify the
id operand, TRACERED will process that system trace file.
2. Avoid using TRACERED keywords for file names and file types as part of the
file id specified with the “FILE” operand.
3. TRACERED uses the first 2 bytes of each TRSOURCE created entry record
as the length of that entry.
4. When more than one tape created by the same TRSAVE command is to be
mounted and processed, they must be processed in chronological order.
5. Use the QUERY TRFILES command to display information about system trace
files you own, including spool ID, file name, and the time of creation.
6. A total of five system trace files, CMS files, or both can be merged. However,
only one CP trace table file or tape may be included. Therefore, you may
specify one of the following:
v One CP trace table file with up to four TRSOURCE trace files
v One tape with CP Trace table and up to four TRSOURCE trace files
v Up to five TRSOURCE trace files.
You cannot merge a CP tape or tapes with a CP trace table file.
7. The following guidelines apply to your responses to the prompt for selection
criteria when CP trace table data is processed:
v Each time the prompt appears, you may specify any or all of the six
selection types: CODE, VMDBK, RDEV, VDEV, CPU, and TIME.
v You do not have to enter these values on one line (with the exception of
TIME), as the prompt for selection criteria will reappear until you enter a null
line or QUIT.
v You cannot specify more than a total of 16 values per selection type in all of
your response lines combined, with the exception of TIME.
v An individual trace entry may or may not contain a field of the same type
specified in your reply to the prompt for selection criteria. All trace entries
have a trace code, CPU address, and time-of-day field; not all trace entries
have a VMDBK address, real device number, or virtual device number. As a
result, there are two main rules that apply to TRACERED data reduction:
– If you specify just one selection type in response to the prompt —
CODE, VMDBK, RDEV, VDEV, CPU, or TIME — then the trace entries
chosen for output will have a field for the selection type you indicated
and a value in the field that matches the value you indicated in your
response.
For instance, your response to the selection criteria prompt may have
been the following:
code 0c32 1000 0100
TRACERED
In this case, all trace entries with the code 0C32, 1000, or 0100 are
selected.
– If you specify more than one selection type in response to the prompt —
some combination of CODE, VMDBK, RDEV, VDEV, CPU, and TIME —
then the trace entries chosen for output depend on the selection type
Chapter 3. CP Utilities 1877