| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Performance Data (CRTPFRDTA) command creates a set of performance database files from performance information stored in a management collection (*MGTCOL) object. For more information about the database files, see the Performance topic in the iSeries Information Center at the Web site: http://www.ibm.com/eserver/iseries/infocenter.
Performance database files and file members will be created as needed based on the data contained in the management collection object and the information requested on this command. If database files already exist and the requested member exists in any of them, the member will be cleared before the collection is generated.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FROMMGTCOL | From collection | Single values: *ACTIVE Other values: Qualified object name |
Required, Positional 1 |
| Qualifier 1: From collection | Name | ||
| Qualifier 2: Library | Name, QPFRDATA | ||
| TOMBR | To member | Name, *FROMMGTCOL | Optional |
| TOLIB | To library | Name, *FROMMGTCOL | Optional |
| TEXT | Text 'description' | Character value, *SAME, *FROMMGTCOL, *GEN, *BLANK | Optional |
| CGY | Categories to process | Single values: *FROMMGTCOL Other values (up to 26 repetitions): Name, *APPN, *CMNBASE, *CMNSAP, *CMNSTN, *DISK, *DOMINO, *DPS, *HDWCFG, *HTTP, *IOPBASE, *IPCS, *JOBMI, *JOBOS, *LCLRSP, *LPAR, *POOL, *POOLTUNE, *SNA, *SNADS, *SUBSYSTEM, *SYSBUS, *SYSCPU, *SYSLVL, *TCPBASE, *TCPIFC, *USRTNS |
Optional |
| INTERVAL | Time interval (in minutes) | *FROMMGTCOL, 0.25, 0.5, 1.0, 5.0, 15.0, 30.0, 60.0 | Optional |
| FROMTIME | Starting date and time | Single values: *FROMMGTCOL Other values: Element list |
Optional |
| Element 1: Starting date | Date | ||
| Element 2: Starting time | Time | ||
| TOTIME | Ending date and time | Single values: *FROMMGTCOL, *ACTIVE Other values: Element list |
Optional |
| Element 1: Ending date | Date | ||
| Element 2: Ending time | Time |
| Top |
Specifies the management collection from which a set of performance database files is to be created.
Single values
Qualifier 1: From collection
Qualifier 2: Library
| Top |
Specifies the database file member to which the output data is to be written. If a member by this name does not exist in each performance database file, one will be created with the specified name.
| Top |
Specifies the library where the database files for performance data are to exist. Each file that is not found in the specified library is automatically created in that library.
| Top |
Specifies the text to be used for each member across the set of performance data base files associated with the collection.
| Top |
Specifies the categories in the management collection object which will be processed into database files.
Single values
Other values (up to 25 repetitions)
Name Description ------------- --------------------------- *APPN APPN *CMNBASE Communications (Base) *CMNSAP Communications (SAP) *CMNSTN Communications (Station) *DISK Disk *DOMINO Domino for iSeries *DPS Data port services *HDWCFG Hardware *HTTP HTTP Server (powered by Apache) *IOPBASE Input/output processors (Base) *IPCS Network server *JOBMI Jobs (MI tasks and threads) *JOBOS Jobs (operating system) *LCLRSP Local response time *LPAR Logical partition *POOL Pool *POOLTUNE Pool tuning *SNA SNA *SNADS SNADS *SUBSYSTEM Subsystem *SYSBUS System Bus *SYSCPU System CPU *SYSLVL System-level data *TCPBASE TCP/IP (base) *TCPIFC TCP/IP (interface) *USRTNS User-defined transaction data
| Top |
Specifies the time interval (in minutes) between successive entries in the database file(s). Within the database, these collection intervals will be identified by interval number and interval time.
Interval numbers will begin with 1 and increment with each interval. Interval time will be based on time at the end of the interval synchronized to the clock time (e.g. if INTERVAL(15) is specified, intervals could be generated as 01:00:00, 01:15:00, 01:30:00, and 01:45:00).
| Top |
Specifies the starting date and time of the performance data in the management collection object which will be used to create the performance database file(s). This time combined with the interval value will determine the date and time for each data base interval.
Single values
Element 1: Starting date
Element 2: Starting time
If the starting date is specified and the starting time is not, the starting time will default as follows:
| Top |
Specifies the ending date and time of the last performance data in the management collection object which will be used to create the performance database file(s).
Single values
This option causes the data base to be generated concurrently with the active collection. The data base will be generated based on the start time specified for any data currently in the management collection object. Additional data will be processed as it is added to the collection object. This will continue until the current collection ends.
Because this option can result in processing for a very long time, it is recommended that TOTIME(*ACTIVE) be specified only when running CRTPFRDTA in a batch job.
Element 1: Ending date
Element 2: Ending time
See the description of the Starting time element of the Starting date and time (FROMTIME) parameter for details about how time values can be specified.
If the ending date is specified and the ending time is not, the ending time will default as follows:
| Top |
Example 1: Generating All Data
CRTPFRDTA FROMMGTCOL(Q099365001) TOMBR(JAN1) TOLIB(MYLIB)
In this example, the database is generated for all categories contained within the management collection object Q099365001 in library QPFRDATA. The performance database files will be created into library MYLIB and the collection member name will be JAN1.
Data is generated from the start of data collection within this management collection object to the end of that collection. The database interval is the default collection interval that was specified at the time the collection was started.
Example 2: Selecting Specific Data
CRTPFRDTA FROMMGTCOL(Q099364002) TOMBR(JAN1J) TOLIB(MYLIB)
CGY(*JOBMI) INTERVAL(15)
FROMTIME(('01/01/98' '14:00:00'))
TOTIME(('01/01/98' '16:00:00'))
In this example, only the database file QAPMJOBMI is generated using *JOBMI category information from management collection Q099364002 in library QPFRDATA. The database interval will be 15 minutes even if the data was collected more frequently (for example, the management collection object may contain data collected every 5 minutes). The generated file will contain only data that was collected between 2:00 PM and 4:00 PM even though the collection object may contain data for a larger time interval.
| Top |
*ESCAPE Messages
| Top |