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

SET TRACEFRAMES
SET TRACEFRAMES
►►
Set
Notes:
Authorization
Purpose
Operands
TRACEFRAMEs
Usage Notes
▼
(1)
Master nnnnnn
Alternate mmm
Privilege Class: A
Percent
1 Specify Master up to one time. Specify Alternate up to one time.
1412 z/VM: CP Commands and Utilities Reference
Use SET TRACEFRAMES to change the number of pages that CP sets aside for
an internal trace table for the master processor and the alternate processors in the
configuration.
Master nnnnnn
specifies the number of pages of storage for the master processor’s internal
trace table. nnnnnn must be equal to or greater than 3, and it cannot exceed
131072.
Alternate mmm Percent
specifies the size of each alternate processor’s internal trace table, which is
mmm percent of the master processor’s internal trace table.
1. CP maintains separate internal trace tables for each processor in the
configuration. You can use this command to set the size of the internal trace
table for the master processor and the alternate processors, which are
expressed as a percentage of the master processor’s trace table.
2. Each increase in the size of the system internal trace tables should be small.
You should break a large increase down into a number of smaller ones, each
less than the size of the system’s available frame queue. Use the QUERY
FRAMES command to see how your system has allocated frames of real
storage.
3. If CP processes a request to increase the internal trace table and all readily
available storage has been allocated, CP returns the internal trace table to the
size prior to the SET TRACEFRAMES command.
4. A TRSAVE command typically extracts data from the system internal trace table.
A SET TRACEFRAMES command, therefore, will be rejected if a TRSAVE
command is active. Similarly, a TRSAVE command will be rejected if a SET
TRACEFRAMES command is active.
5. The number of trace frames for each processor will always be adjusted to a
minimum of 3 pages.
6. See QUERY TRACEFRAMES for information on how to display the size of the
internal trace tables.
►◄