CL Command Reference - STRPEX
CL Command List > STRPEX Reference
Description:
The Start Performance Explorer (STRPEX) command starts a new Performance Explorer session or resumes a suspended Performance Explorer session.
Restrictions:
1. This command is shipped with public *EXCLUDE authority.
2. To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of i5/OS through iSeries Navigator¡¯s Application Administration support. The Change Function Usage Information (QSYCHFUI) API, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
3. The following user profiles have private authorities to use the command: v QPGMR v QSRV4. Two threads within the same job will not be allowed to run STRPEX at the same time. The thread that issued STRPEX first will run the command to completion while the second STRPEX waits.
Examples:
Example 1: Start a New Session
STRPEX SSNID(TESTRUN2) DFN(NEWDESC) OPTION(*NEW) FTR(MYFILTER)
This command starts a new session of the performance explorer using the criteria identified in a definition named NEWDESC and a filter named MYFILTER. The new session name is TESTRUN2.
Example 2: Resume a Suspended Session
STRPEX SSNID(TESTRUN1) OPTION(*RESUME)
This command resumes an already existing session of the performance explorer named TESTRUN1.