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

Restrictions:

1. This command is shipped with public *EXCLUDE authority.
2. The user must have *ADD and *EXECUTE authority to the specified TOLIB library, and *READ and *EXECUTE authority to the FROMLIB library.
3. The user must have *READ authority to the management collection 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

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.

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

data-library-name

Specify the name of the library where the management collection object exists.

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.

member-name

Specify the name of the member for the database used to store the Performance Explorer data.

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.

library-name

Specify the name of the library for the database used to store the Performance Explorer data.

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.

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.

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.

Examples

Example 1: Creating PEX Data

CRTPEXDTA   FROMMGTCOL(QAPEXDTA/MYCOL)  TOMBR(TEST)
            TOLIB(QAPEXDTA)  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.

Error messages

None