Start Performance Trace (STRPFRTRC)

The Start Performance Trace (STRPFRTRC) command is a simplified interface to the TRCINT command for collecting Multiprogramming level (MPL) and Transaction trace data. This command collects the same performance trace data as was collected in previous releases by the Start Performance Monitor (STRPFRMON) command.

The trace started by this command creates and uses trace table QPM_STRPFRTRC.If the trace table exists, any existing data will be deleted before this trace begins.

The trace can be stopped and the data can be written to a data base file by using the End Performance Trace (ENDPFRTRC) command.



Keyword Description Choices Notes
SIZE Trace table size Single values: *CALC, *MAX
Other values: Element list
Optional, Positional 1
Element 1: Number of units 1-998000
Element 2: Unit of measure *KB, *MB
OMTTRCPNT Omit trace points *NONE, *RSCMGT Optional
JOBTYPE Job types Single values: *NONE, *ALL
Other values (up to 12 repetitions): *DFT, *ASJ, *BCH, *EVK, *INT, *MRT, *RDR, *SBS, *SYS, *WTR, *PDJ, *PJ, *BCI
JOBTRCITV Job trace interval 0.1-9.9, 0.5 Optional

Trace table size (SIZE)

Specifies the size of the trace table.

Note: The storage indicated on this parameter is immediately allocated from the system auxiliary storage pool (ASP 1). Refer to the Trace Internal (TRCINT) command SIZE parameter for additional information regarding the setting of trace table size.

Specifying a size of less than 16 megabytes is not recommended.

Single values

The minimum trace table size is determined based on the processor group of your system.
The trace table is set to the maximum size of 258048 megabytes.

Element 1: Number of units

Specify the size of the trace table.

Specify the size of the trace table in kilobytes or megabytes.

Element 2: Unit of measure

Specify whether the value specified for the first element of this parameter should be treated as number of kilobytes or number of megabytes.

The trace table size is specified in kilobytes. The valid range is 128 through 998000.
The trace table size is specified in megabytes. The valid range is 1 through 258048.

Omit trace points (OMTTRCPNT)

Specifies trace points whose trace records are to be excluded.

No trace points are to be excluded.
Resource management trace points (seize/lock conflict data) will be excluded from the trace.

Job types (JOBTYPE)

Specifies the types of jobs for which trace data is to be collected for use in the batch job trace report.

Note: The value *DFT includes the values *ASJ, *BCH, *EVK, *MRT, *PDJ, *PJ and *BCI. The value *BCH includes the values *EVK, *MRT, *PDJ, *PJ, and *BCI.

Single values

No jobs are to be traced.
All job types are to be traced.

Other values (up to 12 repetitions)

Batch and autostart jobs are traced.
Autostart jobs are traced.
Batch jobs are traced.
Jobs started by a procedure start request are traced.
Interactive jobs are traced.
Multiple requester terminal jobs are traced.
Reader jobs are traced.
Subsystem monitor jobs are traced.
System jobs are traced.
Writer jobs are traced.
Print driver jobs are traced.
Prestart jobs are traced.
Batch immediate jobs are traced.

Job trace interval (JOBTRCITV)

Specifies the time interval (in CPU seconds) to be used between each collection of the job trace data.

A time slice interval value of 0.5 CPU seconds is used.
Specify the trace interval to be used, in CPU seconds.



This command starts the collection of performance trace data. The trace table size may be adjusted to the calculated minimum. This example will result in the same trace table size and data as would STRPFRMON TRACE(*ALL) DMPTRC(*NO).

Error messages

*ESCAPE Messages

Performance trace already started

Also refer to the TRCINT command for other messages.