SET TRACEFRAMES

Read syntax diagramSkip visual syntax diagram Set TRACEFRAMEs 1MasternnnnnnAlternatemmmPercent
Notes:
  • 1 Specify Master up to one time. Specify Alternate up to one time.

Authorization

Privilege Class: A

Purpose

Use SET TRACEFRAMES to change the number of real storage frames that CP sets aside for an internal trace table for the master processor and the alternate processors in the configuration.

Operands

Master nnnnnn
specifies the number of real storage frames for the master processor's internal trace table. The value 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.

Usage Notes

  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.
  6. See QUERY TRACEFRAMES for information on how to display the size of the internal trace tables.
  7. Trace pages associated with trace frames are in system execution space (SXS) and backed by a below-2-GB frame. This means that there is a limit on the number of trace frames due to the storage limit on SXS. An "insufficient storage" condition might occur when requesting more trace frames for each logical processor and will become more likely as the number of running logical processors in a configuration increases.

Examples

If you issued the command: 
SET TRACEFRAMES MASTER 100 ALTERNATE 90 PERCENT
and you had a four-processor CPU, the master processor would be allocated a 100-frame internal trace table, and each of the three alternate processors would be allocated a 90-frame internal trace table.
If you subsequently issued the command: 
SET TRACEFRAMES MASTER 200
the master processor would be allocated a 200-frame internal trace table, and each of the three alternate processors would be allocated a 180-frame internal trace table.

Responses

Response 1: 
Command Complete

Messages

  • HCP002E Invalid operand - operand
  • HCP003E Invalid option - command contains extra option(s) starting with operand
  • HCP013E Conflicting option - option
  • HCP6077E TRSAVE is active.
  • HCP6704E Missing token at end of line
  • HCP6706E Invalid number - operand
  • HCP6740E Insufficient storage to complete this request