CL Command Reference - ENDPEX
CL Command List > ENDPEX Reference
Description:
The End Performance Explorer (ENDPEX) command instructs the Performance Explorer tool to stop collecting data. The command expects a session name to accompany the request which identifies which instance of the Performance Explorer session to end.
The user can either end the data collection session or suspend the data collection session. If the user chooses to end the session, the collected data is put into an object of type *MGTCOL or into a set of database files, or it is deleted, based on the value specified for the DTAOPT parameter.
If the user chooses to suspend the collection of performance data, the session remains active. To resume data collection for a suspended session, the user can specify OPTION(*RESUME) on a subsequent call of the STRPEX (Start Performance Explorer) command.
Restrictions:
1. This command is shipped with public *EXCLUDE authority.
2. The user must have *ADD and *EXECUTE authority to the specified DTALIB and MGTCOL libraries.
3. The user must have *OBJMGMT, *OBJEXIST, and use authorities to the managment collection object if replacing an existing management collecton object.
4. 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.
5. The following user profiles have private authorities to use the command:
. QPGMR
. QSRV
6. If running ENDPEX from a secondary thread, the QAYPE* files must already exist in the DTALIB library. These files must be created in the primary thread by running ENDPEX DTAOPT(*LIB).
7. If running ENDPEX from a secondary thread, DTAOPT(*MGTCOL) object cannot be specified.
8. Two threads within the same job will not be allowed to run ENDPEX at the same time. The thread that issued ENDPEX first will run the command to completion while the second ENDPEX waits.
Examples:
Example 1: End a Session and Save the Database Files
ENDPEX SSNID(TEST3) OPTION(*END) DTAOPT(*LIB) DTAMBR(SYS1DATA)
This command ends the performance explorer session named TEST3 and saves the data in a set of database files in library QPEXDATA. The member name to be used for each file is SYS1DATA.
Example 2: End a Session and Delete the Data
ENDPEX SSNID(TESTRUN) OPTION(*END) DTAOPT(*DLT)
This command ends the performance explorer session named TESTRUN and deletes the collected performance data.
Example 3: End a Session and Save the *MGTCOL
ENDPEX SSNID(TEST3) OPTION(*END) DTAOPT(*MGTCOL)
MGTCOL(MYLIB/SYS1DATA) NBRTHD(*CALC)
This command ends the performance explorer session named TEST3 and saves the data in a management collection object in library MYLIB in the management collection object named SYS1DATA. ENDPEX will calculate a number of threads to process this request. This number of threads will do the ENDPEX processing as quickly as possible without disrupting the rest of the system.