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:

This command is shipped with public *EXCLUDE authority.
The following user profiles have private authorities to use the command:
- QSRV

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

Top

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.

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).