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

TRSAVE
Operands
1666 z/VM: CP Commands and Utilities Reference
ID traceid
indicates that this TRSAVE applies to data generated by traceid, which was
defined by the TRSOURCE command.
CP ON
indicates that the recording of CP trace table data should begin.
CP OFF
stops CP system trace table data recording. Any remaining buffers of data are
written to the output medium. Either a tape mark is written, or the DASD file is
closed, depending on the output medium. Tapes are rewound and unloaded.
CP CANCEL
stops CP system trace table data recording. Any pending I/O is canceled. Any
data collected, but not written, is lost. When tape is the output medium, a tape
mark is written, and the tape is rewound and unloaded, regardless of the
previous tape positioning option.
DEFERIO
indicates that no trace data is to be recorded on DASD or TAPE until the
traceid is disabled or, for CP trace table recording, until TRSAVE CP OFF is
issued. Until that time, when all in-storage buffers are filled tracing wraps to the
oldest buffer. DEFERIO is not valid for TYPE GT BLOCK mode traces.
FRAMES nnnnn
specifies the amount of real storage frames to be used for the in-storage-wrap
buffers. The default is 512 frames. The minimum is 8 frames. The maximum is
99999 frames per trace, but may be further limited by the amount of pageable
pages in the system dynamic paging area that are eligible for DEFERIO traces.
See usage note 17 on page 1669 for usage notes regarding DEFERIO and
FRAMES.
DASD
indicates that trace data is to be recorded in system trace files. DASD is the
default.
TO userid
* The operand userid specifies the user ID to receive the system trace file
containing the trace data.
The operand asterisk (*) specifies that the user who issues the command
should receive the system trace file containing the trace data. The operand
asterisk (*) is the default.
NAME fname
specifies the file name to be assigned to the system trace file. For CP system
trace table data, CPTRACE is the default name. For trace data generated by
traces defined by the TRSOURCE command, the trace ID is the default name.
SIZE nnnn
indicates the maximum size of the system trace files. The operand nnnn is a
decimal number that specifies 4 KB pages of trace data. Once the file reaches
the limit, it is closed and a new file is opened when the next trace record is
received. The default is 256 pages. The minimum is eight pages. The maximum
is 9999 pages.
KEEP n
specifies the total number of trace files to be kept on DASD for this recording
function. The default is two files. The maximum is nine files.