Create PEX Data (CRTPEXDTA)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Performance Data (CRTPEXDTA) command creates the Performance Explorer database files based on the data in a Performance Explorer management collection object (object type *MGTCOL).
Additional information about the Performance Explorer tool can be found in the Performance Management information at http://www.ibm.com/servers/eserver/iseries/perfmgmt/resource.html.
Restrictions:
- This command is shipped with public *EXCLUDE authority.
- The user must have *ADD and *EXECUTE authority to the specified TOLIB library, and *READ and *EXECUTE authority to the FROMLIB library.
- The user must have *READ authority to the management collection object.
- To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of the operating system. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can be used to change the list of users that are allowed to perform trace operations.
- The following user profiles have private authorities to use the command:
- QPGMR
- QSRV
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FROMMGTCOL | From collection | Qualified object name | Required, Positional 1 |
| Qualifier 1: From collection | Name | ||
| Qualifier 2: Library | Name, QPEXDATA | ||
| TOMBR | To member | Name, *FROMMGTCOL | Optional, Positional 2 |
| TOLIB | To library | Name, *FROMMGTCOL | Optional, Positional 3 |
| NBRTHD | Number of threads | 1-256, *CALC | Optional |
| RPLDTA | Replace data | *YES, *NO | Optional |
| TEXT | Text 'description' | Character value, *BLANK | Optional |
| Top |
From collection (FROMMGTCOL)
Specifies the name of the Performance Explorer management collection object. The data in this object will be stored in the Performance Explorer database files in the specified member.
This is a required parameter.
- name
- Specify the name of the management collection object.
The possible library values are:
- QPEXDATA
- The QPEXDATA library is the recommended library for storing data collected by the Performance Explorer tool. The first time the Performance Explorer tool is used, this library is created for the user.
- name
- Specify the name of the library where the management collection object exists.
| Top |
To member (TOMBR)
Specifies the member name used to store the data in the Performance Explorer database files.
- *FROMMGTCOL
- The name of the management collection object is used as the member name.
- name
- Specify the name of the member for the database used to store the Performance Explorer data.
| Top |
To library (TOLIB)
Specifies the library used to store the data in the Performance Explorer database files.
- *FROMMGTCOL
- The library specified for the management collection object is used.
- name
- Specify the name of the library for the database used to store the Performance Explorer data.
| Top |
Number of threads (NBRTHD)
Specifies the number of concurrent threads that the CRTPEXDTA command uses to process the data. Specifying a number greater than 1 allows the CRTPEXDTA command to take advantage of available CPU cycles, especially on a multi-processor system. While this may speed up the command processing, it may also degrade the performance of other jobs on the system. You can minimize this impact by changing the priority of the job that runs the CRTPEXDTA command to a higher number. You should also verify the disk subsystem can handle the additional threads. Typically, the CRTPEXDTA command requires one disk arm for each active thread.
- *CALC
- The system will calculate a reasonable number of threads to do the CRTPEXDTA processing which will not use excessive CPU or disk resources. Usually this is one or two threads for each available processor.
- number-of-threads
- Specify the number of threads for CRTPEXDTA to use to process the collected data.
| Top |
Replace data (RPLDTA)
Specifies whether to replace the data in an existing set of file members with new performance data.
- *NO
- If a member already exists with the same name, an error message is sent to the user. This prevents the user from inadvertently writing over existing data.
- *YES
- If a member already exists with the same name, the old data is lost and is replaced by the new data.
| Top |
Text 'description' (TEXT)
Specifies the text that briefly describes the type of data collected.
- *BLANK
- Text is not specified.
- 'description'
- Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Examples
Example 1: Creating PEX Data
CRTPEXDTA FROMMGTCOL(QPEXDATA/MYCOL) TOMBR(TEST)
TOLIB(QPEXDATA) NBRTHD(2)
This command creates Performance Explorer (PEX) data in member name TEST in library QAPEXDATA. The collected data exists in the management collection object MYCOL found in library QAPEXDTA. Two threads will be used to process the data.
| Top |
Error messages
None
| Top |