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.

Restrictions:

Parameters

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
Optional
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

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

Element 1: Number of units

Specify the size of the trace table.

1-998000
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.

*KB
The trace table size is specified in kilobytes. The valid range is 128 through 998000.
*MB
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.

*NONE
No trace points are to be excluded.
*RSCMGT
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

*NONE
No jobs are to be traced.
*ALL
All job types are to be traced.

Other values (up to 12 repetitions)

*DFT
Batch and autostart jobs are traced.
*ASJ
Autostart jobs are traced.
*BCH
Batch jobs are traced.
*EVK
Jobs started by a procedure start request are traced.
*INT
Interactive jobs are traced.
*MRT
Multiple requester terminal jobs are traced.
*RDR
Reader jobs are traced.
*SBS
Subsystem monitor jobs are traced.
*SYS
System jobs are traced.
*WRT
Writer jobs are traced.
*PDJ
Print driver jobs are traced.
*PJ
Prestart jobs are traced.
*BCI
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.

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

Examples

STRPFRTRC   SIZE(*CALC)

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

CPF0A2A
Performance trace already started

Also refer to the TRCINT command for other messages.