Start Performance Tools (STRPFRT)

Where allowed to run:
  • Interactive job (*INTERACT)
  • Interactive program (*IPGM)
  • Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Start Performance Tools (STRPFRT) command calls the performance tools menu interface. This displays the performance tools main menu (PERFORM), which provides access to all of the performance tools.

Top

Parameters

Keyword Description Choices Notes
LIB Library Name, QPFRDATA Optional, Positional 1
JOB Job name Name, *CMD, *MBR Optional
JOBD Job description Single values: *NONE
Other values: Qualified object name
Optional
Qualifier 1: Job description Name, QPFRJOBD
Qualifier 2: Library Name, *LIBL, *CURLIB
Top

Library (LIB)

Specifies the library where the performance data is located.

QPFRDATA
The performance data files are located in the IBM-supplied performance data library, QPFRDATA.
library-name
Specify the name of the library where the performance database files are located.
Top

Job name (JOB)

Specifies the job name to be used for submitting report and utility jobs for batch processing.

Note: If *NONE is specified on the Job description prompt (JOBD parameter), this parameter is ignored, and job processing is performed interactively.

The possible job-name values are:

*CMD
The command name that corresponds to the menu option selected is used to name the job. All jobs created by the same option will have the same name.
*MBR
The name selected for the performance data member in the Member prompt (MBR parameter) of the corresponding command is used. If the command does not have a MBR parameter and *MBR is specified for this parameter, the command name is used.
job-name
Specify the name to be used for batch jobs.
Top

Job description (JOBD)

Specifies the job description used to submit the job for batch processing.

The possible job description values are:

QPFRJOBD
The IBM-supplied job description, QPFRJOBD, is used.
job-description-name
Specify the name of an alternate job description.
*NONE
A batch job is not submitted; processing continues interactively while the user waits. The user's workstation is not available for other use during this time, which could be significant for long jobs.

The possible library values are:

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the job description. If no current library entry exists in the library list, QGPL is used.
library-name
Specify the library in which the job description is located.
Top

Examples

STRPFRT

This command calls the menu interface to Performance Tools. The library, QPFRDATA, is used in storing and getting the performance data for this session. Requests that are submitted to run in batch use the job description QPFRJOBD in the library list.

Top

Error messages

None

Top