Copy Performance Collection (CPYPFRCOL)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FROMCOL | From collection | Name, *SELECT | Optional, Positional 1 |
| FROMLIB | From library | Name, QPFRDATA | Optional, Positional 2 |
| TOCOL | To collection | Name, *FROMCOL | Optional |
| TOLIB | To library | Name, *FROMLIB | Optional |
| COLTYPE | Collection type | Single values: *ALL Other values (up to 10 repetitions): Character value, *CSFILE, *CSMGTCOL, *DWFILE, *JWFILE, *PEXFILE, *PEXMGTCOL |
Optional |
| Top |
From collection (FROMCOL)
Specifies the performance collection to be copied.
- *SELECT
- Lists all collections available in the specified library that match the indicated collection type in the Collection type (COLTYPE) parameter so the user can select performance collections to copy.
Note: This value is valid only when the job that copies the performance collection is submitted interactively.
- name
- Specify the performance collection to be copied.
| Top |
From library (FROMLIB)
Specifies the library where the performance collections are located.
- QPFRDATA
- The IBM-supplied performance data library, QPFRDATA, is where the performance collections are located.
- name
- Specify the name of the library where the performance collections are located.
| Top |
To collection (TOCOL)
Specifies the name of the performance collection to which the performance data is copied.
- *FROMCOL
- The new performance collection has the same name as the one located in the From collection (FROMCOL) parameter. If this is specified, the new performance collection and original performance collection must reside in different libraries.
- name
- Specify the name of the performance collection to which the performance data is copied.
| Top |
To library (TOLIB)
Specifies the library in which the new copy of the performance collection is kept.
- *FROMLIB
- The new performance collection is kept in the same library as the collection from which it is copied.
- name
- Specify the name of the library in which the new performance collection is kept.
| Top |
Collection type (COLTYPE)
Specifies the type of collection to be copied.
Single values
- *ALL
- All types of performance collections with the same name as the one located in the From collection (FROMCOL) parameter are to be copied. This includes file-based collections and object-based collections.
Other values (up to 10 repetitions)
- *CSFILE
- Only the Collection Services file-based collections specified in the From collection (FROMCOL) parameter are to be copied.
- *CSMGTCOL
- Only the Collection Services object-based collections specified in the From collection (FROMCOL) parameter are to be copied.
- *DWFILE
- Only the Disk Watcher file-based collections specified in the From collection (FROMCOL) parameter are to be copied.
- *JWFILE
- Only the Job Watcher file-based collections specified in the From collection (FROMCOL) parameter are to be copied.
- *PEXFILE
- Only the Performance Explorer file-based collections specified in the From collection (FROMCOL) parameter are to be copied.
- *PEXMGTCOL
- Only the Performance Explorer object-based collections specified in the From collection (FROMCOL) parameter are to be copied.
- *BCHFILE
- Only the Batch Model file-based collections specified in the From collection (FROMCOL) parameter are to be copied.
- *HSTFILE
- Only the Historical file-based collections specified in the From collection (FROMCOL) parameter are to be copied.
- type
- Specify the type of collections to be copied.
Valid values depend on the performance collections supported by the system. You can press F4 while prompting this command parameter to see a list of valid collection type values.
| Top |
Examples
Example 1: Showing List of Performance Collections
CPYPFRCOL
This command shows a display for selecting from all of the performance collections in the QPFRDATA library. From this list, the user can select performance collections to copy.
Example 2: Copying Data
CPYPFRCOL FROMCOL(COL1) TOLIB(NEWLIB)
This command copies performance collection COL1 in library QPFRDATA to library NEWLIB. The new copy in library NEWLIB keeps the name COL1.
| Top |
Error messages
*ESCAPE Messages
- CPFC731
- Cannot copy/move performance collection
- Cannot copy/move performance collection &2.amp;2.
- CPFC736
- No performance collections copied/moved from library
- No performance collections copied/moved from library &1.amp;1.
| Top |